群组概述 - IM 即时通讯

开发者中心

IM 即时通讯

集成开发

群组概述

更新时间： 2024/03/12 11:07:15

网易云信 NIM SDK 提供普通群和高级群形式的群聊功能。

目前普通群功能已废弃，SDK 不支持创建和使用普通群，仅支持高级群形式的群聊功能。群组功能中涉及的群组概念皆指高级群。

高级群拥有完善的成员权限体系及管理功能，群内所有用户根据权限分为群主、管理员、以及群成员。

群组功能

高级群的详细功能如下：

功能	说明
群容量	IM 专业版 200人/群，最大可扩展至 5000 人/群（请联系商务经理或技术支持开通增值功能）
创建群	创建高级群，建群数量 100 群/人（免费版 50 群/人），最大可扩展至 5000 群/人（请联系商务经理或技术支持开通增值功能）已解散的群组不占用数量
群信息属性	群名，群头像，群简介，群公告，群扩展字段，申请加入群组的验证模式，群邀请模式，群被邀请模式，群信息修改模式，群信息扩展字段修改模式，群组全员禁言模式
邀请入群	支持配置：仅群主和管理员可邀请、所有人可邀请
被邀请人同意模式	支持配置：需要被邀请人同意、不需要被邀请人同意
申请入群	支持，加群数量 5000 群/人
入群验证	支持配置：需要群主或管理员同意、不需要群主或管理员同意、不允许任何人加入
群成员类型	群主、管理员、普通成员
管理员设置	群主可以增减管理员
群组信息修改权限	支持配置：仅群主和管理员可修改、所有人可修改
修改群成员昵称	仅限群主可以修改群成员的群昵称
修改自己的群昵称	支持
消息类型支持	同基础消息类型
消息提醒	接收提醒、只接收群主和管理员消息提醒、不接收提醒
历史消息	支持云端历史消息，专业版 IM 可获取到最近 1 年的历史记录最多支持扩展至 3 年(增值功能)
离线消息	每个群聊会话最多下发 100 条离线消息
消息漫游	自动漫游7天内、每个会话最近的 100 条消息
指定成员强制推送	支持
踢人	群主和管理员可以踢人，且管理员不能踢群主和其他管理员
主动退群	除群主外，其他用户均可以主动退群群主需先将群转让给其他群成员才可以进行退群操作
禁言	群主可对群成员进行禁言、解除禁言群全员禁言模式支持配置：包含群主和管理员禁言、只禁言普通成员
转让群	群主可以将群的拥有者权限转给群内的其他成员，转移后，被转让者变为新的群主，原群主变为普通成员群主还可以选择在转让的同时，直接退出该群
解散群	群主可以解散群
群消息已读回执	查看某一条群消息已读未读详情（增值功能）目前支持实际群人数 200 人以内的高级群，最大可扩展至 500 人（请至云信控制台配置）。若实际群人数超过 200 人，则消息可以正常发出，但不具备已读回执功能，无法查看消息的已读未读信息。

以上增值功能收费请参见：资费说明

群组对象

群组对象的参数信息参见 群组信息 Json Keys。重要参数如下：
- 群加入模式kNIMTeamInfoKeyJoinMode：入群是否需要验证，枚举类型：NIMTeamJoinMode
- 入群邀请模式 kNIMTeamInfoKeyInviteMode：谁可以邀请他人入群，枚举类型：NIMTeamInviteMode
- 群被邀请模式kNIMTeamInfoKeyBeInviteMode：入群是否需要被邀请人的同意，枚举类型：NIMTeamBeInviteMode
- 群信息修改权限kNIMTeamInfoKeyUpdateInfoMode：谁可以修改群信息，枚举类型：NIMTeamUpdateInfoMode
- 群自定义属性修改权限kNIMTeamInfoKeyUpdateCustomMode：谁可以修改群自定义属性，枚举类型：NIMTeamUpdateCustomMode
- 群禁言模式kNIMTeamInfoKeyMuteType：禁言的成员范围，枚举类型：NIMTeamMuteType
- 第三方服务器扩展字段kNIMTeamInfoKeyServerCustom：该配置项只能通过服务器接口设置，对客户端只读
- 第三放扩展字段kNIMTeamInfoKeyCustom：客户端可配置，仅负责存储和透传
群组成员的结构体参数参见 群组成员信息 Json Keys。重要参数如下：
- 群成员类型kNIMTeamUserKeyType：枚举类型：NIMTeamUserType
- 群成员属性kNIMTeamUserKeyBits：可设置群消息提醒模式，枚举类型：NIMTeamBitsConfigMask

群组 API 概述

C++

SDK 的 nim::Team 提供群组操作相关接口，帮助您快速实现和使用群组的管理功能。

SDK 的 nim_team 提供群组操作相关接口，帮助您快速实现和使用群组的管理功能。

SDK 的 NIM.Team.TeamAPI 提供群组操作相关接口，帮助您快速实现和使用群组的管理功能。

此文档是否对你有帮助？

有帮助

去反馈

群组功能
群组对象
群组 API 概述