流关闭回调说明

下载pdf
更新时间:2019-12-17 18:11

1 使用场景

若业务方有维护直播列表的需求。

当APP在流媒体服务器有流关闭时,将会以 POST 的形式对回调地址进行请求。

2 请求参数

http请求方式: POST/FORM或JSON(表单值需要urldecode解码)新接入的客户默认回调为JSON格式。
地址: 客户提供的回调地址给技术支持,技术支持后台配置。

参数名 类型 说明
stream_sid String 流server ID, 流唯一标识,zego后台生成,客户不用关注
type Int 关闭类型 0为正常关闭,非0为异常关闭(1为后台超时关闭,2为同一主播直播关闭之前
没有关闭的流,3为重复登录kickout关闭之前用户创建的流,4为tcp掉线关闭流(可配置通知时间), 5为房间被清除关闭流)
channel_id String 频道ID 对应客户端RoomID 不超过255字节
stream_alias String 流名 对应客户端StreamID 不超过255字节
timestamp String 服务器当前时间 Uinx时间戳
nonce String 随机数
signature String 检验串,详细见检验说明
appid String appid
event String 事件名称:stream_close

应答为1表示成功,其余都为失败。

3 数据示例

    Array
    (
        [stream_sid] => s-115205137699740000000000104
        [channel_id] => 0xb-0x1
        [type] => 0
        [stream_alias] => aaaa
        [timestamp] => 1481597358
        [nonce] => 158273
        [signature] => signature
        [appid] => 1
        [event] => stream_close
    )

4 返回响应

1

5 回调重试策略

若请求回调地址失败,ZEGO服务器会在5秒后发起一次重试,重试仍然失败后,将不再继续重试。