文档导航
Web
SDK 版本:  5.X
公告:融云新文档中心已上线,欢迎到新文档中心阅读 Web IMLibWeb IMKit 的文档。

设置消息状态(Electron)

更新时间:2023-12-29 PDF

消息状态功能仅限于配合 Electron 模块 (@rongcloud/electron@rongcloud/electron-renderer)使用。

本文档仅适用于 Electron 解决方案,描述了如何客户端本地数据库中维护消息的接收、发送与已读状态。

设置消息的接收状态

支持多状态同时设置

提示

从 SDK 5.9.3 开始支持该接口。

调用 electronExtension.setMessageReceivedStatusInfo 设置对方发送的消息,自己的接收状态(支持同时设置多种状态)。

const messageId = 1 // 取消息中的 messageId 字段
const receivedStatusInfo = {
    isRead: true,
    isListened: true,
    isDownload: false,
    isRetrieved: false,
}
RongIMLib.electronExtension.setMessageReceivedStatusInfo(messageId, receivedStatusInfo).then(res => {
    console.log(res.code)
})

              
已复制
1
2
3
4
5
6
7
8
9
10
11

参数 类型 说明
messageId number 消息 Id
receivedStatusInfo IReceivedStatusInfo 消息的接收状态详情

支持单一状态设置

提示

SDK 从 5.4.0 版本开始支持该接口,于 5.9.3 版本废弃。如果 IMLib SDK 版本 ≧ 5.9.3,建议使用 setMessageReceivedStatusInfo 接口替换。

调用 electronExtension.setMessageReceivedStatus 设置对方发送的消息,自己的接收状态。

const messageId = 1 // 取消息中的 messageId 字段
RongIMLib.electronExtension.setMessageReceivedStatus(messageId, RongIMLib.ReceivedStatus.READ).then(res => {
    console.log(res.code)
})

              
已复制
1
2
3
4
5

参数 类型 说明
messageId number 消息 Id
receivedStatus ReceivedStatus 消息的接收状态

设置消息的发送状态

提示

从 SDK 5.4.0 开始支持该接口。

调用 electronExtension.setMessageSentStatus 设置自己发送的消息的发送状态。

const messageId = 1 // 取消息中的 messageId 字段
RongIMLib.electronExtension.setMessageSentStatus(messageId, RongIMLib.SentStatus.SENT).then(res => {
    console.log(res.code)
})

              
已复制
1
2
3
4
5

参数 类型 说明
messageId number 消息 Id
sentStatus SentStatus 消息的发送状态

通过时间戳设置消息状态为对方已读

提示

从 SDK 5.4.0 开始支持该接口。

调用 electronExtension.setMessageStatusToRead 将自己发送的指定时间之前的消息设置为对方已读,状态值为 SentStatus.READ

const conversation = {
    conversationType: RongIMLib.ConversationType.PRIVATE,
    targetId: "<目标用户ID>",
    channelId: ""
}
const timestamp = 1632728573423
RongIMLib.electronExtension.setMessageStatusToRead(conversation, timestamp).then(res => {
    console.log(res.code)
})

              
已复制
1
2
3
4
5
6
7
8
9
10

参数 类型 说明
conversation IConversationOption 会话
timestamp number 消息的发送时间,将该时间之前的消息设置为已读
文档反馈
意见反馈

您的改进建议

意见反馈

问题类型

联系我们

提交工单

技术支持|集成使用|产品方案


商务咨询

7 x 24 小时

为您解答方案与报价问题

131 6185 6839

文档反馈