文档首页 > > 用户指南> 推流配置> 直播录制至OBS(新版)> 配置录制回调

配置录制回调

分享
更新时间: 2020/08/03 GMT+08:00

直播服务提供了录制文件生成状态回调设置,支持配置HTTP/HTTPS URL,向用户服务器发送POST请求、消息体JSON格式,将文件生成事件信息实时反馈给用户。

操作步骤

  1. 登录视频直播控制台
  2. 在左侧导航树中选择域名管理,进入域名管理页面。
  3. 在需要创建录制回调的推流域名行单击“管理”
  4. 在左侧导航树中选择“模板配置 > 录制配置”,进入录制配置页面。
  5. 单击“添加”设置回调地址,如图1所示。

    设置的回调地址中不能携带消息头和参数。

    图1 添加录制回调URL

回调示例

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

{
  "project_id" : "70b76xxxxxx34253880af501cdxxxxxx",
  "publish_domain" : "push.example.com",
  "event_type" : "RECORD_FILE_COMPLETE",
  "app" : "live",
  "stream" : "mystream",
  "record_format" : "HLS",
  "download_url" : "https://mydomain.com/live/record-xxxx-mystream-1589967495/record-push.example.com-live-mystream-1589967495.m3u8",
  "asset_id" : "1a0d8e9bfae388ccbbe5021e62aa1e96",
  "play_url" : "https://2-cn-north-4.cdn-vod.huaweicloud.com/asset/1a0d8e9bfae388cxxxxxx21e62aa1e96/55c634374750cexxxxxxc035a26ecfac.m3u8",
  "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.myhwclouds.com",
  "obs_bucket" : "mybucket",
  "obs_object" : "live/record-xxxx-mystream-1589967495/record-hwpublish.myun.tv-live-mystream-1589967495.m3u8"
}
表1 消息体字段说明

字段

说明

project_id

项目ID。

publish_domain

直播推流域名。

event_type

消息类型。

取值如下:

  • RECORD_START:表示录制开始。若配置了录制模板和录制回调,则直播推流开始时,开始录制,触发该事件。
  • RECORD_NEW_FILE_START:表示开始创建新的录制文件。以下情况会触发该事件:
    • 直播推流开始,开始创建第一个录制文件。
    • 直播断流恢复后,若“最大断流合并时长”配置为“断流后生成新文件”,则开始创建新的录制文件。
    • 当前录制时长超过了配置的录制周期,则开始新的录制文件生成。
  • RECORD_FILE_COMPLETE:表示录制文件生成完成。以下情况会触发该事件:
    • 录制时长达到配置的录制周期,则当前录制文件生成完成,并开始新的录制生成。
    • 直播断流后,若“最大断流合并时长”配置为“断流后生成新文件”,则当前录制文件生成完成,若断流恢复,将开始新的录制文件生成。
  • RECORD_OVER:表示录制结束,直播断流时长超过了最大断流合并时长,当前录制任务结束,触发该事件。
  • RECORD_FAILED:表示录制失败,当拉流失败、录制文件上传OBS失败等因素导致录制失败时,触发该事件。

app

应用名。

stream

录制的流名。

record_format

录制格式,支持HLS、FLV和MP4格式。

download_url

录制文件的下载地址。当“event_type”“RECORD_FILE_COMPLETE”时,携带该字段。

说明:

该下载地址禁止用于视频播放。请使用“play_url”播放。

asset_id

媒资ID。若配置直播录制时,将存储录制文件的OBS桶授权给点播服务,则为点播的媒资ID。当“event_type”“RECORD_FILE_COMPLETE”时,携带该字段。

play_url

录制文件播放地址,可以直接播放。当配置直播录制时,将存储录制文件的OBS桶授权给点播服务,且仅“event_type”“RECORD_FILE_COMPLETE”时,携带该字段。

file_size

文件大小。

单位:Byte。

record_duration

录制文件的时长。

单位:秒。

start_time

录制文件的开始时间,格式为yyyy-mm-ddThh:mm:ssZ。

“event_type”“RECORD_FILE_COMPLETE”时,携带该字段。

end_time

录制文件的结束时间,格式为yyyy-mm-ddThh:mm:ssZ。

“event_type”“RECORD_FILE_COMPLETE”时,携带该字段。

width

录制文件分辨率的宽。

“event_type”“RECORD_FILE_COMPLETE”时,携带该字段。

height

录制文件分辨率的高。

“event_type”“RECORD_FILE_COMPLETE”时,携带该字段。

obs_location

存储录制文件的OBS桶所在区域。

“event_type”“RECORD_FILE_COMPLETE”时,携带该字段。

obs_bucket

存储录制文件的OBS桶。

“event_type”“RECORD_FILE_COMPLETE”时,携带该字段。

obs_object

OBS桶存储录制文件的路径。

“event_type”“RECORD_FILE_COMPLETE”时,携带该字段。

error_message

录制失败的描述信息。

“event_type”“RECORD_FAILED”时,携带该字段。

分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

智能客服提问云社区提问