更新时间: 2020-08-26
# 功能描述
开发者可使用此功能实现消息已读未读功能的展示。
当 A 给 B 发送了一条消息,B 在未阅读之前 A 用户显示未读,当 B 用户阅读并调用发送回执接口之后,A 用户可在监听回执中收到通知,此时可根据对应的数据内容将发送的消息显示为已读。
# 发送回执
ObjectName | 存储属性 | 计数属性 | 离线属性 | 推送属性 | 推送内容 |
---|---|---|---|---|---|
RC:ReadNtf | 不存储 | 不计数 | 不存储 | 不推送 | 无 |
# 参数说明
属性名称 | 属性类型 | 是否必填 | 属性说明 |
---|---|---|---|
messageUId | String | 是 | 消息唯一 ID |
lastMessageSendTime | Number | 是 | 最后一条消息的发送时间 |
type | String | 是 | 备用,默认赋值 1 即可 |
# 代码示例
var conversation = im.Conversation.get({ targetId: '接收方的 userId', type: RongIMLib.CONVERSATION_TYPE.PRIVATE }); var messageUId = '1301-NBJQ-MK31-3417'; // 消息唯一 Id, message 中的 messageUid var lastMessageSendTime = 1550719033312; // 最后一条消息的发送时间 var type = '1'; // 备用,默认赋值 1 即可 // 以上 3 个属性在会话的最后一条消息中可以获得 conversation.send({ messageType: 'RC:ReadNtf', content: { messageUId: messageUId, lastMessageSendTime: lastMessageSendTime, type: type } }).then(function(message){ console.log('发送已读通知消息成功', message); });
已复制
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
# 接收回执
消息通过设置监听中的消息监听进行接收,消息监听中接收 RC:ReadNtf
消息,收到后按需处理即可。消息监听文档