加入群组管理
本文档指导您如何使用融云即时通讯(IM)Harmony IMLib SDK 实现主动加入群组、邀请用户加入群组、用户同意或拒绝加入群组、管理员同意或拒绝加群申请等功能。
提示
此功能从 1.8.0 版本开始支持。
开通服务
使用此功能前,您需要在控制台开通信息托管服务。
加入群组管理
加入群组管理包含:主动加入群组、邀请加入群组、 用户同意或拒绝加入群组、 管理员同意或拒绝加群申请等功能。
主动加入群组
调用 joinGroup
方法主动加入一个群组。
加入的结果受群组的加入权限 joinPermission 影响,有以下两种情况:
- 群组的加入权限(joinPermission)为需要群主/管理员审批时,接口调用成功后
EngineError
会返回GroupJoinGroupNeedManagerAccept
( 25424 ),表示需要等待群主或管理员的审批。同时本人和群主或管理员会都会收到onGroupApplicationEvent
事件回调。 - 群组的加入权限(joinPermission)为 “无需审批” 时,接口调用成功后
EngineError
会返回Success
( 0 ),表示加入群组成功。同时本人和群内所有人会收到onGroupOperation
事件回调,操作类型为Join
。
代码示例
TypeScript
// 群 Id
let groupId = "groupId";
IMEngine.getInstance().joinGroup(groupId).then(result => {
if (EngineError.Success !== result.code) {
// 加入群组请求失败
return;
}
if (result.data) {
// 加入群组请求成功时需要处理 processCode
let ret: GroupResultWithProcessCode<void> = result.data;
let processCode = ret.processCode;
}
});