imageEXIF

来自于:开发者立即使用

概述

该模块能够获取,设置图片的EXIF信息(包括图片的光圈值,拍摄时间,曝光时间,焦距等信息);

getValue

获取EXIF信息

getValue({params}, callback(ret))

params

path:

  • 类型:字符串
  • 描述:图片路径,(android 不支持widget://)

tag:

  • 类型:字符串
  • 描述:EXIF 信息标记;iOS不支持此参数
  • 取值范围:
    • listAll 方法所列举的所有属性(result中所有的key)(注意:有些属性可能设置无效)

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
{
  status: true,
  value: '',
  msg:'' // status为 false 时,返回              
}

示例代码

var imageEXIF = api.require('imageEXIF');
imageEXIF.getValue({
    tag:'DateTime'
}, function(ret) {
    alert('DateTime: ' + JSON.stringify(ret));
});

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

setValue

设置EXIF信息

setValue({params}, callback(ret))

params

path:

  • 类型:字符串
  • 描述:图片路径,(android不支持widget://)

tag:

  • 类型:字符串
  • 描述:EXIF 信息标记;iOS不支持此参数
  • 取值范围:
    • listAll 方法所列举的所有属性(result中所有的key)(注意:有些属性可能设置无效)

value:

  • 类型: 字符串
  • 描述:EXIF值;iOS不支持此参数

exif:

  • 类型:json对象
  • 描述:图片exif信息;仅支持iOS
  • 内部字段:
{
  dateTimeOriginal:'',//字符串类型;照片创建时间
  userComment:'' // 字符串类型;照片备注              
}

gps:

  • 类型:json对象
  • 描述:图片gps信息;仅支持iOS
  • 内部字段:
{
  latitude:'',//字符串类型;纬度
  latitudeRef:'', // 字符串类型;纬度Ref
  longitude:'',//字符串类型;经度
  longitudeRef:'' // 字符串类型;经度Ref              
}

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
{
  status: true,//布尔类型;是否成功
  msg:'', //字符串类型;错误信息;status为 false 时,返回 
  imagePath:'' //字符串类型;设置完成图片本地路径;仅支持iOS             
}

示例代码

var imageEXIF = api.require('imageEXIF');
imageEXIF.setValue({
  path:''
});

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

listAll

列举所有属性,iOS不支持

listAll({params}, callback(ret))

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
{
  status:false,
  result:{

  },
  msg:'' // status为 false 时,返回               
}

示例代码

var imageEXIF = api.require('imageEXIF');
imageEXIF.listAll(function(ret) {
    alert(JSON.stringify(ret));
});

可用性

Android系统

可提供的1.0.0及更高版本