图片插件(WorkPlus_Image)
1. 拍照返回
拍照,压缩图片后直接返回图片
请求调用示例:
function takePhoto(){
cordova.exec(function(result) {
alert(JSON.stringify(result, null, 4));
},
function(error) {
alert("调用失败");
},
"WorkPlus_Image",
"takePhoto",
[]);
}
说明:
请求输入数据:无
请求返回数据:
{
"imageURL":"压缩后图像存在本地的地址",
"key":"原图像存在本地的地址",
"imageInfo": //相对于图像的信息
{
"height":"图像高",
"width":"图像宽",
"size":"图像大小"
}
}
2. 拍照返回并且可编辑
拍照,截图返回
请求调用示例:
function takePhotoWithEdit(){
cordova.exec(function(result) {
alert(JSON.stringify(result, null, 4));
},
function(error) {
alert("调用失败");
},
"WorkPlus_Image",
"takePhotoWithEdit",
[]);
}
说明:
请求输入数据:无
请求返回数据:
{
"imageURL":"压缩后图像存在本地的地址",
"key":"原图像存在本地的地址",
"imageInfo": //相对于图像的信息
{
"height":"图像高",
"width":"图像宽",
"size":"图像大小"
}
}
3. 选择图片(单张)
调用图片相册,选择图片并压缩返回
请求调用示例:
function selectImage(){
cordova.exec(function(result) {
alert(JSON.stringify(result, null, 4));
},
function(error) {
alert("调用失败");
},
"WorkPlus_Image",
"selectImage",
[]);
}
说明:
请求输入数据:无
请求返回数据:
{
"imageURL":"压缩后图像存在本地的地址",
"key":"原图像存在本地的地址",
"imageInfo": //相对于图像的信息
{
"height":"图像高",
"width":"图像宽",
"size":"图像大小"
}
}
4. 选择图片并截图返回(单张)
调用图片相册,选择图片并截取返回
请求调用示例:
function selectImageWithEdit(){
cordova.exec(function(result) {
alert(JSON.stringify(result, null, 4));
},
function(error) {
alert("调用失败");
},
"WorkPlus_Image",
"selectImageWithEdit",
[]);
}
说明:
请求输入数据:无
请求返回数据:
{
"imageURL":"压缩后图像存在本地的地址",
"key":"原图像存在本地的地址",
"imageInfo": //相对于图像的信息
{
"height":"图像高",
"width":"图像宽",
"size":"图像大小"
}
}
5. 选择多张图片
调用图片相册,选择多张图片并压缩返回,并且支持选过图片的传输
请求调用示例:
function selectImageWithEdit(){
cordova.exec(function(result) {
alert(JSON.stringify(result, null, 4));
},
function(error) {
alert("调用失败");
},
"WorkPlus_Image",
"selectImages",
[{"imageKeys":["图片在本机的地址", "xxx",...]}]
);
}
说明:
请求输入数据(可无):[{"imageKeys":["图片在本机的地址", "xxx",...]}]
请求返回数据:
[{
"imageURL":"压缩后图像存在本地的地址",
"key":"原图像存在本地的地址",
"imageInfo": //相对于图像的信息
{
"height":"图像高",
"width":"图像宽",
"size":"图像大小"
}
},
...
]
6. 清除压缩后的图片
拍照或选择照片后都会生成压缩图片,调用这个方法去清除
请求调用示例:
function cleanCompressImage(){
cordova.exec(function(result) {
alert(JSON.stringify(result, null, 4));
},
function(error) {
alert("调用失败");
},
"WorkPlus_Image",
"cleanCompressImage",
[]
);
}
说明:
请求输入数据:无
请求返回数据:无
7. 批量预览图片
传输图片地址,预览图片
请求调用示例:
function showImages(){
cordova.exec(function(result) {
alert(JSON.stringify(result, null, 4));
},
function(error) {
alert("调用失败");
},
"WorkPlus_Image",
"showImages",
[{
“urls”:["图片在本机的地址", "xxxxx",...],
"medias":["图片的mediaId", "xxxxx",...]
}]
);
}
说明:
请求输入数据:
[{
“urls”:["图片在本机的地址", "xxxxx",...],
"medias":["图片的mediaId", "xxxxx",...]
}]请求返回数据:无
8. 保存图片
传输图片地址,保存图片
请求调用示例:
function saveImages(){
cordova.exec(function(result) {
alert(JSON.stringify(result, null, 4));
},
function(error) {
alert("调用失败");
},
"WorkPlus_Image",
"saveImages",
[
{
“mediaId”:"图片mediaId",
"url":"图片url地址",
}
]
);
}
说明:
请求输入数据:
[
{
“mediaId”:"图片mediaId",
"url":"图片url地址",
}
]
请求返回数据:无
9. 长按图片弹出框
弹出框包括"识别二维码", "保存图片"等选项
请求调用示例:
function actionForLongPressImage(){
cordova.exec(function(result) {
alert(JSON.stringify(result, null, 4));
},
function(error) {
alert("调用失败");
},
"WorkPlus_Image",
"actionForLongPressImage",
[]
);
}
说明:
请求输入数据:
[
{
"imageData": "base64数据"
}
]
请求返回数据:无
10. 新增拍照返回接口(返回带mediaId方式)[此新增接口,workplus版本必须为3.1.3 之后可用]
新增接口,拍照返回,根据传入参数决定是否可以进行裁剪编辑, 同时会将图片上传后台,返回mediaId
请求调用示例:
function takePicture() {
cordova.exec(function(result) {
alert(result)
},
function(error) {
alert(error)
},
"WorkPlus_Image",
"takePicture", [{"editable":true
}]);
}
说明:
请求输入数据:[{"editable":true}]
editable 表示是否进行裁剪
true : 进行裁剪返回,false : 不裁剪直接返回
请求返回数据:
{
"mediaId": "返回后台的mediaId"
"imageURL":"压缩后图像存在本地的地址",
"key":"原图像存在本地的地址",
"imageInfo": //相对于图像的信息
{
"height":"图像高",
"width":"图像宽",
"size":"图像大小"
}
}
11. 新增选择图片接口(返回带mediaId方式)[此新增接口,workplus版本必须为3.1.3 之后可用]
调用图片相册,根据用户参数决定是否选择多张图片或单张图片,支持编辑剪裁(编辑剪裁功能仅仅限于单张图片功能),并且支持选过图片的传输,选择完后会进行后台上传,返回值中带有上传后的mediaId
请求调用示例:
cordova.exec(function(result) {
alert(result)
},
function(error) {
alert(error)
},
"WorkPlus_Image",
"chooseImages", [{"multiple":true,
"imageKeys":["图片在本机的地址", "xxx",...],
"editable":true
}]);
说明:
请求输入数据:
[{
"multiple":true,
"imageKeys":["图片在本机的地址", "xxx",...],
"editable":true
}]
multiple : 是否是多选,ture(多选) fals(单选)
editable : 是否对图像进行剪裁 true(剪裁) false(不剪裁)
注意: editable 为true剪裁方式仅对于单选图片情况下生效,即multiple = false
imageKeys : 可以传送之前选过的图片
请求返回数据:
[{
"imageURL":"压缩后图像存在本地的地址",
"key":"原图像存在本地的地址",
"mediaId":"图像在后台的媒体mediaId"
"imageInfo": //相对于图像的信息
{
"height":"图像高",
"width":"图像宽",
"size":"图像大小"
}
},
...
]