浏览 SDKs · uni-app / uni-app x
平台
SDKsuni-app / uni-app x

插入本地单聊消息

使用 UniApp SDK 向当前设备的单聊记录插入一条本地消息。

复制

本地插入适合只在当前设备展示的提示或迁移数据。先创建完整消息对象,再指定单聊双方:

import {
  createTextMessage,
  insertSingleMessageToLocalStorage,
} from '@/uni_modules/unix-openim-sdk'

const message = await createTextMessage('本地提示')
if (message == null) return

await insertSingleMessageToLocalStorage({
  message,
  recvID: targetUserID,
  sendID: currentUserID,
})

参数说明

参数类型是否必填说明
messageOpenIMMessageItem是要写入本地数据库的完整消息对象。
recvIDstring是单聊接收方用户 ID。
sendIDstring是消息发送方用户 ID。

sendID 和 recvID 必须与目标单聊一致。Promise 成功只表示当前设备本地数据库已写入,客户端可按 conversationID:clientMsgID 维护本地列表状态,不会发送消息、离线推送或触发新消息事件。需要多端同步或让对方收到消息时,应使用发送消息。