常规集成(无 UI 库)

服务端 API

IM SDK 关键类型

最近更新时间:2020-06-29 15:22:37

常用宏和基础配置选项

TIMResult

调用接口的返回值。

名称 含义
TIM_SUCC 接口调用成功
TIM_ERR_SDKUNINIT 接口调用失败,IM SDK 未初始化
TIM_ERR_NOTLOGIN 接口调用失败,用户未登录
TIM_ERR_JSON 接口调用失败,错误的 JSON 格式或 JSON Key
TIM_ERR_PARAM 接口调用失败,参数错误
TIM_ERR_CONV 接口调用失败,无效的会话
TIM_ERR_GROUP 接口调用失败,无效的群组
说明:

若接口参数中有回调,只有当接口返回 TIM_SUCC 时,回调才会被调用。

TIMLogLevel

日志级别。

名称 含义
kTIMLog_Off 关闭日志输出
kTIMLog_Test 全量日志
kTIMLog_Verbose 开发调试过程中一些详细信息日志
kTIMLog_Debug 调试日志
kTIMLog_Info 信息日志
kTIMLog_Warn 警告日志
kTIMLog_Error 错误日志
kTIMLog_Assert 断言日志

TIMNetworkStatus

连接事件类型。

名称 含义
kTIMConnected 已连接
kTIMDisconnected 失去连接
kTIMConnecting 正在连接
kTIMConnectFailed 连接失败

TIMConvEvent

会话事件类型。

名称 含义
kTIMConvEvent_Add 会话新增,例如收到一条新消息,产生一个新的会话是事件触发
kTIMConvEvent_Del 会话删除,例如自己删除某会话时会触发
kTIMConvEvent_Update 会话更新,会话内消息的未读计数变化和收到新消息时触发

TIMConvType

会话类型。

名称 含义
kTIMConv_Invalid 无效会话
kTIMConv_C2C 个人会话
kTIMConv_Group 群组会话
kTIMConv_System 系统会话

TIMPlatform

平台信息。

名称 含义
kTIMPlatform_Other 未知平台
kTIMPlatform_Windows Windows 平台
kTIMPlatform_Android Android 平台
kTIMPlatform_IOS iOS 平台
kTIMPlatform_Mac MacOS 平台
kTIMPlatform_Simulator iOS 模拟器平台

SdKConfig

初始化 IM SDK 的配置。

JSON 键 值类型 属性 含义
kTIMSdkConfigConfigFilePath string 只写(选填) 配置文件路径,默认路径为"/"
kTIMSdkConfigLogFilePath string 只写(选填) 日志文件路径,默认路径为"/"
kTIMSdkConfigJavaVM uint64 只写(选填) 配置 Android 平台的 Java 虚拟机指针

TIMGroupMemberInfoFlag

群组成员信息标识。

名称 含义
kTIMGroupMemberInfoFlag_None
kTIMGroupMemberInfoFlag_JoinTime 加入时间
kTIMGroupMemberInfoFlag_MsgFlag 群消息接收选项
kTIMGroupMemberInfoFlag_MsgSeq 成员已读消息 seq
kTIMGroupMemberInfoFlag_MemberRole 成员角色
kTIMGroupMemberInfoFlag_ShutupUntill 禁言时间。当该值为0时表示没有被禁言
kTIMGroupMemberInfoFlag_NameCard 群名片

TIMGroupMemberRoleFlag

群组成员角色标识。

名称 含义
kTIMGroupMemberRoleFlag_All 获取全部角色类型
kTIMGroupMemberRoleFlag_Owner 获取所有者(群主)
kTIMGroupMemberRoleFlag_Admin 获取管理员,不包括群主
kTIMGroupMemberRoleFlag_Member 获取普通群成员,不包括群主和管理员

GroupMemberGetInfoOption

获取群组成员信息的选项。

JSON 键 值类型 属性 含义
kTIMGroupMemberGetInfoOptionInfoFlag uint64 TIMGroupMemberInfoFlag 读写(选填) 根据想要获取的信息过滤,默认值为 0xffffffff(获取全部信息)
kTIMGroupMemberGetInfoOptionRoleFlag uint64 TIMGroupMemberRoleFlag 读写(选填) 根据成员角色过滤,默认值为 kTIMGroupMemberRoleFlag_All,获取所有角色
kTIMGroupMemberGetInfoOptionCustomArray array string 只写(选填) 请参考 自定义字段

TIMGroupGetInfoFlag

群组成员信息标识。

名称 含义
kTIMGroupInfoFlag_None -
kTIMGroupInfoFlag_Name 群组名称
kTIMGroupInfoFlag_CreateTime 群组创建时间
kTIMGroupInfoFlag_OwnerUin 群组创建者帐号
kTIMGroupInfoFlag_Seq -
kTIMGroupInfoFlag_LastTime 群组信息最后修改时间
kTIMGroupInfoFlag_NextMsgSeq -
kTIMGroupInfoFlag_LastMsgTime 最新群组消息时间
kTIMGroupInfoFlag_AppId -
kTIMGroupInfoFlag_MemberNum 群组成员数量
kTIMGroupInfoFlag_MaxMemberNum 群组成员最大数量
kTIMGroupInfoFlag_Notification 群公告内容
kTIMGroupInfoFlag_Introduction 群简介内容
kTIMGroupInfoFlag_FaceUrl 群头像 URL
kTIMGroupInfoFlag_AddOpton 加群选项
kTIMGroupInfoFlag_GroupType 群类型
kTIMGroupInfoFlag_LastMsg 群组内最新一条消息
kTIMGroupInfoFlag_OnlineNum 群组在线成员数
kTIMGroupInfoFlag_Visible 群组是否可见
kTIMGroupInfoFlag_Searchable 群组是否可以搜索
kTIMGroupInfoFlag_ShutupAll 群组是否全禁言

GroupGetInfoOption

获取群组信息的选项。

JSON 键 值类型 属性 含义
kTIMGroupGetInfoOptionInfoFlag uint64 TIMGroupGetInfoFlag 读写(选填) 根据想要获取的信息过滤,默认值为 0xffffffff(获取全部信息)
kTIMGroupGetInfoOptionCustomArray array string 只写(选填) 请参考 自定义字段

UserConfig

用于配置信息。

JSON 键 值类型 属性 含义
kTIMUserConfigIsReadReceipt bool 只写(选填) true 表示要收已读回执事件
kTIMUserConfigIsSyncReport bool 只写(选填) true 表示服务端要删掉已读状态
kTIMUserConfigIsIngoreGroupTipsUnRead bool 只写(选填) true 表示群 tips 不计入群消息已读计数
kTIMUserConfigIsDisableStorage bool 只写(选填) 是否禁用本地数据库,true 表示禁用,false 表示不禁用。默认是 false
kTIMUserConfigGroupGetInfoOption object GroupGetInfoOption 只写(选填) 获取群组信息默认选项
kTIMUserConfigGroupMemberGetInfoOption object GroupMemberGetInfoOption 只写(选填) 获取群组成员信息默认选项

HttpProxyInfo

HTTP 代理信息。

JSON 键 值类型 属性 含义
kTIMHttpProxyInfoIp string 只写(必填) 代理的 IP
kTIMHttpProxyInfoPort int 只写(必填) 代理的端口

Socks5ProxyInfo

SOCKS5 代理信息。

JSON 键 值类型 属性 含义
kTIMSocks5ProxyInfoIp string 只写(必填) SOCKS5 代理的 IP
kTIMSocks5ProxyInfoPort int 只写(必填) SOCKS5 代理的端口
kTIMSocks5ProxyInfoUserName string 只写(选填) 认证的用户名
kTIMSocks5ProxyInfoPassword string 只写(选填) 认证的密码

SetConfig

