功能描述
已读回执(Read Receipt)用于通知发送人“接收人已经阅读了发送的消息”。当接收人阅读消息后,上报消息已读,后台系统会生成一条通知,并将其发送给发送人,以告知消息已被查看。
在即时通讯工具(WhatsApp、微信等)中,当接收人查看消息时,发送人会看到消息旁边的已读标记,例如蓝色的对勾或“已读”字样。
说明:
“回执”的含义是“回复的收据”,它代表了一种确认接收的凭证。当您发送一条消息,并请求一个回执,您实际上是在请求对方“我想确认你们是否接收并阅读了我的消息”。这个确认就像是一张“收据”,证明您的消息已经被接收。
已读回执有助于确保重要信息已被查看,但也可能引发心理压力和隐私问题,因此我们支持用户关闭已读回执功能。
注意:
1. 该功能仅对旗舰版客户开放,购买 旗舰版套餐包 后可使用。
2. 群聊消息已读回执从 TUIKit 6.2.2363 及以上版本支持。
3. 单聊消息已读回执从 TUIKit 6.3.2609及以上版本支持。
效果展示
单聊消息已读回执
通过消息左侧 “已读” / “未读” 标签展示:
群聊消息已读回执
消息左侧显示消息阅读情况:
无人阅读时,显示“未读”;
部分人阅读时,显示“x人已读”,x 为已经阅读消息的人数;
所有人已读时,显示“全部已读”。
已读回执详情
点击“x人已读”即可进入已读回执详情页面,“未读”、“全部已读”不可点击。
已读 群成员 | 未读 群成员 |
| |
开启消息已读回执
public class GeneralConfig {private boolean msgNeedReadReceipt = false;// ... 其他配置}
如果想开启消息已读回执功能,首先请开通旗舰版套餐包,然后把 msgNeedReadReceipt 的默认值改为
true
,或者在聊天页面初始化之前调用以下方法来开启。TUIChatConfigs.getConfigs().getGeneralConfig().setMsgNeedReadReceipt(true);
常见问题
Error: 套餐包不支持该接口的使用,请升级到旗舰版套餐
6.3.2609 之前版本的单聊已读回执功能不需要开通旗舰版套餐包也可以使用,为什么 6.3.2609 之后需要开通旗舰版套餐包了?
6.3.2609 版本之前的单聊已读回执无法针对单条消息上报已读,只能批量上报整条会话所有的消息已读。6.3.2609 及之后的版本使用了旗舰版套餐包专属的 消息已读回执 功能,可以针对单条消息上报已读,使用体验更好。如果想回退到旧版本方案,可以参考 TUIKit 恢复旧版 C2C 已读上报指引。