SDKsAndroid

消息概览

了解 Android SDK 的 Message 模型、消息生命周期和消息监听。

Android SDK 使用 Message 表示一条消息。消息创建、发送、接收、查询和状态变更是不同阶段；创建 Message 不会发送消息，发送成功也不代表其他客户端已经完成接收。

消息列表通常以 clientMsgID 作为客户端去重和更新键，并结合当前会话上下文判断消息属于单聊还是群聊。Message 本身不包含 conversationID，会话 ID 来自当前会话、历史查询参数或消息事件上下文。

消息处理流程

阶段	Android API 或回调	说明
创建	`MessageManager.create*Message()`	创建待发送的 `Message` 对象，不写入服务端，也不会触发新消息回调。
发送	`sendMessage()` 或 `sendMessageNotOss()`	单聊传入 `recvUid`，群聊传入 `recvGid`。
接收	`OnAdvanceMsgListener`	处理实时、离线、在线消息以及撤回、删除和已读回执等变化。
查询	历史消息、按 ID 查找或搜索 API	查询返回当次读取到的消息，不代替实时消息监听。
更新	撤回、删除、修改、置顶、已读和本地扩展 API	分别处理 API 结果、对应事件和必要的列表重新查询。

消息事件由接收消息页面统一说明。应用应在共享消息状态层设置一次 OnAdvanceMsgListener，再把新消息、离线消息、撤回和删除等变化分发给各页面；本概览页不重复设置 listener。

创建、发送、接收和查询返回的消息对象都是 Message。常用字段如下：

字段	类型	说明
`clientMsgID`	`String`	客户端消息 ID，用于列表去重、状态更新和定位消息。
`serverMsgID`	`String`	服务端消息 ID；消息尚未成功发送时可能没有有效值。
`sessionType`	`int`	会话类型；结合 `recvID`、`groupID` 判断单聊或群聊。
`sendID`	`String`	发送者用户 ID。
`recvID`	`String`	单聊接收方用户 ID。
`groupID`	`String`	群聊对应的群组 ID。
`msgFrom`	`int`	标识消息是用户级别还是系统级别。
`contentType`	`int`	消息类型，使用 `MessageType` 常量判断内容字段。
`createTime`	`long`	消息对象创建时间，Android SDK 模型注释约定为纳秒。
`sendTime`	`long`	消息发送时间，Android SDK 模型注释约定为毫秒。
`seq`	`int`	服务端消息序号。
`status`	`int`	发送状态，使用 `MessageStatus` 常量判断。
`isRead`	`boolean`	当前客户端保存的已读状态。
`platformID`	`int`	发送消息的客户端平台。
`senderNickname`	`String`	消息创建或发送时记录的发送者昵称。
`senderFaceUrl`	`String`	消息创建或发送时记录的发送者头像 URL。
`offlinePush`	`OfflinePushInfo`	离线推送内容。
`attachedInfo`	`String`	SDK 附加信息。
`ext`	`Object`	Android 消息附加字段。
`ex`	`Object`	消息附加字段。
`localEx`	`Object`	仅保存在当前设备的消息扩展字段。

消息正文位于与 contentType 对应的 element 字段中，不要根据列表位置或展示文本判断消息类型：

消息内容	对应字段
文本、富文本	`textElem`、`advancedTextElem`
图片、音频、视频、文件	`pictureElem`、`soundElem`、`videoElem`、`fileElem`
@ 消息、回复消息	`atTextElem`、`quoteElem`
合并转发	`mergeElem`
名片、位置、表情	`cardElem`、`locationElem`、`faceElem`
自定义消息	`customElem`
通知、输入状态和附加状态	`notificationElem`、`typingElem`、`attachedInfoElem`

发送一条消息分为两个步骤：

下表列出了可创建的消息类型及其对应页面：

发送本地路径或本地文件创建的媒体消息时，调用 sendMessage()，SDK 会在发送过程中上传媒体文件。使用已有远端 URL 创建媒体消息时，调用对应的 create*MessageByURL() 方法，再按发送已上传的媒体消息发送，无需再次上传媒体文件。

变化	处理位置	合并方式
新消息和离线消息	接收消息	先确定目标会话，再按 `clientMsgID` 合并。
消息撤回	`onRecvMessageRevokedV2`	按撤回信息中的消息 ID 更新原消息状态。
消息删除	`onMsgDeleted`	按消息 ID 从当前会话列表移除。
C2C 和群聊已读回执	`onRecvC2CReadReceipt`、`onRecvGroupMessageReadReceipt`	更新对应消息或会话的已读状态。
消息扩展变化	`onRecvMessageExtensionsChanged` 等回调	按消息 ID 更新扩展字段，不替换整条消息的正文。
输入状态	更新输入状态	按会话和用户更新临时状态，不写入普通消息列表。

对于撤回、删除、已读和消息扩展等状态变化，应先处理 API 的调用结果，再通过 OnAdvanceMsgListener 同步相关回调；必要时重新查询消息列表。

这个页面有帮助吗？