图片

1. 相机拍照,相册选图

(@since 云助手app 3.1.6)

yzs.chooseImage({
    count:3,
    width:500,
    height:500,
    crop:false,
    sourceType: ["album", "camera"],
    success:function(result){
        /*{
          "images": [
            {
               "localId": "wzsLocalResource_752333898F024F8898F1DEB24CFD7A4C",
               "image": "data:image/jpeg;base64,/9j/2Q==",
               "isOriginal":true,
               "exif":{
                  "height": 3024,
                  "width": 4032,
                  "time": "2020-01-01 10:10:00",
                  "make": "Xiaomi",
                  "model": "Mi 8"
                }
            }
          ]
        }*/
    },
    error:function(result) {
    }
});

参数说明

参数 参数类型 必须 说明
count int 选取图片的个数,默认1张
width int 获取缩略图的宽度,默认200
height int 获取缩略图的宽度,默认200
crop bool 是否需要对图片进行裁剪,默认false,如果要裁剪选完图片后,会自动进去图片裁剪页面
sourceType Array 可以指定来源是相册还是相机,不传或者数组为空都默认为二者都有

返回说明

参数 参数类型 说明
localId String 获取到的图片对应的本地资源id,后面的插件会用到这个id信息
image String 缩略图对应的base64内容
isOriginal boolean @Since 3.4.1 是否要原图上传,默认false

2. 相机拍照,相册选图片视频

(@since 云助手app 4.0.4)

yzs.chooseImageVideo({
    image:{
        width:500,
        height:500,
        crop:false,
    },
    video:{
        maxSize:800
    },
    count:3,
    mode:0,
    sourceType: ["album", "camera"],
    success:function(result){
        /*{
          "images": [
            {
               "localId": "wzsLocalResource_752333898F024F8898F1DEB24CFD7A4C",
               "image": "data:image/jpeg;base64,/9j/2Q==",
               "isOriginal":true,
               "exif":{
                  "height": 3024,
                  "width": 4032,
                  "time": "2020-01-01 10:10:00",
                  "make": "Xiaomi",
                  "model": "Mi 8"
                }
            }
          ],
          "videos": [
            {
               "localId": "wzsLocalResource_752333898F024F8898F1DEB24CFD7A4C",
               "image":"data:image/jpeg;base64,/9j/2Q==",
               "duration":60,
               "exif":{
                  "size": 800,
                  "format": "mp4"
                }
            }
          ]
        }*/
    },
    error:function(result) {
    }
});

参数说明

参数 参数类型 必须 说明
image.width int 获取缩略图的宽度,默认200
image.height int 获取缩略图的宽度,默认200
image.crop bool 是否需要对图片进行裁剪,默认false,true:裁剪选完图片后,会自动进去图片裁剪页面(仅当count=1且mode=0)
video.maxSize int 选择视频文件时值显示小于等于maxSize的视频,单位为K.不传或者值非法的情况下,将显示所有视频文件
count int 选取图片和视频的总数,默认1个
mode int 0:仅仅支持图片 1:仅仅支持视频 2:同时支持图片和视频
sourceType Array 可以指定来源是相册还是相机,不传或者数组为空都默认为二者都有

返回说明

参数 参数类型 说明
images[n].localId String 获取到的图片对应的本地资源id,后面的插件会用到这个id信息
image String 缩略图对应的base64内容
isOriginal boolean @Since 3.4.1 是否要原图上传,默认false
videos[n].localId String 获取到的视频对应的本地资源id,后面的插件会用到这个id信息
videos[n].image String 视频第一帧图像base64内容
videos[n].duration int 视频时长,单位秒
exif.size int 视频文件大小,单位为K
exif.format String 视频文件格式,mp4,avi等

3. 图片预览

(@since 云助手app 3.1.6)

yzs.previewImage({
    urls: ["http://x.y/z.png","wzsLocalResource_752333898F024F8898F1DEB24CFD7A4C"]
    current: "http://x.y/z.png",
    success: function(result) {
    },
    error: function(result) {
    }
})

