ok.chooseLocalImage(Object object)

从本地相册选择图片

首次使用该方法（本地相册选择图片），会出现授权提示弹框，确认授权后可调用本地相册选择图片功能

参数

Object object

属性名	类型	默认值	必填	说明
`minCount`	number	`1`	否	单次选择最少需要选择的图片张数（已选少于该数量时确认按钮不可点击）
`maxCount`	number	`9`	否	单次选择最多可以选择的图片张数（超出该数量选择时给出超出提示），可选值范围为`0~99`
`okText`	string	`'确定'`	否	确定按钮文字（不传或传空时显示默认值）
`tipsText`	string[]	`[]`	否	底部文字提示语（不传或传空时隐藏，大于1条时滚动轮播）
`fileType`	string[]	`['jpg', 'jpeg', 'png', 'heic']`	否	图片文件类型
`displayMode`	string	`all`	否	展示模式

object.fileType 的合法值

值	类型	说明
`jpg`	string	`JPG`格式图片
`jpeg`	string	`JPEG`格式图片
`png`	string	`PNG`格式图片
`gif`	string	`GIF`格式图片
`heic`	string	`HEIC`格式图片
`livp`	string	`Live Photo`格式图片（仅 iOS）

object.displayMode 的合法值

值	类型	说明
`all`	string	展示所有的图片（除指定`fileType`之外的图片类型不可选中）
`filter`	string	仅展示指定`fileType`的类型的图片（除指定`fileType`之外的图片类型不展示）

接口返回值 Object res 的属性

参数名	类型	说明
`code`	number	响应状态码
`data`	object	成功响应结果
`ok`	boolean	值为`true`时，表示用户点击了确定按钮
`cancel`	boolean	值为`true`时，表示用户点击了取消按钮
`localFiles`	array	图片的本地文件列表
`fileId`	string	图片的本地文件 ID（唯一性，客户端用`UUID`生成）
`fileName`	string	图片的本地文件名称
`filePath`	string	图片的本地文件路径（可作为`img`标签的`src`属性显示图片）
`thumbnailFilePath`	string	图片的本地文件缩略图路径（可作为`img`标签的`src`属性显示图片）
`imgWidth`	number	图片宽度，单位为`px`
`imgHeight`	number	图片高度，单位为`px`
`msg`	string	响应信息

示例代码

ok.chooseLocalImage({
    minCount: 3,
    maxCount: 9,
    okText: '完成',
    tipsText: ['照片冲印18张包邮', '仅支持 JPG、PNG、HEIC 格式照片'],
    fileType: ['jpg', 'jpeg', 'png', 'gif', 'heic'],
    displayMode: 'all'
}).then(res => {
    if (res.data.ok) {
        console.log('用户点击了确定');
        console.log(res.data.localFiles);
        // [
        //     {
        //         "fileId": "c4b1b2924b974dab83710a63769d1d99",
        //         "fileName" "IMG_20191102_160941.jpg",
        //         "filePath" "/storage/emulated/0/DCIM/Camera/IMG_20191102_160941.jpg",
        //         "imgWidth": 3720,
        //         "imgHeight": 1920
        //     }
        // ]
    } else if (res.data.cancel) {
        console.log('用户点击了取消');
    }
}).catch(err => {
    console.log("接口调用异常",err);
});

1. ok.chooseLocalImage(Object object)