您当前位置：首页 > 文章中心 > HTML5+CSS3 > HTML5puls

【HTML5puls】

下载

新闻

文章

Device模块管理设备信息，用于获取手机设备的相关信息，如IMEI、IMSI、型号、厂商等。通过plus.device获取设备信息管理对象。

属性：

imei设备的国际移动设备身份码
imsi设备的国际移动用户识别码
model设备的型号
vendor设备的生产厂商
uuid设备的唯一标识

方法：

dial拨打电话
beep发出蜂鸣声
vibrate设备振动
setWakelock设置应用是否保持唤醒（屏幕常亮）状态
isWakelock获取程序是否一直保持唤醒（屏幕常亮）状态
setVolume设置设备的系统音量
getVolume获取设备的系统音量

对象：

screenScreen模块管理设备屏幕信息
displayDisplay模块管理应用可使用的显示区域信息
networkinfoDevice模块用于获取网络信息
osOS模块管理操作系统信息

dial

拨打电话

void plus.device.dial( number, confirm );

说明：

调用系统程序拨打电话。

参数：

number (String) 可选 要获取通讯录的类型，可取通讯录类型常量
confirm (Boolean) 可选 是否弹出确认对话框

返回值：

无

平台支持：

Android : 2.2+

忽略confirm参数

iOS : 4.3+

WP : 7.5+

忽略confirm参数

示例：

<!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) 可选 蜂鸣声重复的次数，默认发出一次蜂鸣声

返回值：

无

平台支持：

Android : 2.2+

播放系统设置中指定的默认通知铃声

iOS : 4.3+

忽略times参数，播放系统的通知铃声

WP : 7.5+

示例：

<!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。

返回值：

无

平台支持：

Android : 2.2+

振动指定的时长

iOS : 4.3+

不支持milliseconds参数，使用系统默认振动时长，仅iPhone设备支持，iPad和iTouch设备不支持，调用此接口无任何效果。注意：如果在系统设置中关闭振动功能则无法调用设备振动（设置->声音->振动）。

WP : 7.5+

示例：

<!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表示关闭程序一直保持唤醒状态。程序退出后将恢复默认状态，默认为关闭程序保持唤醒状态。

返回值：

无

示例：

<!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();

说明：

调用此方法获取程序是否一致保持唤醒状态。

返回值：

返回ture表示程序已设置为一直保持唤醒状态，返回false表示程序未设置为一直保持唤醒状态。

setVolume

设置设备的系统音量

plus.device.setVolume( volume );

说明：

调用此方法调节设备的系统音量。

参数：

volume (Number) 可选 取值范围为0到1，0表示静音，1表示最大音量值。设置设备音量后对所有程序生效，退出程序系统仍然保持最后设定的音量值。

返回值：

无

平台支持：

iOS : 4.3+

Android : 2.2+

设置音量后对所有项的音量生效，如通话音量、系统音量、铃声音量、音乐音量、提示声音音量。

WP : 不支持暂不支持

示例：

<!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表示最大音量值。

返回值：

系统的音量值

imei

设备的国际移动设备身份码

plus.device.imei;

说明：

调用此属性获取设备的国际移动设备身份码。如果设备不支持则返回空字符串。

平台支持：

Android : 2.2+

iOS : 不支持 iOS设备不支持获取imei值，返回空字符串。

imsi

设备的国际移动用户识别码

plus.device.imsi;

说明：

字符串数组类型，获取设备上插入SIM的国际移动设备身份码。如果设备支持多卡模式则返回所有SIM身份码。如果设备不支持或没有插入SIM卡则返回空数组。

平台支持：

Android : 2.2+

如果设备没有插入SIM卡，则返回空数组。

iOS : 不支持 iOS设备不支持获取SIM卡信息，返回空数组。

model

设备的型号

plus.device.imei;

说明：

调用此属性获取设备的型号信息。如果设备不支持则返回空字符串。

vendor

设备的生产厂商

plus.device.vendor;

说明：

调用此属性获取设备的生产厂商信息。如果设备不支持则返回空字符串。

uuid

设备的唯一标识

plus.device.uuid;

说明：

调用此属性获取设备的唯一标识号。

平台支持：

Android : 2.2+

与设备的imei号一致。

iOS : 4.5+