更新配置

  • 自定义数据。
    开发者可以自定义的数据(长度限制为64个字节),IM SDK 只负责透传给即时通信 IM 后台后,可以通过第三方回调 状态变更回调 告知开发者业务后台。
  • HTTP 代理。
    HTTP 代理主要用在发送图片、语音、文件、微视频等消息时,将相关文件上传到 COS,以及接收到图片、语音、文件、微视频等消息,将相关文件下载到本地时用到。设置时,设置的 IP 不能为空,端口不能为0(0端口不可用)。如果需要取消 HTTP 代理,只需将代理的 IP 设置为空字符串,端口设置为0。
  • SOCKS5 代理。
    SOCKS5 代理需要在初始化之前设置。设置之后 IM SDK 发送的所有协议会通过 SOCKS5 代理服务器发送的即时通信 IM 后台。
JSON 键 值类型 属性 含义
kTIMSetConfigLogLevel uint TIMLogLevel 只写(选填) 输出到日志文件的日志级别
kTIMSetConfigCackBackLogLevel uint TIMLogLevel 只写(选填) 日志回调的日志级别
kTIMSetConfigIsLogOutputConsole bool 只写(选填) 是否输出到控制台
kTIMSetConfigUserConfig object UserConfig 只写(选填) 用户配置
kTIMSetConfigUserDefineData string 只写(选填) 自定义数据,如果需要,初始化前设置
kTIMSetConfigHttpProxyInfo object HttpProxyInfo 只写(选填) 设置 HTTP 代理,如果需要,在发送图片、文件、语音、视频前设置
kTIMSetConfigSocks5ProxyInfo object Socks5ProxyInfo 只写(选填) 设置 SOCKS5 代理,如果需要,初始化前设置
kTIMSetConfigIsOnlyLocalDNSSource bool 只写(选填) 如果为 true,SDK 内部会在选择最优 IP 时只使用 LocalDNS

消息关键类型

消息相关宏定义,以及相关结构成员存取 JSON Key 定义。

IOSOfflinePushConfig

消息在 iOS 系统上的离线推送配置。

JSON 键 值类型 属性 含义
kTIMIOSOfflinePushConfigTitle string 读写 通知标题
kTIMIOSOfflinePushConfigSound string 读写 当前消息在 iOS 设备上的离线推送提示声音 URL。当设置为 push。no_sound 时表示无提示音无振动
kTIMIOSOfflinePushConfigIgnoreBadge bool 读写 是否忽略 badge 计数。若为 true,在 iOS 接收端,这条消息不会使 App 的应用图标未读计数增加

TIMAndroidOfflinePushNotifyMode

Android 离线推送模式。

名称 含义
kTIMAndroidOfflinePushNotifyMode_Normal 普通通知栏消息模式,离线消息下发后,点击通知栏消息直接启动应用,不会给应用进行回调
kTIMAndroidOfflinePushNotifyMode_Custom 自定义消息模式,离线消息下发后,点击通知栏消息会给应用进行回调

AndroidOfflinePushConfig

消息在 Android 系统上的离线推送配置。

JSON 键 值类型 属性 含义
kTIMAndroidOfflinePushConfigTitle string 读写 通知标题
kTIMAndroidOfflinePushConfigSound string 读写 当前消息在 Android 设备上的离线推送提示声音 URL
kTIMAndroidOfflinePushConfigNotifyMode uint TIMAndroidOfflinePushNotifyMode 读写 当前消息的通知模式
kTIMAndroidOfflinePushConfigOPPOChannelID string 读写 OPPO 的 ChannelID
说明:

ChannelID 的说明
Android8。0系统以上通知栏消息增加了 channelid 的设置,目前 oppo 要求必须填写,否则在8。0及以上的 OPPO 手机上会收不到离线推送消息。后续可能会增加 xiaomi_channel_id_,huawei_channel_id 等。

TIMOfflinePushFlag

推送规则。

名称 含义
kTIMOfflinePushFlag_Default 按照默认规则进行推送
kTIMOfflinePushFlag_NoPush 不进行推送

OfflinePushConfig

消息离线推送配置。

JSON 键 值类型 属性 含义
kTIMOfflinePushConfigDesc string 读写 当前消息在对方收到离线推送时候展示内容
kTIMOfflinePushConfigExt string 读写 当前消息离线推送时的扩展字段
kTIMOfflinePushConfigFlag uint TIMOfflinePushFlag 读写 当前消息是否允许推送,默认允许推送 kTIMOfflinePushFlag_Default
kTIMOfflinePushConfigIOSConfig object IOSOfflinePushConfig 读写 iOS 离线推送配置
kTIMOfflinePushConfigAndroidConfig object AndroidOfflinePushConfig 读写 Android 离线推送配置

TIMMsgStatus

消息当前状态定义。

名称 含义
kTIMMsg_Sending 消息正在发送
kTIMMsg_SendSucc 消息发送成功
kTIMMsg_SendFail 消息发送失败
kTIMMsg_Deleted 消息已删除
kTIMMsg_LocalImported 消息导入状态
kTIMMsg_Revoked 消息撤回状态

TIMMsgPriority

标识消息的优先级,数字越大优先级越低。

名称 含义
kTIMMsgPriority_High 优先级最高,一般为红包或者礼物消息
kTIMMsgPriority_Normal 表示优先级次之,建议为普通消息
kTIMMsgPriority_Low 建议为点赞消息等
kTIMMsgPriority_Lowest 优先级最低,一般为成员进退群通知(后台下发)

Message

消息 JSON Keys。

JSON 键 值类型 属性 含义
kTIMMsgElemArray array Elem 读写(必填) 消息内元素列表
kTIMMsgConvId string 读写(选填) 消息所属会话 ID
kTIMMsgConvType uint TIMConvType 读写(选填) 消息所属会话类型
kTIMMsgSender string 读写(选填) 消息的发送者
kTIMMsgPriority uint TIMMsgPriority 读写(选填) 消息优先级
kTIMMsgClientTime uint64 读写(选填) 客户端时间
kTIMMsgServerTime uint64 读写(选填) 服务端时间
kTIMMsgIsFormSelf bool 读写(选填) 消息是否来自自己
kTIMMsgPlatform bool 读写(选填) 发送消息的平台
kTIMMsgIsRead bool 读写(选填) 消息是否已读
kTIMMsgIsOnlineMsg bool 读写(选填) 消息是否是在线消息,false 表示普通消息,true 表示阅后即焚消息,默认为 false
kTIMMsgIsPeerRead bool 只读 消息是否被会话对方已读
kTIMMsgStatus uint TIMMsgStatus 读写(选填) 消息当前状态
kTIMMsgUniqueId uint64 只读 消息的唯一标识
kTIMMsgRand uint64 只读 消息的随机码
kTIMMsgSeq uint64 只读 消息序列
kTIMMsgCustomInt uint32_t 读写(选填) 自定义整数值字段
kTIMMsgCustomStr string 读写(选填) 自定义数据字段
kTIMMsgSenderProfile object UserProfile 读写(选填) 消息的发送者的用户资料
kTIMMsgSenderGroupMemberInfo object GroupMemberInfo 读写(选填) 消息发送者在群里面的信息,只有在群会话有效。目前仅能获取字段kTIMGroupMemberInfoIdentifier、kTIMGroupMemberInfoNameCard 其他的字段建议通过TIMGroupGetMemberInfoList接口获取
kTIMMsgOfflinePushConfig object OfflinePushConfig 读写(选填) 消息的离线推送设置
说明:

  • 对应 Elem 的顺序。
    目前文件和语音 Elem 不一定会按照添加顺序传输,其他 Elem 按照顺序,不过建议不要过于依赖 Elem 顺序进行处理,应该逐个按照 Elem 类型处理,防止异常情况下进程 Crash。
  • 针对群组的红包和点赞消息。
    对于直播场景,会有点赞和发红包功能,点赞相对优先级较低,红包消息优先级较高,具体消息内容可以使用自定义消息 CustomElem 进行定义,发送消息时,可通过kTIMMsgPriority定义消息优先级。
  • 阅后即焚消息。
    开发者通过设置kTIMMsgIsOnlineMsg字段为 true 时,表示发送阅后即焚消息,该消息有如下特性。
    • C2C 会话,当此消息发送时,只有对方在线,对方才会收到。如果当时离线,后续再登录也收不到此消息。
    • 群会话,当此消息发送时,只有群里在线的成员才会收到。如果当时离线,后续再登录也收不到此消息。
    • 此消息服务器不会保存。
    • 此消息不计入未读计数。
    • 此消息在本地不会存储。
  • 消息自定义字段。
    开发者可以对消息增加自定义字段,如自定义整数(通过kTIMMsgCustomInt指定)、自定义二进制数据(通过kTIMMsgCustomStr指定,必须转换成 String,JSON 不支持二进制传输),可以根据这两个字段做出各种不同效果,例如语音消息是否已经播放等等。另外需要注意,此自定义字段仅存储于本地,不会同步到 Server,更换终端获取不到。

