Android

消息已读回执

更新时间: 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

具体示例请参考 单聊已读回执 部分。

此文档是否对你有帮助?
有帮助
去反馈
  • 概述
  • 效果展示
  • 单聊已读回执
  • 控制消息已读状态显示
  • 查询消息已读功能状态
  • 群聊已读回执
  • 前提条件
  • 群聊已读回执功能配置