根据包名随机生成的设备标识号。注意：在设备重置后会重新生成。

screen

Screen模块管理设备屏幕信息

方法：

setBrightness设置屏幕亮度
getBrightness获取屏幕亮度值
lockOrientation锁定屏幕方向
unlockOrientation解除锁定屏幕方向

属性：

resolutionHeight：Number，只读属性，设备屏幕区域包括系统状态栏显示区域和应用显示区域，screen获取的是设备屏幕总区域的逻辑分辨率，单位为px。如果需要获取实际分辨率则需要乘以比例值scale。
resolutionWidth：Number，只读属性，设备屏幕区域包括系统状态栏显示区域和应用显示区域，screen获取的是设备屏幕总区域的分辨率，单位为px。如果需要获取实际分辨率则需要乘以比例值scale。
scale：Number，只读属性，屏幕分辨率分逻辑分辨率率和实际分辨率，在html页面中使用的像素值都是相对于逻辑分辨率，此值就是逻辑分辨率和实际分辨率的比例，实际分辨率=逻辑分辨率*比例。
dpiX：Number，只读属性，设备屏幕的密度为每英寸所显示的像素点数，密度越高显示清晰度越高，单位为dpi。
dpiY：Number，只读属性，设备屏幕的密度为每英寸所显示的像素点数，密度越高显示清晰度越高，单位为dpi。

setBrightness

设置屏幕亮度

plus.screen.setBrightness( brightness );

说明：

调用此方法调节设备屏幕亮度。

参数：

brightness (Number) 可选 取值范围为0到1，0表示最低亮度值，1表示最高亮度值。设置屏幕亮度仅对当前程序在前台运行时有效，退出程序后屏幕亮度由系统设置的值决定。

返回值：

无

示例：

<!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表示最高亮度值。

返回值：

返回程序的屏幕亮度值

lockOrientation

锁定屏幕方向

void plus.screen.lockOrientation( String orientation );

说明：

锁定屏幕方向后屏幕只能按锁定的屏幕方向显示，关闭当前页面后仍然有效。可再次调用此方法修改屏幕锁定方向或调用unlockOrientation()方法恢复到应用的默认值。

参数：

orientation (String) 可选 锁定屏幕方向可取以下值： "portrait-primary": 竖屏正方向； "portrait-secondary": 竖屏反方向，屏幕正方向按顺时针旋转180°； "landscape-primary": 横屏正方向，屏幕正方向按顺时针旋转90°； "landscape-secondary": 横屏方向，屏幕正方向按顺时针旋转270°； "portrait": 竖屏正方向或反方向，根据设备重力感应器自动调整； "landscape": 横屏正方向或反方向，根据设备重力感应器自动调整；

返回值：

无

unlockOrientation

解除锁定屏幕方向

void plus.screen.unlockOrientation();

说明：

解除锁定屏幕方向后将恢复应用默认的屏幕显示方向（通常为应用打包发布时设置的方向）。

返回值：

无

display

Display模块管理应用可使用的显示区域信息

属性：

resolutionHeight：Number，只读属性，设备屏幕区域包括系统状态栏显示区域和应用显示区域，display获取的是应用显示区域的逻辑分辨率，单位为px。如果需要获取实际分辨率则需要乘以比例值scale。
resolutionWidth：Number，只读属性，设备屏幕区域包括系统状态栏显示区域和应用显示区域，display获取的是应用显示区域的逻辑分辨率，单位为px。如果需要获取实际分辨率则需要乘以比例值scale。

networkinfo

Device模块用于获取网络信息

方法：

getCurrentType获取设备当前连接的网络类型

常量：

平台支持：

CONNECTION_UNKNOW网络连接状态未知
CONNECTION_NONE未连接网络
CONNECTION_ETHERNET有线网络
CONNECTION_WIFI无线WIFI网络
CONNECTION_CELL2G蜂窝移动2G网络
CONNECTION_CELL3G蜂窝移动3G网络
CONNECTION_CELL4G蜂窝移动4G网络

getCurrentType

获取设备当前连接的网络类型

Number plus.networkinfo.getCurrentType();

说明：

获取当前设备连接的网络类型，返回值为网络类型常量，可取值CONNECTION_*常量。

返回值：

设备当前网络类型

平台支持：

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>