图片
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 |