回调设置

前提条件

视频直播服务目前支持HTTP回调（兼容HTTPS）方式获取事件通知。您需要部署一个HTTP服务来接收回调消息，并在控制台或通过API配置回调地址。

• 当推流或断流事件产生时，直播服务端会向该地址发起HTTP GET请求，具体内容将通过URL参数送达。

• 当其他事件产生时，直播服务端会向该地址发起HTTP POST请求，具体内容将通过JSON Body送达。

使用场景

当直播过程中某些事件被触发时，阿里云将主动发送请求到客户服务器，客户服务器负责应答请求，验证通过后，您可接收到事件回调信息的JSON数据包。

视频直播支持回调直播推流状态、直播录制（按需录制）、直播截图、智能审核（视频审核、语音审核）事件的信息，不同回调事件对应的回调参数和示例详见回调管理。

使用限制

• 回调地址URL无需标识，只需可正常访问，URL的应答有如下要求：如果访问超时，会重试URL，目前超时时间是5秒，重试次数5次，重试间隔1秒。

• 推流回调只能在推流域名的回调事件中进行配置和编辑。录制回调、截图回调、视频审核回调、语音审核回调只能在对应播放域名的回调事件中进行配置和编辑。

功能介绍

事件回调分为推流回调与播流回调

• 推流回调，通过推流域名设置推流回调，回调鉴权。

• 播流回调，通过播流域名设置录制回调、截图回调、视频审核回调和语音审核回调。

• 回调记录，通过回调记录，快速查看直播录制至OSS回调事件的记录与回调内容，具体可参见回调记录。

操作指南

1. 登录视频直播控制台。

2. 在左侧导航栏单击功能管理>事件回调，进入事件回调页面。

3. 选择您要配置的推/播流域名，推流域名支持设置推流回调，播流域名支持设置录制回调、截图回调、视频审核回调和语音审核回调。

4. 在回调设置页签下，配置对应功能。

5. 推流域名

   推流回调

   说明

   您还可以通过SetLiveStreamsNotifyUrlConfig接口设置推流回调配置，请参见设置直播推流回调配置。回调方式和回调内容，请参见直播推流状态回调。

   1. 开启推流回调开关。

   2. 配置回调参数。

      参数	说明
      回调地址	回调地址为您自身拥有的地址，当推流或断流事件产生时，直播服务端会向该地址发起HTTP GET请求，具体内容将通过URL参数传递。
      回调鉴权	选择是否为推流回调地址开启鉴权。如需鉴权，打开鉴权开关，输入鉴权key。

   3. 单击确定。

   播流域名

   • 录制回调

     说明

     您还可以通过AddLiveRecordNotifyConfig接口添加域名级别录制回调配置，请参见添加直播录制回调配置。回调方式和回调内容，请参见直播录制回调。

     1. 开启录制回调开关。

     2. 配置回调参数。

        参数	说明
        回调地址	回调地址为您自身拥有的地址，当录制回调事件发生时，直播服务端会向该地址发起HTTP POST请求，具体内容将通过JSON Body送达。
        触发事件	文件生成回调：录制文件生成时产生回调。 文件生成回调+录制状态回调：录制文件生成、录制开始、暂停、继续录制事件均生成回调。
        按需回调地址	设置按需录制方式后，当开始推直播流时，直播录制服务会发送一条HTTP回调给事先设定的按需回调地址，通过该回调的返回内容决定是否录制这条直播流。按需回调地址默认* ，表示关闭按需录制功能。 说明 设置按需回调地址前，需调用接口添加录制配置配置录制规则。其中OnDemand字段设置为1，表示通过HTTP回调开启按需录制。

     3. 单击确定。

   • 截图回调

     说明

     您还可以通过AddLiveSnapshotNotifyConfig接口添加截图回调配置，请参见添加截图回调配置。回调方式和回调内容，请参见直播截图回调。

     1. 开启截图回调开关。

     2. 配置回调参数。

        参数	说明
        回调地址	回调地址为您自身拥有的地址，当截图回调事件发生时，直播服务端会向该地址发起HTTP POST请求，具体内容将通过JSON Body送达。
        回调鉴权	选择是否为推流回调地址开启鉴权。如需鉴权，打开鉴权开关，输入鉴权key。

   • 视频审核回调

     说明

     • 您还可以通过AddLiveDetectNotifyConfig接口添加视频审核回调配置，请参见添加直播审核回调配置。回调方式和回调内容，请参见智能审核回调。

     • 目前仅部分直播中心支持直播智能审核，具体支持该功能的直播中心，请参见服务地域。

     • 视频审核只会针对有问题的视频内容进行回调通知，通知内容包含问题视频截图的审核信息和存储信息。可在您的回调服务器中查看回调信息。回调信息的格式与示例，请参见智能审核回调。

     • 在OSS中查找识别的内容。您可以根据审核回调信息，在OSS控制台查找指定的审核内容。

       • 根据AppName与StreamName查找指定的审核内容。

       • 根据推流日期查找指定的审核内容。

     1. 开启视频审核回调开关。

     2. 配置回调地址。

        回调地址为您自身拥有的地址，当视频审核回调事件发生时，直播服务端会向该地址发起HTTP POST请求，具体内容将通过JSON Body送达。

     3. 单击确定。

   • 语音审核回调

     说明

     • 您还可以通过AddLiveAudioAuditNotifyConfig接口添加语音审核回调配置，请参见添加直播语音审核回调配置。回调方式和回调内容，请参见智能审核回调。

     • 语音审核只会对于有问题的音频内容进行回调通知，通知内容包含问题语音的文本信息以及最近一分钟内的上下文信息。可在您的回调服务器中查看回调信息。回调信息的格式与示例，请参见智能审核回调。

     • 在OSS中查找识别的内容。您可以根据审核回调信息，在OSS控制台查找指定的审核内容。

       • 根据AppName与StreamName查找指定的审核内容。

       • 根据推流日期查找指定的审核内容。

     1. 开启语音审核回调开关。

     2. 配置回调地址。

        回调地址为您自身拥有的地址，当语音审核回调事件发生时，直播服务端会向该地址发起HTTP POST请求，具体内容将通过JSON Body送达。

     3. 单击确定。

推流回调逻辑

回调鉴权