uni.chooseImage(options)
从本地相册选择图片或使用相机拍照
参数
ChooseImageOptions
| 名称 | 类型 | 必填 | 描述 |
|---|
| count | number | 否 | 最多可以选择的图片张数，默认9 |
| sizeType | Array<string> | 否 | original 原图，compressed 压缩图，默认二者都有 |
| sourceType | Array<string> | 否 | album 从相册选图，camera 使用相机，默认二者都有 |
| extension | Array<string> | 否 | 根据文件拓展名过滤，每一项都不能是空字符串。默认不过滤。 |
| crop | ChooseImageCropOptions | 否 | 图像裁剪参数，设置后 sizeType 失效。 |
| success | (ChooseImageSuccessCallback) => void | 否 | 成功则返回图片的本地文件路径列表 tempFilePaths |
| fail | (UniError) => void | 否 | 接口调用失败的回调函数 |
| complete | (any) => void | 否 | 接口调用结束的回调函数（调用成功、失败都会执行） |
ChooseImageCropOptions
| 名称 | 类型 | 必填 | 描述 |
|---|
| width | number | 是 | 裁剪的宽度，单位为px，用于计算裁剪宽高比。 |
| height | number | 是 | 裁剪的高度，单位为px，用于计算裁剪宽高比。 |
| quality | number | 是 | 取值范围为1-100，数值越小，质量越低（仅对jpg格式有效）。默认值为80。 |
| resize | boolean | 是 | 是否将width和height作为裁剪保存图片真实的像素值。默认值为true。注：设置为false时在裁剪编辑界面显示图片的像素值，设置为true时不显示。 |
| saveToAlbum | boolean | 是 | 是否将裁剪的图片保存到手机相册里，默认值为false。 |
ChooseImageSuccessCallback
| 名称 | 类型 | 必填 | 描述 |
|---|
| errSubject | string | 是 | 调用API的名称 |
| errMsg | string | 是 | - |
| tempFilePaths | Array<string> | 是 | - |
| tempFiles | any | 是 | - |
兼容性
| 安卓系统版本 | 安卓 uni-app | 安卓 uni-app-x | iOS 系统版本 | iOS uni-app | iOS uni-app-x |
|---|
| 4.4 | √ | 3.9.0 | - | - | - |
参见
chooseImage
通用类型
GeneralCallbackResult
| 名称 | 类型 | 必填 | 描述 |
|---|
| errMsg | string | 是 | 错误信息 |
