动态与公告

产品动态

公告

产品简介

产品概述

基本概念

应用场景

功能介绍

账号系统

用户资料与关系链

消息管理

群组相关

公众号系统

音视频通话 Call

使用限制

购买指南

计费概述

价格说明

购买指引

续费指引

停服说明

退费说明

开发指引

Demo 专区

开通服务

体验 Demo

快速跑通

下载中心

SDK & Demo 源码

更新日志

聊天互动（含 UI）

TUIKit 组件介绍

快速开始

全功能接入

单功能接入

AI 集成

构建基础界面

更多特性

定义外观

国际化界面语言

推送服务（Push）

服务概述

名词解释

开通服务

快速跑通

厂商通道

数据统计

排查工具

客户端 API

服务端 API

推送回调

高级功能

更新日志

错误码

常见问题

智能客服

功能概述

快速入门

集成指引

管理员操作手册

客服操作手册

更多实践

直播间搭建

AI 聊天机器人方案

超大娱乐协作社群

Discord 实现指南

游戏内集成 Chat 指南

类 WhatsApp Channel 搭建方案

发送红包

Chat 应对防火墙限制相关

无 UI 集成

快速开始

集成 SDK

初始化

登录登出

消息相关

会话相关

群组相关

社群话题

用户管理

离线推送

云端搜索

本地搜索

公众号

客户端 API

JavaScript

Android

iOS & macOS

Swift

Flutter

Electron

Unity

React Native

C 接口

C++

服务端 API

生成 UserSig

REST API

第三方回调

控制台指南

新版控制台介绍

创建并升级应用

基本配置

功能配置

账号管理

群组管理

公众号管理

回调配置

用量统计

资源包查看指南

实时监控

开发辅助工具

访问管理

高级功能

常见问题

uni-app 常见问题

购买相关问题

SDK 相关问题

账号鉴权相关问题

用户资料与关系链相关问题

消息相关问题

群组相关问题

直播群相关问题

昵称头像相关问题

协议与认证

服务等级协议

安全合规认证

IM 政策

隐私政策

数据隐私和安全协议

平滑迁移方案

平滑迁移完整版

平滑迁移简化版

错误码

联系我们

Unity

PDF

聚焦模式

字号

最后更新时间： 2025-03-21 21:57:47

消息类介绍
在腾讯云 Chat SDK 中，消息类为 Message (点击查看详情) 。您在发送和接收消息过程中都会频繁地用到该类。
消息字段含义
字段
含义
message_elem_array
消息内元素列表
message_conv_id
消息所属会话 ID
message_conv_type
消息所属会话类型
message_sender
消息的发送者
message_priority
消息优先级
message_client_time
客户端时间
message_server_time
服务端时间
message_is_from_self
消息是否来自自己
message_platform
发送消息的平台
message_is_read
消息是否已读
message_is_online_msg
消息是否是在线消息，false 表示普通消息，true 表示在线消息，默认为 false
message_is_peer_read
消息是否被会话对方已读
message_need_read_receipt
消息是否需要已读回执（6.1 以上版本有效，需要您购买专业版、专业版Plus或企业版套餐），群消息在使用该功能之前，需要先到 Chat 控制台设置已读回执支持的群类型
message_status
消息当前状态
message_target_group_member_array
指定群消息接收成员（定向消息）；不支持群 @ 消息设置，不支持社群（Community）和直播群（AVChatRoom）消息设置；该字段设置后，消息会不计入会话未读数。
message_unique_id
消息的唯一标识，推荐使用 kTChatMsgMsgId
message_msg_id
消息的唯一标识
message_rand
消息的随机码
message_has_sent_receipt
是否已经发送了已读回执（只有Group 消息有效）
message_group_receipt_read_count
这个字段是内部字段，不推荐使用，推荐调用 TChatMsgGetMessageReadReceipts 获取群消息已读回执
message_group_receipt_unread_count
这个字段是内部字段，不推荐使用，推荐调用 TChatMsgGetMessageReadReceipts 获取群消息已读回执
message_seq
消息序列
message_custom_int
自定义整数值字段（本地保存，不会发送到对端，程序卸载重装后失效）
message_custom_str
自定义数据字段（本地保存，不会发送到对端，程序卸载重装后失效）
message_cloud_custom_str
消息自定义数据（云端保存，会发送到对端，程序卸载重装后还能拉取到）
message_is_excluded_from_unread_count
消息是否不计入未读计数：默认为 NO，表明需要计入未读计数，设置为 YES，表明不需要计入未读计数
message_is_forward_message
是否是转发消息
message_group_at_user_array
群消息中被 @ 的用户 UserID 列表（即该消息都 @ 了哪些人），如果需要 @ALL ，请传入 kImSDK_MesssageAtALL 字段
message_sender_profile
消息的发送者的用户资料
message_sender_group_member_info
消息发送者在群里面的信息，只有在群会话有效。目前仅能获取字段 kTChatGroupMemberInfoIdentifier、kTChatGroupMemberInfoNameCard 其他的字段建议通过 TChatGroupGetMemberInfoList 接口获取
message_offlie_push_config
消息的离线推送设置
message_excluded_from_last_message
是否作为会话的 lasgMessage，true - 不作为，false - 作为
消息分类
腾讯云 Chat 消息按照消息的发送目标可以分为：“单聊消息”（又称 “C2C 消息”）和“群聊消息” 两种：
消息分类
API 关键词
说明
单聊消息
C2CMessage
又称 C2C 消息，在发送时需要指定消息接收者的 UserID，只有接收者可以收到该消息
群聊消息
GroupMessage
在发送时需要指定目标群组的 groupID，该群中的所有用户均能收到消息
按照消息承载的内容可以分为：“文本消息”、“图片消息”、“视频消息”、“语音消息”、“文件消息”、“位置消息”、“合并消息”、“群 Tips 消息”等几种类型。
消息分类
API 关键词
说明
文本消息
kTChatElem_Text
即普通的文字消息
自定义消息
kTChatElem_Custom
即一段二进制 buffer，通常用于传输您应用中的自定义信令
图片消息
kTChatElem_Image
SDK 会在发送原始图片的同时，自动生成两种不同尺寸的缩略图，三张图分别被称为原图、大图、微缩图
视频消息
kTChatElem_Video
一条视频消息包含一个视频文件和一张配套的缩略图
语音消息
kTChatElem_Sound
支持语音是否播放红点展示
文件消息
kTChatElem_File
文件消息最大支持100MB
位置消息
kTChatElem_Location
地理位置消息由位置描述、经度（longitude ）和纬度（latitude）三个字段组成
合并消息
kTChatElem_Merge
最大支持 300 条消息合并
群 Tips 消息
kTChatElem_GroupTips
群 Tips 消息常被用于承载群中的系统性通知消息，例如有成员进出群组，群的描述信息被修改，群成员的资料发生变化等
消息存储策略
腾讯云 Chat 消息按照消息存储策略，可以分为两种消息：在线消息、非在线消息。
在线消息是指只有当用户在线时才能接收到，离线后不会通过离线推送下发给用户。非在线消息是指无论用户是否在线，都能收到的消息。
在线消息会实时下发，不会存储在服务端。SDK 也不会存储在线消息。所以换设备或卸载后重新安装 App 拉取历史消息都不能拉到此类消息。
说明：
1. 直播群所有的消息都属于在线消息。
2. 全员推送的消息都属于在线消息。
非在线消息会被 SDK 和服务端存储。漫游服务器默认存储 7 天的消息。如果您希望存储超过 7 天，需要购买增值服务。服务内容和计费请查看 增值服务资费。
换设备或卸载后重新安装 App 拉取历史消息可以拉到此类消息。例如所有类型的普通消息。

