开发者指南
视频内容分析
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 API。
图片内容分析
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)函数。
图片摘要分析
图片摘要接口正在邀测阶段，如有需求，请与我们联系
MCA 图片摘要分析接口只支持BOS与HTTP(s)协议类型的资源，针对这两种类型的source拼接规则如下：
- 对于 BOS 视频，
source=bos://{bucket}/{object} - 对于 HTTP(S) URL 视频，
source="<http(s)-url">
提交图片摘要分析
指定图片路径发起图片分析。（提交图片摘要分析接口每个账号只支持1QPS）
分析 BOS 图片
代码示例：
示例一：分析 BOS 图片
source = "bos://YourBucket/YourObject"
response = vca_client.put_image_abstract(source);分析 HTTP(S) URL 图片
根据URL直接发起分析。
代码示例：
示例一： URL 图片
source = "http(s)://url"
response = vca_client.put_image_abstract(source);说明：
目前不支持分析包含鉴权参数的 URL 图片。
目前提供的图片摘要分析接口是同步接口，请求后直接返回分析结果，无需后续查询分析结果，参考
analyzeImageAbstract(AnalyzeRequest)函数。