跳到主要内容

推出聊天室

退出聊天室支持以下几种情况：

  • 被动退出聊天室：聊天室具有离线成员自动踢出机制。该机制被触发时，融云服务端会将用户踢出聊天室。用户如被封禁，也会被踢出聊天室。
  • 主动退出聊天室：客户端提供 API，支持由用户主动退出聊天室。

聊天室离线成员自动退出机制​

聊天室具有离线成员自动退出机制。用户离线后，如满足以下默认预设条件，融云服务端会自动将该用户踢出聊天室：

  • 从用户离线开始 30 秒内，聊天室中产生第 31 条消息时，触发自动踢出。
  • 或用户已离线 30 秒后，聊天室有新消息产生时，触发自动踢出。
提示
  • 默认预设条件均要求聊天室中必须要有新消息产生，否则无法触发踢出动作。如果聊天室中没有消息产生，则无法将异常用户踢出聊天室。
  • 如需修改默认行为对新消息的依赖，请提交工单申请开通聊天室成员异常掉线实时踢出。开通该服务后，服务端会通过 SDK 行为判断用户是否处于异常状态，最迟 5 分钟可以将异常用户踢出聊天室。
  • 如需保护特定用户，即不自动踢出指定用户（如某些应用场景下可能希望用户驻留聊天室），可使用 Server API 提供的聊天室用户白名单功能。

主动退出聊天室​

客户端用户可主动退出聊天室。

方法​

leaveChatRoom(targetId: string): Promise<number>;

参数说明​

参数类型说明
targetIdstring会话 ID

返回值​

返回值描述
Promise<number>当次接口操作状态码，并不代表最终操作结果，状态码详细信息

代码示例​

engine.leaveChatRoom(targetId);
.then((code: number) => {});

回调方法​

  • setOnChatRoomLeftListener
setOnChatRoomLeftListener(listener?: (targetId: string) => void): void;

参数说明

参数类型说明
targetIdString会话 ID

代码示例

engine.setOnChatRoomLeftListener(
  (
    argetId： string
  ) => {}
);