MessageReceipt

消息已读回执。

JSON 键 值类型 属性 含义
kTIMMsgReceiptConvId string 只读 会话 ID
kTIMMsgReceiptConvType uint TIMConvType 只读 会话类型
kTIMMsgReceiptTimeStamp uint64 只读 时间戳

TIMElemType

元素的类型。

名称 含义
kTIMElem_Text 文本元素
kTIMElem_Image 图片元素
kTIMElem_Sound 声音元素
kTIMElem_Custom 自定义元素
kTIMElem_File 文件元素
kTIMElem_GroupTips 群组系统消息元素
kTIMElem_Face 表情元素
kTIMElem_Location 位置元素
kTIMElem_GroupReport 群组系统通知元素
kTIMElem_Video 视频元素
kTIMElem_FriendChange 关系链变更消息元素
kTIMElem_ProfileChange 资料变更消息元素
kTIMElem_Invalid 未知元素类型

Elem

元素的类型。

JSON 键 值类型 属性 含义
kTIMElemType uint TIMElemType 读写(必填) 元素类型

TextElem

文本元素。

JSON 键 值类型 属性 含义
kTIMTextElemContent string 读写(必填) 文本内容

FaceElem

表情元素。

JSON 键 值类型 属性 含义
kTIMFaceElemIndex int 读写(必填) 表情索引
kTIMFaceElemBuf string 读写(选填) 其他额外数据,可由用户自定义填写。若要传输二进制,麻烦先转码成字符串。JSON 只支持字符串
说明:

IM SDK 并不提供表情包,如果开发者有表情包,可使用kTIMFaceElemIndex存储表情在表情包中的索引,由用户自定义。或者直接使用kTIMFaceElemBuf存储表情二进制信息(必须转换成 String,JSON 不支持二进制传输),由用户自定义,IM SDK 内部只做透传。

LocationElem

位置元素。

JSON 键 值类型 属性 含义
kTIMLocationElemDesc string 读写(选填) 位置描述
kTIMLocationElemLongitude double 读写(必填) 经度
kTIMLocationElemlatitude double 读写(必填) 纬度

TIMImageLevel

图片质量级别。

名称 含义
kTIMImageLevel_Orig 原图发送
kTIMImageLevel_Compression 高压缩率图发送(图片较小,默认值)
kTIMImageLevel_HD 高清图发送(图片较大)

ImageElem

图片元素。

JSON 键 值类型 属性 含义
kTIMImageElemOrigPath string 读写(必填) 发送图片的路径
kTIMImageElemLevel uint TIMImageLevel 读写(必填) 发送图片的质量级别
kTIMImageElemFormat int 读写 发送图片格式
kTIMImageElemOrigId string 只读 原图的 UUID
kTIMImageElemOrigPicHeight int 只读 原图的图片高度
kTIMImageElemOrigPicWidth int 只读 原图的图片宽度
kTIMImageElemOrigPicSize int 只读 原图的图片大小
kTIMImageElemThumbId string 只读 略缩图 UUID
kTIMImageElemThumbPicHeight int 只读 略缩图的图片高度
kTIMImageElemThumbPicWidth int 只读 略缩图的图片宽度
kTIMImageElemThumbPicSize int 只读 略缩图的图片大小
kTIMImageElemLargeId string 只读 大图片 UUID
kTIMImageElemLargePicHeight int 只读 大图片的图片高度
kTIMImageElemLargePicWidth int 只读 大图片的图片宽度
kTIMImageElemLargePicSize int 只读 大图片的图片大小
kTIMImageElemOrigUrl string 只读 原图 URL
kTIMImageElemThumbUrl string 只读 略缩图 URL
kTIMImageElemLargeUrl string 只读 大图片 URL
kTIMImageElemTaskId int 只读 任务 ID
说明:

  • 图片规格说明:每幅图片有三种规格,分别是 Original(原图)、Large(大图)、Thumb(缩略图)。
    • 原图:指用户发送的原始图片,尺寸和大小都保持不变。
    • 大图:是将原图等比压缩,压缩后宽、高中较小的一个等于720像素。
    • 缩略图:是将原图等比压缩,压缩后宽、高中较小的一个等于198像素。
  • 如果原图尺寸就小于198像素,则三种规格都保持原始尺寸,不需压缩。
  • 如果原图尺寸在198 - 720之间,则大图和原图一样,不需压缩。
  • 在手机上展示图片时,建议优先展示缩略图,用户单击缩略图时再下载大图,单击大图时再下载原图。当然开发者也可以选择跳过大图,单击缩略图时直接下载原图。
  • 在 Pad 或 PC 上展示图片时,由于分辨率较大,且基本都是 Wi-Fi 或有线网络,建议直接显示大图,用户单击大图时再下载原图。

SoundElem

声音元素。

JSON 键 值类型 属性 含义
kTIMSoundElemFilePath string 读写(必填) 语音文件路径,需要开发者自己先保存语言然后指定路径
kTIMSoundElemFileSize int 读写(必填) 语言数据文件大小,以秒为单位
kTIMSoundElemFileTime int 读写(必填) 语音时长
kTIMSoundElemFileId string 只读 下载声音文件时的 ID
kTIMSoundElemBusinessId int 只读 下载时用到的 businessID
kTIMSoundElemDownloadFlag int 只读 是否需要申请下载地址(0:需要申请,1:到 cos 申请,2:不需要申请,直接拿 URL 下载)
kTIMSoundElemUrl string 只读 下载的 URL
kTIMSoundElemTaskId int 只读 任务 ID
说明:

  • 语音是否已经播放,可使用消息自定义字段实现,如定义一个字段值0表示未播放,1表示播放,当用户单击播放后可设置改字段的值为1。
  • 一条消息只能添加一个声音元素,添加多个声音元素时,发送消息可能失败。

CustomElem

自定义元素。

JSON 键 值类型 属性 含义
kTIMCustomElemData string 读写 数据,支持二进制数据
kTIMCustomElemDesc string 读写 自定义描述
kTIMCustomElemExt string 读写 后台推送对应的 ext 字段
kTIMCustomElemSound string 读写 自定义声音
说明:

自定义消息是指当内置的消息类型无法满足特殊需求,开发者可以自定义消息格式,内容全部由开发者定义,IM SDK 只负责透传。

FileElem

文件元素。

JSON 键 值类型 属性 含义
kTIMFileElemFilePath string 读写(必填) 文件所在路径(包含文件名)
kTIMFileElemFileName string 读写(必填) 文件名,显示的名称。不设置该参数时,kTIMFileElemFileName 默认为 kTIMFileElemFilePath 指定的文件路径中的文件名
kTIMFileElemFileSize int 读写(必填) 文件大小
kTIMFileElemFileId string 只读 下载视频时的 UUID
kTIMFileElemBusinessId int 只读 下载时用到的 businessID
kTIMFileElemDownloadFlag int 只读 文件下载 flag
kTIMFileElemUrl string 只读 文件下载的 URL
kTIMFileElemTaskId int 只读 任务 ID
说明:

