模板创建
1. 进入媒体处理控制台, 依次单击模板管理 > 智能分析模板 > 创建智能分析模板。
2. 在创建内容分析模板界面填写模板名称,并开启精彩剪辑配置,单击创建。
任务处理
场景一:离线文件处理
1、零代码自动生成
1.1 创建编排
在任务配置中,选择添加智能分析节点。然后,在智能分析设置页面,单击选择模板。确定所需模板后,继续单击保存设置 > 创建,即可完成服务编排的创建。
1.2 启用编排
在点播服务编排管理列表中,选中刚创建好的编排,单击打开按钮即成功启动此服务编排。
1.3 触发任务
在成功启动编排后,请等待5分钟。然后,将需要获取集锦的源视频上传到刚才设置的触发位置对应的目录下,系统将自动启动集锦任务。
1.4 任务查询
1.5 结果视频
任务成功结束后,集锦的结果视频会存储在配置的输出位置中。
注意:
由于集锦存在一些特殊参数当前无法在模板中配置,可能会影响直接使用集锦的效果, 更推荐您使用 API 的方式调用。
2、API 接入
2.1 API Explorer 发起请求
调用 API 发起媒体文件处理任务可参考 发起媒体处理 文档。在文档中单击内容描述的 API Explorer 调试,进入页面填写相关参数信息后即可发起在线调用。其中 ExtendedParameter 为扩展参数,其值为序列化的 json 字符串,具体参数含义见 扩展参数 部分。
说明:
此参数为定制需求参数,需要线下对接。
例如填写如下:
{"hht":{"top_clip":10, "force_cls":5003, "need_vad":1, "threshold":0.9, "merge_time":60, "merge_type":0, "res_save_type":1}
2.2 使用 API 发起
直接向腾讯云发起 POST 请求, definition 为创建的视频内容分析模板 id,下面为请求的参考范例:
{"InputInfo": {"Type": "URL","UrlInputInfo": {"Url": "https://mg-aidata-1258344699.cos-internal.ap-guangzhou.tencentcos.cn/test/hht_test/MyStoryForYouEP39.mp4"}},"OutputStorage": {"Type": "COS","CosOutputStorage": {"Bucket": "mg-aidata-1258344699","Region": "ap-guangzhou"}},"OutputDir": "/test_data/","AiAnalysisTask": {"Definition": 47064,"ExtendedParameter": "{\\"hht\\":{\\"top_clip\\":10, \\"force_cls\\":5003, \\"need_vad\\":1, \\"threshold\\":0.9, \\"merge_time\\":60, \\"merge_type\\":0, \\"res_save_type\\":1}"}}
场景二:直播流
1、发起请求
1.1 通过 API Explorer 发起请求
{"hht":{"top_clip":10, "force_cls":5003, "need_vad":1, "res_save_type":1}
1.2 通过 API 发起
直接向腾讯云发起 POST 请求, definition 为创建的视频内容分析模板 id,下面为请求的参考范例:
{"Url": "https://mg-aidata-1258344699.cos-internal.ap-guangzhou.tencentcos.cn/material/news/cctv/20180512_CCTV-TBO65hNxKFQ.mp4","TaskNotifyConfig": {"NotifyType": "URL","NotifyUrl": "http://test.cloud.com/callback"},"OutputStorage": {"Type": "COS","CosOutputStorage": {"Bucket": "mg-aidata-1258344699","Region": "ap-guangzhou"}},"OutputDir": "/output/","AiAnalysisTask": {"Definition": 47064,"ExtendedParameter": "{\\"hht\\":{\\"top_clip\\":10, \\"force_cls\\":5003, \\"need_vad\\":1, \\"threshold\\":0.9, \\"merge_time\\":60, \\"merge_type\\":0, \\"res_save_type\\":1}"}}
2、接收回调
3、任务终止协议
扩展参数说明
参数 | 是否必填 | 类型 | 说明 |
force_cls | No | int | 指定集锦类别: 5003:综艺/影视 4001:足球 4002:篮球 1001:王者荣耀 100101:王者荣耀竞赛 1003:英雄联盟 |
need_vad | No | int | vad 用于判断视频一句话结尾,vad 扩展能够让视频语音完整,默认开启 1:使用 vad 0:不使用 |
threshold | No | float | 置信度阈值,低于阈值的片段都过滤掉,每种类型的集锦都会有默认阈值设置 备注:建议客户初次使用时不设置 |
res_save_type | No | int | 是否存储结果,默认存储 1:存储结果 0:只输出时间段 |
output_pattern | No | string | 输出视频命名格式,{}表示占位符 {year}-{month}-{day}-{hour}-{minute}-{second}_{start_dts}-{end_dts}-{timestamp}.mp4 |
image_pattern | No | string | image-{start_dts}.jpg 可以占位的参数同上 |
merge_type | No | int | 注意:仅离线场景可用 是否合并结果为一个视频: 1:合并(top_clip 参数不生效) 0:不合并(merge_time 参数不生效) |
merge_time | No | int | 注意:仅离线场景可用 合并成一个视频时,指定视频输出长度 |