Web
群组概述
更新时间： 2024/03/14 18:45:32
网易云信 NIM SDK 提供普通群和高级群形式的群聊功能。
目前普通群功能已废弃，SDK 不支持创建和使用普通群，仅支持高级群形式的群聊功能。群组功能中涉及的群组概念皆指高级群。
高级群拥有完善的成员权限体系及管理功能，群内所有用户根据权限分为群主、管理员、以及群成员。
群组功能
高级群的详细功能如下：
| 功能 | 说明 |
|---|---|
| 群容量 | IM 专业版 200人/群，最大可扩展至 5000 人/群（请联系商务经理或技术支持开通增值功能） |
| 创建群 | 创建高级群，建群数量 100 群/人（免费版 50 群/人），最大可扩展至 5000 群/人（请联系商务经理或技术支持开通增值功能） 已解散的群组不占用数量 |
| 群信息属性 | 群名，群头像，群简介，群公告，群扩展字段， 申请加入群组的验证模式，群邀请模式，群被邀请模式， 群信息修改模式，群信息扩展字段修改模式，群组全员禁言模式 |
| 邀请入群 | 支持配置：仅群主和管理员可邀请 、 所有人可邀请 |
| 被邀请人同意模式 | 支持配置： 需要被邀请人同意、不需要被邀请人同意 |
| 申请入群 | 支持，加群数量 5000 群/人 |
| 入群验证 | 支持配置：需要群主或管理员同意、不需要群主或管理员同意、不允许任何人加入 |
| 群成员类型 | 群主、管理员、普通成员 |
| 管理员设置 | 群主可以增减管理员 |
| 群组信息修改权限 | 支持配置：仅群主和管理员可修改、所有人可修改 |
| 修改群成员昵称 | 仅限群主可以修改群成员的群昵称 |
| 修改自己的群昵称 | 支持 |
| 消息类型支持 | 同基础消息类型 |
| 消息提醒 | 接收提醒、只接收群主和管理员消息提醒、不接收提醒 |
| 历史消息 | 支持云端历史消息，专业版 IM 可获取到最近 1 年的历史记录 最多支持扩展至 3 年(增值功能) |
| 离线消息 | 每个群聊会话最多下发 100 条离线消息 |
| 消息漫游 | 自动漫游7天内、每个会话最近的 100 条消息 |
| 指定成员强制推送 | 支持 |
| 踢人 | 群主和管理员可以踢人，且管理员不能踢群主和其他管理员 |
| 主动退群 | 除群主外，其他用户均可以主动退群 群主需先将群转让给其他群成员才可以进行退群操作 |
| 禁言 | 群主可对群成员进行禁言、解除禁言 群全员禁言模式支持配置：包含群主和管理员禁言、只禁言普通成员 |
| 转让群 | 群主可以将群的拥有者权限转给群内的其他成员，转移后， 被转让者变为新的群主，原群主变为普通成员 群主还可以选择在转让的同时，直接退出该群 |
| 解散群 | 群主可以解散群 |
| 群消息已读回执 | 查看某一条群消息已读未读详情（增值功能） 目前支持实际群人数 200 人以内的高级群，最大可扩展至 500 人（请至云信控制台配置）。若实际群人数超过 200 人，则消息可以正常发出，但不具备已读回执功能，无法查看消息的已读未读信息。 |
以上增值功能收费请参见：资费说明
群组对象
- 群组的原型参见
NIMTeam。
Team 重要参数如下：
| 参数 | 类型 | 说明 |
|---|---|---|
| teamId | String | 群组 ID |
| type | String | 群组类型，advanced 为高级群 |
| name | String | 群组名称 |
| avatar | String | 群组头像 |
| intro | String | 群组简介 |
| announcement | String | 群组公告 |
| joinMode | String | 群组加入方式 noVerify： 不需要验证 needVerify： 需要验证 rejectAll： 禁止任何人加入 |
| beInviteMode | String | 群被邀请模式 noVerify：不需要验证 needVerify：此群邀请某人，需要被邀请人的验证通过才能加入 |
| inviteMode | String | 群邀请模式 manager：仅群主和管理员可以邀请人进群 all：所有人都可以邀请人进群 |
| updateTeamMode | String | 群信息修改权限 manager：仅群主和管理员可以修改群信息 all：所有人都可以修改 |
| updateCustomMode | String | 群信息自定义字段修改权限 manager：仅群主和管理员可以修改 all：所有人都可以修改 |
| owner | String | 群主 |
| level | Number | 群人数上限 |
| memberNum | Number | 群成员数量 |
| memberUpdateTime | Number | 群成员最后更新时间 |
| createTime | Number | 群创建时间 |
| updateTime | Number | 群最后更新时间 |
| custom | String | 第三方扩展字段, 开发者可以自行扩展, 建议封装成 JSON 格式字符串 |
| serverCustom | String | 第三方服务器扩展字段, 开发者可以自行扩展, 建议封装成JSON格式字符串 |
| valid | Boolean | 是否有效, 解散后该群无效 |
| validToCurrentUser | Boolean | 该群是否对当前用户有效, 如果无效, 说明当前用户已被踢出该群组 |
| mute | Boolean | 是否禁言 mute 为 true 等效于 muteType 为 normal） |
| muteType | Boolean | 禁言模式 none: 都不禁言 normal: 普通成员禁言，不包括群主和管理员 all: 全体禁言，包括群主和管理员 |
- 群组成员的原型参见
NIMTeamMember。
TeamMember 重要参数如下：
| 参数 | 类型 | 说明 |
|---|---|---|
| teamId | Number | 群组ID |
| account | String | 群组成员账号 |
| id | String | 群成员 ID (群 ID + account) |
| type | NIMTeamMemberType |
群成员类型 normal：普通成员 owner：群主 manager：管理员 |
| invitorAccid | String | 邀请者的账号 |
| nickInTeam | String | 在群里的昵称 |
| muteTeam | Boolean | 是否关闭此群的消息提醒 true：表示关闭提醒 SDK 仍会收到此群的消息，SDK 只是记录该设置， 具体根据该设置执行的操作由第三方APP决定 |
| joinTime | Number | 入群时间 |
| updateTime | Number | 更新时间 |
| active | Boolean | 成员状态，是否被激活 |
| mute | Boolean | 是否被禁言 |
| muteNotiType | String | 提醒策略 0：开启提醒；1：关闭消息提醒；2：只接收群主和管理员的消息的提醒 |
| custom | String | 第三方扩展字段 |
| valid | Boolean | 群成员是否有效 |
此文档是否对你有帮助？
