ok.chooseEcloudImage(object)

基础库1.2.4开始支持

从云盘相册选择图片。

参数

Object object

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

object.fileType 的合法值

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

object.displayMode 的合法值

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

接口返回值 Object res 的属性

Object res

参数名	类型	说明
`code`	number	响应状态码
`data`	object	成功响应结果
`ok`	boolean	值为`true`时，表示用户点击了确定按钮
`cancel`	boolean	值为`true`时，表示用户点击了取消按钮
`localFiles`	array	图片的本地文件列表
`fileId`	string	图片的云端文件 ID（唯一性，云盘文件唯一ID）
`fileName`	string	图片的云端文件名称
`fileSize`	string	图片的云端文件原图大小/单位（KB）
`smallUrl`	string	图片的云端文件路径（可作为`img`标签的`src`属性显示图片）
`middleUrl`	string	图片的云端文件路径（可作为`img`标签的`src`属性显示图片）
`largeUrl`	string	图片的云端文件路径（可作为`img`标签的`src`属性显示图片）
`familyId`	number	家庭id（当选择家庭云照片时展示familyId）
`msg`	string	响应信息

示例代码

ok.chooseEcloudImage({
    minCount: 3,
    maxCount: 9,
    okText: '完成',
    tipsText: ['照片冲印18张包邮', '仅支持 JPG、PNG、HEIC 格式照片'],
    fileType: ['jpg', 'jpeg', 'png', 'heic'],
    displayMode: 'filter',
    selectedStyle: 1
}).then(res => {
  if (res.data.ok) {
    console.log(res.data.localFiles);
    // [
    //     {
    //         "fileId": "c4b1b2924b974dab83710a63769d1d99",
    //         "fileName": "IMG_20191102_160941.jpg",
    //         "fileSize": "688802",
    //         "familyId": "684350435",
    //         "smallUrl": "https://preview.cloud.189.cn/image/familyImageAction?xxx",
    //         "middleUrl": "https://preview.cloud.189.cn/image/familyImageAction?xxx",
    //         "largeUrl": "https://preview.cloud.189.cn/image/familyImageAction?xxx",
    //     },
    //     {
    //         "fileId": "73142de80f78423fb17f12098734d6c7",
    //         "fileName": "IMG_20191103_092437.jpg",
    //         "familyId": "684350435",
    //         "smallUrl": "https://preview.cloud.189.cn/image/familyImageAction?xxx",
    //         "middleUrl": "https://preview.cloud.189.cn/image/familyImageAction?xxx",
    //         "largeUrl": "https://preview.cloud.189.cn/image/familyImageAction?xxx",
    //     }
    // ]
  } else if (res.data.cancel) {
    console.log('用户点击了取消');
  }
})

1. ok.chooseEcloudImage(object)