本文中含有需要您注意的重要提示信息,忽略该信息可能对您的业务造成影响,请务必仔细阅读。
通过智能媒体管理(IMM)的视频管理功能获取媒体文件的元信息,包括分辨率、码率、帧率及编码标准等。这些信息可用于媒体的检索、播放展示及智能管理,从而提升媒体的运营与管理效率。您可以按照以下步骤将媒体信息检测从旧版(API版本为2017-09-06)迁移至新版(API版本为2020-09-30)。
背景信息
媒体信息检测后续新增功能及优化将主要集中于新版,旧版将逐步下线。新版本相较于旧版提供了更多的格式支持以及更广泛的地域支持,为了确保您获得更优质的使用体验,建议您尽快迁移至新版。
新版优势
媒体格式:新版对媒体文件元信息获取增加了更多的格式。
响应速度:新版对媒体文件元信息获取速度相对于旧版更快。
准确性:新版对媒体文件元信息获取准确率相对于旧版更高。
新版与旧版API对应关系说明
SDK/API版本
旧版使用旧版SDK,API版本为2017-09-06。
新版使用新版SDK,API版本为2020-09-30。
文档在线预览和协作编辑关于新版与旧版API的对应关系,请参见下表。
功能 | 新版API | 旧版API | 说明 |
功能 | 新版API | 旧版API | 说明 |
媒体文件元信息 | API版本为2020-09-30 | API版本为2017-09-06 | 新版本支持更多的媒体格式。 |
如何迁移
您可以按照以下步骤进行迁移:
创建新版项目。
调试新版接口以对应现有功能,并将您的业务切换至新版接口。
删除旧版本项目。
步骤一 :创建新版项目
创建新版项目之前确认是否已创建过新版项目,参考检查项目新旧版本,新版项目存在则无需创建。
创建新版项目
登录智能媒体管理控制台。
左下角提供了新旧版本的切换功能,用户可在旧版中点击以体验新版。
在项目列表页面,请在页面左上角选择与旧版项目相同的地域,具体如下图所示。
在项目列表页面,单击创建项目,弹出创建项目面板,填写项目信息确认完成创建,如下图所示。
创建项目时,需选择与旧版项目相同的服务角色,并将工作流模板设置为Official:MediaMeta,其余选项无需进行配置。
步骤二:调用新版媒体信息检测接口
调用新版接口DetectMediaMeta - 获取媒体文件元信息。具体操作请参见以下步骤:
DetectMediaMeta获取媒体文件元信息接口的项目名参数应使用新版本创建的项目名称。
SDK/API版本
新版使用新版SDK,API版本为2020-09-30。
旧版使用旧版SDK,API版本为2017-09-06。
SDK 安装命令
pip install alibabacloud_imm20200930==4.6.1
示例代码:
# -*- coding: utf-8 -*- # This file is auto-generated, don't edit it. Thanks. import os import sys from typing import List from alibabacloud_imm20200930.client import Client as imm20200930Client from alibabacloud_tea_openapi import models as open_api_models from alibabacloud_imm20200930 import models as imm_20200930_models from alibabacloud_tea_util import models as util_models from alibabacloud_tea_util.client import Client as UtilClient class Sample: def __init__(self): pass @staticmethod def create_client() -> imm20200930Client: """ 使用AK&SK初始化账号Client @return: Client @throws Exception """ # 工程代码泄露可能会导致 AccessKey 泄露,并威胁账号下所有资源的安全性。以下代码示例仅供参考。 # 建议使用更安全的 STS 方式。 config = open_api_models.Config( # 必填,请确保代码运行环境设置了环境变量 ALIBABA_CLOUD_ACCESS_KEY_ID。, access_key_id=os.environ['ALIBABA_CLOUD_ACCESS_KEY_ID'], # 必填,请确保代码运行环境设置了环境变量 ALIBABA_CLOUD_ACCESS_KEY_SECRET。, access_key_secret=os.environ['ALIBABA_CLOUD_ACCESS_KEY_SECRET'] ) # Endpoint 请参考 https://api.aliyun.com/product/imm config.endpoint = f'imm.cn-hangzhou.aliyuncs.com' return imm20200930Client(config) @staticmethod def main( args: List[str], ) -> None: client = Sample.create_client() detect_media_meta_request = imm_20200930_models.DetectMediaMetaRequest( project_name='TestProject', source_uri='oss://test/test.mp4' ) runtime = util_models.RuntimeOptions() try: # 复制代码运行请自行打印 API 的返回值 client.detect_media_meta_with_options(detect_media_meta_request, runtime) except Exception as error: # 此处仅做打印展示,请谨慎对待异常处理,在工程项目中切勿直接忽略异常。 # 错误 message print(error.message) # 诊断地址 print(error.data.get("Recommend")) UtilClient.assert_as_string(error.message) @staticmethod async def main_async( args: List[str], ) -> None: client = Sample.create_client() detect_media_meta_request = imm_20200930_models.DetectMediaMetaRequest( project_name='TestProject', source_uri='oss://test/test.mp4' ) runtime = util_models.RuntimeOptions() try: # 复制代码运行请自行打印 API 的返回值 await client.detect_media_meta_with_options_async(detect_media_meta_request, runtime) except Exception as error: # 此处仅做打印展示,请谨慎对待异常处理,在工程项目中切勿直接忽略异常。 # 错误 message print(error.message) # 诊断地址 print(error.data.get("Recommend")) UtilClient.assert_as_string(error.message) if __name__ == '__main__': Sample.main(sys.argv[1:])
步骤三:删除旧版项目
删除旧版项目之前,请确保业务已完全迁移到新版,旧版没有流量之后再进行删除,此操作不可恢复。
登录智能媒体管理控制台。
左下角可切换新旧版本,点击可返回旧版。
在项目列表页面中,选择旧版项目所处的地域,如下图所示。
在项目列表页面中,选择需删除的旧版项目,然后点击删除按钮,如下图所示。
点击确定完成删除操作。
新旧版本媒体信息检测计费
新旧版本的计费项和计费模式一致。
媒体信息检测计费项
版本 | API | 计费 | 计费说明 |
版本 | API | 计费 | 计费说明 |
旧版媒体信息检测 | API版本为2017-09-06 | 新旧版本的计费项与计费模式相同。 | |
新版媒体信息检测 | API版本为2020-09-30 |
- 本页导读 (1)
- 背景信息
- 新版优势
- 新版与旧版API对应关系说明
- 如何迁移
- 步骤一 :创建新版项目
- 步骤二:调用新版媒体信息检测接口
- 步骤三:删除旧版项目
- 新旧版本媒体信息检测计费
- 媒体信息检测计费项