# [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> ~~~