• UIKit
  • SDK
  • 服务端 API
Chat/
UIKit/
Android/
功能/
UIKit
  • 界面库介绍
  • Run Demo
  • 快速开始
  • 集成组件
    • TUIKit
    • TUIChat
  • 构建基础界面
    • 聊天界面
    • 会话列表
    • 联系人列表
    • 添加联系人
    • 创建群聊
    • 音视频通话
  • 功能
    • 表情回应
    • 消息引用
    • 已读回执
    • 用户在线状态
    • 文本消息翻译
    • 语音转文本
    • 搜索消息
  • 自定义
    • 自定义消息
    • 自定义表情
  • 本地化
  • 更新日志
  • 开发指引
  • 控制台指南
    • 创建和升级应用
    • 基本配置
    • 功能配置
    • 账号管理
    • 群组管理
    • 回调配置
  • 产品介绍
    • 消息管理
      • 单聊消息
      • 消息存储
      • 离线推送
      • 群消息
      • 消息格式
    • 账号系统
      • 登陆验证
      • 在线状态管理
    • 群相关
      • 群组系统
      • 群组管理
    • 用户资料和关系链
      • 资料管理
      • 关系链管理
  • 购买指南
    • 计费概述
    • 价格中心
  • 错误码

已读回执

功能描述

已读回执(Read Receipt)用于通知发送人“接收人已经阅读了发送的消息”。当接收人阅读消息后,上报消息已读,后台系统会生成一条通知,并将其发送给发送人,以告知消息已被查看。
在即时通讯工具(WhatsApp、微信等)中,当接收人查看消息时,发送人会看到消息旁边的已读标记,例如蓝色的对勾或“已读”字样。
说明:
“回执”的含义是“回复的收据”,它代表了一种确认接收的凭证。当您发送一条消息,并请求一个回执,您实际上是在请求对方“我想确认你们是否接收并阅读了我的消息”。这个确认就像是一张“收据”,证明您的消息已经被接收。
已读回执有助于确保重要信息已被查看,但也可能引发心理压力和隐私问题,因此我们支持用户关闭已读回执功能。
注意:
1. 该功能仅进阶版支持,请购买进阶版后使用。
2. 群聊消息已读回执从 TUIKit 6.2.2363 及以上版本支持。
3. 单聊消息已读回执从 TUIKit 6.3.2609及以上版本支持。

效果展示

单聊消息已读回执

通过消息上的 ✔️ 或者高亮的 ✔️✔️展示。


群聊消息已读回执

消息上显示消息阅读情况:
无人阅读时,显示 ✔️ ;
部分人阅读时,显示灰色的 ✔️✔️;
所有人已读时,显示高亮的 ✔️✔️ 。

消息列表



已读回执详情

点击已读状态即可进入已读回执详情页面。


开启消息已读回执

TUIChat 组件中的 GeneralConfig.java 文件里,提供了“消息已读回执”功能开关 msgNeedReadReceipt , 其类型为 boolean,默认为 false
public class GeneralConfig {
private boolean msgNeedReadReceipt = false;
}
如果想开启消息已读回执功能,首先请开通旗舰版套餐包,然后把 msgNeedReadReceipt 的默认值改为 true ,或者在聊天页面初始化之前调用以下方法来开启。
TUIChatConfigs.getConfigs().getGeneralConfig().setMsgNeedReadReceipt(true);

常见问题

Error: The usage of this API is not supported by the package. Please upgrade to the premium version.
“消息已读回执” 功能仅进阶版支持,该报错信息表示您当前的套餐包不支持此能力,请 购买进阶版 后使用。