全部产品
Search
文档中心

视频直播:配置推流回调地址

更新时间:Jul 30, 2024

视频直播支持配置推流回调地址、对推流回调地址鉴权,避免越权造成直播异常。本文介绍配置推流回调地址及其鉴权的具体操作。

推流回调地址

如果您需要接收推流相关的回调消息,请参考以下步骤配置推流回调地址及回调鉴权:

说明

关于回调逻辑和回调鉴权说明,请参考回调逻辑说明回调鉴权说明

  1. 登录视频直播控制台
  2. 在左侧导航栏单击推/播流域名管理,进入域名管理页面。

  3. 选择您要配置的推流域名,单击域名配置

  4. 进入直播管理 > 基本配置页面,单击推流信息页签。

  5. 单击推流回调地址的编辑图标,打开回调设置小窗口。

    回调地址中文

  6. 回调设置小窗口完成推流回调地址配置。

    1. 输入推流回调地址。

    2. 选择是否为推流回调地址开启鉴权。

      如需鉴权,打开鉴权开关,输入鉴权KEY,再单击确定完成配置。推流回调健全KEY

      如无需鉴权,直接单击确定完成配置。

      推流回调鉴权NO

回调逻辑说明

直播推流状态回调中开播(publish)状态回调逻辑

  1. RTMP推流在阿里云直播服务收到On Publish消息后2秒内,如果推流端不主动断开,阿里云直播服务就会发推流成功回调。

  2. 假设您有推流域名A和播流域名B,如果您的域名B使用拉流直播(固定拉流和触发回源拉流)需要回调,请在域名A配置推流回调。配置后域名B的拉流回调逻辑与上一条一致,建联后默认2秒无主动断开即认为拉流成功。

说明

建议业务方不仅根据回调通知判断推流、拉流接入正常,同时配合查询域名在线流列表接口查询推流正常后,再下发直播流播放地址。

回调鉴权说明

推流回调鉴权功能默认关闭,用户可在配置推流回调地址时启用鉴权。启用功能后,鉴权逻辑如下:

  1. 阿里云视频直播发起回调请求时在HTTP(S)请求头中带上ALI-LIVE-TIMESTAMPALI-LIVE-SIGNATURE 字段,供回调消息接收服务端进行签名认证。其中,ALI-LIVE-SIGNATURE的值由如下计算而得:

    ALI-LIVE-SIGNATURE=MD5SUM(MD5CONTENT)

    MD5CONTENT=推流域名|ALI-LIVE-TIMESTAMP取值|鉴权KEY

    说明

    回调域名指配置回调URL的推流域名。鉴权Key指用户为推流回调URL配置的鉴权Key。

  2. 回调消息接收服务端接收回调消息时,将回调域名、ALI-LIVE-TIMESTAMP取值、鉴权Key进行拼接后计算MD5值,得到加密字符串,再将计算出的加密字符串与视频直播发起的HTTP(S)请求头中的ALI-LIVE-SIGNATURE字段值进行对比。如果不一致,则请求非法。