uexDevice查看3.0文档

1.1、说明

本类封装了设备硬件参数相关信息和硬件状态相关信息.

1.2、UI展示

1.3、开源源码

插件测试用例与源码下载:点击插件中心至插件详情页 (插件测试用例与插件源码已经提供)

1.4、平台版本支持

本插件的所有API默认支持Android4.0+iOS7.0+操作系统. 有特殊版本要求的API会在文档中额外说明.

1.5、接口有效性

本插件所有API默认在插件版本4.0.0+可用. 在后续版本中新添加的接口会在文档中额外说明.

2、API概览

2.1、方法
vibrate //开启设备震动

uexDevice.vibrate(milliseconds)

说明:

开启设备震动,iOS平台中,ipad,ipod不支持震动.

参数:

参数名称 参数类型 是否必选 说明
milliseconds Number 震动持续时长,单位毫秒

示例:

    uexDevice.vibrate(500);
cancelVibrate //关闭设备震动

uexDevice.cancelVibrate()

说明:

关闭设备震动

参数:

示例:

    uexDevice.cancelVibrate();
getInfo //获取设备信息

uexDevice.getInfo(infoID)

说明:

获取设备信息

参数:

参数名称 参数类型 是否必选 说明
infoID Number 设备信息类型,详见CONSTANT中设备信息类型.

返回值:

String类型对应设备信息.

示例:

 var systemVersion = uexDevice.getInfo('1');//获取系统版本
 alert(systemVersion);
screenCapture //获取当前屏幕截图

uexDevice.screenCapture(quality, callbackFunction)

说明:

获取当前屏幕截图

参数:

参数名称 参数类型 是否必选 说明
quality Number 图片压缩质量,取值范围[0,1] 为0时压缩率最大
callbackFunction Function 回调函数,用来获取相关业务数据

回调参数:

var callbackFunction = function(error,data){
}
参数名称 参数类型 说明
error Number 为0时表示成功,非0时表示失败
data Object 返回数据,形式见下
var data = { 
   savePath://String,屏幕截图的路径,error非零为空字符串
}

示例:

    uexDevice.screenCapture(0.8,function(error,data){
          if (!error) {
              alert('截屏成功:' + data.savePath);
          } else {
              alert('截屏失败');
  }
  });
setVolume //设置系统音量值

uexDevice.setVolume(volume)

说明:

设置系统音量值.特别说明,iOS需关闭设置—>声音—>用按钮调整,才有效.

参数:

参数名称 参数类型 是否必选 说明
volume Number 音量大小,取值范围0~1 为1时音量为最大

示例:

    uexDevice.setVolume(0.5);//设置系统音量
getVolume //获取系统音量值

uexDevice.getVolume()

说明:

获取系统音量值

参数:

返回值:

Number类型音量值

示例:

 var volume = uexDevice.getVolume();//获取系统音量值
 alert(volume);
setScreenAlwaysBright //屏幕常亮控制

uexDevice.setScreenAlwaysBright(data)

说明:

屏幕常亮控制(应用在前台时有效)

参数:

参数名称 参数类型 是否必选 说明
data Number 屏幕常亮控制值,0 为取消常亮控制;1为设置屏幕常亮

示例:

    uexDevice.setScreenAlwaysBright(1);//设置屏幕常亮
setScreenBrightness //调整屏幕亮度

uexDevice.setScreenBrightness(brightness)

说明:

调整屏幕亮度

参数:

参数名称 参数类型 是否必选 说明
brightness Number 屏幕亮度值,取值范围[0,1] 为1时屏幕亮度最大

示例:

    uexDevice.setScreenBrightness(0.5);//设置屏幕亮度
getScreenBrightness //获取屏幕亮度值

uexDevice.getScreenBrightness()

说明:

获取屏幕亮度值

参数:

返回值:

Number类型屏幕亮度值

示例:

 var brightness = uexDevice.getScreenBrightness();//获取屏幕亮度
 alert(brightness);
openWiFiInterface //打开WIFI设置页面

uexDevice.openWiFiInterface()

说明:

打开WIFI设置页面

