浏览 SDKs · Flutter
平台
SDKsFlutter

使用本地路径创建文件消息

使用 Flutter SDK 从绝对路径创建文件消息。

复制

从本地文件系统的完整绝对路径构建待发送的文件消息对象:

参数说明

参数类型是否必填说明
filePathString是设备文件系统中的完整绝对路径。
fileNameString是文件的展示名称(建议包含文件后缀名,例如 document.pdf)。
final message = await OpenIM.iMManager.messageManager
    .createFileMessageFromFullPath(
  filePath: absolutePath,
  fileName: fileName,
);

传入的绝对路径必须在当前平台具备有效读取权限。

返回结果

Future 成功返回待发送的文件消息对象(Message),文件属性保存在 fileElem 中。

创建操作仅在本地组装消息数据,不会自动执行网络发送或文件上传,也不会触发新消息事件通知。构建完成后,需将返回的 Message 实例传给发送消息,由 SDK 执行媒体上传与消息投递。若使用平台通用相对路径,请参考创建文件消息;若文件已上传至对象存储,请参考使用 URL 创建文件消息。