Docs Overview/
Chat/
UIKit/
iOS and macOS/
功能/
已读回执/

已读回执

功能描述

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

效果展示

单聊消息已读回执

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


群聊消息已读回执

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

消息列表



已读回执详情

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


开启消息已读回执

在 TUIChat 组件中的 TUIChatConfig 文件里，提供了“消息已读回执”功能开关 msgNeedReadReceipt , 其类型为 BOOL，默认为 NO 。
- (id)init {
    self = [super init];
    if (self) {
      //...other config
      self.msgNeedReadReceipt = NO;
    }
    return self;
}
如果想开启消息已读回执功能，首先请开通旗舰版套餐包，然后把 msgNeedReadReceipt 的默认值改为 YES ，或者在聊天页面初始化之前调用以下方法来开启。
TUIChatConfig.defaultConfig.msgNeedReadReceipt = YES;

常见问题

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