uploadFile(options)

上传文件到云存储

参数

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

UniCloudUploadFileOptions 的方法

onUploadProgress(options)

上传进度回调

参数

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

返回值

类型
any

返回值

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

uploadFile 兼容性

Android	iOS	web
阿里云 3.9，腾讯云 3.91，支付宝云 3.98	4.11	4.0

参见

相关 Bug

chooseAndUploadFile(options)

选择并上传文件

参数

名称	类型	必填	默认值	描述
options	UniCloudChooseAndUploadFileOptions	是	-	-
名称 类型 必备 默认值 描述 sourceType Array<string> | null 否 - count number | null 否 - sizeType Array<string> | null 否 - extension Array<string> | null 否 - compressed boolean | null 否 - maxDuration number | null 否 - camera string | null 否 - crop ChooseImageCropOptions | null 否 - type string 是 - -

UniCloudChooseAndUploadFileOptions 的方法

onChooseFile(arg)

参数

名称	类型	必填	默认值	描述
arg	UniCloudChooseFileResult	是	-	-
名称 类型 必备 默认值 描述 tempFiles Array<UniCloudChooseFileItem> 是 - - 名称 类型 必备 默认值 描述 name string 是 - - path string 是 - - cloudPath string 是 - - cloudPathAsRealPath boolean | null 否 - url string | null 否 - errMsg string | null 否 - tempFilePaths Array<string> 是 - -

返回值

类型	必备
void | null	否

onUploadProgress(arg)

参数

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

返回值

类型	必备
void | null	否

返回值

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

chooseAndUploadFile 兼容性

Android	iOS	web
阿里云 3.9，腾讯云 3.91，支付宝云 3.98	4.11	4.0

参见

相关 Bug

注意

• 由于uni-app-x暂不支持选择视频、文件，目前此接口仅能上传图片，即type参数仅能设为image。

getTempFileURL(options)

获取文件临时URL

参数

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

返回值

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

getTempFileURL 兼容性

Android	iOS	web
阿里云 3.9，腾讯云 3.91，支付宝云 3.98	4.11	4.0

参见

相关 Bug

示例

hello uni-app x

Template

Script

<template>
  <!-- #ifdef APP -->
  <scroll-view class="page-scroll-view">
  <!-- #endif -->
    <view>
      <page-head :title="title"></page-head>
      <view class="uni-padding-wrap uni-common-mt">
        <view class="uni-btn-v uni-common-mt">
          <button type="primary" @click="uploadFile">选择文件上传</button>
        </view>
      </view>
    </view>
  <!-- #ifdef APP -->
  </scroll-view>
  <!-- #endif -->
</template>


<style>
</style>