浏览 SDKs · Android
平台
SDKsAndroid

申请加入群组

提交加入指定群组的申请或直接加入群聊。

复制

向指定群组发起加入请求。根据群组的验证模式,该操作将直接加入群聊或向群管理员提交入群申请。

String groupID = "group_123";
String reqMsg = "申请加入技术交流群";
int joinSource = 3; // 3 表示通过搜索加入
String ex = "{\"source\":\"search_page\"}";

OpenIMClient.getInstance().groupManager.joinGroup(
    new OnBase<String>() {
        @Override
        public void onSuccess(String data) {
            // 加入请求已成功处理或申请已提交
        }

        @Override
        public void onError(int code, String error) {
            // 处理申请失败
        }
    },
    groupID,
    reqMsg,
    joinSource,
    ex
);

参数说明

参数类型是否必填说明
baseOnBase<String>是异步请求回调。
groupIDString是目标群组的全局唯一 ID。
reqMsgString否入群申请附言,可向管理员说明入群原因。
joinSourceint是入群来源方式。2 表示通过邀请,3 表示通过搜索,4 表示扫描二维码。
exString否扩展字段,用于传递业务自定义参数(如 JSON 字符串)。不需要时可传空字符串。

返回结果

成功回调中的 data 返回确认信息。群组在设置入群验证方式中的配置决定了后续流转:

  • 免验证加入:直接成功加入群组。本地随后会通过 onJoinedGroupAdded 事件接收群资料,客户端以 groupID 为标识合并至已加入群组列表。
  • 需要验证:表示入群申请已成功提交至服务端,需等待群主或管理员审核。审批通过后,当前用户将通过 onJoinedGroupAdded 接收加群事件。

事件监听的完整注册与处理请参阅群组概览。