tencent cloud

即时通信 IM

iOS(UIKit)

Unduh
Mode fokus
Ukuran font
Terakhir diperbarui: 2026-04-14 17:03:41

功能描述

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

效果展示

单聊消息已读回执

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


群聊消息已读回执

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

消息列表



已读回执详情

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


开启消息已读回执

TUIChat 组件中的 TUIChatConfig 文件里,提供了“消息已读回执”功能开关 msgNeedReadReceipt , 其类型为 BOOL,默认为 NO
如果想开启消息已读回执功能,首先请开通专业版、专业版 Plus 或企业版套餐包,然后把 msgNeedReadReceipt 的默认值改为 YES ,或者在聊天页面初始化之前调用以下方法来开启。
Swift
Objective-C
TUIChatConfig.shared.msgNeedReadReceipt = true
TUIChatConfig.defaultConfig.msgNeedReadReceipt = YES;

常见问题

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


Bantuan dan Dukungan

Apakah halaman ini membantu?

masukan