HTML5猎取设施信息
Device模块治理设备信息,用于猎取手机设备的相关信息,如IMEI、IMSI、型号、厂商等。通过plus.device猎取设备信息治理对象。
1、属性
1.1、imei: 设备的国际移动设备身份码,调取此属性猎取设备的国际移动设备身份码。 假如设备不支撑则返回空字符串。
平台支撑:Android - 2.2+ (支撑),iOS - 4.5+ (不支撑): iOS设备不支撑猎取imei值,返回空字符串。
示例:
[html] view plain copy
<!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>
1.2、imsi: 设备的国际移动会员识别码,字符串数组类型,猎取设备上插入SIM的国际移动设备身份码。 假如设备支撑多卡模式则返回所有SIM身份码。 假如设备不支撑或没有插入SIM卡则返回空数组。
平台支撑:Android - 2.2+ (支撑): 假如设备没有插入SIM卡,则返回空数组。
iOS - 4.5+ (不支撑): iOS设备不支撑猎取SIM卡信息,返回空数组。
示例:
[html] view plain copy
<!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>
1.3、model: 设备的型号,调取此属性猎取设备的型号信息。 假如设备不支撑则返回空字符串。
示例:
[html] view plain copy
<!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>
1.4、vendor: 设备的生产厂商,调取此属性猎取设备的生产厂商信息。 假如设备不支撑则返回空字符串。
平台支撑:Android - 2.2+ (支撑)、iOS - 4.3+ (支撑)
示例:
[html] view plain copy
<!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>
1.5、uuid: 设备的独一标识,调取此属性猎取设备的独一标识号。
平台支撑:Android - 2.2+ (支撑): 与设备的imei号一致。留意:假如没法猎取设备imei则使用设备wifi的mac地址,假如没法猎取设备mac地址则随机生成设备标识号,确保不一样App在统一台设备上猎取的值一致。iOS - 4.5+ (支撑): 按照包名随机生成的设备标识号。留意:在设备重置后会从新生成。
示例:
[html] view plain copy
<!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>
2、办法
2.1、dial: 拨打电话
void plus.device.dial( number, confirm );
说明:调取系统程序拨打电话。
参数:
number: ( String ) 必选 要拨打的电话号码
confirm: ( Boolean ) 可选 可否需要会员确定后开端拨打电话,设定为true表示翻开系统拨打电话界面,需会员点击拨号按钮后才开端拨打电话,false则无需确定直接拨打电话,默许值为true。
返回值:void : 无
平台支撑:Android - 2.2+ (支撑)、iOS - 5.1+ (支撑): 忽略confirm参数,调取直接拨打电话。
示例:
[html] view plain copy
<!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>
2.2、beep: 发出蜂鸣声
void plus.device.beep( times );
说明:调取此办法使得设备发出蜂鸣声。
参数:
times: ( Number ) 可选 蜂鸣声反复的次数,默许发出一次蜂鸣声
返回值:void : 无
平台支撑:Android - 2.2+ (支撑): 播放系统设定中指定的默许通知铃声,iOS - 4.3+ (支撑): 忽略times参数,播放系统的通知铃声
示例:
[html] view plain copy
<!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>
2.3、vibrate: 设备振动
plus.device.vibrate( milliseconds );
说明:调取此办法使得设备振动。
参数:
milliseconds: ( Number ) 必选 设备振动连续的时间,数值类型,单位为ms,默许为500ms。
返回值:void : 无
平台支撑:Android - 2.2+ (支撑): 振动指定的时长。iOS - 4.3+ (支撑): 不支撑milliseconds参数,使用系统默许振动时长,仅iPhone设备支撑,iPad和iTouch设备不支撑,调取此接口无任何结果。 留意:假如在系统设定中关闭振动功效则没法调取设备振动(设定->声音->振动)。
示例:
[html] view plain copy
<!DOCTYPE html> <html> <head> <meta charset="utf-8"> <title>Device Example</title> <script type="text/javascript"> // H5 plus事件处置 function plusReady(){ plus.device.vibrate( 2000 ); } if(window.plus){ plusReady(); }else{ document.addEventListener("plusready",plusReady,false); } </script> </head> <body> 设备振动<br/> </body> </html>
2.4、setWakelock: 设定利用可否保持叫醒(屏幕常亮)状态
plus.device.setWakelock( lock );
说明:调取此办法设定利用可否不断保持叫醒状态,保持叫醒状态将会致使程序屏幕常亮、系统不会主动锁屏,从而致使耗损更多的电量。若未设定不断保持叫醒状态则会按照系统设定主动锁定屏幕。
参数:
lock: ( Boolean ) 必选 可否设定程序不断保持叫醒状态,可取值true或false,true表示设定程序不断保持叫醒状态,false表示关闭程序不断保持叫醒状态。程序退出后将复原默许状态,默许为关闭程序保持叫醒状态。
返回值:void : 无
示例:
[html] view plain copy
<!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>
2.5、isWakelock: 猎取程序可否不断保持叫醒(屏幕常亮)状态
Boolean plus.device.isWakelock();
说明:调取此办法猎取程序可否一致保持叫醒状态。
返回值:Boolean : 返回ture表示程序已设定为不断保持叫醒状态,返回false表示程序未设定为不断保持叫醒状态。
2.6、setVolume: 设定设备的系统音量
plus.device.setVolume( volume );
说明:调取此办法调理设备的系统音量。
参数:
volume: ( Number ) 必选 设备的系统音量值,取值范畴为0到1,0表示静音,1表示最大音量值。设定设备音量后对所有程序生效,退出程序系统依然保持最后设定的音量值。
返回值:void : 无
平台支撑:iOS - 4.3+ (支撑)。Android - 2.2+ (支撑): 设定音量后对所有项的音量生效,如通话音量、系统音量、铃声音量、音乐音量、提醒声音音量。
示例:
[html] view plain copy
<!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>
2.7、getVolume: 猎取设备的系统音量
Number plus.device.getVolume();
说明:系统音量值范畴为0到1,0表示静音,1表示最大音量值。
返回值:Number : 系统的音量值
3、对象
3.1、screen: Screen模块治理设备屏幕信息
3.1.1、属性
1)、resolutionHeight: 设备屏幕高度辨论率
plus.screen.resolutionHeight;
说明:Number 类型 只读属性,设备屏幕区域包罗系统状态栏显示区域和利用显示区域,screen猎取的是设备屏幕总区域的逻辑辨论率,单位为px。 假如需要猎取实际辨论率则需要乘以比例值scale。
示例:
[html] view plain copy
<!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>
2)、resolutionWidth: 设备屏幕宽度辨论率
plus.screen.resolutionWidth;
说明:Number 类型 只读属性,设备屏幕区域包罗系统状态栏显示区域和利用显示区域,screen猎取的是设备屏幕总区域的辨论率,单位为px。 假如需要猎取实际辨论率则需要乘以比例值scale。
示例:
[html] view plain copy
<!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>
3)、scale: 逻辑辨论率与实际辨论率的比例
plus.screen.scale;
说明:Number 类型 只读属性,屏幕辨论率分逻辑辨论率率和实际辨论率,在html页面中使用的像素值都是相关于逻辑辨论率,此值就是逻辑辨论率和实际辨论率的比例,实际辨论率=逻辑辨论率*比例。
平台支撑:Android - 2.2+ (支撑),iOS - 4.3+ (支撑)
示例:
[html] view plain copy
<!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>
4)、dpiX: 设备屏幕水平标的目的的密度
plus.screen.dpiX;
说明:Number 类型 只读属性,设备屏幕的密度为每英寸所显示的像素点数,密度越高显示清楚度越高,单位为dpi。
平台支撑:Android - 2.2+ (支撑)。iOS - 4.3+ (支撑)
示例:
[html] view plain copy
<!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>
5)、dpiY: 设备屏幕垂直标的目的的密度
plus.screen.dpiY;
说明:Number 类型 只读属性,设备屏幕的密度为每英寸所显示的像素点数,密度越高显示清楚度越高,单位为dpi。
平台支撑:Android - 2.2+ (支撑),iOS - 4.3+ (支撑)
示例:
[html] view plain copy
<!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>
3.1.2办法
1)、setBrightness: 设定屏幕亮度
plus.screen.setBrightness( brightness );
说明:调取此办法调理设备屏幕亮度。
参数:brightness: ( Number ) 必选 屏幕的亮度值,取值范畴为0到1,0表示最低亮度值,1表示最高亮度值。设定屏幕亮度仅对当前程序在前台运转时有效,退出程序后屏幕亮度由系统设定的值决议。
返回值:void : 无
示例:
[html] view plain copy
<!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>
2)、getBrightness: 猎取屏幕亮度值
Number plus.screen.getBrightness();
说明:屏幕亮度值范畴为0到1,0表示最低亮度值,1表示最高亮度值。
返回值:Number : 返回程序的屏幕亮度值
3)、lockOrientation: 锁定屏幕标的目的
void plus.screen.lockOrientation( String orientation );
说明:锁定屏幕标的目的后屏幕只能按锁定的屏幕标的目的显示,关闭当前页面后依然有效。 可再次调取此办法修改屏幕锁定标的目的或调取unlockOrientation()办法复原到利用的默许值。
参数:
orientation: ( String ) 必选 要锁定的屏幕标的目的值,锁定屏幕标的目的可取以下值: "portrait-primary": 竖屏正标的目的; "portrait-secondary": 竖屏反标的目的,屏幕正标的目的按顺时针扭转180°; "landscape-primary": 横屏正标的目的,屏幕正标的目的按顺时针扭转90°; "landscape-secondary": 横屏标的目的,屏幕正标的目的按顺时针扭转270°; "portrait": 竖屏正标的目的或反标的目的,按照设备重力感应器主动调整; "landscape": 横屏正标的目的或反标的目的,按照设备重力感应器主动调整;
返回值:void : 无
4)、unlockOrientation: 解除锁定屏幕标的目的
void plus.screen.unlockOrientation();
说明:解除锁定屏幕标的目的后将复原利用默许的屏幕显示标的目的(平常为利用打包公布时设定的标的目的)。
返回值:void : 无
3.2、display: Display模块治理利用可使用的显示区域信息
属性:
(1)、resolutionHeight: 利用可使用的屏幕高度逻辑辨论率
plus.display.resolutionHeight;
说明:Number 类型 只读属性,设备屏幕区域包罗系统状态栏显示区域和利用显示区域,display猎取的是利用显示区域的逻辑辨论率,单位为px。 假如需要猎取实际辨论率则需要乘以比例值scale。
平台支撑:Android - 2.2+ (支撑),iOS - 4.3+ (支撑)
示例:
[html] view plain copy
<!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.screen.scale + "px" ); } if(window.plus){ plusReady(); }else{ document.addEventListener("plusready",plusReady,false); } </script> </head> <body> 利用可使用的屏幕高度逻辑辨论率<br/> </body> </html>
(2)、resolutionWidth: 利用可使用的屏幕宽度逻辑辨论率
plus.display.resolutionWidth;
说明:Number 类型 只读属性,设备屏幕区域包罗系统状态栏显示区域和利用显示区域,display猎取的是利用显示区域的逻辑辨论率,单位为px。 假如需要猎取实际辨论率则需要乘以比例值scale。
示例:
[html] view plain copy
<!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.screen.scale + "px" ); } if(window.plus){ plusReady(); }else{ document.addEventListener("plusready",plusReady,false); } </script> </head> <body> 利用可使用的屏幕宽度逻辑辨论率<br/> </body> </html>
3.3、networkinfo: Device模块用于猎取网络信息
3.3.1、常量
(1)、CONNECTION_UNKNOW: 网络连接状态未知
(2)、CONNECTION_NONE: 未连接网络
(3)、CONNECTION_ETHERNET: 有线网络
(4)、CONNECTION_WIFI: 无线WIFI网络
(5)、CONNECTION_CELL2G: 蜂窝移动2G网络
(6)、CONNECTION_CELL3G: 蜂窝移动3G网络
(7)、CONNECTION_CELL4G: 蜂窝移动4G网络
3.3.2、办法
getCurrentType: 猎取设备当前连接的网络类型
Number plus.networkinfo.getCurrentType();
说明:猎取当前设备连接的网络类型,返回值为网络类型常量,可取值CONNECTION_*常量。
返回值:Number : 设备当前网络类型
平台支撑:Android - 2.3+ (支撑),iOS - 4.3+ (支撑): 没法区分蜂窝移动网络类型,在蜂窝移动网络环境下均返回CONNECTION_CELL2G。
示例:
[html] view plain copy
<!DOCTYPE html> <html> <head> <meta charset="utf-8"> <title>Device Example</title> <script type="text/javascript"> // H5 plus事件处置 function plusReady(){ var types = {}; types[plus.networkinfo.CONNECTION_UNKNOW] = "Unknown connection"; types[plus.networkinfo.CONNECTION_NONE] = "None connection"; types[plus.networkinfo.CONNECTION_ETHERNET] = "Ethernet connection"; types[plus.networkinfo.CONNECTION_WIFI] = "WiFi connection"; types[plus.networkinfo.CONNECTION_CELL2G] = "Cellular 2G connection"; types[plus.networkinfo.CONNECTION_CELL3G] = "Cellular 3G connection"; types[plus.networkinfo.CONNECTION_CELL4G] = "Cellular 4G connection"; alert( "Network: " + types[plus.networkinfo.getCurrentType()] ); } if(window.plus){ plusReady(); }else{ document.addEventListener("plusready",plusReady,false); } </script> </head> <body> 猎取设备当前连接的网络类型<br/> </body> </html>
3.4、os: OS模块治理操纵系统信息
属性:
(1)、language: 系统说话信息
plus.os.language;
说明:String 类型 只读属性,猎取当前操纵系统设定的系统说话,字符串类型数据。
平台支撑:Android - 2.2+ (支撑),iOS - 4.3+ (支撑)
示例:
[html] view plain copy
<!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>
(2)、version: 系统版本信息
plus.os.version;
说明:String 类型 只读属性,猎取当前操纵系统的版本信息,字符串类型数据。平台支撑:Android - 2.2+ (支撑),iOS - 4.3+ (支撑)
示例:
[html] view plain copy
<!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>
(3)、name: 系统的名称
plus.os.name;
说明:String 类型 只读属性,猎取当前操纵系统的名称,字符串类型数据。
平台支撑:Android - 2.2+ (支撑): 返回字符串“Android”,iOS - 4.3+ (支撑): 返回字符串“iOS”
示例:
[html] view plain copy
<!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>
(4)、vendor: 系统的供给商信息
plus.os.vendor;
说明:String 类型 只读属性,猎取当前操纵系统的供给商名称,字符串类型数据。
平台支撑:Android - 2.2+ (支撑): 返回字符串“Google”,iOS - 4.3+ (支撑): 返回字符串“Apple”
示例:
[html] view plain copy
<!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>
相关引荐:
html5猎取手机GPS信息的示例代码分享
以上就是HTML5猎取设备信息的具体内容,更多请关注百分百源码网其它相关文章!