HTML5 提供的 Vibration API 并不是用来读取设备震动数据的接口,它的职责是控制设备振动马达,让页面能够以特定时长或节奏发出震动反馈。开发者通过 navigator.vibrate() 方法向浏览器发起震动请求,浏览器再把指令交给底层硬件处理。这个 API 的返回值只表示当前环境是否支持并接受了震动请求,并不包含震动强度、频率或者传感器采集到的加速度信息。

一、核心调用方法与参数形式
最基础的调用是传入一个数字,单位是毫秒。比如 navigator.vibrate(200) 表示让设备震动 200 毫秒。调用后会返回一个布尔值:如果当前设备不支持震动或浏览器禁止该请求,结果为 false;如果请求已经被接受,结果为 true。需要注意的是返回 true 并不代表震动已经完成,而只是表示浏览器接受了这个震动任务。
更复杂的节奏可以通过数组表达。数组中的奇数位表示震动时长,偶数位表示停顿时长。例如 navigator.vibrate([200, 100, 200]) 表示震动 200 毫秒、停顿 100 毫秒、再震动 200 毫秒。数组长度可以是任意正整数,但不同平台可能对总时长或数组长度有上限。通常较长的数组会被浏览器截断或忽略。
// 单次震动 300 毫秒 navigator.vibrate(300); // 模式震动:震 200ms,停 100ms,震 400ms navigator.vibrate([200, 100, 400]); // 立即停止所有震动 navigator.vibrate(0); navigator.vibrate([]);
停止震动有两种写法:传 0 或者传空数组。两者效果相同,都会立即中断正在进行的震动任务。这个接口没有回调函数,也没有事件可以监听震动结束,所以如果需要精确控制后续逻辑,只能使用 setTimeout() 或 setInterval() 自己估算时间。
二、从“取数”到“控制”:纠正一个常见误解
标题里提到的获取震动反馈数据其实是一个容易混淆的点。Vibration API 没有提供任何传感器读数,调用 navigator.vibrate() 之后拿到的只是 true 或 false,它既不代表震动强度,也不返回震动波形。真正的震动传感器或加速度采集需要依靠另外的接口。
如果页面需要感知设备是否在震动,或者分析用户晃动手机的幅度,应该使用 DeviceMotionEvent。该事件能提供 accelerationIncludingGravity 等加速度信息,适用于摇一摇、运动检测等场景。更进一步还可以使用 Generic Sensor API 中的 Accelerometer 或 LinearAccelerationSensor,但这些接口在移动端的支持情况需要单独检测。
因此,把 Vibration API 当作数据采集工具是不准确的。更合理的理解是:它是一个输出型 API,从网页向硬件发送震动指令。与之对应的输入型 API 才是 DeviceMotionEvent、传感器 API 等。二者可以在同一页面中配合使用,例如用户触发某个动作后先震动反馈,同时读取加速度数据做后续计算。
// 监听设备加速度变化
window.addEventListener('devicemotion', function (event) {
var acc = event.accelerationIncludingGravity;
if (acc) {
console.log('x: ' + acc.x, 'y: ' + acc.y, 'z: ' + acc.z);
}
});
三、兼容性、权限与用户手势限制
Vibration API 的桌面端支持并不理想,Chrome、Firefox 的桌面版本通常不会触发物理震动,因为大多数台式机和笔记本没有振动马达。移动端主要集中在 Android Chrome 和部分基于 Chromium 的浏览器。iOS 上的 Safari 目前没有实现该接口,所以 iPhone 和 iPad 页面调用 navigator.vibrate 会直接失败或不存在。
调用前应始终进行能力检测。可以写成 if ('vibrate' in navigator) { ... },或者 if (navigator.vibrate) { ... }。在 iframe 环境中,浏览器可能会根据 Permissions Policy 限制震动,跨域 iframe 需要在 <iframe> 标签上添加相应的 allow 属性。部分浏览器还要求震动必须由用户手势触发,脚本自动执行可能被静默忽略。
移动设备对震动的处理还存在省电和防滥用策略。页面切到后台时,浏览器可能自动取消尚未完成的震动;长时间震动也可能被系统缩短。所以在实际使用中,500 毫秒以内的反馈比较稳定,超过 1 秒的震动不一定能完整执行。如果需要更长时间提醒,建议使用重复模式而不是单次超长震动。
<iframe src="https://ipipp.com/demo" allow="vibrate"></iframe>
四、封装一个可复用的震动工具函数
为了让震动逻辑集中管理,可以封装一个简单的工具函数。基本能力包括:检测浏览器是否支持、校验时长参数、避免重复调用导致任务被覆盖、提供停止方法。下面是一个轻量实现,适合放在工具模块中。
这个函数会先判断 navigator.vibrate 是否存在,然后把单个数字包装成数组传入。这样能统一参数格式,避免传参错误。对于小于 0 或非数字的情况直接返回 false,不产生无效调用。外部可以通过调用 stopVibrate() 立即停止震动。
var vibrationUtil = {
isSupported: function () {
return 'vibrate' in navigator;
},
vibrate: function (pattern) {
if (!this.isSupported()) {
return false;
}
if (typeof pattern === 'number') {
if (pattern < 0 || !isFinite(pattern)) {
return false;
}
pattern = [pattern];
}
if (Object.prototype.toString.call(pattern) !== '[object Array]') {
return false;
}
for (var i = 0; i < pattern.length; i++) {
if (typeof pattern[i] !== 'number' || pattern[i] < 0) {
return false;
}
}
return navigator.vibrate(pattern);
},
stop: function () {
if (this.isSupported()) {
navigator.vibrate(0);
}
}
};
// 使用示例
vibrationUtil.vibrate(300);
vibrationUtil.vibrate([200, 100, 200]);
vibrationUtil.stop();
实际业务中还可以在收到新消息、提交表单出错、游戏角色受击等节点调用 vibrationUtil.vibrate()。注意不要在页面加载时无节制地触发震动,否则容易让用户反感,甚至被系统限制。把震动当成交互反馈中的辅助手段,比把它当作通知主渠道更合适。
Vibration API设备震动HTML5修改时间:2026-10-29 10:27:36