# uploadFile(options)

上传文件到云存储

# uploadFile 兼容性

Web Android iOS
4.0 阿里云 3.9,腾讯云 3.91,支付宝云 3.98 4.11

# 参数

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

# UniCloudUploadFileOptions 的方法

# (options: UniCloudUploadProgress) => any

上传进度回调

# onUploadProgress 兼容性

Web Android iOS
- - -

# 参数

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

# 返回值

类型
any

# 返回值

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

# 参见

# chooseAndUploadFile(options)

选择并上传文件

# chooseAndUploadFile 兼容性

Web Android iOS
4.0 阿里云 3.9,腾讯云 3.91,支付宝云 3.98 4.11

# 参数

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

# UniCloudChooseAndUploadFileOptions 的方法

# (arg: UniCloudChooseAndUploadFileResult) => void | null

# onChooseFile 兼容性

Web Android iOS
- - -

# 参数

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

# (arg: UniCloudChooseAndUploadFileProgressEvent) => void | null

# onUploadProgress 兼容性

Web Android iOS
- - -

# 参数

名称 类型 必填 默认值 兼容性 描述
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> - - -

# 参见

注意

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

# getTempFileURL(options)

获取文件临时URL

# getTempFileURL 兼容性

Web Android iOS
4.0 阿里云 3.9,腾讯云 3.91,支付宝云 3.98 4.11

# 参数

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

# 返回值

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

# 参见