已读回执
IMKit 提供了单聊、群聊的已读回执功能。App 用户通过已读回执获知对方是否阅读该消息。
在 IMKit 内置页面中已默认实现并启用已读回执功能。在单聊会话中,消息默认更新已读状态。在群聊会话中,消息发送者需要在页面上主动请求获取已读状态。
阅读回执开关
IMKit 中回执功能默认开启,在单聊和群聊中默认会展示消息回执。
您可以修改支持的会话类型。下面的代码将阅读回执功能配置为仅在单聊中支持,群聊中将不启用阅读回执功能。
RCKitConfigCenter.message.enabledReadReceiptConversationTypeList = @[ @(ConversationType_PRIVATE) ];
单聊阅读回执
在单聊会话中,发送方会实时收到消息的已读状态更新。在 IMKit 内置页面中,单聊已读状态显示在两处:
- 单聊会话页面(消息列表页面):在发送方的单聊会话页面,消息的左下角会显示对号,表示对方已读。
- 会话列表页面:会话列表的每条会话会显示会话中的最后一条消息的预览。如果单聊会话最后一条消息被对方阅读,发送方的会话列表页中对应会话条目的右下角也会显示对号,表示对方已读。
SDK 会话页面中文本消 息已读的 UI 默认是一个“对勾”图标,如果展示为文本“已读”或“未读”,可以在消息 Cell 展示前修改。详见会话页面中的定制化。
群聊阅读回执
提示
IMKit 的群聊已读回执功能仅支持文本消息类型。
在群聊会话中发送消息后 120 秒之内,发送者可以在会话页面上主动请求获取已读人数数据。在会话页面上,消息的左下角会显示对号按钮(请求阅读回执的按钮)。点击按钮后,IMKit 才会请求已读回执。IMKit 在收到已读回执结果后会刷新页面,显示为 “n 人已读”。