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

发送非 OSS 消息

发送已经准备好远端资源信息的消息。

复制

sendMessageNotOss() 适用于文件、图片、音频或视频已经通过业务上传服务取得 URL 的消息,可避免再次进入 SDK 的上传流程。

参数说明

参数类型是否必填说明
recvIDstring条件必填单聊时填写接收方用户 ID;群聊时传空字符串。
groupIDstring条件必填群聊时填写群组 ID;单聊时传空字符串。
messageOpenIMMessageItem由 URL 型创建 API 返回、已含远端资源的待发送消息。
offlinePushInfoOpenIMOfflinePushnull离线推送标题、描述和平台配置。
isOnlineOnlybooleannull是否只向在线客户端投递;此类消息不进入本地历史。
import { sendMessageNotOss } from '@/uni_modules/unix-openim-sdk'

const sentMessage = await sendMessageNotOss({
  recvID: receiverUserID,
  groupID: '',
  message: urlMessage,
})

资源 URL、大小、类型、尺寸和时长必须来自实际上传结果。Promise 成功后直接返回服务端确认的 OpenIMMessageItem,应用按 clientMsgID 合并返回对象;字段见消息概览

该方法不会负责上传资源,也不适用于仍只包含本地文件的消息。把本地路径消息误交给本入口会导致接收方无法访问媒体;普通本地文件使用 sendMessage()