uni.chooseFile(options) @choosefile

# uni.chooseFile(options)

从本地选择文件

# chooseFile 兼容性

Web	微信小程序	Android	iOS
4.0	4.41	4.51	x

# 参数

名称

类型

必填

默认值

兼容性

描述

options

ChooseFileOptions

是

名称

类型

必备

默认值

兼容性

描述

count

number

否

最多可以选择的文件数，默认100,注意Android中count只会决定是否是单选/多选，如果count>1 是多选效果，等于1为单选效果,

type

string

否

选择文件的类型，默认all，可选
- image: 选择图片文件
- video: 选择视频文件
- audio: 选择音频文件
- all: 默认值，选择本地文件，包含图片和视频

合法值	兼容性	描述
image	-	-
video	-	-
all	-	-
audio	-	-

extension

Array<string>

否

选择文件的后缀名，暂只支持.zip、.png等，不支持application/msword等值, Android平台不支持

sizeType

any

否

original 原图，compressed 压缩图，默认二者都有, Android平台不支持

sourceType

Array<string>

否

album 从相册选图，camera 使用相机，默认二者都有, Android平台不支持

success

(result: ChooseFileSuccess) => void

否

成功则返回图片的本地文件路径列表 tempFilePaths、tempFiles

fail

(result: IMediaError) => void

否

接口调用失败的回调函数

complete

(result: any) => void

否

接口调用结束的回调函数（调用成功、失败都会执行）

# ChooseFileSuccess 的属性值

名称

类型

必备

默认值

兼容性

描述

tempFilePaths

Array<string>

是

文件的本地文件路径列表, Android平台不支持

tempFiles

Array<ChooseFileTempFile>

是

文件的本地文件列表，每一项是一个 File 对象

名称

类型

必备

默认值

兼容性

描述

name

string

是

选择的文件名称

path

string

是

文件路径

size

number

是

文件大小，单位 B

type

string

是

选择的文件类型
可选值：
- 'video': 选择了视频文件;
- 'image': 选择了图片文件;
- 'audio': 选择了音频文件;
- 'file': 选择了除图片和视频的文件;

合法值	兼容性	描述
video	-	-
image	-	-
audio	-	-
file	-	-

# IMediaError 的属性值

名称

类型

必备

默认值

兼容性

描述

errCode

number

是

错误码

合法值	兼容性	描述
1101001	-	用户取消
1101002	-	urls至少包含一张图片地址
1101003	-	文件不存在
1101004	-	图片加载失败
1101005	-	未获取权限
1101006	-	图片或视频保存失败
1101007	-	图片裁剪失败
1101008	-	拍照或录像失败
1101009	-	图片压缩失败
1101010	-	其他错误