帮助和支持

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

您也可以联系销售或提交工单以寻求帮助。

填写满意度调查问卷，共创更好文档体验。

文档反馈

tencent cloud

即时通信 IM

Unity

消息类介绍

消息字段含义

消息分类

消息存储策略

帮助和支持

字段	含义
message_elem_array	消息内元素列表
message_conv_id	消息所属会话 ID
message_conv_type	消息所属会话类型
message_sender	消息的发送者
message_priority	消息优先级
message_client_time	客户端时间
message_server_time	服务端时间
message_is_from_self	消息是否来自自己
message_platform	发送消息的平台
message_is_read	消息是否已读
message_is_online_msg	消息是否是在线消息，false 表示普通消息，true 表示在线消息，默认为 false
message_is_peer_read	消息是否被会话对方已读
message_need_read_receipt	消息是否需要已读回执（6.1 以上版本有效，需要您购买专业版、专业版Plus或企业版套餐），群消息在使用该功能之前，需要先到 Chat 控制台设置已读回执支持的群类型
message_status	消息当前状态
message_target_group_member_array	指定群消息接收成员（定向消息）；不支持群 @ 消息设置，不支持社群（Community）和直播群（AVChatRoom）消息设置；该字段设置后，消息会不计入会话未读数。
message_unique_id	消息的唯一标识，推荐使用 kTChatMsgMsgId
message_msg_id	消息的唯一标识
message_rand	消息的随机码
message_has_sent_receipt	是否已经发送了已读回执（只有Group 消息有效）
message_group_receipt_read_count	这个字段是内部字段，不推荐使用，推荐调用 TChatMsgGetMessageReadReceipts 获取群消息已读回执
message_group_receipt_unread_count	这个字段是内部字段，不推荐使用，推荐调用 TChatMsgGetMessageReadReceipts 获取群消息已读回执
message_seq	消息序列
message_custom_int	自定义整数值字段（本地保存，不会发送到对端，程序卸载重装后失效）
message_custom_str	自定义数据字段（本地保存，不会发送到对端，程序卸载重装后失效）
message_cloud_custom_str	消息自定义数据（云端保存，会发送到对端，程序卸载重装后还能拉取到）
message_is_excluded_from_unread_count	消息是否不计入未读计数：默认为 NO，表明需要计入未读计数，设置为 YES，表明不需要计入未读计数
message_is_forward_message	是否是转发消息
message_group_at_user_array	群消息中被 @ 的用户 UserID 列表（即该消息都 @ 了哪些人），如果需要 @ALL ，请传入 kImSDK_MesssageAtALL 字段
message_sender_profile	消息的发送者的用户资料
message_sender_group_member_info	消息发送者在群里面的信息，只有在群会话有效。目前仅能获取字段 kTChatGroupMemberInfoIdentifier、kTChatGroupMemberInfoNameCard 其他的字段建议通过 TChatGroupGetMemberInfoList 接口获取
message_offlie_push_config	消息的离线推送设置
message_excluded_from_last_message	是否作为会话的 lasgMessage，true - 不作为，false - 作为

消息分类	API 关键词	说明
单聊消息	C2CMessage	又称 C2C 消息，在发送时需要指定消息接收者的 UserID，只有接收者可以收到该消息
群聊消息	GroupMessage	在发送时需要指定目标群组的 groupID，该群中的所有用户均能收到消息