logo
即时通讯
当前页

创建房间


描述

凭借本回调,您可以实时监听用户创建房间的行为,查看用户创建的房间的信息

回调说明

  • 请求方法:POST。
    说明

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

  • 请求地址:请在 ZEGO 控制台 上配置回调地址,配置流程请参考控制台文档 ZIM 相关回调配置
  • 传输协议:HTTPS/HTTP,建议使用 HTTPS。

回调参数

公共参数类型说明
appidStringApp 的唯一标识。
eventString回调事件,此回调返回值为 room_create
timestampInt创建房间的时间,以服务器当前时间记录,Unix 时间戳,单位为秒(s)。
nonceString随机数,用于计算 signature。
signatureString检验串,详情见 检验说明
业务参数类型说明
room_idString房间 ID。
operator_accountString房间创建操作者的用户 ID。
room_nameString房间名称。
attributesArray of Object创建房间时设置的属性。
└ keyString属性 Key。
└ valueString属性 Value。
└ auto_deleteIntoperator_account 退出房间时,此属性是否会被自动删除。
  • 0:(默认)否。
  • 1:是。
    说明
    如果 operator_account 并未在房间内,则在其进入房间后退出时,此参数会被自动删除。
说明

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

数据示例

Untitled
{
    "appid" : "1",
    "event" : "room_create",
    "room_id" : "1",
    "nonce": "350176",
    "signature": "signature",
    "operator_account" : "userA",
    "room_name" : "room_name",
    "attributes" : [
        {
            "key" : "UserSet1",
            "value" : "UserGet1",
            "auto_delete" : 0
        }
        {
            "key" : "UserSet2",
            "value" : "UserGet2",
            "auto_delete" : 0
        }
    ]
    "timestamp" : 1499676978
}
1
Copied!

返回响应

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

回调重试策略

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

Previous

登录登出

Next

加入房间