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 上传进度回调

参数

名称	类型	必填	描述
options	UniCloudUploadProgress	是	上传进度回调参数
名称 类型 必备 描述 loaded number 是 已上传大小 total number 是 总大小

返回值

类型
any

UniCloudUploadProgress 的属性值

名称	类型	必备	描述
loaded	number	是	已上传大小
total	number	是	总大小

返回值

类型
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

参数

名称	类型	必填
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

参数

名称	类型	必填
arg	UniCloudChooseAndUploadFileProgressEvent	是
名称 类型 必备 index number 是 loaded number 是 total number 是 tempFilePath string 是 tempFile UniCloudChooseAndUploadFileItem 是 名称 类型 必备 name string 是 path string 是 cloudPath string 是 cloudPathAsRealPath boolean 否 url string 否 errMsg string 否

UniCloudChooseAndUploadFileResult 的属性值

名称	类型	必备
tempFiles	Array<UniCloudChooseAndUploadFileItem>	是
名称 类型 必备 name string 是 path string 是 cloudPath string 是 cloudPathAsRealPath boolean 否 url string 否 errMsg string 否
tempFilePaths	Array<string>	是

UniCloudChooseAndUploadFileProgressEvent 的属性值

名称	类型	必备
index	number	是
loaded	number	是
total	number	是
tempFilePath	string	是
tempFile	UniCloudChooseAndUploadFileItem	是
名称 类型 必备 name string 是 path string 是 cloudPath string 是 cloudPathAsRealPath boolean 否 url string 否 errMsg string 否

返回值

类型
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