一条消息只能添加一个文件元素,添加多个文件时,发送消息可能失败。

VideoElem

视频元素。

JSON 键 值类型 属性 含义
kTIMVideoElemVideoType string 读写(必填) 视频文件类型,发送消息时进行设置
kTIMVideoElemVideoSize uint 读写(必填) 视频文件大小
kTIMVideoElemVideoDuration uint 读写(必填) 视频时长,发送消息时进行设置
kTIMVideoElemVideoPath string 读写(必填) 适配文件路径
kTIMVideoElemVideoId string 只读 下载视频时的 UUID
kTIMVideoElemBusinessId int 只读 下载时用到的 businessID
kTIMVideoElemVideoDownloadFlag int 只读 视频文件下载 flag
kTIMVideoElemVideoUrl string 只读 视频文件下载的 URL
kTIMVideoElemImageType string 读写(必填) 截图文件类型,发送消息时进行设置
kTIMVideoElemImageSize uint 读写(必填) 截图文件大小
kTIMVideoElemImageWidth uint 读写(必填) 截图高度,发送消息时进行设置
kTIMVideoElemImageHeight uint 读写(必填) 截图宽度,发送消息时进行设置
kTIMVideoElemImagePath string 读写(必填) 保存截图的路径
kTIMVideoElemImageId string 只读 下载视频截图时的 ID
kTIMVideoElemImageDownloadFlag int 只读 截图文件下载 flag
kTIMVideoElemImageUrl string 只读 截图文件下载的 URL
kTIMVideoElemTaskId uint 只读 任务 ID

TIMGroupTipGroupChangeFlag

群组信息修改的类型。

名称 含义
kTIMGroupTipChangeFlag_Unknown 未知的修改
kTIMGroupTipChangeFlag_Name 修改群组名称
kTIMGroupTipChangeFlag_Introduction 修改群简介
kTIMGroupTipChangeFlag_Notification 修改群公告
kTIMGroupTipChangeFlag_FaceUrl 修改群头像 URL
kTIMGroupTipChangeFlag_Owner 修改群所有者
kTIMGroupTipChangeFlag_Custom 修改群自定义信息

GroupTipGroupChangeInfo

群组系统消息-群组信息修改。

JSON 键 值类型 属性 含义
kTIMGroupTipGroupChangeInfoFlag uint TIMGroupTipGroupChangeFlag 只读 群消息修改群信息标志
kTIMGroupTipGroupChangeInfoValue string 只读 修改的后值,不同的info_flag字段,具有不同的含义
kTIMGroupTipGroupChangeInfoKey string 只读 自定义信息对应的key值,只有info_flagkTIMGroupTipChangeFlag_Custom时有效

GroupTipMemberChangeInfo

群组系统消息-群组成员禁言。

JSON 键 值类型 属性 含义
kTIMGroupTipMemberChangeInfoIdentifier string 只读 群组成员 ID
kTIMGroupTipMemberChangeInfoShutupTime uint 只读 禁言时间

TIMGroupTipType

群组系统消息类型。

名称 含义
kTIMGroupTip_None 无效的群提示
kTIMGroupTip_Invite 邀请加入提示
kTIMGroupTip_Quit 退群提示
kTIMGroupTip_Kick 踢人提示
kTIMGroupTip_SetAdmin 设置管理员提示
kTIMGroupTip_CancelAdmin 取消管理员提示
kTIMGroupTip_GroupInfoChange 群信息修改提示
kTIMGroupTip_MemberInfoChange 群成员信息修改提示

GroupTipsElem

群组系统消息元素(针对所有群成员)。

JSON 键 值类型 属性 含义
kTIMGroupTipsElemTipType uint TIMGroupTipType 只读 群消息类型
kTIMGroupTipsElemOpUser string 只读 操作者 ID
kTIMGroupTipsElemGroupName string 只读 群组名称
kTIMGroupTipsElemGroupId string 只读 群组 ID
kTIMGroupTipsElemTime uint 只读 群消息时间
kTIMGroupTipsElemUserArray array string 只读 被操作的帐号列表
kTIMGroupTipsElemGroupChangeInfoArray array GroupTipGroupChangeInfo 只读 群资料变更信息列表,仅当tips_type值为kTIMGroupTip_GroupInfoChange时有效
kTIMGroupTipsElemMemberChangeInfoArray array GroupTipMemberChangeInfo 只读 群成员变更信息列表,仅当tips_type值为kTIMGroupTip_MemberInfoChange时有效
kTIMGroupTipsElemOpUserInfo object UserProfile 只读 操作者个人资料
kTIMGroupTipsElemOpGroupMemberInfo object GroupMemberInfo 只读 群成员信息
kTIMGroupTipsElemChangedUserInfoArray array UserProfile 只读 被操作者列表资料
kTIMGroupTipsElemChangedGroupMemberInfoArray array GroupMemberInfo 只读 群成员信息列表
kTIMGroupTipsElemMemberNum uint 只读 当前群成员数,只有当事件消息类型为kTIMGroupTip_InvitekTIMGroupTip_QuitkTIMGroupTip_Kick时有效
kTIMGroupTipsElemPlatform string 只读 操作方平台信息

TIMGroupReportType

群组系统通知类型。

名称 含义
kTIMGroupReport_None 未知类型
kTIMGroupReport_AddRequest 申请加群(只有管理员会接收到)
kTIMGroupReport_AddAccept 申请加群被同意(只有申请人自己接收到)
kTIMGroupReport_AddRefuse 申请加群被拒绝(只有申请人自己接收到)
kTIMGroupReport_BeKicked 被管理员踢出群(只有被踢者接收到)
kTIMGroupReport_Delete 群被解散(全员接收)
kTIMGroupReport_Create 创建群(创建者接收,不展示)
kTIMGroupReport_Invite 邀请加群(被邀请者接收)
kTIMGroupReport_Quit 主动退群(主动退出者接收,不展示)
kTIMGroupReport_GrantAdmin 设置管理员(被设置者接收)
kTIMGroupReport_CancelAdmin 取消管理员(被取消者接收)
kTIMGroupReport_RevokeAdmin 群已被回收(全员接收,不展示)
kTIMGroupReport_InviteReq 邀请加群(只有被邀请者会接收到)
kTIMGroupReport_InviteAccept 邀请加群被同意(只有发出邀请者会接收到)
kTIMGroupReport_InviteRefuse 邀请加群被拒绝(只有发出邀请者会接收到)
kTIMGroupReport_ReadReport 已读上报多终端同步通知(只有上报人自己收到)
kTIMGroupReport_UserDefine 用户自定义通知(默认全员接收)

GroupReportElem

群组系统通知元素(针对个人)。

JSON 键 值类型 属性 含义
kTIMGroupReportElemReportType uint TIMGroupReportType 只读 类型
kTIMGroupReportElemGroupId string 只读 群组 ID
kTIMGroupReportElemGroupName string 只读 群组名称
kTIMGroupReportElemOpUser string 只读 操作者 ID
kTIMGroupReportElemMsg string 只读 操作理由
kTIMGroupReportElemUserData string 只读 操作者填的自定义数据
kTIMGroupReportElemOpUserInfo object UserProfile 只读 操作者个人资料
kTIMGroupReportElemOpGroupMemberInfo object GroupMemberInfo 只读 操作者群内资料
kTIMGroupReportElemPlatform string 只读 操作方平台信息

TIMProfileChangeType

名称 含义
kTIMProfileChange_None 未知类型
kTIMProfileChange_Profile 资料修改

ProfileChangeElem

JSON 键 值类型 属性 含义
kTIMProfileChangeElemChangeType uint TIMProfileChangeType 只读 资料变更类型
kTIMProfileChangeElemFromIndentifier string 只读 资料变更用户的 UserID
kTIMProfileChangeElemUserProfileItem object UserProfileItem 只读 具体的变更信息,只有当change_typekTIMProfileChange_Profile时有效

