IMSDK
即时通信 IM 提供全球接入、单聊、群聊、消息推送、资料关系链托管、账号鉴权等全方位解决方案,并提供完备的 App 接入、后台管理接口。
V2TIMGroupInfo

详细描述

群资料

属性

NSString * groupID
 
NSString * groupType
 
BOOL isSupportTopic
 
NSString * groupName
 
NSString * notification
 
NSString * introduction
 
NSString * faceURL
 
BOOL allMuted
 
NSDictionary< NSString *, NSData * > * customInfo
 
NSString * owner
 
uint32_t createTime
 
V2TIMGroupAddOpt groupAddOpt
 
V2TIMGroupAddOpt groupApproveOpt
 
uint32_t lastInfoTime
 
uint32_t lastMessageTime
 
uint32_t memberCount
 
uint32_t onlineCount
 
uint32_t memberMaxCount
 
uint32_t role
 
V2TIMReceiveMessageOpt recvOpt
 
uint32_t joinTime
 
BOOL enablePermissionGroup
 
uint64_t defaultPermissions
 

属性说明

◆ groupID

- (NSString*) groupID
readwritenonatomicstrong

群组 ID

注意
自定义群组 ID 必须为可打印 ASCII 字符(0x20-0x7e),最长 48 个字节,且前缀不能为 @TGS(避免与默认分配的群组 ID 混淆)

◆ groupType

- (NSString*) groupType
readwritenonatomicstrong

群类型

◆ isSupportTopic

- (BOOL) isSupportTopic
readwritenonatomicassign

社群是否支持创建话题

注意
只在群类型为 Community 时有效

◆ groupName

- (NSString*) groupName
readwritenonatomicstrong

群名称

注意
群名称最长 100 字节,使用 UTF-8 编码

◆ notification

- (NSString*) notification
readwritenonatomicstrong

群公告

注意
群公告最长 400 字节,使用 UTF-8 编码

◆ introduction

- (NSString*) introduction
readwritenonatomicstrong

群简介

注意
群简介最长 400 字节,使用 UTF-8 编码

◆ faceURL

- (NSString*) faceURL
readwritenonatomicstrong

群头像

注意
群头像 URL 最长 500 字节,使用 UTF-8 编码

◆ allMuted

- (BOOL) allMuted
readwritenonatomicassign

是否全员禁言

◆ customInfo

- (NSDictionary<NSString *,NSData *>*) customInfo
readwritenonatomicstrong

设置群自定义字段需要两个步骤: 1.在 控制台 (功能配置 -> 群自定义字段) 配置群自定义字段的 key 值,Key 为 String 类型,长度不超过 16 字节。 2.调用 setGroupInfo 接口设置该字段,value 为 NSData 数据,长度不超过 512 字节。

注解
该字段主要用于 V1 和 V2 版本的兼容,如果您直接使用的是 V2 版本的 API ,建议使用 initGroupAttributes 接口设置群属性,其设置更灵活(无需控制台配置),支持的存储也更大(最大支持 16K)

◆ owner

- (NSString*) owner
readnonatomicstrong

群创建人/管理员

◆ createTime

- (uint32_t) createTime
readnonatomicassign

创建群组的 UTC 时间戳

◆ groupAddOpt

- (V2TIMGroupAddOpt) groupAddOpt
readwritenonatomicassign

申请进群是否需要管理员审批:工作群(Work)默认值为 V2TIM_GROUP_ADD_FORBID,即默认不允许申请入群,您可以修改该字段打开申请入群方式。

◆ groupApproveOpt

- (V2TIMGroupAddOpt) groupApproveOpt
readwritenonatomicassign

邀请进群是否需要管理员审批 (从 7.1 版本开始支持)

  • 除工作群(Work)之外的其他群类型默认值都为 V2TIM_GROUP_ADD_FORBID,即默认不允许邀请入群,您可以修改该字段打开邀请入群方式。
  • 直播群、社群和话题默认不允许邀请入群,也不支持修改。

◆ lastInfoTime

- (uint32_t) lastInfoTime
readnonatomicassign

上次修改群信息的 UTC 时间戳

◆ lastMessageTime

- (uint32_t) lastMessageTime
readnonatomicassign

群最近一次发消息时间

◆ memberCount

- (uint32_t) memberCount
readnonatomicassign

已加入的群成员数量

◆ onlineCount

- (uint32_t) onlineCount
readnonatomicassign

在线的群成员数量(待废弃字段,请使用 getGroupOnlineMemberCount:succ:fail: 接口获取群在线人数)

◆ memberMaxCount

- (uint32_t) memberMaxCount
readnonatomicassign

最多允许加入的群成员数量

注意
各类群成员人数限制详见: https://cloud.tencent.com/document/product/269/1502#.E7.BE.A4.E7.BB.84.E9.99.90.E5.88.B6.E5.B7.AE.E5.BC.82

◆ role

- (uint32_t) role
readnonatomicassign

当前用户在此群组中的角色(V2TIMGroupMemberRole),切换角色请调用 setGroupMemberRole 接口

◆ recvOpt

- (V2TIMReceiveMessageOpt) recvOpt
readnonatomicassign

当前用户在此群组中的消息接收选项,修改群消息接收选项请调用 setGroupReceiveMessageOpt 接口

◆ joinTime

- (uint32_t) joinTime
readnonatomicassign

当前用户加入此群的 UTC 时间戳,不支持设置,系统自动生成

◆ enablePermissionGroup

- (BOOL) enablePermissionGroup
readwritenonatomicassign

是否开启权限组能力,仅支持社群,7.8 版本开始支持 开启后,管理员角色的权限失效,用群权限、话题权限和权限组能力来对社群、话题进行管理。

◆ defaultPermissions

- (uint64_t) defaultPermissions
readwritenonatomicassign

群权限,仅支持社群,7.8 版本开始支持 群成员在没有加入任何权限组时的默认权限,仅在 enablePermissionGroup = true 打开权限组之后生效