群组概览

OpenIM 的多人聊天场景通过群组承载共享资料、成员关系与权限管控。groupID 是群组的唯一标识，无论是发送群消息、读取群资料、管理成员还是处理入群申请都需要使用它。聊天列表中的群会话仍由 conversationID 统一管理，两者不可混淆。

核心数据类型

群角色使用 OIMGroupMemberRole：普通成员为 OIMGroupMemberRoleMember（20），管理员为 OIMGroupMemberRoleAdmin（60），群主为 OIMGroupMemberRoleOwner（100）。前端可以据此控制入口，但最终权限由 OpenIMServer 校验。

群资料和生命周期

• 创建群组
• 更新群名称、简介和头像
• 发布或更新群公告
• 设置入群验证方式
• 设置成员资料查看权限
• 设置群内添加好友权限
• 设置群组扩展字段
• 申请加入群组
• 退出群组
• 解散群组
• 查询指定群组资料
• 搜索群组

群成员和申请

• 入群申请概览
• 群成员查询概览
• 邀请用户加入群组

群组管控

• 设置群组全员禁言
• 设置群成员禁言

状态更新

群资料变动、当前用户加入或退出群组以及群组解散事件可在 OIMGroupListener 协议中集中监听：

- (void)startGroupEvents { [[OIMManager callbacker] addGroupListener:self]; }
- (void)stopGroupEvents { [[OIMManager callbacker] removeGroupListener:self]; }

- (void)onJoinedGroupAdded:(OIMGroupInfo *)group { [self upsertGroup:group]; }
- (void)onJoinedGroupDeleted:(OIMGroupInfo *)group { [self removeGroupID:group.groupID]; }
- (void)onGroupInfoChanged:(OIMGroupInfo *)group { [self upsertGroup:group]; }
- (void)onGroupDismissed:(OIMGroupInfo *)group { [self markDismissed:group.groupID]; }

应用应强引用稳定的 OIMGroupListener 对象，并使用同一实例添加和移除。事件按 groupID 幂等合并；成功 callback、之后到达的 delegate 和重新查询应分别处理。

成员事件归属群成员查询概览，申请事件归属入群申请概览。

OpenIM iOS SDK 的群组 API 聚焦于群资料、成员关系与权限管理。公开展现、复杂群目录和超大规模群聊的容量治理通常由业务后端与 OpenIMServer 配置协同实现。