加入群组管理
本文档旨在指导开发者如何使用融云即时通讯 Web IMLib SDK 实现主动加入群组、邀请用户加入群组、 用户同意或拒绝加入群组、 管理员同意或拒绝加群申请等功能。
提示
此功能从 5.12.0 版本开始支持。
开通服务
使用此功能前,您须在控制台开通信息托管服务。
用户申请或邀请事件及结果回调
用户加入群组可以通过用户主动调用 joinGroup
接口申请加入群组,或者群内成员调用 inviteUsersToGroup
邀请用户加入群组。产生的申请或邀请事件及结果可通过 Events.GROUP_APPLICATION_EVENT
接收,返回数据类型为 IGroupApplicationInfo。
RongIMLib.addEventListener(Events.GROUP_APPLICATION_EVENT, (data) => {
console.log('用户申请或邀请事件及结果回调', data);
});
加入群组管理
加入群组管理包含:主动加入群组、邀请加入群组、 用户同意或拒绝加入群组、 管理员同意或拒绝加群申请等功能。
主动加入群组
您可以调用 joinGroup
方法主动加入一个群组。
提示
此接口的成功结果受群组的 joinPermission 权限影响,有以下两种情况:
-
群组的加入权限为 需要群主审批或需要群主/管理员审批 时,接口调用成功后
processCode
会返回 25424 ,表示需要等待群主或管理员的审批 。同时当前操作用户和群主或管理员会都会收到Events.GROUP_APPLICATION_EVENT
事件回调。 -
群组的加入权限为 无需审批 时,接口调用成功后
processCode
会返回 0,表示加入群组成功。同时当前操作用户和群内所有人会收到Events.GROUP_OPERATION
事件回调,事件返回数据中operation
操作类型值为 1,对应枚举GroupOperation.JOIN
。 -
群组的加入权限为 不允许任何人加入 时,无法通过
joinGroup
接口加入群组。
// 必填,最大长度 64 个字符。支持大小写英文字母与数字的组合
const groupId = 'group001';
const res = await RongIMLib.joinGroup(groupId);
console.info('加入群组结果', res);