配置录制回调

前提条件

• 已添加推流域名。
• 已在域名DNS服务商处完成CNAME解析配置。

操作步骤

1. 登录视频直播控制台。
2. 在左侧导航栏中，选择“域名管理”，进入域名管理页面。
3. 在需要创建录制回调的推流域名行，单击“管理”。
4. 在左侧导航树中，选择“模板配置 > 录制配置（新版）”，进入录制配置页面。
5. 单击“新建回调配置”，弹出“添加回调配置”对话框。
   设置回调地址，如图1所示，回调参数说明请参见表1。

   图1 添加录制回调URL
   

   表1 录制回调参数说明

   参数	说明
   回调地址	回调地址中不能携带消息头和参数，仅支持HTTP/HTTPS协议。推荐使用HTTPS协议。
   回调类型	回调消息的类型，包含如下分类： 录制文件生成完成 录制开始 创建新的录制文件 录制结束 录制失败 各回调类型的详细说明请参见表2。
   鉴权方式	回调消息中的加密内容会根据选择的不同鉴权方式而有所不同。MD5方式可能存在安全风险，推荐使用HMACSHA256方式。 MD5方式：MD5(key + auth_timestamp) HMACSHA256方式：HMACSHA256(auth_timestamp + event_type + publish_domain + app + stream + download_url + play_url，key)
   鉴权密钥	鉴权key值。支持自定义设置，由32位的字母和数字组成。

修改/删除录制回调配置

录制回调配置完成后，您还可以根据实际需要进行如下操作。

• 修改录制回调配置

  录制回调配置完成后，若您需要修改部分参数，可以在录制模板回调配置列表中，单击操作列的“修改”，修改录制回调配置中的相关参数。

• 删除录制回调配置

  录制回调配置完成后，若您需要删除录制回调配置，可以在录制回调配置列表中，单击操作列的“删除”，删除该录制回调配置。

回调示例

录制文件生成事件回调示例如下。回调消息体字段如表2所示。

{
    "project_id": "70b76xxxxxx34253880af501cdxxxxxx",
    "job_id": "dc0a1773-0cef-xxxx-xxxx-9a38fdb095d2",
    "task_id": "51126d0ebe94b1da00d2e21a10xxxxxx",
    "event_type": "RECORD_FILE_COMPLETE",
    "publish_domain": "push.example.com",
    "app": "live",
    "stream": "mystream",
    "record_format": "HLS",
    "download_url": "https://obs.cn-north-4.myhuaweicloud.com/live/record-xxxx-mystream-1589967495/record-push.example.com-live-mystream-1589967495.m3u8",
    "asset_id": "1a0d8e9bfaexxxxxxbe5021e62aa1e96",
    "file_size": 3957964,
    "record_duration": 120,
    "start_time": "2020-03-08T14:10:25Z",
    "end_time": "2020-03-08T14:12:25Z",
    "width": 1280,
    "height": 720,
    "obs_location": "https://obs.cn-north-4.myhuaweicloud.com",
    "obs_bucket": "mybucket",
    "obs_object": "live/record-xxxx-mystream-1589967495/record-hwpublish.myun.tv-live-mystream-1589967495.m3u8",
    "auth_sign": "4f97f46759axxxxxx7ad21e9935dc175",
    "auth_timestamp": 1583676745
}