文档中心
服务端 API
后台回调说明
流关闭回调说明

流关闭回调说明

更新时间：2023-09-15 17:42

1 使用场景

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

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

2 请求参数

HTTP 请求方式: POST/FORM 或 JSON（表单值需要 urldecode 解码）新接入的客户默认回调为 JSON 格式。
地址：客户可到 ZEGO 控制台进行自主配置。

参数名	类型	说明
stream_sid	String	流server ID, 流唯一标识，ZEGO后台生成，客户不用关注
type	String	关闭类型： 0：正常关闭（用户调用流关闭接口，后台调用流关闭接口）非0为异常关闭： 1：用户心跳超时关闭 2：用户重复登录同一个房间，关闭上次登录会话的流 3：服务端接口kickout用户，关闭用户创建的流 4：tcp掉线关闭流（可配置通知时间） 5：房间被清除关闭流
channel_id	String	频道ID 对应客户端RoomID 不超过127字节
stream_alias	String	流名对应客户端StreamID 不超过255字节
timestamp	String	服务器当前时间（Unix时间戳）
nonce	String	随机数
signature	String	检验串，详细见检验说明
appid	String	appid
event	String	事件名称：stream_close
stream_id	String	流id, 对应客户端StreamID,跟`stream_alias`的意义一样
stream_seq	String	服务器流列表变更的seq，每次流变更都会加1
room_id	String	房间id，对应客户端RoomID，跟`channel_id`的意义一样，不超过127字节
user_id	String	用户id，跟`publish_id`的意义一样，不超过255字节
user_name	String	用户昵称，跟`publish_name` 的意义一样，不超过255字节

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 服务器没有收到响应，会在 15 秒后发起重试，最多重试两次。

服务端API

流关闭回调说明

1 使用场景

2 请求参数

3 数据示例

4 返回响应

5 回调重试策略