大网数据广告活动
Web 标准与前端开发

振动 API

· 52CE 我爱测

大多数现代移动设备包括振动硬件,其允许软件代码通过使设备振动来向用户提供物理反馈。**振动 API**(Vibration API)为 Web 应用程序提供访问此硬件的功能(如果存在),如果设备不支持此功能,则不会执行任何操作。

Vibration API

大多数现代移动设备包括振动硬件,其允许软件代码通过使设备振动来向用户提供物理反馈。振动 API(Vibration API)为 Web 应用程序提供访问此硬件的功能(如果存在),如果设备不支持此功能,则不会执行任何操作。

概念和用法

振动被抽象成开——关脉冲的模式,且可以具有变化的长度。模式可以是单个整数,表示持续振动的毫秒数;或一个整数数组,描述振动和暂停模式。振动由单一方法控制:Navigator.vibrate()。

一个单次振动

你可以通过指定单个值或仅由一个值组成的数组来向振动硬件发出一次脉冲:

navigator.vibrate(200);
navigator.vibrate([200]);

以上两个例子都可以使设备振动 200 ms。

振动模式

一组数值描述了设备振动和不振动的交替周期。数组中的每个值都将转换成一个整数,然后交替解析为设备应该振动的毫秒数和不振动的毫秒数。例如:

navigator.vibrate([200, 100, 200]);

这会使设备振动 200 ms,然后暂停 100 ms,然后再次振动设备 200 ms。

你可以根据需要设定多个振动/暂停对,数组的值可以是偶数或奇数个;值得注意的是,由于振动在每个振动周期结束时自动停止,因此你不必提供最后一个值去暂停。

取消现有振动

当调用 Navigator.vibrate() 的参数为 0、空数组或包含全 0 值的数组时会取消任何正在进行中的振动。

持续振动

一些基于 setInterval 和 clearInterval 操作将允许你创建持续的振动:

let vibrateInterval;

// 在通过的级别开始振动
function startVibrate(duration) {
  navigator.vibrate(duration);
}

// 停止振动
function stopVibrate() {
  // 清除周期并停止持续振动
  if (vibrateInterval) clearInterval(vibrateInterval);
  navigator.vibrate(0);
}

// 以给定的持续时间和周期开始持续振动,假设已给定一个数值
function startPersistentVibrate(duration, interval) {
  vibrateInterval = setInterval(() => {
    startVibrate(duration);
  }, interval);
}

当然上面的代码片段没有考虑到振动参数为数组的情况;基于阵列的持久性振动将需要计算数组项的和,并基于该数量创建周期(可能具有额外的延迟)。

接口

其他接口的扩展

  • Navigator.vibrate()
    • : 在支持它的设备上引起振动。如果振动支持不可用,则不执行任何操作。

规范

浏览器兼容性

参见

  • Navigator.vibrate()

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。