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

从 URL 创建语音消息

使用已上传音频的 OpenIMSoundElem 创建消息。

复制

createSoundMessageByURL() 使用已经上传的音频信息创建消息。

参数说明

参数类型说明
uuidstringnull音频资源的唯一标识。
soundPathstringnull音频文件的本地名称或业务路径;只有远端资源时传空字符串。
sourceUrlstringnull已上传音频的可访问地址。
dataSizenumbernull音频大小,单位为字节。
durationnumbernull音频时长,单位按服务端协议约定。
import { createSoundMessageByURL } from '@/uni_modules/unix-openim-sdk'

const message = await createSoundMessageByURL({
  uuid: createBusinessUUID(),
  soundPath: '',
  sourceUrl: uploaded.url,
  dataSize: uploaded.size,
  duration,
})

URL、UUID、大小和时长应与上传结果一致。资源需对接收方可访问,不要把本地沙盒路径当成远端 URL。当前 OpenIMSoundElem 不包含 Wasm 版的 soundType 字段,不要传入未公开字段。

Promise 成功只创建待发送的 OpenIMMessageItem | null;发送时使用 sendMessageNotOss()