Group

Group

群组对象,用于描述群组具有的属性,如类型、群组公告、创建时间等。

Deprecated:
  • !!!v2.8.0起弃用memberNum和maxMemberNum,请分别用memberCount替换memberNum,maxMemberCount替换maxMemberNum。
Properties:
Name Type Description
groupID String

群组的唯一标识,群组 ID,App 内保证唯一,其格式前缀为 @TGS#。另外,App 亦可自定义群组 ID

name String

群组名称,最长30字节,不可调整

avatar String

群组头像 URL,最长100字节,不可调整

type String

群组类型,当前 SDK 支持的类型如下:

类型 含义
TIM.TYPES.GRP_WORK 好友工作群
TIM.TYPES.GRP_PUBLIC 陌生人社交群
TIM.TYPES.GRP_MEETING 临时会议群
TIM.TYPES.GRP_AVCHATROOM 直播群
introduction String

群组简介,最长120字节,不可调整

notification String

群组公告,最长150字节,不可调整

ownerID String

群主 ID

createTime Number

群组的创建时间

infoSequence Number

群资料的每次变都会增加该值

lastInfoTime Number

群组最后一次信息变更时间

selfInfo Object

当前用户在群组中的信息

Properties
Name Type Description
role String

角色

messageRemindType String

消息接收选项

  • TIM.TYPES.MSG_REMIND_ACPT_AND_NOTE - SDK 接收消息并通知接入侧(抛出 收到消息事件),接入侧做提示
  • TIM.TYPES.MSG_REMIND_ACPT_NOT_NOTE - SDK 接收消息并通知接入侧(抛出 收到消息事件),接入侧不做提示
  • TIM.TYPES.MSG_REMIND_DISCARD - SDK 拒收消息
joinTime Number

入群时间

nameCard String

群名片

lastMessage Object

群组最后一条消息。注意:若会话列表中没有该群组,则该对象只有 lastTime 有值,其他值为空。

Properties
Name Type Description
lastTime Number

群组最后一条消息的时间戳,单位:秒

lastSequence Number

当前群组类型会话的最新消息的 Seq

fromAccount Number

群组最后一条消息的来源用户

messageForShow Number

用于展示的群组最后一条消息的简要内容,文本则展示原内容,图片则展示“[图片]”。

nextMessageSeq Number

群内下一条消息的 Seq,群组内每一条消息都有一条唯一的消息 Seq,且该 Seq 是按照发消息顺序而连续的。从 1 开始,群内每增加一条消息,nextMessageSeq 就会增加 1

memberNum Number

Deprecated: 当前成员数量

memberCount Number

当前成员数量

maxMemberNum Number

Deprecated: 最大成员数量

maxMemberCount Number

最大成员数量

muteAllMembers Boolean

设置全体禁言,true 表示全体禁言,false 表示取消全体禁言,v2.6.2 起支持

joinOption String

申请加群选项。

  • TIM.TYPES.JOIN_OPTIONS_FREE_ACCESS(自由加入,直播群固定为该值)
  • TIM.TYPES.JOIN_OPTIONS_NEED_PERMISSION(需要验证)
  • TIM.TYPES.JOIN_OPTIONS_DISABLE_APPLY(禁止加群,好友工作群固定为该值)
groupCustomField Array.<Object>

群组自定义字段。默认情况是没有的。开通群组维度的自定义字段详情请参见 自定义字段

Properties
Name Type Description
key String

群组自定义字段的 Key

value String

群组自定义字段的 Value