TIMFriendChangeType

名称 含义
kTIMFriendChange_None 未知类型
kTIMFriendChange_FriendAdd 好友表增加
kTIMFriendChange_FriendDel 好友表删除
kTIMFriendChange_PendencyAdd 未决增加
kTIMFriendChange_PendencyDel 未决删除
kTIMFriendChange_BlackListAdd 黑名单添加
kTIMFriendChange_BlackListDel 黑名单删除
kTIMFriendChange_PendencyReadedReport 未决已读上报
kTIMFriendChange_FriendProfileUpdate 好友数据更新
kTIMFriendChange_FriendGroupAdd 分组增加
kTIMFriendChange_FriendGroupDel 分组删除
kTIMFriendChange_FriendGroupModify 分组修改

FriendProfileUpdate

JSON 键 值类型 属性 含义
kTIMFriendProfileUpdateIdentifier string 只写 资料更新的好友的 UserID
kTIMFriendProfileUpdateItem object FriendProfileItem 只写 资料更新的 Item

FriendChangeElem

JSON 键 值类型 属性 含义
kTIMFriendChangeElemChangeType uint TIMFriendChangeType 只读 资料变更类型
kTIMFriendChangeElemFriendAddIdentifierArray array string 只读 新增的好友 UserID 列表,只有当change_typekTIMFriendChange_FriendAdd时有效
kTIMFriendChangeElemFriendDelIdentifierArray array string 只读 删除的好友 UserID 列表,只有当change_typekTIMFriendChange_FriendDel时有效
kTIMFriendChangeElemFriendAddPendencyItemArray array FriendAddPendency 只读 好友添加未决信息列表,只有当change_typekTIMFriendChange_PendencyAdd时有效
kTIMFriendChangeElemPendencyDelIdentifierArray array string 只读 好友未决信息删除列表,只有当change_typekTIMFriendChange_PendencyDel时有效
kTIMFriendChangeElemPendencyReadedReportTimestamp uint64 只读 未决已读上报时间戳,只有当change_typekTIMFriendChange_PendencyReadedReport时有效
kTIMFriendChangeElemBlackListAddIdentifierArray array string 只读 新增的黑名单 UserID 列表,只有当change_typekTIMFriendChange_BlackListAdd时有效
kTIMFriendChangeElemBlackListDelIdentifierArray array string 只读 删除的黑名单 UserID 列表,只有当change_typekTIMFriendChange_BlackListDel时有效
kTIMFriendChangeElemFreindProfileUpdateItemArray array FriendProfileUpdate 只读 好友资料更新列表,只有当change_typekTIMFriendChange_FriendProfileUpdate时有效
kTIMFriendChangeElemFriendGroupAddIdentifierArray array string 只读 新增的好友分组名称列表,只有当change_typekTIMFriendChange_FriendGroupAdd时有效
kTIMFriendChangeElemFriendGroupDelIdentifierArray array string 只读 删除的好友分组名称列表,只有当change_typekTIMFriendChange_FriendGroupDel时有效
kTIMFriendChangeElemFriendGroupModifyIdentifierArray array string 只读 修改的好友分组名称列表,只有当change_typekTIMFriendChange_FriendGroupModify时有效

MsgBatchSendParam

消息群发接口的参数。

JSON 键 值类型 属性 含义
kTIMMsgBatchSendParamIdentifierArray array string 只写(必填) 群发的 ID 列表
kTIMMsgBatchSendParamMsg object Message 只写(必填) 群发的消息

MsgBatchSendResult

消息群发接口的返回。

JSON 键 值类型 属性 含义
kTIMMsgBatchSendResultIdentifier string 只读 群发的单个 ID
kTIMMsgBatchSendResultCode int 错误码 只读 消息发送结果
kTIMMsgBatchSendResultDesc string 只读 消息发送的描述
kTIMMsgBatchSendResultMsg object Message 只读 发送的消息

MsgLocator

消息定位符。

JSON 键 值类型 属性 含义
kTIMMsgLocatorConvId bool 读写 要查找的消息所属的会话 ID
kTIMMsgLocatorConvType bool 读写 要查找的消息所属的会话类型
kTIMMsgLocatorIsRevoked bool 读写(必填) 要查找的消息是否是被撤回。true 表示被撤回的,false 表示未撤回的。默认为 false
kTIMMsgLocatorTime uint64 读写(必填) 要查找的消息的时间戳
kTIMMsgLocatorSeq uint64 读写(必填) 要查找的消息的序列号
kTIMMsgLocatorIsSelf bool 读写(必填) 要查找的消息的发送者是否是自己。true 表示发送者是自己,false 表示发送者不是自己。默认为 false
kTIMMsgLocatorRand uint64 读写(必填) 要查找的消息随机码
kTIMMsgLocatorUniqueId uint64 读写(必填) 要查找的消息的唯一标识

MsgGetMsgListParam

消息获取接口的参数。

JSON 键 值类型 属性 含义
kTIMMsgGetMsgListParamLastMsg object Message 只写(选填) 指定的消息,不允许为 null
kTIMMsgGetMsgListParamCount uint 只写(选填) 从指定消息往后的消息数
kTIMMsgGetMsgListParamIsRamble bool 只写(选填) 是否漫游消息
kTIMMsgGetMsgListParamIsForward bool 只写(选填) 是否向前排序

MsgDeleteParam

消息删除接口的参数。

JSON 键 值类型 属性 含义
kTIMMsgDeleteParamMsg object Message 只写(选填) 指定在会话中要删除的消息
kTIMMsgDeleteParamIsRamble bool 只写(选填) 是否删除本地/漫游所有消息。true 删除漫游消息,false 删除本地消息,默认值 false

TIMDownloadType

UUID 类型。

名称 含义
kTIMDownload_VideoThumb 视频缩略图
kTIMDownload_File 文件
kTIMDownload_Video 视频
kTIMDownload_Sound 声音

DownloadElemParam

下载元素接口的参数。

JSON 键 值类型 属性 含义
kTIMMsgDownloadElemParamFlag uint 只写 从消息元素里面取出来,元素的下载类型
kTIMMsgDownloadElemParamType uint TIMDownloadType 只写 从消息元素里面取出来,元素的类型
kTIMMsgDownloadElemParamId string 只写 从消息元素里面取出来,元素的 ID
kTIMMsgDownloadElemParamBusinessId uint 只写 从消息元素里面取出来,元素的 BusinessID
kTIMMsgDownloadElemParamUrl string 只写 从消息元素里面取出来,元素 URL

MsgDownloadElemResult

下载元素接口的返回。

JSON 键 值类型 属性 含义
kTIMMsgDownloadElemResultCurrentSize uint 只读 当前已下载的大小
kTIMMsgDownloadElemResultTotalSize uint 只读 需要下载的文件总大小

会话关键类型

会话相关宏定义,以及相关结构成员存取 JSON Key 定义。

Draft

草稿信息。

JSON 键 值类型 属性 含义
kTIMDraftMsg object Message 只读 草稿内的消息
kTIMDraftUserDefine string 只读 用户自定义数据
kTIMDraftEditTime uint 只读 草稿最新编辑时间

ConvInfo

会话信息。

JSON 键 值类型 属性 含义
kTIMConvId string 只读 会话 ID
kTIMConvType uint TIMConvType 只读 会话类型
kTIMConvOwner string 只读 会话所有者
kTIMConvUnReadNum uint64 只读 会话未读计数
kTIMConvActiveTime uint64 只读 会话的激活时间
kTIMConvIsHasLastMsg bool 只读 会话是否有最后一条消息
kTIMConvLastMsg object Message 只读 会话最后一条消息
kTIMConvIsHasDraft bool 只读 会话是否有草稿
kTIMConvDraft object Draft 只读(选填) 会话草稿

群组关键类型

群组相关宏定义,以及相关结构成员存取 JSON Key 定义。

