文件上传

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

平台调用风格

回调式（callback-last）：有返回数据用 ResultCallback<T>，无返回数据用 OperationCallback；所有回调在主线程投递。

接口一览​

操作语义传输返回
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(data: ByteArray, name: String, mime: String? = null, callback: ResultCallback<UploadResult>)
REST（客户端）since 1.0.0
参数
参数类型说明
databytes|blob必填；文件二进制内容（<=20MB）
namestring必填；名称（群名 / 聊天室名 / 文件名）
mimestring可选；MIME 类型，如 image/png
返回

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

示例
Kotlin
client.uploadFile(
    data = byteArrayOf(1, 2, 3),
    name = "report.pdf",
    callback = object : ResultCallback<UploadResult> {
        override fun onSuccess(result: UploadResult) { /* 处理返回数据 */ }
        override fun onError(error: IMError) { /* 处理 error.code */ }
    },
)
错误码
错误码名称分类HTTP可重试说明
1001INVALID_PARAMETER客户端 / 参数 / 权限400否参数错误
1003FORBIDDEN客户端 / 参数 / 权限403否无权限
1007MESSAGE_TOO_LARGE客户端 / 参数 / 权限400否消息体过大（上限 5KB）

相关文档​