媒体处理高光集锦能力接入-实践教程-文档中心-腾讯云

模板创建
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 发起请求
调用 API 发起直播流处理任务可参见 对直播流发起处理 文档。在文档中单击内容描述的 API Explorer 调试，进入页面填写相关参数信息后即可发起在线调用。
其中 OutputStorage 可以参考离线场景填写， ExtendedParameter 举例如下，具体参数含义见扩展参数 部分：
 {"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、接收回调
参见 解析直播流处理结果 文档，解析 AiAnalysisResultInfo 字段。
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
注意：仅离线场景可用
合并成一个视频时，指定视频输出长度

参数	是否必填	类型	说明
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	注意：仅离线场景可用合并成一个视频时，指定视频输出长度

高光集锦能力接入

本页目录：

模板创建

任务处理

场景一：离线文件处理

1、零代码自动生成

2、API 接入

场景二：直播流

1、发起请求

2、接收回调

3、任务终止协议

扩展参数说明