logo
实时音视频
服务端 API
当前页

房间创建回调


描述

当开发者需要了解某个房间创建的相关信息时,可以通过本回调获取。

回调说明

  • 请求方法:POST。
说明

回调数据格式为 JSON,您需要对其进行 UrlDecode 解码。

  • 请求地址:请在 ZEGO 控制台 上配置回调地址。
  • 传输协议:HTTPS/HTTP,建议使用 HTTPS。

回调参数

公共参数类型描述
eventString回调事件,此回调返回值为 room_create
appidUInt32APP 的唯一标识。
timestampInt64服务器当前时间,Unix 时间戳,单位:秒。
nonceString随机数。
signatureString检验串,详情见 检验说明
业务参数类型描述
room_idString房间 ID。
room_session_idUInt64

房间生命周期唯一标识,在该房间的整个生命周期中保持不变。
房间创建后,会生成唯一的 room_session_id;如果房间被销毁后,再用相同的 room_id 创建一个新的房间,会生成新的唯一的 room_session_id。

该参数与 登录房间回调退出房间回调 中的参数 room_seq 一致。

room_create_timeString房间创建时间,服务器当前时间,Unix 时间戳,单位:毫秒。
id_nameString房间创建者的用户 ID。
说明

建议您将部分参数转换为 Int 进行逻辑处理,相关字段包括 room_create_time

数据示例

{
    "event": "room_create",
    "appid": 1,
    "timestamp": 1499676978,
    "nonce": "350176",
    "signature": "signature",
    "room_id": "rid_1242649",
    "room_session_id": 858012925204410400,
    "room_create_time": "1499676978027",
    "id_name": "id123"
}

返回响应

返回 HTTP status code 为 2XX (例如 200)表示成功,其他响应都表示失败。

回调重试策略

如果 ZEGO 服务器没有收到响应,或收到的 HTTP status code 不为 2XX(例如 200),都会尝试重试,最多进行 5 次重试。每次重试请求与上一次请求的间隔时间分别为 2s、4s、8s、16s、32s。若第 5 次重试后仍然失败,将不再重试,该回调丢失。

Previous

回调配置说明

Next

房间关闭回调