流状态事件通知

最近更新时间:2025-11-21 07:44:44

流状态回调用于推送流上线和下线状态信息。您需在回调模板中配置流状态回调接收服务器URL,并将该模板与业务组或设备进行关联。视频流上线后,天翼云视频监控服务会将视频流上线状态回调到您设置的接收服务器中。

1. 回调消息参数

参数类型描述
EventTypeLong流状态事件类型。
取值:2。
ExpiresLong回调消息的失效时间点,1970 年 1 月 1 日以来的秒数。
说明:来自天翼云的消息通知默认过期时间是10分钟,如果一条消息通知中的Expires值所指定的时间已经过期,则可以判定这条通知无效,进而可以防止网络重放攻击。
SignatureString回调消息的安全签名,Signature=MD5(CallbackKey+Expires)
说明:天翼云把CallbackKey和Expires进行字符串拼接后通过MD5计算得出Signature值,并将其放在回调消息里,您的后台服务器在收到通知消息后可以根据同样的算法确认Signature是否正确,进而确认消息是否确实来自天翼云后台。
DeviceIdString设备ID。
StreamStatusString流状态。
取值:on(在线), off(离线)。
EventTimeLong事件消息产生的时间戳,单位秒。

2. 回调消息错误码

ErrorCodeErrorMessage

3. 回调消息示例

{
  "EventType": 2,
  "Expires": 1545030873,
  "Signature": "ca3e25e5dc17a6f9909a9ae7281e300d",
  "DeviceId": "29942114322219022",
  "StreamStatus": "on",
  "EventTime": 1545047000
}