Tencent Cloud

Web

最后更新时间：2023-08-04 14:55:28

消息类介绍
IM SDK 中 Message 表示消息对象，用于描述一条消息具有的属性，如类型、消息的内容、所属的会话 ID 等。
属性
类型
默认值
说明
ID
String
-
消息 ID。其拼接规则为 ${senderTinyID}-${clientTime}-${random}，与 NativeIM 消息的 ID 拼接规则一致。
type
String
-
消息类型，具体如下：
TencentCloudChat.TYPES.MSG_TEXT：文本消息
TencentCloudChat.TYPES.MSG_IMAGE：图片消息
TencentCloudChat.TYPES.MSG_AUDIO：音频消息
TencentCloudChat.TYPES.MSG_VIDEO：视频消息
TencentCloudChat.TYPES.MSG_FILE：文件消息
TencentCloudChat.TYPES.MSG_CUSTOM：自定义消息
TencentCloudChat.TYPES.MSG_MERGER：合并消息
TencentCloudChat.TYPES.MSG_LOCATION：位置消息
TencentCloudChat.TYPES.MSG_GRP_TIP：群提示消息
TencentCloudChat.TYPES.MSG_GRP_SYS_NOTICE：群系统通知消息
payload
Object
-
消息的内容，具体如下：
﻿文本﻿
﻿图片﻿
﻿音频﻿
﻿视频﻿
﻿文件﻿
﻿自定义﻿
﻿合并﻿
﻿地理位置﻿
﻿群提示消息﻿
﻿群系统通知﻿
conversationID
String
-
消息所属的会话 ID
conversationType
String
-
消息所属会话的类型，具体如下：
TencentCloudChat.TYPES.CONV_C2C：C2C(Client to Client, 端到端) 会话
TencentCloudChat.TYPES.CONV_GROUP：GROUP(群组) 会话
TencentCloudChat.TYPES.CONV_SYSTEM：SYSTEM(系统) 会话
to
String
-
接收方的 userID
from
String
-
发送方的 userID，在消息发送时，会默认设置为当前登录的用户
flow
String
-
消息的流向。
in：收到的消息
out：发出的消息
time
Number
-
消息时间戳。单位：秒
status
String
-
消息状态。
unSend：未发送
success：发送成功
fail：发送失败
isRevoked
Boolean
false
是否被撤回的消息，true 标识被撤回的消息
priority
String
TencentCloudChat.TYPES.MSG_PRIORITY_NORMAL
消息优先级，用于群聊
nick
String
''
消息发送者的昵称（需提前调用 updateMyProfile 设置）
avatar
String
''
消息发送者的头像地址（需提前调用 updateMyProfile 设置）
isPeerRead
Boolean
false
C2C 消息对端是否已读，true 标识对端已读
nameCard
String
''
非直播群消息发送者的群名片（也可称之为消息发送者的群昵称），需提前调用 setGroupMemberNameCard 设置
atUserList
Array
[]
群聊时此字段存储被 at 的群成员的 userID
cloudCustomData
String
''
消息自定义数据（云端保存，会发送到对端，程序卸载重装后还能拉取到）
isDeleted
Boolean
false
是否被删除的消息，true 标识被删除的消息
isModified
Boolean
false
是否被修改过的消息，true 标识被修改过的消息
needReadReceipt
Boolean
false
是否需要已读回执，true 标识需要（仅用于群消息，需要您购买旗舰版套餐）
readReceiptInfo
Object
{
  readCount,
  unreadCount,
  isPeerRead
}
消息已读回执信息
readCount：消息已读数，可通过调用 getMessageReadReceiptList 查询；如果想要查询哪些群成员已读了消息，可调用 getGroupMessageReadMemberList﻿
unreadCount：消息未读数，可通过调用 getMessageReadReceiptList 查询
isPeerRead: C2C 消息对端是否已发送已读回执，消息接收方调用
sendMessageReadReceipt 成功后，消息发送方收到已读回执通知或拉漫游时会更新此属
isBroadcastMessage
Boolean
false
对所有直播群广播消息，true 标识直播群广播消息（需要您购买旗舰版套餐）
isSupportExtension
Boolean
false
是否支持消息扩展，true 支持 false 不支持（需要您购买旗舰版套餐）
revoker
String | null
null
消息撤回者的 userID
﻿

