作用

当发生以下事件导致观众状态变化时，企业直播会对所设置的接口地址进行回调通知。

• 观众进入直播间
• 观众离开直播间
• 观众开始观看预告
• 观众停止观看预告
• 观众开始观看直播
• 观众停止观看直播
• 观众开始观看回放
• 观众停止观看回放

例如，直播状态从直播中变为回放，则会分别触发观众停止观看直播事件和观众开始观看回放事件的 2 次回调。
如需触发观众开始观看预告事件或观众结束观看预告事件的回调，请确保预告状态期间有预告片正在播放。例如，直播状态从预告变为直播中，但预告状态期间并未播放预告片，则仅会触发观众开始观看直播事件的 1 次回调。

配置方式

将接收回调通知的接口地址提供给企业直播技术支持。

详情

设置回调的接口地址后，当发生特定事件导致观众状态变化时，企业直播会将具体的事件、事件发生时间、观众的用户 ID 和观众的设备类型等信息以 POST 方式提交给您自定义的回调接口地址。
请求示例如下所示：

POST /xxxxx HTTP/1.1
Header1: ...
Header2: ...
...
{
     "ActivityID": "17211234",
     "EventType": "ActivityUserEnterCallBack",
     "EnterTimestamp": "1721099280120",
     "UserID": "123987123",
     "ExternalUserID": "81239871232",
     "Timestamp": "1721099426120",
     "Sign": "b96c2ac3d6aed7557a8bec33****",
     "Status": "1",
     "UserDevice": "android"
}

超时重试

回调服务器在发送消息通知后，5 秒内没有收到您的服务器的响应，即认为通知失败。后续会以 5 秒为间隔继续重试 2 次。

参数