参数说明

参数 参数类型 必须 说明
urls Array[String] 要预览的图片地址,可以是网络地址,也可以是本地资源id(拍照插件返回的id)
current String 预览时自动定位对应的图片,如果不传,默认定位到urls数组中的第一个图片

4. 图片预览,视频播放

(@since 云助手app 4.0.4)

yzs.previewImageVideo({
    urls: [{
              "url": "http://x.y/z.png",
              "type": "image"
            }, 
            {
              "url": "http://x.y/z.mp4",
              "type": "video"
            }, 
            {
              "url": "wzsLocalResource_752333898F024F8898F1DEB24CFD7A4C",
              "type": "video"
            }, 
            {
              "url": "wzsLocalResource_752333898F024F8898F1DEB24CFD7A4A",
              "type": "image"
            }
          ],
    current: 0,
    config:{
      autoPlayVideo:false
    },
    success: function(result) {
    },
    error: function(result) {
    }
})

参数说明

参数 参数类型 必须 说明
urls Array[Object] 要预览的图片或要播放的视频地址,可以是网络地址,也可以是本地资源id(拍照插件返回的id)
current int 预览或播放时自动定位对应的图片或者视频,如果不传,默认定位到urls数组中的第一个元素
config.autoPlayVideo bool 打开视频后是否自动播放,默认为false

5. 获取图片信息

(@since 云助手app 3.1.6)

yzs.getPictureById({
    ids: ['wzsLocalResource_752333898F024F8898F1DEB24CFD7A4C'],
    maxSize: 300,
    success:function(result){
      /*
         [
           {
            "localResourceId":"wzsLocalResource_752333898F024F8898F1DEB24CFD7A4C",
            "data":"data:image/jpg;base64,/9j/4A//Z"
            }
         ]
      */
    },
    error:function(result) {
    }
});

参数说明

参数 参数类型 必须 说明
ids Array[String] 要获取的图片本地资源id数组
maxSize int 返回的图片大小,默认300K

返回说明

参数 参数类型 说明
localResourceId String 获取到的图片对应的本地资源id
data String 图片对应的base64内容

6. 图片上传

(@since 云助手app 3.1.6)

 yzs.uploadImage({
    localIds: ['wzsLocalResource_752333898F024F8898F1DEB24CFD7A4C'],
    appCode:'3000',
    sync:false,
    maxSize:300,
    isOriginal:false,
    progress: function(index,total) {
        /*
          1 //当上传多张图片时,每上传一张成功后,就会回调这个方法,index为当前图片的索引,从1开始
        */
    },
    success: function(res) {
        /*
         {
            errMsg: "uploadImage:ok",
            images: [
                  {
                     localId: "wzsLocalResource_6ED17477056E45059A123DF84959627F",
                     url: "https://oss/3000/d6b8",
                     thumb: "https://oss/3000/d6b8?x-oss-process=image/resize,m_fixed,h_100,w_100"
                 }
           ]
        }
        */
    },
    error: function(res) {
    }
});

参数说明

参数 参数类型 必须 说明
appCode String 在企业平台中挂接应用时对应的code代码
ids Array[String] 要获取的图片本地资源id数组
maxSize int 返回的图片大小(非原图上传),默认300K
sync bool 同步或异步 true 同步 false异步 默认异步
isOriginal boolean @Since 3.4.1 是否要原图上传,默认false

返回说明

参数 参数类型 说明
localId String 图片对应的本地资源id
url String 上传后的图片对应的网络地址
thumb String 上传后的缩略图对应的网络地址

7. 图片上传V2

