开发者指南
媒资分析
MCA 支持对BOS音/视频、VOD音/视频分析。对于不同来源的媒资,需要按照如下规则拼接路径source
:
- 对于 BOS 媒资,
source=bos://{bucket}/{object}
- 对于 VOD 媒资,
source=vod://{mediaId}
- 对于 HTTP(S) URL 媒资,
source="<http(s)-url">
提交媒资分析
指定视频、音频路径发起分析。
分析 BOS 媒资
根据BOS bucket和BOS key直接发起分析。需要说明,使用本方法需要将object配置公共GetObject权限,参考设置BOS bucket权限。简述为:在BOS 的控制台中 Bucket 设置-权限设置-自定义权限中添加 MCA 服务账号: 876d365b2f35424898b7ec8630593a50。
MCA 也支持BOS回源,只要在BOS配置了正确的回源地址,参考设置BOS镜像回源,MCA 可以帮助回源并完成分析。
代码示例:
source = "bos://YourBucket/YourObject"
preset = "YourPreset"
notification = "YourNotification"
response = vca_client.put_media(source, preset, notification);
参数意义参见视频分析接口。
分析 VOD 媒资
根据 VOD 媒资ID直接发起分析。
代码示例:
source = "vod://vod-mediaId"
preset = "YourPreset"
notification = "YourNotification"
response = vca_client.put_media(source, preset, notification);
说明:
提交媒资分析时可以配置分析模板和通知名称。
分析 HTTP(S) URL 媒资
根据 URL 直接发起分析。
代码示例:
source = "http(s)://url"
preset = "YourPreset"
notification = "YourNotification"
response = vca_client.put_media(source, preset, notification);
说明:
提交媒资分析时可以配置分析模板和通知名称。
查询媒资分析结果
指定媒资路径查询媒资的分析结果,查询结果前记得先调用上面的分析接口发起分析。
代码示例:
source = 'vod://vod-mediaId'
response = vca_client.get_media(source)
媒资分析结果格式和各字段含义参考MCA API。
查询媒资中间结果
指定媒资路径查询媒资的分析结果,查询结果前记得先调用上面的媒资分析结果查询接口确认分析成功。
视频的分析过程,会涉及很多中间任务的执行。发起视频分析时选用的分析模板定义了需要执行的中间任务集合,根据视频路径查询指定类型的中间任务分析结果。
代码示例:
source = 'vod://vod-mediaId'
subtask_type = 'character'
response = vca_client.get_sub_task(source,subtask_type)
参数意义参见视频分析接口中的查询视频分析中间任务结果小节。
图片分析
MCA 针对图片资源单独提供了同步分析接口。图片分析接口只支持BOS与HTTP(s)协议类型的资源,针对这两种类型的source
拼接规则如下:
- 对于 BOS 视频,
source=bos://{bucket}/{object}
- 对于 HTTP(S) URL 视频,
source="<http(s)-url">
说明:
注意:虽然视频分析支持图片类型资源,但图片分析提供更具针对性和准确的分析。建议图片类型的资源直接采用图片分析接口。
提交图片分析
指定图片路径发起图片分析。如果使用定制图片分析模板,先由 MCA 研发人员在后台帮用户创建好图片分析模板,然后创建视频时在请求参数或请求体中配置模板名称即可。
分析 BOS 图片
代码示例:
示例一:使用默认模板分析 BOS 图片
source = "bos://YourBucket/YourObject"
response = vca_client.put_image(source);
示例二:使用定制模板分析 BOS 图片
source = "bos://YourBucket/YourObject"
preset = "YourPreset"
response = vca_client.put_image(source, preset);
分析 HTTP(S) URL 图片
根据URL直接发起分析。
代码示例:
示例一:使用默认模板分析 URL 图片
source = "http(s)://url"
response = vca_client.put_image(source);
示例二:使用定制模板分析 URL 图片
source = "http(s)://url"
preset = "YourPreset"
response = vca_client.put_image(source, preset);
说明:
图片分析与视频分析使用两种不同类型的模版,在指定模版名时注意是否存在该图片分析模版。
目前不支持分析包含鉴权参数的 URL 图片。
目前提供的图片分析接口是同步接口,请求后直接返回分析结果,无需后续查询分析结果,参考
analyzeImage(AnalyzeRequest)
函数。