AppCan插件使用文档之uexDevice.docx

AppCan插件使用文档之uexDevice
uexDevice对象封装了用于调用设备硬件参数相关信息和硬件状态相关信息。
使用示例
以下示例代码说明了如何使用uexDevice对象的方法.

AppCan API uexDevice

function $$(id){
return document.getElementById(id);
}
function isDefin</p><p style='padding:5px 0px;'>2、e(para) {
if (typeof para == 'undefined' || para == '' || para == null || para == undefined) return false;
else return true;
}
window.uexOnload = function(type){
if(!type){
/**
* 屏幕旋转监听方法
* @param {Object} mode
</p><p style='padding:5px 0px;'>3、 */
uexDevice.onOrientationChange = function(mode){
if(mode == 1){
$$('data').innerHTML ='正竖屏';
}else if(mode == 2){
$$('data').innerHTML ='左横屏';
}else if(mode == 4){
$$('</p><p style='padding:5px 0px;'>4、data').innerHTML ='倒竖屏';
}else if(mode == 8){
$$('data').innerHTML ='右横屏';
}
}
uexWidgetOne.cbError=function(opCode,errorCode,errorInfo){
console.log(errorInfo);
}
}
/**
</p><p style='padding:5px 0px;'>5、 * 设备信息的回调方法
* @param {Object} opCode
* @param {Object} dataType
* @param {Object} data
*/
uexDevice.cbGetInfo=function (opCode,dataType,data){
var device = eval('('+data+')');

var cpuFrequency=device.cp</p><p style='padding:5px 0px;'>6、u;
if(isDefine(cpuFrequency)){
console.log('CPU信息：' + cpuFrequency);
}

var osVersion=device.os;
if(isDefine(osVersion)){
console.log('系统版本信息：' + osVersion);
}
var manufacturer=device.man</p><p style='padding:5px 0px;'>7、ufacturer;
if(isDefine(manufacturer)){
console.log('厂商信息：' + manufacturer);
}

var keyboard= device.keyboard;
if(isDefine(keyboard)){
console.log('是否支持键盘：' + keyboard);//1：支持；0：不支持
}

va</p><p style='padding:5px 0px;'>8、r bluetooth=device.blueTooth;
if(isDefine(bluetooth)){
console.log('是否支持蓝牙：' + bluetooth);//1：支持；0：不支持
}

var wifi=device.wifi;
if(isDefine(wifi)){
console.log('是否支持WIFI：' + wifi);//1：支持；0：不支持
}
</p><p style='padding:5px 0px;'>9、 var camera=device.camera;
if(isDefine(camera)){
console.log('是否支持摄像头：' + camera);//1：支持；0：不支持
}

var gps=device.gps;
if(isDefine(gps)){
console.log('是否支持GPS：' + gps);//1：支持；0：不支持
}
</p><p style='padding:5px 0px;'>10、 var gprs=device.gprs;
if(isDefine(gprs)){
console.log('是否支持GPRS：' + gprs);//1：支持；0：不支持
}

var touch=device.touch;
if(isDefine(touch)){
console.log('是否支持触屏：' + touch);//1：支持；0：不支持
}

va</p><p style='padding:5px 0px;'>11、r imei=device.imei;
if(isDefine(imei)){
console.log('IMEI号：' + imei);
}
var deviceToken = device.deviceToken;
if(isDefine(deviceToken)){
//没有时返回空字符串。Android的deviceToken是softToken。
//带推送证书的ios证书打包的i</p><p style='padding:5px 0px;'>12、os安装包可获取
console.log('deviceToken值：' + deviceToken);
}else{
console.log('未获得deviceToken值')
}
var deviceType=device.deviceType ;
if(isDefine(deviceType)){//isAndroid = (/android/gi).test(navigator.appVersion)
</p><p style='padding:5px 0px;'>13、 if(deviceType==0){
//也可用此法判断var isIphone = (/iphone/gi).test(navigator.appVersion)&&!(/iPod/gi).test(navigator.appVersion)
console.log('设备类型：IPhone');
}else if(deviceType==1){
//isIpad = (/ipad/gi).test(navig</p><p style='padding:5px 0px;'>14、ator.appVersion)
console.log('设备类型：IPad');
}else if(deviceType==2){
//isIPodTouch = (/iPod/gi).test(navigator.appVersion),
console.log('设备类型：IPodTouch');
}
}
var connectStatus=</p><p style='padding:5px 0px;'>15、device.connectStatus;
if(isDefine(connectStatus)){
if(connectStatus==-1){
console.log('网络状态：网络不可用');
}else if(connectStatus==0){
console.log('网络状态：WIFI网络');
}else if(connectStatus==1){
</p><p style='padding:5px 0px;'>16、 console.log('网络状态：3G网络');
}else if(connectStatus==2){
console.log('网络状态：2G网络');
}
}
var restDiskSize = device.restDiskSize;
if(isDefine(restDiskSize)){
console.log('磁盘剩余空间：'+r</p><p style='padding:5px 0px;'>17、estDiskSize+'B');//单位Byte
}
var operatorName=device.mobileOperatorName;
if(isDefine(operatorName)){
console.log('移动网络运营商：'+operatorName);
}else{
console.log('为获取到移动网络运营商');//ipod、ipad wifi版
}

</p><p style='height:0px;padding:0;overflow:hidden'>18、 var macAddress=device.macAddress;
if(isDefine(macAddress)){
console.log('mac地址：'+macAddress);//当前设备的WIFI mac地址
}

var model=device.model;
if(isDefine(model)){
console.log('硬件型号：'+model);
}
</p><p style='height:0px;padding:0;overflow:hidden'>19、 }
}
/**
* 设备震动
* 注意：ipod、ipad不支持震动
*/
function startVibrate(){
var time = $$('time').value;
if(!isDefine(time)){
console.log('请填入震动时间');
return ;
}
uexDevice.vibrate(time);
}

