下载文档

设备模块Device
更新时间:2015-07-31

appcan.device.vibrate(millisecond)

使设备震动

  1. millisecond:设备震动的时常 单位毫秒

例如:

  1. //让手机振动10秒
  2. appcan.device.vibrate(10000);

appcan.device.cancelVibrate()

停止设备震动

例如:

  1. //取消手机振动
  2. appcan.device.cancelVibrate()
  3. //另外一种使用方式
  4. var device = appcan.require('device');
  5. device.cancelVibrate()

appcan.device.getInfo(infoId,callback)

获取设备对应id的信息

  1. infoId:相关信息id
  2.  0: 描述CPU频率的字符串,eg:“1024MHZ”。IOS平台获取不到时,返回“0
  3.  1: 描述系统版本的字符串,eg:“Android2.3.4
  4.  2:标书设备制造商的字符串eg:“htc
  5.  3:代表是否支持键盘的字符串0(不支持)或1(支持)
  6.  4:代表是否支持蓝牙的字符串0(不支持)或1(支持) 当设备有蓝牙功能时,即使蓝牙关闭,返回信息仍然是支持蓝牙,即值为字符串1 IOS上的蓝牙功能只支持同一应用间使用,和普遍人们理解的不同,视为不支持。
  7.  5:代表是否支持WIFI的字符串0(不支持)或1(支持) 当设备有wifi功能时,即使wifi关闭,返回信息仍然是支持wifi,即值为字符串1
  8.  6:代表是否支持摄像头的字符串0(不支持)或1(支持)
  9.  7:代表是否支持GPS的字符串0(不支持)或1(支持) 当设备有gps功能时,即使gps关闭,返回信息仍然是支持gps,即值为字符串1
  10.  8:代表当前移动网络数据连接是否可用(不含WIFI)的字符串0(不可用)或1(可用)
  11.  9:代表设备是否支持触屏的字符串0(不支持)或1 (支持)
  12.  10:代表此设备IMEI(国际移动设备唯一标识码)号的15位字符串,eg:“356357046156042”。 IOS上,获得不到imei时可获得UUIDeg:“dea7f0e2f8c7dfd0c07555b96aff2d342587505b
  13.  11:推送服务器需要的一个代表此设备的唯一令牌的字符串。 eg:“98d264a3 77689b33 6f1215e6 264ab0c5 55f45b4a ab61e6ff f667883a ef829ccb”,没有时返回空字符串。 AndroiddeviceTokensoftToken
  14.  12:设备类型,用来判断当前的设备是phone ouch或者pad(IOS专用,类型值参考常量表IOS设备类型)
  15.   13:当前联网的方式(类型值参考常量表网络状态类型)
  16.  14:当前设备剩余的磁盘空间大小的字符串,eg:“12345678”单位:字节
  17.  15:当前移动网络运营商的名称,比如”中国联通”,如果获取不到返回空字符串
  18.  16:表示当前设备的WIFI mac地址 ,可作为设备的唯一标识,IMEI可能在某些不具备移动通讯的android平板或MP4上获取不到,但是android系统设备一般都会具有WIFI功能,所以mac地址作为设备唯一标识比IMEI更可靠
  19.  17:当前设备的型号名称,如“Galaxy Nexus
  20. callback(err,data,dataType,optId):第一个参数是Error对象如果为空则表示 没有错误,否则表示操作出错了,data表示返回的操作结果,dataType操作结果的数据类型,optId该操作id

例如:

  1. //获取手机WIFI信息
  2. appcan.device.getInfo(5,function(err,data,dataType,optId){
  3. if(err){
  4. alert('get device error');
  5. return;
  6. }
  7. //{wifi:1}
  8. });
  9. //另外一种使用方式
  10. var device = appcan.require('device');
  11. device.getInfo(5,function(err,data,dataType,optId){
  12. if(err){
  13. alert('get device error');
  14. return;
  15. }
  16. //{wifi:1}
  17. });

appcan.device.getDeviceInfo(callback)

获取所有相关的设备信息

  1. callback(deviceInfo,singleInfo,i,len,completeCount):
  2.    deviceInfo当前已经获得的设备信息
  3.   singleInfo正在读取的设备信息
  4.   i设备信息id
  5.   len设备信息总数
  6. completeCount已经获得的设备信息数

例如:

  1. //获取所有相关的信息
  2. appcan.device.getDeviceInfo(function(deviceInfo,singleInfo,i,len,completeCount){
  3. //deviceInfo 所有的信息,这是一个循环,每调用一次增加一个
  4. });
  5. //另外一种使用方式
  6. var device = appcan.require('device');
  7. device.getDeviceInfo(function(deviceInfo,singleInfo,i,len,completeCount){
  8. //deviceInfo 所有的信息,这是一个循环,每调用一次增加一个
  9. });