- 动态与公告
- 产品简介
- 购买指南
- 体验 Demo
- 下载中心
- 快速入门
- 聊天互动（含 UI）
- 视频通话（含 UI）
- 客服场景
- 智能机器人
- 更多实践
- 无 UI 集成
- 客户端 API
- 服务端 API
- 控制台指南
- 常见问题
- 协议与认证
- IM 政策
- 平滑迁移方案
- 错误码
- 联系我们
- 动态与公告
- 产品简介
- 购买指南
- 体验 Demo
- 下载中心
- 快速入门
- 聊天互动（含 UI）
- 视频通话（含 UI）
- 客服场景
- 智能机器人
- 更多实践
- 无 UI 集成
- 客户端 API
- 服务端 API
- 控制台指南
- 常见问题
- 协议与认证
- IM 政策
- 平滑迁移方案
- 错误码
- 联系我们
一、功能描述
开启“消息已读回执”功能后，TUIChat 组件会监听消息的滚动，当未读消息出现在接收方聊天窗口的可视区域内时，将自动触发向发送方发送已读回执，精确监控每一条消息的阅读状态。
注意
二、如何开启消息已读回执
2.1 设置支持已读回执的群类型
注意：
直播群（AVChatRoom）或社群（Community）不支持已读回执功能。
2.2 用户侧控制开启\\关闭已读回执
说明：
在控制台进行群聊的已读回执配置后，已经默认开启已读回执能力，如无特殊需求，无需在用户侧操作开关。
在用户侧也支持手动开启\\关闭已读回执能力（该项默认是开启的），但如果关闭，他人无法看到自己是否已读（即不会发送已读回执），同时自己也看不到他人是否阅读自己的消息（不展示自己发送消息的已读状态）。
在登录成功后，利用
TUIUserService.switchMessageReadStatus(isDisplay: boolean) Api 来控制该开关。import { TUIUserService } from "@tencentcloud/chat-uikit-engine";TUIUserService.switchMessageReadStatus(true); // 开启TUIUserService.switchMessageReadStatus(false); // 关闭
三、扩展资料
说明：
以下内容仅为辅助阅读资料，已读回执功能已在旗舰版 TUIKit 中包含，不需要用户手动实现。
3.1 群聊和单聊的已读回执规则
开启已读回执功能后，发送的
Message 的 needReadReceipt 字段默认为 true ，当消息处于对方消息列表的可视位置时，对方会发送已读回执。但要注意的是：单聊和群聊在开启已读回执功能前后的规则有所不同。3.1.1 群聊的已读回执规则
1. 群聊开启已读回执之前：
不展示已读状态。
2. 群聊开启已读回执之后：
根据
Message 的 readReceiptInfo 获得已读数和未读数。已读数为0：展示“未读”。
未读数为0：展示“全部已读”。
否则展示“x 人已读”，其中 x 为已读数。
3.1.2 单聊的已读回执规则
1. 单聊开启已读回执之前：
展示已读状态，但属于全量已读，当用户点击进入会话时，无论是否看到消息，所有未读消息会全部置为已读。根据
Message 的 isPeerRead 判断消息是已读或未读。2. 单聊开启已读回执之后：
根据单条消息
Message 的 readReceiptInfo.isReceiptPeerRead 字段（布尔值）获取是否已读，从而判断处于“已读”、“未读”中的一种状态。四、常见问题
4.1 Error: 套餐包不支持该接口的使用，请升级到旗舰版套餐
4.2 如何关闭已读功能？
请参考本文档 2.2 节的内容，通过
TUIUserService.switchMessageReadStatus(isDisplay: boolean) 关闭已读功能。import { TUIUserService } from "@tencentcloud/chat-uikit-engine";TUIUserService.switchMessageReadStatus(false);
是
否
本页内容是否解决了您的问题？