TIMGroupAddOption

群组加群选项。

名称 含义
kTIMGroupAddOpt_Forbid 禁止加群
kTIMGroupAddOpt_Auth 需要管理员审批
kTIMGroupAddOpt_Any 任何人都可以加群

TIMGroupType

群组类型。

名称 含义
kTIMGroup_Public 公开群
kTIMGroup_Private 私有群
kTIMGroup_ChatRoom 聊天室
kTIMGroup_BChatRoom 在线成员广播大群
kTIMGroup_AVChatRoom 互动直播聊天室

TIMGroupMemberRole

群组成员角色类型。

名称 含义
kTIMMemberRole_None 未定义
kTIMMemberRole_Normal 群成员
kTIMMemberRole_Admin 管理员
kTIMMemberRole_Owner 超级管理员(群主)

GroupMemberInfoCustemString

JSON 键 值类型 属性 含义
kTIMGroupMemberInfoCustemStringInfoKey string 只写 自定义字段的 key
kTIMGroupMemberInfoCustemStringInfoValue string 只写 自定义字段的 value

GroupMemberInfo

群组成员信息。

JSON 键 值类型 属性 含义
kTIMGroupMemberInfoIdentifier string 读写(必填) 群组成员 ID
kTIMGroupMemberInfoJoinTime uint 只读 群组成员加入时间
kTIMGroupMemberInfoMemberRole uint TIMGroupMemberRole 读写(选填) 群组成员角色
kTIMGroupMemberInfoMsgFlag uint 只读 成员接收消息的选项
kTIMGroupMemberInfoMsgSeq uint 只读 -
kTIMGroupMemberInfoShutupTime uint 只读 成员禁言时间
kTIMGroupMemberInfoNameCard string 只读 成员群名片
kTIMGroupMemberInfoCustomInfo array GroupMemberInfoCustemString 只读 请参考 自定义字段

GroupInfoCustemString

JSON 键 值类型 属性 含义
kTIMGroupInfoCustemStringInfoKey string 只写 自定义字段的 key
kTIMGroupInfoCustemStringInfoValue string 只写 自定义字段的 value

CreateGroupParam

创建群组接口的参数。

JSON 键 值类型 属性 含义
kTIMCreateGroupParamGroupName string 只写(必填) 群组名称
kTIMCreateGroupParamGroupId string 只写(选填) 群组 ID,不填时创建成功回调会返回一个后台分配的群 ID
kTIMCreateGroupParamGroupType uint TIMGroupType 只写(选填) 群组类型,默认为 Public
kTIMCreateGroupParamGroupMemberArray array GroupMemberInfo 只写(选填) 群组初始成员数组
kTIMCreateGroupParamNotification string 只写(选填) 群组公告
kTIMCreateGroupParamIntroduction string 只写(选填) 群组简介
kTIMCreateGroupParamFaceUrl string 只写(选填) 群组头像 URL
kTIMCreateGroupParamAddOption uint TIMGroupAddOption 只写(选填) 加群选项,默认为 Any
kTIMCreateGroupParamMaxMemberCount uint 只写(选填) 群组最大成员数
kTIMCreateGroupParamCustomInfo array GroupInfoCustemString 只读(选填) 请参考 自定义字段

CreateGroupResult

创建群组接口的返回。

JSON 键 值类型 属性 含义
kTIMCreateGroupResultGroupId string 只读 创建的群 ID

GroupInviteMemberParam

邀请成员接口的参数。

JSON 键 值类型 属性 含义
kTIMGroupInviteMemberParamGroupId string 只写(必填) 群组 ID
kTIMGroupInviteMemberParamIdentifierArray array string 只写(必填) 被邀请加入群组用户 ID 数组
kTIMGroupInviteMemberParamUserData string 只写(选填) 用于自定义数据

HandleGroupMemberResult

群组基础信息。

名称 含义
kTIMGroupMember_HandledErr 失败
kTIMGroupMember_HandledSuc 成功
kTIMGroupMember_Included 已是群成员
kTIMGroupMember_Invited 已发送邀请

GroupInviteMemberResult

邀请成员接口的返回。

JSON 键 值类型 属性 含义
kTIMGroupInviteMemberResultIdentifier string 只读 被邀请加入群组的用户 ID
kTIMGroupInviteMemberResultResult uint HandleGroupMemberResult 只读 邀请结果

GroupDeleteMemberParam

删除成员接口的参数。

JSON 键 值类型 属性 含义
kTIMGroupDeleteMemberParamGroupId string 只写(必填) 群组 ID
kTIMGroupDeleteMemberParamIdentifierArray array string 只写(必填) 被删除群组成员数组
kTIMGroupDeleteMemberParamUserData string 只写(选填) 用于自定义数据

GroupDeleteMemberResult

删除成员接口的返回。

JSON 键 值类型 属性 含义
kTIMGroupDeleteMemberResultIdentifier string 只读 删除的成员 ID
kTIMGroupDeleteMemberResultResult uint HandleGroupMemberResult 只读 删除结果

TIMGroupReceiveMessageOpt

群组消息接收选项。

名称 含义
kTIMRecvGroupMsgOpt_ReceiveAndNotify 接收群消息并提示
kTIMRecvGroupMsgOpt_NotReceive 不接收群消息,服务器不会进行转发
kTIMRecvGroupMsgOpt_ReceiveNotNotify 接收群消息,不提示

GroupSelfInfo

群组内本人的信息。

JSON 键 值类型 属性 含义
kTIMGroupSelfInfoJoinTime uint 只读 加入群组时间
kTIMGroupSelfInfoRole uint 只读 用户在群组中的角色
kTIMGroupSelfInfoUnReadNum uint 只读 消息未读计数
kTIMGroupSelfInfoMsgFlag uint TIMGroupReceiveMessageOpt 只读 群消息接收选项

GroupBaseInfo

获取已加入群组列表接口的返回(群组基础信息)。

JSON 键 值类型 属性 含义
kTIMGroupBaseInfoGroupId string 只读 群组 ID
kTIMGroupBaseInfoGroupName string 只读 群组名称
kTIMGroupBaseInfoGroupType uint TIMGroupType 只读 群组类型
kTIMGroupBaseInfoFaceUrl string 只读 群组头像 URL
kTIMGroupBaseInfoInfoSeq uint 只读 群资料的 Seq,群资料的每次变更都会增加这个字段的值
kTIMGroupBaseInfoLastestSeq uint 只读 群最新消息的 Seq。群组内每一条消息都有一条唯一的消息 Seq,且该 Seq 是按照发消息顺序而连续的。从1开始,群内每增加一条消息,LastestSeq 就会增加1
kTIMGroupBaseInfoReadedSeq uint 只读 用户所在群已读的消息 Seq
kTIMGroupBaseInfoMsgFlag uint 只读 消息接收选项
kTIMGroupBaseInfoIsShutupAll bool 只读 当前群组是否设置了全员禁言
kTIMGroupBaseInfoSelfInfo object GroupSelfInfo 只读 用户所在群的个人信息

GroupDetailInfo

群组详细信息。

