接收消息

iOS SDK 通过 OIMAdvancedMsgListener 推送普通新消息、在线消息、撤回、删除和已读回执。应用应在消息状态层初始化时注册一次，并以强引用持有 listener；OIMCallbacker 对 listener 使用弱引用。

消息类型

普通事件每次返回一个 OIMMessageInfo。根据消息元素选择文本、@ 文本、自定义、图片、音频、视频、文件或降级渲染；不要假设所有消息都有 textElem。媒体消息只读取元素中的远端地址、大小、名称、时长与快照，不需要重新上传。

消息可能属于当前未打开的会话。先根据 sessionType、sendID、recvID 与 groupID 确定目标会话，再按 clientMsgID 幂等合并。

固定 SDK 中用于接收、路由与合并的常用 OIMMessageInfo 属性如下：

textElem、pictureElem、soundElem、videoElem、fileElem、atTextElem、customElem 等内容属性都可以为 nil。渲染时应同时检查 contentType 与对应 element；缺少预期内容时使用降级占位，不要强制取值。

注册新消息监听

@interface MessageStore () <OIMAdvancedMsgListener>
@end

@implementation MessageStore

- (void)startListening {
    [[OIMManager callbacker] addAdvancedMsgListener:self];
}

- (void)stopListening {
    [[OIMManager callbacker] removeAdvancedMsgListener:self];
}

- (void)onRecvNewMessage:(OIMMessageInfo * _Nullable)message {
    if (message.clientMsgID.length == 0) {
        return;
    }
    [self mergeMessage:message];
}

- (void)onRecvOnlineOnlyMessage:(OIMMessageInfo * _Nullable)message {
    if (message.clientMsgID.length == 0) {
        return;
    }
    [self handleOnlineOnlyMessage:message];
}

@end

应在 initSDK 成功后、login 前完成全局消息监听注册，退出登录、切换账号或销毁状态层时用同一实例移除。固定版本的 closure callback 类型允许消息参数为空，示例同时校验 clientMsgID。该版本每次传入单个 OIMMessageInfo，不是消息数组，也没有独立的离线新消息 selector；不要同时注册其他平台的单数／复数事件名称。

只在线消息不会进入普通历史存储，适合临时提示或业务通知。发送参数见发送消息。

合并消息

先根据消息路由字段确定会话，再按 clientMsgID 幂等合并。新消息事件可能和发送成功回调、历史查询结果重叠，不能直接追加数组。

历史查询负责建立当前快照；onRecvNewMessage: 负责在线增量；重新登录后的离线变化由 SDK 同步。同步完成后，可重新查询当前会话历史校准列表。

首次进入会话时读取历史

事件只负责新到达的消息。首次进入会话、向上翻页或补齐同步后的列表时，使用 getAdvancedHistoryMessageList:onSuccess:onFailure: 读取历史。第一页把 startClientMsgID 设为 nil，后续使用边界消息的 clientMsgID；完整处理见加载历史消息。

查询 callback 直接建立消息快照，不会触发新消息 listener。分页与事件可能包含同一条消息，因此两条路径必须使用相同的会话路由与 clientMsgID 去重规则。

标记会话已读

用户实际打开会话并阅读完可见消息后，调用 markConversationMessageAsRead:onSuccess:onFailure: 清理未读数。单聊回执处理见标记会话已读；群消息成员级回执见上报群消息已读。

其他消息事件

• 撤回事件的完整实现见撤回消息。
• 删除事件见批量删除消息。
• 单聊已读回执见标记会话已读，群聊已读回执见上报群消息已读。
• 自定义业务监听见接收自定义业务消息。

查询 API、本地插入和消息创建不会触发 onRecvNewMessage:。

验证接收流程

• 从另一个账号向目标单聊或群组发送消息，确认按目标会话和 clientMsgID 只合并一次。
• 发送只在线消息，确认走 onRecvOnlineOnlyMessage:，且历史查询不会回放该消息。
• 撤回或删除消息，确认对应归属页的处理器按 clientMsgID 更新原气泡。
• 退出登录或切换账号后确认 listener 已移除，重新登录时不会重复处理。

相关页面

• 消息概览
• 发送消息
• 加载历史消息
• 标记会话已读