IM 即时通讯
Windows/macOS
开发指南

群组概述

更新时间: 2023/09/21 20:07:04

网易云信 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。重要参数如下:

群组 API 概述

C++

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

C

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

C#

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

此文档是否对你有帮助?
有帮助
去反馈
  • 群组功能
  • 群组对象
  • 群组 API 概述