介绍
这个插件是用于连接到设备的振动功能。
安装插件
cordova plugin add cordova-plugin-vibration
使用方法
这个插件定义了全局的对象包含着navigator.vibrate。虽然在全局范围内,但是他们需要在deviceready事件之后才可用
document.addEventListener("deviceready", onDeviceReady, false);
function onDeviceReady() {
console.log(navigator.vibrate);
}
支持的平台Supported Platforms
· Amazon Fire OS
· Android
· BlackBerry 10
· Firefox OS
· iOS
· Windows Phone 7 and 8
· Windows (Windows Phone 8.1 devices only)
方法
navigator.vibrate,
navigator.notification.vibrate
navigator.notification.vibrateWithPattern
navigator.notification.cancelVibration
目前cordova 7.0+ 新版本
震动 (推荐)
这个函数有三个不同的功能,根据传递给它的参数。
标准振动Standard vibrate
为振动装置给定一个时间。
—时间:毫秒数给振动装置(数字)
navigator.vibrate(time)
or
navigator.vibrate([time])
平台特性
iOS 特性
时间:忽略指定的时间和振动在预先设定的时间。
navigator.vibrate(3000); // 3000 is ignored(3000被忽略)
Windows and Blackberry Quirks
时间:最大时间是5000ms(5S)和最小时间是1ms
navigator.vibrate(8000); // will be truncated to 5000(将变成5000)
震动模式Vibrate with a pattern (Android and Windows only)
该装置与一个给定的模式振动
navigator.vibrate(pattern);
pattern:序列的持续时间(毫秒数),打开或关闭振动器。(数字数组)
平台特性
Windows Phone 8 特性
振动(模式)依靠振动与默认的持续时间
Cancel vibration (not supported in iOS)
立即取消所有当前正在运行的振动。
navigator.vibrate(0)
or
navigator.vibrate([])
or
navigator.vibrate([0])
通过在0个参数,一个空数组,或者一个价值0个元素的数组将取消任何振动。
cordova 旧版本
*notification.vibrate (不推荐使用)
为振动装置给定一个时间。
navigator.notification.vibrate(time)
time:毫秒数给振动装置(数字)
平台特性
iOS 特性
time:忽略指定的时间和振动在预先设定的时间。
navigator.notification.vibrate();
navigator.notification.vibrate(2500); // 2500 is ignored 忽略
*notification.vibrateWithPattern (不推荐使用)
该装置与一个给定的模式振动。
navigator.notification.vibrateWithPattern(pattern, repeat)
pattern:序列的持续时间(毫秒数),打开或关闭振动器。(数字数组)
repeat:可选指标纳入图案阵列,开始重复(重复直至取消),或1不重复(默认)。(数字)
*notification.cancelVibration (不推荐使用)
立即取消所有当前正在运行的振动。
navigator.notification.cancelVibration()
示例
index.html:
<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8"/>
<meta http-equiv="Content-Security-Policy" content="default-src 'self' data: gap: https://ssl.gstatic.com 'unsafe-eval'; style-src 'self' 'unsafe-inline'; media-src *; img-src 'self' data: content:;">
<meta name="format-detection" content="telephone=no">
<meta name="msapplication-tap-highlight" content="no">
<meta name="viewport" content="user-scalable=no, initial-scale=1, maximum-scale=1, minimum-scale=1, width=device-width">
<title>Hello World</title>
<style>
.line {
padding: 5px;
}
</style>
</head>
<body>
<div class="app">
<div class="line"><button id = "vibrate">标准震动</button></div>
<div class="line"><button id = "vibrationPattern">自定义震动</button></div>
</div>
<script type="text/javascript" src="cordova.js"></script>
<script type="text/javascript" src="js/index.js"></script>
</body>
</html>