跳到主要内容

版本:2.X

消息回执

功能描述

开发者可使用此功能实现消息已读未读功能的展示。

当 A 给 B 发送了一条消息,B 在未阅读之前 A 用户显示未读,当 B 用户阅读并调用发送回执接口之后,A 用户可在监听回执中收到通知,此时可根据对应的数据内容将发送的消息显示为已读。

发送回执

消息类名ObjectName存储属性计数属性离线属性推送属性推送内容
ReadReceiptMessageRC:ReadNtf不存储不计数不存储不推送

API 参考:sendMessage

参数说明

输入参数说明

属性名称属性类型是否必填属性说明
messageUIdString消息唯一 ID
lastMessageSendTimeNumber最后一条消息的发送时间
typeString备用,默认赋值 1 即可

回调参数说明

请参考 message 属性说明。

代码示例

var messageUId = '1301-NBJQ-MK31-3417';  // 消息唯一 ID, message 中的 messageUid
var lastMessageSendTime = 1550719033312; // 最后一条消息的发送时间
var type = '1'; // 备用,默认赋值 1 即可
// 以上 3 个属性在会话的最后一条消息中可以获得

var msg = new RongIMLib.ReadReceiptMessage({ messageUId: messageUId, lastMessageSendTime: lastMessageSendTime, type: type });
var conversationType = RongIMLib.ConversationType.PRIVATE;
var targetId = '接收方的 userId'; // 目标 ID

RongIMClient.getInstance().sendMessage(conversationType, targetId, msg, {
onSuccess: function (message) {
console.log('发送已读通知成功', message);
},
onError: function (errorCode) {
console.log('发送已读通知失败', errorCode);
}
});

接收回执

消息通过设置监听中的消息监听进行接收,消息监听中接收 ReadReceiptMessage 消息,收到后按需处理即可。消息监听