文件上传

上传图片、语音、文件等媒体，返回可发送的消息内容体。

平台调用风格

异步风格：Future<RcResult<T>>；错误码在 res.code，不使用异常表达业务失败。

接口一览​

操作语义传输返回
uploadFile上传文件（<=20MB），返回可用于图片/文件/语音消息的 url。REST（客户端）{url:string,name:string,size:uint64,mime:string,fullUrl?:string}

本页 1 个操作，其中 1 个在本平台绑定中声明了方法签名。

跨端方法名​

操作AndroidWebElectronmacOSFlutterNative (C ABI)iOS
uploadFileuploadFileuploadFileuploadFileuploadFileuploadFileim_client_upload_filefunc

方法名在 GA 平台之间保持一致（规则 A）；Native C ABI 只覆盖部分操作，其余操作以 — 标注。

uploadFile​

上传文件（<=20MB），返回可用于图片/文件/语音消息的 url。

uploadFile(List<int> data, String name, {String? mime})
REST（客户端）since 1.0.0
参数
参数类型说明
databytes|blob必填；文件二进制内容（<=20MB）
namestring必填；名称（群名 / 聊天室名 / 文件名）
mimestring可选；MIME 类型，如 image/png
返回

{url:string,name:string,size:uint64,mime:string,fullUrl?:string} 上传结果（url 可直接用于媒体消息）

示例
Dart
final res = await engine.uploadFile(<int>[1, 2, 3], 'report.pdf');
if (res.code != 0) throw Exception(res.msg);
错误码
错误码名称分类HTTP可重试说明
1001INVALID_PARAMETER客户端 / 参数 / 权限400否参数错误
1003FORBIDDEN客户端 / 参数 / 权限403否无权限
1007MESSAGE_TOO_LARGE客户端 / 参数 / 权限400否消息体过大（上限 5KB）

相关文档​