JSON 键 值类型 属性 含义
kTIMGroupDetialInfoGroupId string 只读 群组 ID
kTIMGroupDetialInfoGroupType uint TIMGroupType 只读 群组类型
kTIMGroupDetialInfoGroupName string 只读 群组名称
kTIMGroupDetialInfoNotification string 只读 群组公告
kTIMGroupDetialInfoIntroduction string 只读 群组简介
kTIMGroupDetialInfoFaceUrl string 只读 群组头像 URL
kTIMGroupDetialInfoCreateTime uint 只读 群组创建时间
kTIMGroupDetialInfoInfoSeq uint 只读 群资料的 Seq,群资料的每次变更都会增加这个字段的值
kTIMGroupDetialInfoLastInfoTime uint 只读 群组信息最后修改时间
kTIMGroupDetialInfoNextMsgSeq uint 只读 群最新消息的 Seq
kTIMGroupDetialInfoLastMsgTime uint 只读 最新群组消息时间
kTIMGroupDetialInfoMemberNum uint 只读 群组当前成员数量
kTIMGroupDetialInfoMaxMemberNum uint 只读 群组最大成员数量
kTIMGroupDetialInfoAddOption uint TIMGroupAddOption 只读 群组加群选项
kTIMGroupDetialInfoOnlineMemberNum uint 只读 群组在线成员数量
kTIMGroupDetialInfoVisible uint 只读 群组成员是否对外可见
kTIMGroupDetialInfoSearchable uint 只读 群组是否能被搜索
kTIMGroupDetialInfoIsShutupAll bool 只读 群组是否被设置了全员禁言
kTIMGroupDetialInfoOwnerIdentifier string 只读 群组所有者 ID
kTIMGroupDetialInfoCustomInfo array GroupInfoCustemString 只读 请参考 自定义字段

GetGroupInfoResult

获取群组信息列表接口的返回。

JSON 键 值类型 属性 含义
kTIMGetGroupInfoResultCode int 错误码 只读 获取群组详细信息的结果
kTIMGetGroupInfoResultDesc string 只读 获取群组详细失败的描述信息
kTIMGetGroupInfoResultInfo object GroupDetailInfo 只读 群组详细信息

TIMGroupModifyInfoFlag

设置(修改)群组信息的类型。

名称 含义
kTIMGroupModifyInfoFlag_None -
kTIMGroupModifyInfoFlag_Name 修改群组名称
kTIMGroupModifyInfoFlag_Notification 修改群公告
kTIMGroupModifyInfoFlag_Introduction 修改群简介
kTIMGroupModifyInfoFlag_FaceUrl 修改群头像 URL
kTIMGroupModifyInfoFlag_AddOption 修改群组添加选项
kTIMGroupModifyInfoFlag_MaxMmeberNum 修改群最大成员数
kTIMGroupModifyInfoFlag_Visible 修改群是否可见
kTIMGroupModifyInfoFlag_Searchable 修改群是否被搜索
kTIMGroupModifyInfoFlag_ShutupAll 修改群是否全体禁言
kTIMGroupModifyInfoFlag_Custom 修改群自定义信息
kTIMGroupModifyInfoFlag_Owner 修改群主

GroupModifyInfoParam

设置群信息接口的参数。

JSON 键 值类型 属性 含义
kTIMGroupModifyInfoParamGroupId string 只写(必填) 群组 ID
kTIMGroupModifyInfoParamModifyFlag uint TIMGroupModifyInfoFlag 只写(必填) 修改标识,可设置多个值按位或
kTIMGroupModifyInfoParamGroupName string 只写(选填) 修改群组名称,当modify_flag包含kTIMGroupModifyInfoFlag_Name时必填,其他情况不用填
kTIMGroupModifyInfoParamNotification string 只写(选填) 修改群公告,当modify_flag包含kTIMGroupModifyInfoFlag_Notification时必填,其他情况不用填
kTIMGroupModifyInfoParamIntroduction string 只写(选填) 修改群简介,当modify_flag包含kTIMGroupModifyInfoFlag_Introduction时必填,其他情况不用填
kTIMGroupModifyInfoParamFaceUrl string 只写(选填) 修改群头像 URL,当modify_flag包含kTIMGroupModifyInfoFlag_FaceUrl时必填,其他情况不用填
kTIMGroupModifyInfoParamAddOption uint 只写(选填) 修改群组添加选项,当modify_flag包含kTIMGroupModifyInfoFlag_AddOption时必填,其他情况不用填
kTIMGroupModifyInfoParamMaxMemberNum uint 只写(选填) 修改群最大成员数,当modify_flag包含kTIMGroupModifyInfoFlag_MaxMmeberNum时必填,其他情况不用填
kTIMGroupModifyInfoParamVisible uint 只写(选填) 修改群是否可见,当modify_flag包含kTIMGroupModifyInfoFlag_Visible时必填,其他情况不用填
kTIMGroupModifyInfoParamSearchAble uint 只写(选填) 修改群是否被搜索,当modify_flag包含kTIMGroupModifyInfoFlag_Searchable时必填,其他情况不用填
kTIMGroupModifyInfoParamIsShutupAll bool 只写(选填) 修改群是否全体禁言,当modify_flag包含kTIMGroupModifyInfoFlag_ShutupAll时必填,其他情况不用填
kTIMGroupModifyInfoParamOwner string 只写(选填) 修改群主所有者,当modify_flag包含kTIMGroupModifyInfoFlag_Owner时必填,其他情况不用填。此时modify_flag不能包含其他值,当修改群主时,同时修改其他信息已无意义
kTIMGroupModifyInfoParamCustomInfo array GroupInfoCustemString 只写(选填) 请参考 自定义字段

GroupGetMemberInfoListParam

获取群成员列表接口的参数。

JSON 键 值类型 属性 含义
kTIMGroupGetMemberInfoListParamGroupId string 只写(必填) 群组 ID
kTIMGroupGetMemberInfoListParamIdentifierArray array string 只写(选填) 群成员 ID 列表
kTIMGroupGetMemberInfoListParamOption object GroupMemberGetInfoOption 只写(选填) 获取群成员信息的选项
kTIMGroupGetMemberInfoListParamNextSeq uint64 只写(选填) 分页拉取标志,第一次拉取填0,回调成功如果不为零,需要分页,调用接口传入再次拉取,直至为0

GroupGetMemberInfoListResult

获取群成员列表接口的返回。

JSON 键 值类型 属性 含义
kTIMGroupGetMemberInfoListResultNexSeq uint64 只读 下一次拉取的标志,server 返回0表示没有更多的数据,否则在下次获取数据时填入这个标志
kTIMGroupGetMemberInfoListResultInfoArray array GroupMemberInfo 只读 成员信息列表

TIMGroupMemberModifyInfoFlag

设置(修改)群成员信息的类型。

名称 含义
kTIMGroupMemberModifyFlag_None -
kTIMGroupMemberModifyFlag_MsgFlag 修改消息接收选项
kTIMGroupMemberModifyFlag_MemberRole 修改成员角色
kTIMGroupMemberModifyFlag_ShutupTime 修改禁言时间
kTIMGroupMemberModifyFlag_NameCard 修改群名片
kTIMGroupMemberModifyFlag_Custom 修改群成员自定义信息

GroupModifyMemberInfoParam

设置群成员信息接口的参数。

JSON 键 值类型 属性 含义
kTIMGroupModifyMemberInfoParamGroupId string 只写(必填) 群组 ID
kTIMGroupModifyMemberInfoParamIdentifier string 只写(必填) 被设置信息的成员 ID
kTIMGroupModifyMemberInfoParamModifyFlag uint TIMGroupMemberModifyInfoFlag 只写(必填) 修改类型,可设置多个值按位或
kTIMGroupModifyMemberInfoParamMsgFlag uint 只写(选填) 修改消息接收选项,当modify_flag包含kTIMGroupMemberModifyFlag_MsgFlag时必填,其他情况不用填
kTIMGroupModifyMemberInfoParamMemberRole uint TIMGroupMemberRole 只写(选填) 修改成员角色,当modify_flag包含kTIMGroupMemberModifyFlag_MemberRole时必填,其他情况不用填
kTIMGroupModifyMemberInfoParamShutupTime uint 只写(选填) 修改禁言时间,当modify_flag包含kTIMGroupMemberModifyFlag_ShutupTime时必填,其他情况不用填
kTIMGroupModifyMemberInfoParamNameCard string 只写(选填) 修改群名片,当modify_flag包含kTIMGroupMemberModifyFlag_NameCard时必填,其他情况不用填
kTIMGroupModifyMemberInfoParamCustomInfo array GroupMemberInfoCustemString 只写(选填) 请参考 自定义字段

