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

从 URL 创建文件消息

使用已上传文件的 OpenIMFileElem 创建消息。

复制

createFileMessageByURL() 使用已经上传的文件信息创建消息。

参数说明

参数类型说明
filePathstringnull文件的本地名称或业务路径;只有远端资源时传空字符串。
fileNamestringnull对外展示的文件名。
uuidstringnull文件资源的唯一标识。
sourceUrlstringnull已上传文件的可访问地址。
fileSizenumbernull文件大小,单位为字节。
import { createFileMessageByURL } from '@/uni_modules/unix-openim-sdk'

const message = await createFileMessageByURL({
  filePath: '',
  fileName: 'report.pdf',
  uuid: createBusinessUUID(),
  sourceUrl: uploaded.url,
  fileSize: uploaded.size,
})

文件 URL、名称、UUID 和大小必须来自真实上传结果;URL 需要接收方可访问,不能直接暴露私有存储凭据。当前 OpenIMFileElem 不包含 Wasm 版的 fileType 字段,不要传入未公开字段。

Promise 成功只创建待发送的 OpenIMMessageItem | null。由于资源已经上传,发送时使用 sendMessageNotOss()