服务端 API v2
  • API概览
  • 快速开始
  • 调用方式
  • 房间信令接口
  • 混流接口
  • 媒体服务接口
  • 媒体文件接口
  • 音视频流审核接口
  • 回调说明
  • 全局返回码
  • 使用 Postman 调试

踢出房间用户

更新时间:2022-06-10 14:25

1 描述

调用本接口踢出房间内的指定用户,该用户当前的推流和拉流会全部停止。多用于内容审核场景下,开发者后台发现某个用户的直播内容违规时,可通过本接口将该用户踢出房间。

客户端被踢的用户会收到 ZEGO SDK 回调接口:

ZegoExpress SDK LiveRoom SDK
iOS/macOS onRoomStateUpdate onKickOut
Android onRoomStateUpdate onKickOut
Windows onRoomStateUpdate OnKickOut
Web/小程序 roomStateUpdate onKickOut

客户端接收房间内用户变更的通知使用 ZEGO SDK 回调接口:

ZegoExpress SDK LiveRoom SDK
iOS/macOS onRoomUserUpdate onUserUpdate
Android onRoomUserUpdate onUserUpdate
Windows onRoomUserUpdate OnUserUpdate
Web/小程序 roomUserUpdate onUserStateUpdate

2 接口原型

  • 请求方法:GET
  • 请求地址:https://rtc-api.zego.im/?Action=KickoutUser
  • 传输协议:HTTPS
  • 调用频率限制(同一个 AppID 下所有房间):50 次/秒

3 请求参数

以下请求参数列表仅列出了接口请求参数和部分公共参数,完整公共参数列表请参考 调用方式 - 公共请求参数

参数 类型 是否必选 描述
RoomId
String
房间 ID。
UserId[]
Array of String
踢出房间的用户 ID 列表,最大支持 5 个用户 ID。
示例:UserId[]=a&UserId[]=b
CustomReason
String
踢人原因。

使用时,请对该参数内容进行 UrlEncode。

4 请求示例

https://rtc-api.zego.im/?Action=KickoutUser
&RoomId=123
&UserId[]=a&UserId[]=b
&CustomReason=%E8%B8%A2%E5%87%BA%E7%94%A8%E6%88%B7-%E5%8E%9F%E5%9B%A0
&<公共请求参数>

5 响应参数

参数 类型 描述
Code
Number
返回码。
Message
String
操作结果描述。
RequestId
String
请求 ID。

6 响应示例

{
    "Code":0,
    "Message":"success",
    "RequestId":"343649807833778782"
}

7 返回码

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

返回码 说明 处理建议
104 房间不存在,与 5024、50001 内部判断逻辑相同。 请确认请求房间 RoomId 是否存在。
206 App 请求 QPS 过高被限制。 降低请求频率,或联系 ZEGO 技术支持提高 QPS 限制阈值。
5018 房间状态不一致。 请稍后重试。
5024 房间不存在,与 104、50001 内部判断逻辑相同。 请确认请求房间 RoomId 是否存在。
50001 房间不存在,与 104、5024 内部判断逻辑相同。
  • 当房间内没有用户时,房间会被服务端自动销毁。
  • 当房间内只有一个用户时,该用户退出房间或被踢出房间,房间会被服务端自动销毁。
  • 当用户心跳请求超时 100 秒后,用户会掉线;所有用户都不在房间后,房间会被服务端自动销毁。
请确认请求房间 RoomId 是否存在。
50002 用户账号不存在。 请确认请求用户 UserId 是否在线。
50003 查找用户在线信息失败。 请确认请求用户 UserId 是否在线。
50004 读取用户信息失败。 请确认请求用户 UserId 是否在线。
50009 审核失败。 请稍后重试,或 ZEGO 联系技术支持。
50011 推送自定义消息目的用户个数超过限制。 请检查请求包中的用户个数是否超过限制。
50012 推送自定义消息长度超过限制。 请检查消息长度是否超过限制。
50013 发送自定义消息失败。 请联系 ZEGO 技术支持处理。