logo
实时音视频
服务端 API
场景服务接口
当前页

CloseRoom

GET

https://rtc-api.zego.im/

调用本接口将把房间内所有用户从房间移出,并关闭房间。

如果开发者已参考 回调配置说明,配置了 退出房间回调流关闭回调,服务端调用本接口时:

  • 服务端会收到 退出房间回调 通知,开发者可以了解用户退出房间的情况。
  • 原房间内的流的状态为关闭,服务端会收到 流关闭回调,开发者可以知悉有关房间内流关闭的信息。

房间关闭后,客户端用户会被踢出房间,会收到 ZEGO SDK 回调接口:

ZegoExpress SDKLiveRoom SDK
iOS/macOSonRoomStateChangedonKickout
AndroidonRoomStateChangedonKickout
WindowsonRoomStateChangedOnKickOut
WebroomStateChangedonKickout
调用频率限制
同一个 AppID 下所有房间:1 次/秒(测试环境:1 次/秒)

Request

Query Parameters

    Action stringrequired

    Possible values: [CloseRoom]

    接口原型参数

    https://rtc-api.zego.im?Action=CloseRoom

    AppId uint32required

    💡公共参数。AppId,ZEGO 分配的用户唯一凭证。

    SignatureNonce stringrequired

    💡公共参数。随机字符串。

    Timestamp int64required

    💡公共参数。Unix 时间戳,单位为秒。最多允许 10 分钟的误差。

    Signature stringrequired

    💡公共参数。签名,用于验证请求的合法性。

    SignatureVersion stringrequired

    Possible values: [2.0]

    Default value: 2.0

    💡公共参数。签名版本号。

    IsTest string

    Possible values: [true, false]

    Default value: false

    💡公共参数。是否为测试环境。设为 true 表示使用测试环境。2021-11-16 及之前在 ZEGO 控制台创建的项目默认是测试环境,可根据业务需求设置此参数;而之后创建的项目默认是正式环境。

    RoomId stringrequired

    房间 ID。

    CustomReason string

    关闭原因,最大长度为 256 字节。 使用时,需对其内容执行 URL 编码(UrlEncode)处理。

    RoomCloseCallback boolean

    是否产生 房间关闭回调。 由于通常是开发者主动发起的关闭行为,故不再另行通过 房间关闭回调 通知开发者。如果您需要通过 房间关闭回调 进行统一的逻辑处理,可自行修改为 true。

    📌 注意

    该参数只影响是否产生 房间关闭回调,其他原因导致房间关闭的回调通知(例如 退出房间回调)不受影响。

Responses

操作成功
Schema
    Code int32

    返回码。以下仅列出了接口业务逻辑相关的部分返回码,完整返回码请参考 全局返回码

    返回码说明处理建议
    5018房间已销毁或不存在。请确认请求房间 RoomId 是否存在。
    5024房间不存在,与 104、50001 内部判断逻辑相同。请确认请求房间 RoomId 是否存在。
    Message string

    操作结果描述。

    RequestId string

    请求 ID。


Request
Collapse all
Base URL
https://rtc-api.zego.im
统一接入地址(不区分区域)
Parameters
queryrequired
queryrequired
queryrequired
queryrequired
queryrequired
queryrequired
queryrequired
query
query
query
RESPONSEClear

Click the "Send" button above and see the response here!

Previous

获取简易流列表

Next

踢出房间用户

当前页

返回到顶部