消息概述

消息：表示发送方给接收方发送的内容。消息包括多种类型，如：文本、图片、语音、视频、位置消息等。

利用环信即时通讯 IM，开发者可方便以会话为单位对本地消息进行管理，从服务端获取历史会话和消息，提供消息回执等功能。

消息类型

类型	描述
文本消息	文本消息的内容是文本，包含超链接和表情符号等。表情消息基于文本消息实现。 文本消息大小限制为 5 KB。
位置消息	位置消息需要第三方的地图服务提供经纬度信息。接收方接收到位置消息，通过经纬度信息可以在第三方的地图服务中显示位置。
透传消息	透传消息可视为命令消息。通过发送这条命令给对方，通知对方要执行的操作，对方收到消息后系统可以自定义处理。透传消息不会在 UI 上展示。 消息大小限制为 5 KB。 你可以使用透传消息更新头像和昵称以及进行状态同步等。 透传消息不会存入本地数据库。
图片消息	图片消息是附件消息，需要先将图片上传至消息服务器。接收方收到图片时自动下载图片缩略图。 图片默认不能超过 10 MB，图片消息大小限制为 5 KB。
语音消息	语音消息是附件消息，需要先将语音上传至消息服务器。接收方收到语音时自动下载语音。 音频文件默认不能超过 10 MB，音频消息大小限制为 5 KB。
视频消息	视频消息是附件消息，需要先将视频上传至消息服务器。接收方收到视频时自动下载视频缩略图，点击下载视频消息。对于 Web 端，视频消息没有缩略图。 视频文件默认不能超过 10 MB，视频消息大小限制为 5 KB。
文件消息	文件消息是附件消息，需要先将文件上传至消息服务器。 附件大小不能超过 10 MB，文件消息大小限制为 5 KB。
自定义类型消息	开发者自定义的消息类型。自定义消息支持设置类型名称，开发者可以添加多种自定义消息。 自定义消息大小限制为 5 KB。 自定义消息的使用场景：红包消息、模板消息等。
流式消息	流式消息是一种边生成、边发送、边接收的实时消息传输机制。流式消息由业务服务端生成并通过 RESTful API 发送。SDK 负责接收、排序、合并和回调，不提供客户端主动发送流式消息的能力。消息大小限制为 5 KB。

消息功能列表

即时通讯 IM 的消息功能包括发送和接收消息、获取历史消息、撤回消息、搜索、修改和转发消息、以及导入、更新、删除和置顶消息等。

下表为各平台/框架支持的消息功能。

消息功能	Android	iOS	Web	小程序	HarmonyOS	Flutter	React Native	Unity	Windows
发送和接收消息	✓	✓	✓	✓	✓	✓	✓	✓	✓
接收流式消息	✓	✓	✓	✓	✓	✓	✓	—	—
获取服务端历史消息	✓	✓	✓	✓	✓	✓	✓	✓	✓
获取本地历史消息	✓	✓	—	—	✓	✓	✓	✓	✓
撤回消息	✓	✓	✓	✓	✓	✓	✓	✓	✓
搜索本地消息	✓	✓	—	—	✓	✓	✓	✓	✓
搜索服务端消息	✓	✓	✓	✓	—	—	—	—	—
编辑消息	✓	✓	✓	✓	✓	—	✓	✓	✓
消息表情回复	✓	✓	✓	✓	✓	✓	✓	✓	✓
转发消息	✓	✓	—	—	✓	✓	✓	✓	✓
导入和插入消息	✓	✓	—	—	✓	✓	✓	✓	✓
更新消息	✓	✓	—	—	✓	✓	✓	✓	✓
删除服务端历史消息	✓	✓	✓	✓	✓	✓	✓	✓	✓
删除本地历史消息	✓	✓	—	—	✓	✓	✓	✓	✓
消息回执	✓	✓	✓	✓	✓	✓	✓	✓	✓
置顶消息	✓	✓	✓	✓	✓	✓	✓	✓	✓
定向消息	✓	✓	✓	✓	✓	✓	✓	✓	✓
翻译消息	✓	✓	✓	✓	—	✓	✓	✓	✓
只投在线用户	✓	✓	✓	✓	✓	✓	✓	✓	✓
消息扩展	✓	✓	✓	✓	✓	✓	✓	✓	✓
多端同步	✓	✓	✓	✓	✓	✓	✓	✓	✓
离线推送	✓	✓	—	—	✓	✓	✓	✓	✓

各类会话的消息

关于单聊、群聊和聊天室会话的消息应用场景、消息能力、发送控制方式和发送频率控制，详见 单聊消息、群组消息 和 聊天室消息。

消息存储

消息存储分为本地存储和服务器存储，详见 消息存储介绍。

消息格式

关于各类型消息格式以及离线推送的消息扩展字段，详见 消息格式文档。