device
Device模块管理设备信息,用于获取手机设备的相关信息,如IMEI、IMSI、型号、厂商等。通过plus.device获取设备信息管理对象。
属性:
方法:
- beep: 发出蜂鸣声
- dial: 拨打电话
- getInfo: 获取设备信息
- getOAID: 获取匿名设备标识符
- getVAID: 获取开发者匿名设备标识符
- getAAID: 获取应用匿名设备标识符
- getVolume: 获取设备的系统音量
- isWakelock: 获取程序是否一直保持唤醒(屏幕常亮)状态
- setWakelock: 设置应用是否保持唤醒(屏幕常亮)状态
- setVolume: 设置设备的系统音量
- vibrate: 设备振动
对象:
- DeviceInfo: 设备信息对象
- screen: Screen模块管理设备屏幕信息
- display: Display模块管理应用可使用的显示区域信息
- networkinfo: networkinfo模块用于获取网络信息
- os: OS模块管理操作系统信息
回调方法:
- DeviceSuccessCallback: 成功回调函数
- DeviceFailCallback: 失败回调函数
- DeviceCompleteCallback: 操作完成回调函数
权限:
5+功能模块(permissions)
{ // ... "permissions":{ // ... "Device": { "description": "设备信息" } } }
DeviceInfo
设备信息对象
interface plus.device.DeviceInfo { attribute String imei; attribute String imsi; attribute String uuid; }
属性:
- imei: (String
类型
)设备的国际移动设备身份码
如果设备不支持或无法获取(如用户未授权)则返回空字符串。 如果设备存在多个身份码,则以“,”字符分割拼接,如“862470039452950,862470039452943”。
- imsi: (Array[
String
]
类型
)设备的国际移动用户识别码
字符串数组类型,获取设备上插入SIM的国际移动设备身份码。 如果设备支持多卡模式则返回所有SIM身份码。 如果设备不支持或没有插入SIM卡则返回空数组。
- uuid: (String
类型
)设备标识
设备的唯一标识号。
screen
Screen模块管理设备屏幕信息
interface plus.screen { attribute String dpiX; attribute String dpiY; attribute Number height; attribute Number width; attribute Number resolutionHeight; attribute Number resolutionWidth; attribute Number scale; function void setBrightness(brightness); function Number getBrightness(); function void lockOrientation(orientation); function void unlockOrientation(); }
属性:
- dpiX: 设备屏幕水平方向的密度
- dpiY: 设备屏幕垂直方向的密度
- height: 屏幕高度物理分辨率
- width: 屏幕宽度物理分辨率
- resolutionHeight: 屏幕高度逻辑分辨率
- resolutionWidth: 屏幕宽度逻辑分辨率
- scale: 逻辑分辨率与物理分辨率的缩放比例
方法:
- setBrightness: 设置屏幕亮度
- getBrightness: 获取屏幕亮度值
- lockOrientation: 锁定屏幕方向
- unlockOrientation: 解除锁定屏幕方向
display
Display模块管理应用可使用的显示区域信息
interface plus.display { attribute Number resolutionHeight; attribute Number resolutionWidth; }
属性:
- resolutionHeight: 应用可使用的屏幕高度逻辑分辨率
- resolutionWidth: 应用可使用的屏幕宽度逻辑分辨率
networkinfo
networkinfo模块用于获取网络信息
interface plus.networkinfo { const attribute Number CONNECTION_UNKNOW = 0; const attribute Number CONNECTION_NONE = 1; const attribute Number CONNECTION_ETHERNET = 2; const attribute Number CONNECTION_WIFI = 3; const attribute Number CONNECTION_CELL2G = 4; const attribute Number CONNECTION_CELL3G = 5; const attribute Number CONNECTION_CELL4G = 6; function Number getCurrentType(); }
常量:
- CONNECTION_UNKNOW: 网络连接状态未知
- CONNECTION_NONE: 未连接网络
- CONNECTION_ETHERNET: 有线网络
- CONNECTION_WIFI: 无线WIFI网络
- CONNECTION_CELL2G: 蜂窝移动2G网络
- CONNECTION_CELL3G: 蜂窝移动3G网络
- CONNECTION_CELL4G: 蜂窝移动4G网络
方法:
- getCurrentType: 获取设备当前连接的网络类型
os
OS模块管理操作系统信息
interface plus.os { attribute String language; attribute String name; attribute String vendor; attribute String version; }
属性:
DeviceSuccessCallback
成功回调函数
void onSuccess(JSON event){ }
说明:
不同接口触发的成功回调参数event包含的属性存在差异,具体参考对应的接口描述说明。
参数:
- event:
(
JSON
)
必选 回调参数
回调参数包含的属性由调用接口决定,具体参考对应的接口描述说明。
返回值:
void : 无DeviceFailCallback
失败回调函数
function void onFail(Exception error){ // Handle error var code = error.code; // 错误编码 var message = error.message; // 错误描述信息 }
参数:
- error:
(
Exception
)
必选 回调参数,错误信息
可通过error.code(Number类型)获取错误编码; 可通过error.message(String类型)获取错误描述信息。
返回值:
void : 无DeviceCompleteCallback
操作完成回调函数
function void onComplete(JSON event){ }
说明:
调用成功或失败都会触发此回调。
参数:
- event:
(
JSON
)
可选 回调参数
调用成功时回调参数与DeviceSuccessCallback一致,调用失败时回调参数与DeviceFailCallback一致。