uploadFile(options)

上传文件到云存储

uploadFile 兼容性

Web	微信小程序	Android	iOS	HarmonyOS
4.0	4.41	阿里云 3.9，腾讯云 3.91，支付宝云 3.98	4.11	4.61

参数

名称	类型	必填	默认值	兼容性	描述
options	UniCloudUploadFileOptions	是	-	-	-
名称 类型 必备 默认值 兼容性 描述 filePath string 是 - - 文件路径 cloudPath string 是 - - 云端路径 cloudPathAsRealPath boolean 否 - - 是否以云端路径是否为真实路径保存上传的文件

UniCloudUploadFileOptions 的方法

onUploadProgress: (options: UniCloudUploadProgress) => any

onUploadProgress 上传进度回调

onUploadProgress 兼容性

Web	微信小程序	Android	iOS	HarmonyOS
-	-	-	-	-

参数

名称	类型	必填	默认值	兼容性	描述
options	UniCloudUploadProgress	是	-	-	上传进度回调参数
名称 类型 必备 默认值 兼容性 描述 loaded number 是 - - 已上传大小 total number 是 - - 总大小

返回值

类型
any

返回值

类型
Promise<UniCloudUploadFileResult>
名称 类型 必备 默认值 兼容性 描述 filePath string 是 - - 文件路径 fileID string 是 - - 文件id

参见

• 相关 Bug

chooseAndUploadFile(options)

选择并上传文件

chooseAndUploadFile 兼容性

Web	微信小程序	Android	iOS	HarmonyOS
4.0	4.41	阿里云 3.9，腾讯云 3.91，支付宝云 3.98	4.11	4.61

参数

名称	类型	必填	默认值	兼容性	描述
options	UniCloudChooseAndUploadFileOptions	是	-	-	-
名称 类型 必备 默认值 兼容性 描述 sourceType Array<string> 否 - - 合法值 兼容性 描述 album - - camera - - count number 否 - - sizeType Array<string> 否 - - 合法值 兼容性 描述 original - - compressed - - extension Array<string> 否 - - compressed boolean 否 - - maxDuration number 否 - - camera string 否 - - - 合法值 兼容性 描述 front - - back - - crop ChooseImageCropOptions 否 - - type string 是 - - - 合法值 兼容性 描述 image - - video - - all - -

UniCloudChooseAndUploadFileOptions 的方法

onChooseFile: (arg: UniCloudChooseAndUploadFileResult) => void | null

onChooseFile

onChooseFile 兼容性

Web	微信小程序	Android	iOS	HarmonyOS
-	-	-	-	-

参数

名称	类型	必填	默认值	兼容性	描述
arg	UniCloudChooseAndUploadFileResult	是	-	-	-
名称 类型 必备 默认值 兼容性 描述 tempFiles Array<UniCloudChooseAndUploadFileItem> 是 - - - 名称 类型 必备 默认值 兼容性 描述 name string 是 - - - path string 是 - - - cloudPath string 是 - - - cloudPathAsRealPath boolean 否 - - url string 否 - - errMsg string 否 - - tempFilePaths Array<string> 是 - - -

onUploadProgress: (arg: UniCloudChooseAndUploadFileProgressEvent) => void | null

onUploadProgress

onUploadProgress 兼容性

Web	微信小程序	Android	iOS	HarmonyOS
-	-	-	-	-

参数

名称	类型	必填	默认值	兼容性	描述
arg	UniCloudChooseAndUploadFileProgressEvent	是	-	-	-
名称 类型 必备 默认值 兼容性 描述 index number 是 - - - loaded number 是 - - - total number 是 - - - tempFilePath string 是 - - - tempFile UniCloudChooseAndUploadFileItem 是 - - -

返回值

类型
Promise<UniCloudChooseAndUploadFileResult>
名称 类型 必备 默认值 兼容性 描述 tempFiles Array<UniCloudChooseAndUploadFileItem> 是 - - - 名称 类型 必备 默认值 兼容性 描述 name string 是 - - - path string 是 - - - cloudPath string 是 - - - cloudPathAsRealPath boolean 否 - - url string 否 - - errMsg string 否 - - tempFilePaths Array<string> 是 - - -

参见

• 相关 Bug

注意

• 4.18之前uni-app-x在app端仅支持选择图片，即type参数仅能设为image。
• 4.18及之后的版本uni-app-x在app端仅支持选择图片、视频，即type参数仅能设为image、video。

getTempFileURL(options)

获取文件临时URL

getTempFileURL 兼容性

Web	微信小程序	Android	iOS	HarmonyOS
4.0	4.41	阿里云 3.9，腾讯云 3.91，支付宝云 3.98	4.11	4.61

参数

名称	类型	必填	默认值	兼容性	描述
options	UniCloudGetTempFileURLOptions	是	-	-	-
名称 类型 必备 默认值 兼容性 描述 fileList Array<string> 是 - - 文件列表

返回值

类型
Promise<UniCloudGetTempFileURLResult>
名称 类型 必备 默认值 兼容性 描述 fileList Array<UniCloudGetTempFileURLResultItem> 是 - - 文件列表 名称 类型 必备 默认值 兼容性 描述 fileID string 是 - - 文件id tempFileURL string 是 - - 文件临时url

参见

• 相关 Bug