设备
屏幕方向切换当前的屏幕方向为：
震动
输入震动持续时间（毫秒为单位）：

ype='button' value='停止震动'onclick='uexDevice.cancelVibrate();'>
设备信息
1.获取CPU信息：

2.获取系统版本:

3.获取厂商信息：

4.获取键盘信息：

5.获取蓝牙信息：

6.获取WIFI信息：

7.获取摄像头信息：

8.获取GPS信息：
value='GPS信息' onclick="uexDevice.getInfo('7');">
9.获取GPRS信息：

10.获取触屏信息：

11.获取IMEI信息：>

12.获取DeviceToken：

13.获取ios设备类型：

14.获取网络状态：

15.获取磁盘剩余空间：

16.获取移动网络运营商的名称：
ue='运营商名称' onclick="uexDevice.getInfo('15');">
17.获取WIFI mac地址：

18.获取硬件型号：

Methods
1、vibrate(inMilliseconds)
启动设备震动器震动一定时间，单位为毫秒数。
备注，ios平台中，ipad，ipod不支持震动，在使用之前需要判断是否是iphone
Parameters：
inMilliseconds
震动毫秒数。

2、cancelVibrate()
取消震动。
3、getInfo(inInfoID)
根据inInfoID获取设备信息或状态。
Parameters
inInfoID
设备信息ID。
inInfoID值
说明
返回值
0
描述CPU频率的字符串，eg：“1024MHZ”。IOS平台获取不到时，返回“0”
{"cpu":"xxx"}
1
描述系统版本的字符串，eg：“Android2.3.4”
{"os":"xxx"}
2
标书设备制造商的字符串eg:“htc”
{"manufacturer":"xxx"}
3
代表是否支持键盘的字符串0（不支持）或1（支持）
{"keyboard":1}
4
代表是否支持蓝牙的字符串0（不支持）或1（支持）
当设备有蓝牙功能时，即使蓝牙关闭，返回信息仍然是支持蓝牙，即值为字符串1。
在IOS上的蓝牙功能只支持同一应用间使用，和普遍人们理解的不同，视为不支持。
{"blueTooth":1}
5
代表是否支持WIFI的字符串0不支持）或1（支持）
当设备有wifi功能时，即使wifi关闭，返回信息仍然是支持wifi，即值为字符串1。
{"wifi":1}
6
代表是否支持摄像头的字符串0（不支持）或1（支持）
{"camera":1}
7
代表是否支持GPS的字符串0（不支持）或1（支持）
当设备有gps功能时，即使gps关闭，返回信息仍然是支持gps，即值为字符串1。
{"gps":1}
8
代表当前移动网络数据连接是否可用（不含WIFI）的字符串0（不可用）或1（可用）
{"gprs":1}
9
代表设备是否支持触屏的字符串0（不支持）或1 （支持）
{"touch":1}
10
代表此设备IMEI（国际移动设备唯一标识码）号的15位字符串，eg：“356357046156042”。
在IOS上，获得不到imei时可获得UUID，eg:“dea7f0e2f8c7dfd0c07555b96aff2d342587505b”
{"imei":"xxx"}
11
推送服务器需要的一个代表此设备的唯一令牌的字符串。
eg：“98d264a3 77689b33 6f1215e6 264ab0c5 55f45b4a ab61e6ff f667883a ef829ccb”,没有时返回空字符串。
Android的deviceToken是softToken。
{"deviceToken":"xxx"}
12
设备类型，用来判断当前的设备是phone ouch或者pad(IOS专用，类型值参考常量表IOS设备类型)
{"deviceType":"0"}
13
当前联网的方式(类型值参考常量表网络状态类型)
{"connectStatus":"-1"}
14
当前设备剩余的磁盘空间大小的字符串，eg：“12345678”单位：字节
{"restDiskSize":"10000"}
15
当前移动网络运营商的名称，比如”中国联通”,如果获取不到返回空字符串
{"mobileOperatorName":"xxx"}
16
表示当前设备的WIFI mac地址 ，可作为设备的唯一标识，IMEI可能在某些不具备移动通讯的android平板或MP4上获取不到，但是android系统设备一般都会具有WIFI功能，所以mac地址作为设备唯一标识比IMEI更可靠
{"macAddress":"xxx"}
17
当前设备的型号名称，如“Galaxy Nexus”
{"model":"xxx"}

4、cbGetInfo(opId,dataType,data)
uexDevice.getInfo的回调函数,返回代表设备信息或状态的字符串
Parameters
opId
操作ID，在此函数中不起作用，可忽略。
dataType
返回数据的数据类型为uex.cJSON(值为1)
data
返回的json格式数据，如：{"typename":"typevalue"}
5、onOrientationChange(inOrientationValue)
屏幕旋转监听方法。
Parameters
inOrientationValue
屏幕的方向。Int ；1：正竖屏；2：左横屏；4：倒竖屏；8：右横屏

    window.uexOnload = function(type){
    if(!type){
        /**
         * 屏幕旋转监听方法
   </p><p style='height:0px;padding:0;overflow:hidden'>35、      * @param {Object} mode
         */
        uexDevice.onOrientationChange = function(mode){
            if(mode == 1){
                $$('data').innerHTML ='正竖屏';
            }else if(mode == 2){
                $$('data').innerHTML ='左横屏';
            }else if(mode == 4){
                $$('data').innerHTML ='倒竖屏';
            }else if(mode == 8){
                $$('data').innerHTML ='右横屏';
            }
        }
    }