# [device]()
Device模块管理设备信息，用于获取手机设备的相关信息，如IMEI、IMSI、型号、厂商等。通过plus.device获取设备信息管理对象。
### 属性：
- [imei](http://www.dcloud.io/docs/api/zh_cn/device.shtml#plus.device.imei): 设备的国际移动设备身份码
- [imsi](http://www.dcloud.io/docs/api/zh_cn/device.shtml#plus.device.imsi): 设备的国际移动用户识别码
- [model](http://www.dcloud.io/docs/api/zh_cn/device.shtml#plus.device.model): 设备的型号
- [vendor](http://www.dcloud.io/docs/api/zh_cn/device.shtml#plus.device.vendor): 设备的生产厂商
- [uuid](http://www.dcloud.io/docs/api/zh_cn/device.shtml#plus.device.uuid): 设备的唯一标识
### 方法：
- [dial](http://www.dcloud.io/docs/api/zh_cn/device.shtml#plus.device.dial): 拨打电话
- [beep](http://www.dcloud.io/docs/api/zh_cn/device.shtml#plus.device.beep): 发出蜂鸣声
- [vibrate](http://www.dcloud.io/docs/api/zh_cn/device.shtml#plus.device.vibrate): 设备振动
- [setWakelock](http://www.dcloud.io/docs/api/zh_cn/device.shtml#plus.device.setWakelock): 设置应用是否保持唤醒（屏幕常亮）状态
- [isWakelock](http://www.dcloud.io/docs/api/zh_cn/device.shtml#plus.device.isWakelock): 获取程序是否一直保持唤醒（屏幕常亮）状态
- [setVolume](http://www.dcloud.io/docs/api/zh_cn/device.shtml#plus.device.setVolume): 设置设备的系统音量
- [getVolume](http://www.dcloud.io/docs/api/zh_cn/device.shtml#plus.device.getVolume): 获取设备的系统音量
### 对象：
- [screen](http://www.dcloud.io/docs/api/zh_cn/device.shtml#plus.screen): Screen模块管理设备屏幕信息
- [display](http://www.dcloud.io/docs/api/zh_cn/device.shtml#plus.display): Display模块管理应用可使用的显示区域信息
- [networkinfo](http://www.dcloud.io/docs/api/zh_cn/device.shtml#plus.networkinfo): Device模块用于获取网络信息
- [os](http://www.dcloud.io/docs/api/zh_cn/device.shtml#plus.os): OS模块管理操作系统信息
### 权限：
permissions
~~~
"Device": {
"description": "访问设备信息"
}
~~~
# [imei]()
设备的国际移动设备身份码
~~~
plus.device.imei;
~~~
### 说明：
String 类型 只读属性
调用此属性获取设备的国际移动设备身份码。 如果设备不支持则返回空字符串。
### 平台支持：
- Android - 2.2+ (支持)
- iOS - 4.5+ (不支持): iOS设备不支持获取imei值，返回空字符串。
### 示例：
~~~
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>Device Example</title>
<script type="text/javascript">
// H5 plus事件处理
function plusReady(){
alert( "IMEI: " + plus.device.imei );
}
if(window.plus){
plusReady();
}else{
document.addEventListener("plusready",plusReady,false);
}
</script>
</head>
<body>
获取设备的国际移动设备身份码
</body>
</html>
~~~
# [imsi]()
设备的国际移动用户识别码
~~~
plus.device.imsi;
~~~
### 说明：
Array 类型 只读属性
字符串数组类型，获取设备上插入SIM的国际移动设备身份码。 如果设备支持多卡模式则返回所有SIM身份码。 如果设备不支持或没有插入SIM卡则返回空数组。
### 平台支持：
- Android - 2.2+ (支持): 如果设备没有插入SIM卡，则返回空数组。
- iOS - 4.5+ (不支持): iOS设备不支持获取SIM卡信息，返回空数组。
### 示例：
~~~
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>Device Example</title>
<script type="text/javascript">
// H5 plus事件处理
function plusReady(){
alert( "IMSI: " + plus.device.imsi );
}
if(window.plus){
plusReady();
}else{
document.addEventListener("plusready",plusReady,false);
}
</script>
</head>
<body>
获取设备的国际移动用户识别码
</body>
</html>
~~~
# [model]()
设备的型号
~~~
plus.device.imei;
~~~
### 说明：
String 类型 只读属性
调用此属性获取设备的型号信息。 如果设备不支持则返回空字符串。
### 示例：
~~~
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>Device Example</title>
<script type="text/javascript">
// H5 plus事件处理
function plusReady(){
alert( "Device: " + plus.device.model );
}
if(window.plus){
plusReady();
}else{
document.addEventListener("plusready",plusReady,false);
}
</script>
</head>
<body>
获取设备的型号
</body>
</html>
~~~
# [vendor]()
设备的生产厂商
~~~
plus.device.vendor;
~~~
### 说明：
String 类型 只读属性
调用此属性获取设备的生产厂商信息。 如果设备不支持则返回空字符串。
### 平台支持：
- Android - 2.2+ (支持)
- iOS - 4.3+ (支持)
### 示例：
~~~
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>Device Example</title>
<script type="text/javascript">
// H5 plus事件处理
function plusReady(){
alert( "Vendor: " + plus.device.vendor );
}
if(window.plus){
plusReady();
}else{
document.addEventListener("plusready",plusReady,false);
}
</script>
</head>
<body>
获取设备的生产厂商
</body>
</html>
~~~
# [uuid]()
设备的唯一标识
~~~
plus.device.uuid;
~~~
### 说明：
String 类型 只读属性
调用此属性获取设备的唯一标识号。
### 平台支持：
- Android - 2.2+ (支持): 与设备的imei号一致。
- iOS - 4.5+ (支持): 根据包名随机生成的设备标识号。注意：在设备重置后会重新生成。
### 示例：
~~~
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>Device Example</title>
<script type="text/javascript">
// H5 plus事件处理
function plusReady(){
alert( "uuid: "+plus.device.uuid );
}
if(window.plus){
plusReady();
}else{
document.addEventListener("plusready",plusReady,false);
}
</script>
</head>
<body>
获取设备的唯一标识号
</body>
</html>
~~~
# [dial]()
拨打电话
~~~
void plus.device.dial( number, confirm );
~~~
### 说明：
调用系统程序拨打电话。
### 参数：
- number: *( String ) 必选 *要获取通讯录的类型，可取通讯录类型常量
- confirm: *( Boolean ) 可选 *是否弹出确认对话框
### 返回值：
void : 无
### 平台支持：
- Android - 2.2+ (支持): 忽略confirm参数
- iOS - 4.3+ (支持)
### 示例：
~~~
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>Device Example</title>
<script type="text/javascript">
// H5 plus事件处理
function plusReady(){
}
if(window.plus){
plusReady();
}else{
document.addEventListener("plusready",plusReady,false);
}
function dialTest() {
plus.device.dial( "10086", false );
}
</script>
</head>
<body>
拨打电话<br/>
<button onclick="dialTest()">Dial</button>
</body>
</html>
~~~
# [beep]()
发出蜂鸣声
~~~
void plus.device.beep( times );
~~~
### 说明：
调用此方法使得设备发出蜂鸣声。
### 参数：
- times: *( Number ) 可选 *蜂鸣声重复的次数，默认发出一次蜂鸣声
### 返回值：
void : 无
### 平台支持：
- Android - 2.2+ (支持): 播放系统设置中指定的默认通知铃声
- iOS - 4.3+ (支持): 忽略times参数，播放系统的通知铃声
### 示例：
~~~
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>Device Example</title>
<script type="text/javascript">
// H5 plus事件处理
function plusReady(){
plus.device.beep( 3 );
}
if(window.plus){
plusReady();
}else{
document.addEventListener("plusready",plusReady,false);
}
</script>
</head>
<body>
发出蜂鸣声<br/>
</body>
</html>
~~~
# [vibrate]()
设备振动
~~~
plus.device.vibrate( milliseconds );
~~~
### 说明：
调用此方法使得设备振动。
### 参数：
- milliseconds: *( Number ) 必选 *设备振动持续的时间
数值类型，单位为ms，默认为500ms。
### 返回值：
void : 无
### 平台支持：
- Android - 2.2+ (支持): 振动指定的时长
- iOS - 4.3+ (支持): 不支持milliseconds参数，使用系统默认振动时长，仅iPhone设备支持，iPad和iTouch设备不支持，调用此接口无任何效果。 注意：如果在系统设置中关闭振动功能则无法调用设备振动（设置->声音->振动）。
### 示例：
~~~
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>Device Example</title>
<script type="text/javascript">
// H5 plus事件处理
function plusReady(){
plus.device.vibreate( 2000 );
}
if(window.plus){
plusReady();
}else{
document.addEventListener("plusready",plusReady,false);
}
</script>
</head>
<body>
设备振动<br/>
</body>
</html>
~~~
# [setWakelock]()
设置应用是否保持唤醒（屏幕常亮）状态
~~~
plus.device.setWakelock( lock );
~~~
### 说明：
调用此方法设置应用是否一直保持唤醒状态，保持唤醒状态将会导致程序屏幕常亮、系统不会自动锁屏，从而导致消耗更多的电量。若未设置一直保持唤醒状态则会根据系统设置自动锁定屏幕。
### 参数：
- lock: *( Boolean ) 必选 *是否设置程序一直保持唤醒状态
可取值ture或false，true表示设定程序一直保持唤醒状态，false表示关闭程序一直保持唤醒状态。程序退出后将恢复默认状态，默认为关闭程序保持唤醒状态。
### 返回值：
void : 无
### 示例：
~~~
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>Device Example</title>
<script type="text/javascript">
// H5 plus事件处理
function plusReady(){
// 开启一直保持程序唤醒状态
plus.device.setWakelock( true );
}
if(window.plus){
plusReady();
}else{
document.addEventListener("plusready",plusReady,false);
}
</script>
</head>
<body>
设置应用保持唤醒（屏幕常亮）状态<br/>
<button onclick="plus.device.setWakelock(false)">UnWakelock</button>
</body>
</html>
~~~
# [isWakelock]()
获取程序是否一直保持唤醒（屏幕常亮）状态
~~~
Boolean plus.device.isWakelock();
~~~
### 说明：
调用此方法获取程序是否一致保持唤醒状态。
### 参数：
无
### 返回值：
Boolean : 返回ture表示程序已设置为一直保持唤醒状态，返回false表示程序未设置为一直保持唤醒状态。
# [setVolume]()
设置设备的系统音量
~~~
plus.device.setVolume( volume );
~~~
### 说明：
调用此方法调节设备的系统音量。
### 参数：
- volume: *( Number ) 必选 *设备的系统音量值
取值范围为0到1，0表示静音，1表示最大音量值。设置设备音量后对所有程序生效，退出程序系统仍然保持最后设定的音量值。
### 返回值：
void : 无
### 平台支持：
- iOS - 4.3+ (支持)
- Android - 2.2+ (支持): 设置音量后对所有项的音量生效，如通话音量、系统音量、铃声音量、音乐音量、提示声音音量。
### 示例：
~~~
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>Device Example</title>
<script type="text/javascript">
// H5 plus事件处理
function plusReady(){
// 设置音量
plus.device.setVolume( 0.5 );
}
if(window.plus){
plusReady();
}else{
document.addEventListener("plusready",plusReady,false);
}
</script>
</head>
<body>
设备的系统音量值<br/>
</body>
</html>
~~~
# [getVolume]()
获取设备的系统音量
~~~
Number plus.device.getVolume();
~~~
### 说明：
系统音量值范围为0到1，0表示静音，1表示最大音量值。
### 参数：
无
### 返回值：
Number : 系统的音量值
# [screen]()
Screen模块管理设备屏幕信息
### 属性：
- [resolutionHeight](http://www.dcloud.io/docs/api/zh_cn/device.shtml#plus.screen.resolutionHeight): 设备屏幕高度分辨率
- [resolutionWidth](http://www.dcloud.io/docs/api/zh_cn/device.shtml#plus.screen.resolutionWidth): 设备屏幕宽度分辨率
- [scale](http://www.dcloud.io/docs/api/zh_cn/device.shtml#plus.screen.scale): 逻辑分辨率与实际分辨率的比例
- [dpiX](http://www.dcloud.io/docs/api/zh_cn/device.shtml#plus.screen.dpiX): 设备屏幕水平方向的密度
- [dpiY](http://www.dcloud.io/docs/api/zh_cn/device.shtml#plus.screen.dpiY): 设备屏幕垂直方向的密度
### 方法：
- [setBrightness](http://www.dcloud.io/docs/api/zh_cn/device.shtml#plus.screen.setBrightness): 设置屏幕亮度
- [getBrightness](http://www.dcloud.io/docs/api/zh_cn/device.shtml#plus.screen.getBrightness): 获取屏幕亮度值
- [lockOrientation](http://www.dcloud.io/docs/api/zh_cn/device.shtml#plus.screen.lockOrientation): 锁定屏幕方向
- [unlockOrientation](http://www.dcloud.io/docs/api/zh_cn/device.shtml#plus.screen.unlockOrientation): 解除锁定屏幕方向
# [resolutionHeight]()
设备屏幕高度分辨率
~~~
plus.screen.resolutionHeight;
~~~
### 说明：
Number 类型 只读属性
设备屏幕区域包括系统状态栏显示区域和应用显示区域，screen获取的是设备屏幕总区域的逻辑分辨率，单位为px。 如果需要获取实际分辨率则需要乘以比例值scale。
### 示例：
~~~
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>Device Example</title>
<script type="text/javascript">
// H5 plus事件处理
function plusReady(){
alert( "Screen height: " + plus.screen.resolutionHeight*plus.screen.scale + "px" );
}
if(window.plus){
plusReady();
}else{
document.addEventListener("plusready",plusReady,false);
}
</script>
</head>
<body>
设备屏幕高度分辨率<br/>
</body>
</html>
~~~
# [resolutionWidth]()
设备屏幕宽度分辨率
~~~
plus.screen.resolutionWidth;
~~~
### 说明：
Number 类型 只读属性
设备屏幕区域包括系统状态栏显示区域和应用显示区域，screen获取的是设备屏幕总区域的分辨率，单位为px。 如果需要获取实际分辨率则需要乘以比例值scale。
### 示例：
~~~
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>Device Example</title>
<script type="text/javascript">
// H5 plus事件处理
function plusReady(){
alert( "Screen width: " + plus.screen.resolutionWidtht*plus.screen.scale + "px" );
}
if(window.plus){
plusReady();
}else{
document.addEventListener("plusready",plusReady,false);
}
</script>
</head>
<body>
设备屏幕宽度分辨率<br/>
</body>
</html>
~~~
# [scale]()
逻辑分辨率与实际分辨率的比例
~~~
plus.display.scale;
~~~
### 说明：
Number 类型 只读属性
屏幕分辨率分逻辑分辨率率和实际分辨率，在html页面中使用的像素值都是相对于逻辑分辨率，此值就是逻辑分辨率和实际分辨率的比例，实际分辨率=逻辑分辨率*比例。
### 平台支持：
- Android - 2.2+ (支持)
- iOS - 4.3+ (支持)
### 示例：
~~~
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>Device Example</title>
<script type="text/javascript">
// H5 plus事件处理
function plusReady(){
alert( "Screen resolution: " + plus.screen.resolutionWidth*plus.screen.scale + " x " + plus.screen.resolutionHeight*plus.screen.scale );
}
if(window.plus){
plusReady();
}else{
document.addEventListener("plusready",plusReady,false);
}
</script>
</head>
<body>
逻辑分辨率与实际分辨率的比例<br/>
</body>
</html>
~~~
# [dpiX]()
设备屏幕水平方向的密度
~~~
plus.screen.dpiX;
~~~
### 说明：
Number 类型 只读属性
设备屏幕的密度为每英寸所显示的像素点数，密度越高显示清晰度越高，单位为dpi。
### 平台支持：
- Android - 2.2+ (支持)
- iOS - 4.3+ (支持)
### 示例：
~~~
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>Device Example</title>
<script type="text/javascript">
// H5 plus事件处理
function plusReady(){
alert( "Screen dip in X: " + plus.screen.dpiX );
}
if(window.plus){
plusReady();
}else{
document.addEventListener("plusready",plusReady,false);
}
</script>
</head>
<body>
设备屏幕水平方向的密度<br/>
</body>
</html>
~~~
# [dpiY]()
设备屏幕垂直方向的密度
~~~
plus.screen.dpiY;
~~~
### 说明：
Number 类型 只读属性
设备屏幕的密度为每英寸所显示的像素点数，密度越高显示清晰度越高，单位为dpi。
### 平台支持：
- Android - 2.2+ (支持)
- iOS - 4.3+ (支持)
### 示例：
~~~
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>Device Example</title>
<script type="text/javascript">
// H5 plus事件处理
function plusReady(){
alert( "Screen dip in Y: " + plus.screen.dpiY );
}
if(window.plus){
plusReady();
}else{
document.addEventListener("plusready",plusReady,false);
}
</script>
</head>
<body>
设备屏幕垂直方向的密度<br/>
</body>
</html>
~~~
# [setBrightness]()
设置屏幕亮度
~~~
plus.screen.setBrightness( brightness );
~~~
### 说明：
调用此方法调节设备屏幕亮度。
### 参数：
- brightness: *( Number ) 必选 *屏幕的亮度值
取值范围为0到1，0表示最低亮度值，1表示最高亮度值。设置屏幕亮度仅对当前程序在前台运行时有效，退出程序后屏幕亮度由系统设置的值决定。
### 返回值：
void : 无
### 示例：
~~~
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>Device Example</title>
<script type="text/javascript">
// H5 plus事件处理
function plusReady(){
// 设置屏幕亮度
plus.screen.setBrightness( 0.5 );
}
if(window.plus){
plusReady();
}else{
document.addEventListener("plusready",plusReady,false);
}
</script>
</head>
<body>
设置屏幕亮度<br/>
</body>
</html>
~~~
# [getBrightness]()
获取屏幕亮度值
~~~
Number plus.screen.getBrightness();
~~~
### 说明：
屏幕亮度值范围为0到1，0表示最低亮度值，1表示最高亮度值。
### 参数：
无
### 返回值：
Number : 返回程序的屏幕亮度值
# [lockOrientation]()
锁定屏幕方向
~~~
void plus.screen.lockOrientation( String orientation );
~~~
### 说明：
锁定屏幕方向后屏幕只能按锁定的屏幕方向显示，关闭当前页面后仍然有效。 可再次调用此方法修改屏幕锁定方向或调用unlockOrientation()方法恢复到应用的默认值。
### 参数：
- orientation: *( String ) 必选 *要锁定的屏幕方向值
锁定屏幕方向可取以下值： "portrait-primary": 竖屏正方向； "portrait-secondary": 竖屏反方向，屏幕正方向按顺时针旋转180°； "landscape-primary": 横屏正方向，屏幕正方向按顺时针旋转90°； "landscape-secondary": 横屏方向，屏幕正方向按顺时针旋转270°； "portrait": 竖屏正方向或反方向，根据设备重力感应器自动调整； "landscape": 横屏正方向或反方向，根据设备重力感应器自动调整；
### 返回值：
void : 无
# [unlockOrientation]()
解除锁定屏幕方向
~~~
void plus.screen.unlockOrientation();
~~~
### 说明：
解除锁定屏幕方向后将恢复应用默认的屏幕显示方向（通常为应用打包发布时设置的方向）。
### 参数：
无
### 返回值：
void : 无
# [display]()
Display模块管理应用可使用的显示区域信息
### 属性：
- [resolutionHeight](http://www.dcloud.io/docs/api/zh_cn/device.shtml#plus.display.resolutionHeight): 应用可使用的屏幕高度逻辑分辨率
- [resolutionWidth](http://www.dcloud.io/docs/api/zh_cn/device.shtml#plus.display.resolutionWidth): 应用可使用的屏幕宽度逻辑分辨率
# [resolutionHeight]()
应用可使用的屏幕高度逻辑分辨率
~~~
plus.display.resolutionHeight;
~~~
### 说明：
Number 类型 只读属性
设备屏幕区域包括系统状态栏显示区域和应用显示区域，display获取的是应用显示区域的逻辑分辨率，单位为px。 如果需要获取实际分辨率则需要乘以比例值scale。
### 平台支持：
- Android - 2.2+ (支持)
- iOS - 4.3+ (支持)
### 示例：
~~~
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>Device Example</title>
<script type="text/javascript">
// H5 plus事件处理
function plusReady(){
alert( "Display height: " + plus.display.resolutionHeight*plus.display.scale + "px" );
}
if(window.plus){
plusReady();
}else{
document.addEventListener("plusready",plusReady,false);
}
</script>
</head>
<body>
应用可使用的屏幕高度逻辑分辨率<br/>
</body>
</html>
~~~
# [resolutionWidth]()
应用可使用的屏幕宽度逻辑分辨率
~~~
plus.display.resolutionHeight;
~~~
### 说明：
Number 类型 只读属性
设备屏幕区域包括系统状态栏显示区域和应用显示区域，display获取的是应用显示区域的逻辑分辨率，单位为px。 如果需要获取实际分辨率则需要乘以比例值scale。
### 示例：
~~~
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>Device Example</title>
<script type="text/javascript">
// H5 plus事件处理
function plusReady(){
alert( "Display width: " + plus.display.resolutionWidth*plus.display.scale + "px" );
}
if(window.plus){
plusReady();
}else{
document.addEventListener("plusready",plusReady,false);
}
</script>
</head>
<body>
应用可使用的屏幕宽度逻辑分辨率<br/>
</body>
</html>
~~~
# [networkinfo]()
Device模块用于获取网络信息
### 常量：
- [CONNECTION_UNKNOW](http://www.dcloud.io/docs/api/zh_cn/device.shtml#plus.networkinfo.CONNECTION_UNKNOW): 网络连接状态未知
- [CONNECTION_NONE](http://www.dcloud.io/docs/api/zh_cn/device.shtml#plus.networkinfo.CONNECTION_NONE): 未连接网络
- [CONNECTION_ETHERNET](http://www.dcloud.io/docs/api/zh_cn/device.shtml#plus.networkinfo.CONNECTION_ETHERNET): 有线网络
- [CONNECTION_WIFI](http://www.dcloud.io/docs/api/zh_cn/device.shtml#plus.networkinfo.CONNECTION_WIFI): 无线WIFI网络
- [CONNECTION_CELL2G](http://www.dcloud.io/docs/api/zh_cn/device.shtml#plus.networkinfo.CONNECTION_CELL2G): 蜂窝移动2G网络
- [CONNECTION_CELL3G](http://www.dcloud.io/docs/api/zh_cn/device.shtml#plus.networkinfo.CONNECTION_CELL3G): 蜂窝移动3G网络
- [CONNECTION_CELL4G](http://www.dcloud.io/docs/api/zh_cn/device.shtml#plus.networkinfo.CONNECTION_CELL4G): 蜂窝移动4G网络
### 方法：
- [getCurrentType](http://www.dcloud.io/docs/api/zh_cn/device.shtml#plus.networkinfo.getCurrentType): 获取设备当前连接的网络类型
# [CONNECTION_UNKNOW]()
网络连接状态未知
~~~
plus.networkinfo.CONNECTION_UNKNOW;
~~~
### 说明：
Number 类型
网络状态常量，表示当前设备网络状态未知，固定值为0。
### 平台支持
# [CONNECTION_NONE]()
未连接网络
~~~
plus.networkinfo.CONNECTION_NONE;
~~~
### 说明：
Number 类型
网络状态常量，当前设备网络未连接网络，固定值为1。
### 平台支持
# [CONNECTION_ETHERNET]()
有线网络
~~~
plus.networkinfo.CONNECTION_ETHERNET;
~~~
### 说明：
Number 类型
网络状态常量，当前设备连接到有线网络，固定值为2。
### 平台支持
# [CONNECTION_WIFI]()
无线WIFI网络
~~~
plus.networkinfo.CONNECTION_WIFI;
~~~
### 说明：
Number 类型
网络状态常量，当前设备连接到无线WIFI网络，固定值为3。
### 平台支持
# [CONNECTION_CELL2G]()
蜂窝移动2G网络
~~~
plus.networkinfo.CONNECTION_CELL2G;
~~~
### 说明：
Number 类型
网络状态常量，当前设备连接到蜂窝移动2G网络，固定值为4。
### 平台支持
# [CONNECTION_CELL3G]()
蜂窝移动3G网络
~~~
plus.networkinfo.CONNECTION_CELL3G;
~~~
### 说明：
Number 类型
网络状态常量，当前设备连接到蜂窝移动3G网络，固定值为5。
### 平台支持
- Android - 2.2+ (支持)
- iOS - 4.3+ (支持): 在iPhone上无法区分蜂窝网络类型，只能返回CONNECTION_CELL2G类型。
# [CONNECTION_CELL4G]()
蜂窝移动4G网络
~~~
plus.networkinfo.CONNECTION_CELL4G;
~~~
### 说明：
Number 类型
网络状态常量，当前设备连接到蜂窝移动4G网络，固定值为6。
### 平台支持
- Android - 2.2+ (支持)
- iOS - 4.3+ (支持): 在iPhone上无法区分蜂窝网络类型，只能返回CONNECTION_CELL2G类型。
# [getCurrentType]()
获取设备当前连接的网络类型
~~~
Number plus.networkinfo.getCurrentType();
~~~
### 说明：
获取当前设备连接的网络类型，返回值为网络类型常量，可取值CONNECTION_*常量。
### 参数：
无
### 返回值：
Number : 设备当前网络类型
### 平台支持：
- Android - 2.3+ (支持)
- iOS - 4.3+ (支持): 无法区分蜂窝移动网络类型，在蜂窝移动网络环境下均返回CONNECTION_CELL2G。
### 示例：
~~~
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>Device Example</title>
<script type="text/javascript">
// H5 plus事件处理
function plusReady(){
var types = {};
types[plus.networikinfo.CONNECTION_UNKNOW] = "Unknown connection";
types[plus.networikinfo.CONNECTION_NONE] = "Ethernet connection";
types[plus.networikinfo.CONNECTION_ETHERNET] = "Ethernet connection";
types[plus.networikinfo.CONNECTION_WIFI] = "WiFi connection";
types[plus.networikinfo.CONNECTION_CELL2G] = "Cellular 2G connection";
types[plus.networikinfo.CONNECTION_CELL3G] = "Cellular 3G connection";
types[plus.networikinfo.CONNECTION_CELL4G] = "Cellular 4G connection";
alert( "Network: " + plus.networkinfo.getCurrentType() );
}
if(window.plus){
plusReady();
}else{
document.addEventListener("plusready",plusReady,false);
}
</script>
</head>
<body>
获取设备当前连接的网络类型<br/>
</body>
</html>
~~~
# [os]()
OS模块管理操作系统信息
### 属性：
- [language](http://www.dcloud.io/docs/api/zh_cn/device.shtml#plus.os.language): 系统语言信息
- [version](http://www.dcloud.io/docs/api/zh_cn/device.shtml#plus.os.version): 系统版本信息
- [name](http://www.dcloud.io/docs/api/zh_cn/device.shtml#plus.os.name): 系统的名称
- [vendor](http://www.dcloud.io/docs/api/zh_cn/device.shtml#plus.os.vendor): 系统的供应商信息
# [language]()
系统语言信息
~~~
plus.os.language;
~~~
### 说明：
String 类型 只读属性
获取当前操作系统设置的系统语言，字符串类型数据。
### 平台支持：
- Android - 2.2+ (支持)
- iOS - 4.3+ (支持)
### 示例：
~~~
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>Device Example</title>
<script type="text/javascript">
// H5 plus事件处理
function plusReady(){
alert( "OS language: " + plus.os.language );
}
if(window.plus){
plusReady();
}else{
document.addEventListener("plusready",plusReady,false);
}
</script>
</head>
<body>
获取系统语言信息<br/>
</body>
</html>
~~~
# [version]()
系统版本信息
~~~
plus.os.version;
~~~
### 说明：
String 类型 只读属性
获取当前操作系统的版本信息，字符串类型数据。
### 平台支持：
- Android - 2.2+ (支持)
- iOS - 4.3+ (支持)
### 示例：
~~~
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>Device Example</title>
<script type="text/javascript">
// H5 plus事件处理
function plusReady(){
alert( "OS version: " + plus.os.version );
}
if(window.plus){
plusReady();
}else{
document.addEventListener("plusready",plusReady,false);
}
</script>
</head>
<body>
获取系统版本信息<br/>
</body>
</html>
~~~
# [name]()
系统的名称
~~~
plus.os.name;
~~~
### 说明：
String 类型 只读属性
获取当前操作系统的名称，字符串类型数据。
### 平台支持：
- Android - 2.2+ (支持): 返回字符串“Android”
- iOS - 4.3+ (支持): 返回字符串“iOS”
### 示例：
~~~
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>Device Example</title>
<script type="text/javascript">
// H5 plus事件处理
function plusReady(){
alert( "OS name: " + plus.os.name );
}
if(window.plus){
plusReady();
}else{
document.addEventListener("plusready",plusReady,false);
}
</script>
</head>
<body>
获取系统的名称<br/>
</body>
</html>
~~~
# [vendor]()
系统的供应商信息
~~~
plus.os.vendor;
~~~
### 说明：
String 类型 只读属性
获取当前操作系统的供应商名称。，字符串类型数据。
### 平台支持：
- Android - 2.2+ (支持): 返回字符串“Google”
- iOS - 4.3+ (支持): 返回字符串“Apple”
### 示例：
~~~
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>Device Example</title>
<script type="text/javascript">
// H5 plus事件处理
function plusReady(){
alert( "OS name: " + plus.os.vendor );
}
if(window.plus){
plusReady();
}else{
document.addEventListener("plusready",plusReady,false);
}
</script>
</head>
<body>
获取系统的供应商信息<br/>
</body>
</html>
~~~
- API参考
- Accelerometer
- Audio
- Camera
- Contacts
- Device
- Downloader
- Events
- Gallery
- Geolocation
- IO
- Key
- Messaging
- NativeUI
- Navigator
- Orientation
- Proximity
- SplashScreen
- Storage
- UI
- Uploader
- InterfaceOrientation
- Runtime
- WebView
- XMLHttpRequest
- Zip
- Plugins
- Barcode
- Maps
- Payment
- Push
- Share
- Speech
- Statistic
- Native.js
- Android
- iOS