imageEXIF

来自于：开发者立即使用

getValue setValue listAll

概述

该模块能够获取，设置图片的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及更高版本