浏览 SDKs · Flutter
SDKsFlutter

上传文件

使用 Flutter SDK 独立上传文件。

复制

独立文件上传可用于头像、群头像、资料附件或业务文件,不从属于消息。使用业务生成的稳定 id 关联上传任务与 listener。

参数说明

参数类型是否必填说明
idString必填关联任务与 listener 的稳定业务 ID。
filePathString必填当前平台可读取的文件路径。
fileNameString必填原始文件名。
contentTypeString?可选MIME 类型。
causeString?可选业务侧上传原因。
await OpenIM.iMManager.uploadFile(
  id: uploadID,
  filePath: filePath,
  fileName: fileName,
  contentType: contentType,
  cause: 'user-avatar',
);

Future、上传进度和完成回调是不同阶段。完成 callback 返回的 URL 可用于更新头像或其他业务资源;该方法不会自动更新资料,也不会创建或发送消息。listener 的唯一设置方式见 setUploadFileListener()