Tencent Cloud

Recent Pages

Android

最后更新时间：2024-10-31 10:10:41

功能描述
已读回执（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.
“消息已读回执” 功能仅进阶版支持，该报错信息表示您当前的套餐包不支持此能力，请 购买进阶版 后使用。
﻿