图片

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 ""