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

详细描述

群资料

Public 成员函数

 V2TIMGroupInfo ()
 
 V2TIMGroupInfo (const V2TIMGroupInfo &groupInfo)
 
 ~V2TIMGroupInfo ()
 

成员变量

V2TIMString groupID
 
V2TIMString groupType
 
bool isSupportTopic
 
V2TIMString groupName
 
V2TIMString notification
 
V2TIMString introduction
 
V2TIMString faceURL
 
bool allMuted
 
V2TIMCustomInfo customInfo
 
V2TIMString 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
 
uint32_t modifyFlag
 

构造及析构函数说明

◆ V2TIMGroupInfo() [1/2]

◆ V2TIMGroupInfo() [2/2]

V2TIMGroupInfo ( const V2TIMGroupInfo groupInfo)

◆ ~V2TIMGroupInfo()

结构体成员变量说明

◆ groupID

V2TIMString groupID

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

◆ groupType

V2TIMString groupType

群类型

◆ isSupportTopic

bool isSupportTopic

社群是否支持创建话题,只在群类型为 Community 时有效

◆ groupName

V2TIMString groupName

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

◆ notification

V2TIMString notification

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

◆ introduction

V2TIMString introduction

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

◆ faceURL

V2TIMString faceURL

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

◆ allMuted

bool allMuted

是否全员禁言

◆ customInfo

V2TIMCustomInfo customInfo

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

◆ owner

V2TIMString owner

群创建人/管理员

◆ createTime

uint32_t createTime

创建群组的 UTC 时间戳

◆ groupAddOpt

V2TIMGroupAddOpt groupAddOpt

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

◆ groupApproveOpt

V2TIMGroupAddOpt groupApproveOpt

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

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

◆ lastInfoTime

uint32_t lastInfoTime

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

◆ lastMessageTime

uint32_t lastMessageTime

群最近一次发消息时间

◆ memberCount

uint32_t memberCount

已加入的群成员数量

◆ onlineCount

uint32_t onlineCount

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

◆ memberMaxCount

uint32_t memberMaxCount

最多允许加入的群成员数量 各类群成员人数限制详见: 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

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

◆ recvOpt

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

◆ joinTime

uint32_t joinTime

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

◆ enablePermissionGroup

bool enablePermissionGroup

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

◆ defaultPermissions

uint64_t defaultPermissions

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

◆ modifyFlag

uint32_t modifyFlag

群资料修改标记位 枚举 V2TIMGroupInfoModifyFlag 列出哪些字段支持修改,如果您修改群资料,请设置这个字段值 如果您同时修改多个字段,多个枚举值按位或 | 组合,例如,同时修改群名称和头像 info.groupName = "new group name"; info.faceURL = "new face url"; info.modifyFlag = V2TIM_GROUP_INFO_MODIFY_FLAG_GROUP_NAME | V2TIM_GROUP_INFO_MODIFY_FLAG_FACE_URL;