sendMessageReadReceipts
功能介绍
发送消息已读回执
该功能需要购买旗舰版套餐包,购买 旗舰版套餐包 后可使用。
当消息为 Group 消息时,messageIDList 里的消息ID必须在同一个 Group 会话中。
如果是群消息已读回执,需要先在 即时通信 IM 控制台 >功能配置>登录与消息>群已读消息回执配置 中设置支持已读回执消息的群类型。
该接口调用成功后,会话未读数不会变化,消息发送者会收到 onRecvMessageReadReceipts 回调,回调里面会携带消息的最新已读信息。
参数详解
参数名称 | 参数类型 | 是否必填 | 描述 |
---|---|---|---|
messageIDList | string[] | 是 | 需要确认已读的消息id列表 |
返回模板
V2TimCallback
{
code : number
desc : string
}
返回值详解
名称 | 数值类型 | 描述 |
---|---|---|
code | number | 请求结果错误码 |
desc | string | 请求结果描述 |
代码示例
import { TencentImSDKPlugin } from 'react-native-tim-js';
// 用户首先需要创建一条信息
const createCustomMessageRes = await TencentImSDKPlugin.v2TIMManager
.getMessageManager()
.createCustomMessage({
data: '正在输入中',
});
// 发送消息时,需要把needReadReceipt设置为true
TencentImSDKPlugin.v2TIMManager.getMessageManager().sendMessage({
id: createCustomMessageRes.data!.id!,
receiver: '',
groupID: 'groupID',
onlineUserOnly: true,
needReadReceipt: true,
}); // 消息需要已读回执设置
// 通过消息id确认消息已读
// 接收端发送消息已读回执后,发送端可以通过 V2TimAdvancedMsgListener 的 onRecvMessageReadReceipts 回调监听消息已读回执通知
const sendMessageReadReceipts = await TencentImSDKPlugin.v2TIMManager
.getMessageManager()
.sendMessageReadReceipts([createCustomMessageRes.data!.id!]); // 需要确认已读的消息id
if (sendMessageReadReceipts.code === 0) {
// 成功
} else {
// 失败
}