tencent cloud

Recent Pages

Web

消息类介绍

本页内容是否解决了您的问题？

本页内容是否解决了您的问题？

属性	类型	默认值	说明
ID	String	-	消息 ID。其拼接规则为 `${senderTinyID}-${clientTime}-${random}`，与 NativeIM 消息的 ID 拼接规则一致。
type	String	-	消息类型，具体如下： `TencentCloudChat.TYPES.MSG_TEXT`：文本消息 `TencentCloudChat.TYPES.MSG_IMAGE`：图片消息 `TencentCloudChat.TYPES.MSG_AUDIO`：音频消息 `TencentCloudChat.TYPES.MSG_VIDEO`：视频消息 `TencentCloudChat.TYPES.MSG_FILE`：文件消息 `TencentCloudChat.TYPES.MSG_CUSTOM`：自定义消息 `TencentCloudChat.TYPES.MSG_MERGER`：合并消息 `TencentCloudChat.TYPES.MSG_LOCATION`：位置消息 `TencentCloudChat.TYPES.MSG_GRP_TIP`：群提示消息 `TencentCloudChat.TYPES.MSG_GRP_SYS_NOTICE`：群系统通知消息
payload	Object	-	消息的内容，具体如下：文本图片音频视频文件自定义合并地理位置群提示消息群系统通知
conversationID	String	-	消息所属的会话 ID
conversationType	String	-	消息所属会话的类型，具体如下： `TencentCloudChat.TYPES.CONV_C2C`：C2C(Client to Client, 端到端) 会话 `TencentCloudChat.TYPES.CONV_GROUP`：GROUP(群组) 会话 `TencentCloudChat.TYPES.CONV_SYSTEM`：SYSTEM(系统) 会话
to	String	-	接收方的 userID
from	String	-	发送方的 userID，在消息发送时，会默认设置为当前登录的用户
flow	String	-	消息的流向。 in：收到的消息 out：发出的消息
time	Number	-	消息时间戳。单位：秒
status	String	-	消息状态。 unSend：未发送 success：发送成功 fail：发送失败
isRevoked	Boolean	false	是否被撤回的消息，true 标识被撤回的消息
priority	String	`TencentCloudChat.TYPES.MSG_PRIORITY_NORMAL`	消息优先级，用于群聊
nick	String	''	消息发送者的昵称（需提前调用 updateMyProfile 设置）
avatar	String	''	消息发送者的头像地址（需提前调用 updateMyProfile 设置）
isPeerRead	Boolean	false	C2C 消息对端是否已读，true 标识对端已读
nameCard	String	''	非直播群消息发送者的群名片（也可称之为消息发送者的群昵称），需提前调用 setGroupMemberNameCard 设置
atUserList	Array	[]	群聊时此字段存储被 at 的群成员的 userID
cloudCustomData	String	''	消息自定义数据（云端保存，会发送到对端，程序卸载重装后还能拉取到）
isDeleted	Boolean	false	是否被删除的消息，true 标识被删除的消息
isModified	Boolean	false	是否被修改过的消息，true 标识被修改过的消息
needReadReceipt	Boolean	false	是否需要已读回执，true 标识需要（仅用于群消息，需要您购买旗舰版套餐）
readReceiptInfo	Object	`{` `readCount, unreadCount, isPeerRead }`	消息已读回执信息 readCount：消息已读数，可通过调用 getMessageReadReceiptList 查询；如果想要查询哪些群成员已读了消息，可调用 getGroupMessageReadMemberList unreadCount：消息未读数，可通过调用 getMessageReadReceiptList 查询 isPeerRead: C2C 消息对端是否已发送已读回执，消息接收方调用 sendMessageReadReceipt 成功后，消息发送方收到已读回执通知或拉漫游时会更新此属
isBroadcastMessage	Boolean	false	对所有直播群广播消息，true 标识直播群广播消息（需要您购买旗舰版套餐）
isSupportExtension	Boolean	false	是否支持消息扩展，true 支持 false 不支持（需要您购买旗舰版套餐）
revoker	String \| null	null	消息撤回者的 userID

tencent cloud

注册

登录

Recent Pages

Web

消息类介绍

本页内容是否解决了您的问题？

本页内容是否解决了您的问题？