(@since 云助手app 3.5.1)

 yzs.uploadImageV2({
    localId: 'wzsLocalResource_752333898F024F8898F1DEB24CFD7A4C',
    appCode:'3000',
    sync:false,
    maxSize:300,
    isOriginal:false,
    interval:1000,
    progress: function(res) {
        /*
          同步上传模式下,上传过程中会调用此方法并会返回图片上传的实时进度,
          格式如下
          {
            "localId":"图片的localId",
            "url":"http://www.xxx.yyy.png,
            "thumb":"http://www.xxx.yyy.png,
            "progress":50 (0-100)
          }
        */
    },
    success: function(res) {
        /* 图片上传成功后,会调用此方法
          {
            "localId":"图片的localId",
            "url":"http://www.xxx.yyy.png,
            "thumb":"http://www.xxx.yyy.png,
            "progress":100 (0-100)
          }
        */
    },
    error: function(res) {
       /* 上传失败或者调用参数不合法时会调用此方法
          {
            "code":-1,
            "message":"错误信息"
          }
        */
    }
});

参数说明

参数 参数类型 必须 说明
appCode String 在企业平台中挂接应用时对应的code代码
localId String 图片本地资源id
maxSize int 返回的图片大小(非原图上传),默认300K
sync bool 同步或异步 true 同步 false异步 默认异步
isOriginal boolean 是否要原图上传,默认false
interval int 同步上传时实时进度的回调时间间隔,单位毫秒 默认1000(1秒)

返回说明

参数 参数类型 说明
localId String 图片对应的本地资源id
url String 上传后的图片对应的网络地址
thumb String 上传后的缩略图对应的网络地址
progress int 上传进度(0-100),同步上传模式下才有此字段

8. 视频上传

(@since 云助手app 4.0.4)

 yzs.uploadVideo({
    localId: 'wzsLocalResource_752333898F024F8898F1DEB24CFD7A4C',
    appCode:'3000',
    sync:false,
    interval:1000,
    progress: function(res) {
        /*
          同步上传模式下,上传过程中会调用此方法并会返回视频上传的实时进度,
          格式如下
          {
            "localId":"视频的localId",
            "url":"http://www.xxx.yyy.mp4,
            "progress":50 (0-100)
          }
        */
    },
    success: function(res) {
        /* 视频上传成功后,会调用此方法
          {
            "localId":"视频的localId",
            "url":"http://www.xxx.yyy.mp4,
            "progress":100 (0-100)
          }
        */
    },
    error: function(res) {
       /* 上传失败或者调用参数不合法时会调用此方法
          {
            "code":-1,
            "message":"错误信息"
          }
        */
    }
});

参数说明

参数 参数类型 必须 说明
appCode String 在企业平台中挂接应用时对应的code代码
localId String 视频本地资源id
sync bool 同步或异步 true 同步 false异步 默认异步
interval int 同步上传时实时进度的回调时间间隔,单位毫秒 默认1000(1秒)

返回说明

参数 参数类型 说明
localId String 视频对应的本地资源id
url String 上传后的视频对应的网络地址
progress int 上传进度(0-100),同步上传模式下才有此字段

9. 图片涂鸦

(@since 云助手app 3.4.0) 参数说明

yzs.graffiti({
    url:"https://ss0.baidu.com/97f.jpg",
    rightBtn:"完成",
    success: function(res) {
     /*
       {
          "code": 0,
          "message": "",
          "localResourceId": "wzsu121312121"
        }
     */
    },
    error: function(res) {
    }
   });
参数 参数类型 必须 说明
url String 要涂鸦图片的网络地址或者本地资源id
rightBtn String 涂鸦界面右上角按钮文本

返回说明

参数 参数类型 说明
localResourceId String 获取到的图片对应的本地资源id

10. 保存base64图片到系统相册

(@since 云助手app 3.6.7) 参数说明

yzs.saveToAlbum({
    base64:"data:image/jpeg;base64,/9j/4...dkad==",
    success: function(res) {
     /*
       {
          "code": 0,
          "message": "",
          "localId": "wzsu121312121"
        }
     */
    },
    error: function(res) {
    }
   });
参数 参数类型 必须 说明
base64 String 要保存的图片base64内容

返回说明

参数 参数类型 说明
localId String 获取到的图片对应的本地资源id

results matching ""

    No results matching ""