参数:

示例:

    uexDevice.openWiFiInterface();//打开WIFI设置页面
isFunctionEnable //判断某功能是否开启

uexDevice.isFunctionEnable(params, callbackFunction)

说明:

判断某功能是否开启

参数:

var params = {
    setting:
}

各字段含义如下:

字段名称 类型 是否必选 说明
setting String 功能名称,详情请参考功能
callbackFunction 函数 必选 回调函数,用来获取相关业务数据

回调参数:

var callbackFunction = function(data){
}
参数名称 参数类型 说明
data Boolean true开启,false未开启

示例:

var params = {
     setting:"GPS"//位置服务功能
};
var data = JSON.stringify(params);
uexDevice.isFunctionEnable(data, function(data) {
   if (data) {
           alert('已开启');
       } else {
           alert('未开启');
           }
});
getIP //获取系统IP

uexDevice.getIP()

说明:

获取系统IP,同步返回内网地址

参数:

返回值:

String 内网IP

示例:

 var ip = uexDevice.getIP();
 alert(ip);
openSetting //打开设置界面

uexDevice.openSetting(params)

说明:

打开设置界面,iOS统一打开系统设置里App的页面

参数:

var params = {
    setting:
}

各字段含义如下:

字段名称 类型 是否必选 说明
setting String 功能名称,详情请参考功能,不传时打开设置入口界面

示例:

var params = {
     setting:"GPS"//位置服务功能
};
var data = JSON.stringify(params);
uexDevice.openSetting(data);
startNetStatusListener //打开网络状态监听器

uexDevice.startNetStatusListener(params)

说明:

  • 打开网络状态监听器。
  • 为避免内存泄露,在不需要监听网络状态时,必须调用stopNetStatusListener关闭网络状态监听器。

参数:

版本支持:

  • iOS 4.0.3+
  • Android 4.0.2+

示例:

uexDevice.startNetStatusListener();
stopNetStatusListener //关闭网络状态监听器

uexDevice.stopNetStatusListener(params)

说明:

关闭网络状态监听器。

参数:

版本支持:

  • iOS 4.0.3+
  • Android 4.0.2+

示例:

uexDevice.stopNetStatusListener();
2.2、监听方法
onOrientationChange //屏幕旋转的监听方法

uexDevice.onOrientationChange(mode)

说明:

该监听方法需要注册在主窗口中,注册在浮动窗口中无效.

参数:

参数名称 参数类型 是否必选 说明
mode Number 屏幕方向,1-正竖屏;2-左横屏.

示例:

 uexDevice.onOrientationChange = function(mode){
    if(mode == 1){
        alert("正竖屏");
    }else if(mode == 2){
        alert("左横屏");
    }
};
onNetStatusChanged //网络状态变化的监听方法

uexDevice.onNetStatusChanged(data)

说明:

网络状态变化的监听方法。

参数:

参数名称 参数类型 是否必选 说明
data String 网络状态,-1:无网络连接;0:wifi网络;1:3G网络;3:4G网络。

平台支持:

Android2.2+ iOS6.0+

版本支持:

3.0.0+

示例:

 uexDevice.onNetStatusChanged = function(data){
    alert(data);
};

3、更新历史

iOS

API版本: uexDevice-4.0.4

最近更新时间:2017-04-28

历史发布版本 更新内容
4.0.4 plugin.xml文件配置startNetStatusListener和stopsNetStatusListener方法
4.0.3 增加onNetStatusChanged,startNetStatusListener和stopsNetStatusListener网络监听方法
4.0.1 添加接口getIP(),可以获取本地IP地址
Android

API版本: uexDevice-4.0.2

最近更新时间:2017-01-16

历史发布版本 更新内容
4.0.2 增加网络状态监听的功能
4.0.1 添加接口getIP(),可以获取本地IP地址

4、附录

Settings
value 说明
GPS GPS功能
BLUETOOTH 蓝牙功能
NOTIFICATION 推送通知设置(仅iOS)
CAMERA 摄像头权限是否开启
还需要帮助吗? 联系我们
最新更新 2nd May 2017