Message

Message

消息对象，用于描述一条消息具有的属性，如类型、消息的内容、所属的会话 ID 等。

Properties:
Name Type Default Description
ID String

消息 ID
type String

消息类型，具体如下：

类型 含义
TIM.TYPES.MSG_TEXT 文本消息
TIM.TYPES.MSG_IMAGE 图片消息
TIM.TYPES.MSG_SOUND 音频消息（已废弃，请使用 TIM.TYPES.MSG_AUDIO ）
TIM.TYPES.MSG_AUDIO 音频消息
TIM.TYPES.MSG_VIDEO 视频消息
TIM.TYPES.MSG_FILE 文件消息
TIM.TYPES.MSG_CUSTOM 自定义消息
TIM.TYPES.MSG_GRP_TIP 群提示消息
TIM.TYPES.MSG_GRP_SYS_NOTICE 群系统通知消息
payload Object

消息的内容，具体如下：
conversationID String

消息所属的会话 ID
conversationType String

消息所属会话的类型，具体如下：

类型 含义
TIM.TYPES.CONV_C2C C2C(Client to Client, 端到端) 会话
TIM.TYPES.CONV_GROUP GROUP(群组) 会话
TIM.TYPES.CONV_SYSTEM SYSTEM(系统) 会话
to String

接收方的 userID
from String

发送方的 userID，在消息发送时，会默认设置为当前登录的用户
flow String

消息的流向

  • in 为收到的消息
  • out 为发出的消息
time Number

消息时间戳。单位：秒
status String

消息状态。

  • unSend(未发送)
  • success(发送成功)
  • fail(发送失败)
isRead Boolean false

是否已读
isResend Boolean false

是否为重发消息

Methods

getElements() → {Array}

SDK 内部访问 _elements 请调用此方法

Returns:
Type
Array

Type Definitions

TextPayload

Properties:
Name Type Description
text String

文本消息内容

文本消息的 content 结构

ImagePayload

Properties:
Name Type Description
uuid String

图片唯一标识
imageFormat String

图片格式类型
imageInfoArray Array.<Object>

图片信息

Properties
Name Type Description
width Number

宽度
height Number

高度
url String

图片地址，可用于渲染
size Number

图片大小，单位：Byte
sizeType Number

图片大小类型。值为 1 时表示原图，数值越大表示压缩比率越高。

图片消息的 content 结构

AudioPayload

Properties:
Name Type Description
uuid String

唯一标识
url String

音频地址，可用于播放
size Number

文件大小，单位：Byte
second Number

音频时长，单位：秒

音频消息的 content 结构

VideoPayload

Properties:
Name Type Description
videoFormat String

视频文件的格式
videoSecond Number

视频文件时长，单位：秒
videoSize Number

视频文件大小，单位：Byte
videoUrl String

视频文件的地址，可用于播放
thumbSize Number

缩略图大小，单位：Byte
thumbWidth Number

缩略图宽度
thumbHeight Number

缩略图高度
thumbUrl String

缩略图地址，可用于渲染

视频消息的 content 结构

FilePayload

Properties:
Name Type Description
uuid String

唯一标识
fileName String

文件名
fileUrl String

文件地址
fileSize Number

文件大小，单位：Byte

文件消息的 content 结构

CustomPayload

Properties:
Name Type Description
data String

自定义消息的 data 字段
description String

自定义消息的 description 字段
extension String

自定义消息的 extension 字段

自定义消息的 content 结构

GroupTipPayload

Properties:
Name Type Description
operatorID String

执行该操作的用户 ID
operationType Number

操作类型，具体如下:

操作类型 值 含义
TIM.TYPES.GRP_TIP_MBR_JOIN 1 有成员加群
TIM.TYPES.GRP_TIP_MBR_QUIT 2 有群成员退群
TIM.TYPES.GRP_TIP_MBR_KICKED_OUT 3 有群成员被踢出群
TIM.TYPES.GRP_TIP_MBR_SET_ADMIN 4 有群成员被设为管理员
TIM.TYPES.GRP_TIP_MBR_CANCELED_ADMIN 5 有群成员被撤销管理员
TIM.TYPES.GRP_TIP_GRP_PROFILE_UPDATED 6 群组资料变更
TIM.TYPES.GRP_TIP_MBR_PROFILE_UPDATED 7 群成员资料变更
userIDList Array.<String>

相关的 userID 列表
newGroupProfile Object

若是群资料变更，该字段存放变更的群资料

群提示消息的 content 结构。系统会在恰当的时机，向全体群成员发出群提示消息。例如：有群成员退群/进群，系统会给所有群成员发对应的群提示消息。

GroupSystemNoticePayload

Properties:
Name Type Description
operatorID String

执行该操作的用户 ID
operationType Number

操作类型，具体如下：

值 描述 接收对象
1 有用户申请加群 群管理员/群主接收
2 申请加群被同意 申请加群的用户接收
3 申请加群被拒绝 申请加群的用户接收
4 被踢出群组 被踢出的用户接收
5 群组被解散 全体群成员接收
6 创建群组 创建者接收
7 邀请加群 被邀请者接收
8 退群 退群者接收
9 设置管理员 被设置方接收
10 取消管理员 被取消方接收
255 用户自定义通知 默认全员接收
groupProfile Object

相关的群组资料
userDefinedField String

用户自定义字段。使用 RestAPI 发送自定义通知时，可在该属性值中拿到自定义通知的内容。
handleMessage Object

处理的附言。例如：user1 申请加入 group1 时，若进群需要验证，且 user1 填写了申请加群的附言。则 group1 的管理员会在相应群系统通知中看到该字段。

群系统通知的 content 结构。系统会在恰当的时机，向特定用户发出群系统通知。例如：user1 被踢出群组，系统会给 user1 发送对应的群系统消息。