GroupPendencyOption

获取群未决信息列表的参数。

JSON 键 值类型 属性 含义
kTIMGroupPendencyOptionStartTime uint64 只写(必填) 设置拉取时间戳,第一次请求填0,后边根据 server 返回的 GroupPendencyResult 键 kTIMGroupPendencyResultNextStartTime 指定的时间戳进行填写
kTIMGroupPendencyOptionMaxLimited uint 只写(选填) 拉取的建议数量,server 可根据需要返回或多或少,不能作为完成与否的标志

TIMGroupPendencyType

未决请求类型。

名称 含义
kTIMGroupPendency_RequestJoin 请求加群
kTIMGroupPendency_InviteJoin 邀请加群
kTIMGroupPendency_ReqAndInvite 邀请和请求的

TIMGroupPendencyHandle

群未决处理状态。

名称 含义
kTIMGroupPendency_NotHandle 未处理
kTIMGroupPendency_OtherHandle 他人处理
kTIMGroupPendency_OperatorHandle 操作方处理

TIMGroupPendencyHandleResult

群未决处理操作类型。

名称 含义
kTIMGroupPendency_Refuse 拒绝
kTIMGroupPendency_Accept 同意

GroupPendency

群未决信息定义。

JSON 键 值类型 属性 含义
kTIMGroupPendencyGroupId string 读写 群组 ID
kTIMGroupPendencyFromIdentifier string 读写 请求者的 ID,例如:请求加群:请求者,邀请加群:邀请人
kTIMGroupPendencyToIdentifier string 读写 判决者的 ID,请求加群:"",邀请加群:被邀请人
kTIMGroupPendencyAddTime uint64 只读 未决信息添加时间
kTIMGroupPendencyPendencyType uint TIMGroupPendencyType 只读 未决请求类型
kTIMGroupPendencyHandled uint TIMGroupPendencyHandle 只读 群未决处理状态
kTIMGroupPendencyHandleResult uint TIMGroupPendencyHandleResult 只读 群未决处理操作类型
kTIMGroupPendencyApplyInviteMsg string 只读 申请或邀请附加信息
kTIMGroupPendencyFromUserDefinedData string 只读 申请或邀请者自定义字段
kTIMGroupPendencyApprovalMsg string 只读 审批信息:同意或拒绝信息
kTIMGroupPendencyToUserDefinedData string 只读 审批者自定义字段
kTIMGroupPendencyKey string 只读 签名信息,客户不用关心
kTIMGroupPendencyAuthentication string 只读 签名信息,客户不用关心
kTIMGroupPendencySelfIdentifier string 只读 自己的 ID

GroupPendencyResult

获取群未决信息列表的返回。

JSON 键 值类型 属性 含义
kTIMGroupPendencyResultNextStartTime uint64 只读 下一次拉取的起始时戳,server 返回0表示没有更多的数据,否则在下次获取数据时以这个时间戳作为开始时间戳
kTIMGroupPendencyResultReadTimeSeq uint64 只读 已读上报的时间戳
kTIMGroupPendencyResultUnReadNum uint 只读 未决请求的未读数
kTIMGroupPendencyResultPendencyArray array GroupPendency 只读 群未决信息列表

GroupHandlePendencyParam

处理群未决消息接口的参数。

JSON 键 值类型 属性 含义
kTIMGroupHandlePendencyParamIsAccept bool 只写(选填) true 表示接受,false 表示拒绝。默认为 false
kTIMGroupHandlePendencyParamHandleMsg string 只写(选填) 同意或拒绝信息,默认为空字符串
kTIMGroupHandlePendencyParamPendency object GroupPendency 只写(必填) 未决信息详情

关系链和资料关键类型

关系链和资料相关宏定义,以及相关结构成员存取 JSON Key 定义。

FriendShipGetProfileListParam

处理群未决消息接口的参数。

JSON 键 值类型 属性 含义
kTIMFriendShipGetProfileListParamIdentifierArray array string 只写 想要获取目标用户资料的 UserID 列表
kTIMFriendShipGetProfileListParamForceUpdate bool 只写 是否强制更新。false 表示优先从本地缓存获取,获取不到则去网络上拉取。true 表示直接去网络上拉取资料。默认为 false

TIMGenderType

用户性别类型。

名称 含义
kTIMGenderType_Unkown 未知性别
kTIMGenderType_Male 性别男
kTIMGenderType_Female 性别女

TIMProfileAddPermission

用户加好友的选项。

名称 含义
kTIMProfileAddPermission_Unknown 未知
kTIMProfileAddPermission_AllowAny 允许任何人添加好友
kTIMProfileAddPermission_NeedConfirm 添加好友需要验证
kTIMProfileAddPermission_DenyAny 拒绝任何人添加好友

UserProfileCustemStringInfo

用户自定义资料字段,字符串。

JSON 键 值类型 属性 含义
kTIMUserProfileCustemStringInfoKey string 只写 用户自定义资料字段的 key 值(包含前缀 Tag_Profile_Custom_)
kTIMUserProfileCustemStringInfoValue string 只写 该字段对应的字符串值
说明:

字符串长度不得超过500字节。

UserProfile

JSON 键 值类型 属性 含义
kTIMUserProfileIdentifier string 只读 用户 ID
kTIMUserProfileNickName string 只读 用户的昵称
kTIMUserProfileGender uint TIMGenderType 只读 性别
kTIMUserProfileFaceUrl string 只读 用户头像 URL
kTIMUserProfileSelfSignature string 只读 用户个人签名
kTIMUserProfileAddPermission uint TIMProfileAddPermission 只读 用户加好友的选项
kTIMUserProfileLocation string 只读 用户位置信息
kTIMUserProfileLanguage uint 只读 语言
kTIMUserProfileBirthDay uint 只读 生日
kTIMUserProfileLevel uint 只读 等级
kTIMUserProfileRole uint 只读 角色
kTIMUserProfileCustomStringArray array UserProfileCustemStringInfo 只读 请参考 自定义资料字段

UserProfileItem

JSON 键 值类型 属性 含义
kTIMUserProfileItemNickName string 只写 修改用户昵称
kTIMUserProfileItemGender uint TIMGenderType 只写 修改用户性别
kTIMUserProfileItemFaceUrl string 只写 修改用户头像
kTIMUserProfileItemSelfSignature string 只写 修改用户签名
kTIMUserProfileItemAddPermission uint TIMProfileAddPermission 只写 修改用户加好友的选项
kTIMUserProfileItemLoaction uint 只写 修改位置
kTIMUserProfileItemLanguage uint 只写 修改语言
kTIMUserProfileItemBirthDay uint 只写 修改生日
kTIMUserProfileItemLevel uint 只写 修改等级
kTIMUserProfileItemRole uint 只写 修改角色
kTIMUserProfileItemCustomStringArray array UserProfileCustemStringInfo 只写 修改 自定义资料字段

FriendProfileCustemStringInfo

JSON 键 值类型 属性 含义
kTIMFriendProfileCustemStringInfoKey string 只写 好友自定义资料字段 key
kTIMFriendProfileCustemStringInfoValue string 只写 好友自定义资料字段 value

FriendProfile

好友资料。

JSON 键 值类型 属性 含义
kTIMFriendProfileIdentifier string 只读 好友 UserID
kTIMFriendProfileGroupNameArray array string 只读 好友分组名称列表
kTIMFriendProfileRemark string 只读 好友备注,最大96字节,获取自己资料时,该字段为空
kTIMFriendProfileAddWording string 只读 好友申请时的添加理由
kTIMFriendProfileAddSource string 只读 好友申请时的添加来源
kTIMFriendProfileAddTime uint64 只读 好友添加时间
kTIMFriendProfileUserProfile object UserProfile 只读 好友的个人资料
kTIMFriendProfileCustomStringArray array FriendProfileCustemStringInfo 只读 [自定义好友字段](https://cloud.tencent.com/document/pr
目录