Flutter

最近更新时间:2025-07-14 12:06:02

我的收藏

功能描述

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

效果展示

单聊消息已读回执

通过消息左侧 “已读” / “未读” 展示。


群聊消息已读回执

通过消息旁圆圈,体现群成员已读数量。点击后,进入展示详情。

消息列表



已读回执详情

已读群成员
未读群成员





控制消息已读回执

在 TIMUIKitChat 的配置参数 config 中,提供了“消息已读回执”功能开关,具体如下代码说明。对于 Boolean 类型的配置开关,默认值为 true
TIMUIKitChat(
config: TIMUIKitChatConfig(
isShowReadingStatus: true 或 false, // 是否展示消息已读回执
// ... 其他 config 配置
),
// ... 其他 TIMUIKitChat 参数
)

常见问题

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

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

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

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