浏览 SDKs · Flutter
平台
SDKsFlutter

创建文件消息

使用 Flutter SDK 从平台路径创建文件消息。

复制

从本地文件路径构建待发送的文件消息对象:

参数说明

参数类型是否必填说明
filePathString是设备本地可访问的文件路径。
fileNameString是文件的展示名称(建议包含文件后缀名,例如 document.pdf)。
final message = await OpenIM.iMManager.messageManager.createFileMessage(
  filePath: filePath,
  fileName: fileName,
);

传入的路径必须是当前设备平台上真实存在且具备读取权限的文件路径。

返回结果

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

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