Android

最近更新时间:2024-10-14 09:09:21

我的收藏

功能描述

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

效果展示

单聊消息已读回执

通过消息左侧 “已读” / “未读” 标签展示:




群聊消息已读回执

消息左侧显示消息阅读情况:
无人阅读时,显示“未读”;
部分人阅读时,显示“x人已读”,x 为已经阅读消息的人数;
所有人已读时,显示“全部已读”。




已读回执详情

点击“x人已读”即可进入已读回执详情页面,“未读”、“全部已读”不可点击。
已读 群成员
未读 群成员







开启消息已读回执

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

常见问题

Error: 套餐包不支持该接口的使用,请升级到旗舰版套餐

“消息已读回执” 功能仅旗舰版套餐支持,该报错信息表示您当前的套餐包不支持此能力,请登录 即时通信 IM 购买页 开通旗舰版套餐包进行体验。

6.3.2609 之前版本的单聊已读回执功能不需要开通旗舰版套餐包也可以使用,为什么 6.3.2609 之后需要开通旗舰版套餐包了?

6.3.2609 版本之前的单聊已读回执无法针对单条消息上报已读,只能批量上报整条会话所有的消息已读。6.3.2609 及之后的版本使用了旗舰版套餐包专属的 消息已读回执 功能,可以针对单条消息上报已读,使用体验更好。如果想回退到旧版本方案,可以参考 TUIKit 恢复旧版 C2C 已读上报指引