消息已读回执
更新时间: 2025/11/18 16:13:01
概述
已读回执(Read Receipt)是即时通讯应用中的核心功能,它能让消息发送者知道接收方是否已阅读了消息。当接收方查看消息后,系统会自动向服务器上报消息已读状态,服务器生成通知并发送给原发送方。
在现代即时通讯工具(如微信、WhatsApp)中,已读回执通常以特定图标(如对勾标记)或文字形式(如 已读)显示。
回执(Receipt) 源自传统通信领域,指 确认接收的凭证。在消息系统中,已读回执相当于接收方向发送方提供的一份确认,表明 您的消息已被我查看 的电子凭证。
效果展示
单聊已读回执
IM UIKit 默认开启单聊已读回执功能。
控制消息已读状态显示
初始化 SDK 后,您可以调用 SettingRepo.setShowReadStatus 方法全局控制消息已读/未读状态的显示。
Javapublic class MyApplication extends Application {
@Override
public void onCreate() {
super.onCreate();
// 初始化 SDK 前配置 NIM UIKit
IMKitConfigCenter.xxxxxx(...)
// 之后再初始化 SDK
SDKInitializer.initialize(...);
// 参数为 true 表示显示已读/未读状态,false 表示隐藏
SettingRepo.setShowReadStatus(true);
}
}
查询消息已读功能状态
业务层向用户提供了一个按钮,用户可以选择是否开启消息已读回执。若想要查询当前状态,可以使用以下方法:
Java// 查询当前的已读状态显示设置
boolean isShowingReadStatus = SettingRepo.getShowReadStatus();
群聊已读回执
前提条件
-
群聊消息已读回执 功能仅 IM 旗舰版 或 IM 专属版 套餐支持,使用前请确认已开通旗舰版或专属版套餐。
-
群聊消息已读回执 功能仅支持 200 人以内的高级群。
-
群聊消息已读回执 功能需要在在 网易云信控制台 开通,具体请参考 配置群组功能。
群聊已读回执功能配置
群聊已读回执功能开通后,您可以使用与单聊相同的接口来控制和查询已读状态显示:
- 控制限制:
SettingRepo.setShowReadStatus - 查询状态:
isShowingReadStatus
具体示例请参考 单聊已读回执 部分。
此文档是否对你有帮助?




