消息回执
功能描述
开发者可使用此功能实现消息已读未读功能的展示。
当 A 给 B 发送了一条消息,B 在未阅读之前 A 用户显示未读,当 B 用户阅读并调用发送回执接口之后,A 用户可在监听回执中收到通知,此时可根据对应的数据内容将发送的消息显示为已读。
发送回执
消息类名 | ObjectName | 存储属性 | 计数属性 | 离线属性 | 推送属性 | 推送内容 |
---|---|---|---|---|---|---|
ReadReceiptMessage | RC:ReadNtf | 不存储 | 不计数 | 不存储 | 不推送 | 无 |
API 参考:sendMessage
参数说明
输入参数说明
属性名称 | 属性类型 | 是否必填 | 属性说明 |
---|---|---|---|
messageUId | String | 是 | 消息唯一 ID |
lastMessageSendTime | Number | 是 | 最后一条消息的发送时间 |
type | String | 是 | 备用,默认赋值 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
消息,收到后按需处理即可。消息监听。