本规范定义了一个接口，它提供了访问托管设备的振动机制。振动是一种触觉反馈。
本文档状态本节描述本文档发布时状态，其他文档可能取代本文档。 W3C 最新发布的技术报告， 以及本技术报告的最新版本， 参见 W3C 技术报告索引： http://www.w3.org/TR/。
自发布提案推荐标准以来，本文档没有任何新的改变。
W3C 期望通过发布该推荐标准，其所规范的功能不受 Web IDL 规范通往推荐标准的过程所影响。
本文档代表该小组在振动接口这一范围和特性的共识。应当指出的是，工作组意识到了 无法使用这一简单的第一个版本规范来实现更先进的使用案例。留待未来的修订来解决它们。
本文档由设备接口工作组发布为推荐标准。 关于本文档的任何反馈意见，请发送至工作组邮件列表： public-device-apis@w3.org （订阅, 归档）。 欢迎反馈。
请参阅工作组的实现报告。
本文档已由 W3C 成员、软件开发者、 W3C 工作组和有关各方审阅，并由 W3C 理事会批准为推荐标准。 此为稳定的文档，可以用作参考文献或从另一个文件中引用。 W3C 制定推荐标准的任务是使之受到关注，并促使其被广泛使用。这将增强 Web 的功能性与互操作性。
本文档由一个遵循 2004年2月5日 W3C 专利政策的小组创作。 W3C 维护着一个与工作组交付产品相关的已公开的专利列表；该列表页面还包括如何公开一项专利的说明。 对某专利拥有实际知识并相信该专利包含了 基本要求的个人，必须根据 W3C 专利政策第6节的要求公开这些信息。
本文档受制于2005年10月14日 W3C 过程文档。
目录 1. 引言本章节不具有规范性。
振动接口专门设计用于仅需简单触觉反馈的用例场景。那些需要细粒度控制的用例场景超出了本规范的范围。 该接口并非用于通用的通知机制。通用的通知可使用通知接口 [NOTIFICATIONS] 规范来处理。此外，决定是否启用振动也超出了本规范的范围。
2. 一致性像其他不具有规范性的章节一样，本规范中所有指导方案、图表、示例以及注解都不具有规范性。 本规范中其余部分均具有规范性。
关键词可以和必须的释义由 [RFC2119] 进行解释。
本规范所定义的一致性标准条件仅适用于实现了规范所包含接口的用户代理。
由于本规范使用了 WebIDL 规范及其术语，因此如果使用 ECMA 脚本对本规范定义的应用程序接口进行实现， 则必须保持实现与 ECMA 脚本绑定定义的 WebIDL 规范 [WEBIDL] 相一致。
3. 术语browsing context 和 spin the event loop 的概念由 [HTML5] 规范定义。
4. 振动接口typedef (unsigned long or sequence<unsigned long>) VibratePattern;partial interface Navigator { boolean vibrate (
VibratePatternpattern); };
当调用 vibrate() 方法时，必须运行 processing vibration patterns 算法。
processing vibration patterns 的算法的规则描述如下：
vibrate() 方法的第一个参数。 hidden 属性值 [PAGE-VISIBILITY] 设置为 true，则返回 false 并终止所有步骤。
注
可信（也称授权）应用程序因为与操作系统功能集成紧密，即使完全不可见，也可能产生设备振动， 因此可以忽略前述步骤。
为 validate and normalize 某一给定的振动模式 pattern，运行这些步骤：
注
如果模式的长度大于最大长度，该接口的实现可以考虑将此振动请求有效地分解成多个内部短请求， 来实现同样的效果，而不是忽略最大长度后面的请求。 然而，有些情况下忽略模式超过最大长度的部分是合时的。 一个例子是，如果长度太长,将会有效地创建一个拒绝服务攻击用户。 如果已知对某 web 应用程序来说某个长度太长时，该应用程序也可能采用多个请求； 模式之间可能存在的差距是可以接受的。
注
如果 pattern 的长度是偶数并且非零，那么模式中的最后一项就会没有效果，因此实现可以在此从 pattern 中将之删除。
为使用 pattern perform vibration ，运行这些步骤：
注
例如，用户设置了某些域的页面不得使设备振动，或者振动的总时间长度超过了页面允许的最大值从而拒绝振动请求，这些情况下算法实现可以停止算法运行。
当 Document browsing context 上的 visibilitychange 事件 [PAGE-VISIBILITY] 触发时， 用户代理 必须 终止所有已经在运行的 processing vibration patterns 算法。
本章节不具有规范性。
以下演示如何让设备振动 1 秒：
示例 1
// 振动 1 秒 navigator.vibrate(1000); // 或者 navigator.vibrate([1000]);
以下演示如何让设备先振动 50 毫秒，再停止 100 毫秒，再振动 150 毫秒：
示例 2
navigator.vibrate([50, 100, 150]);
以下演示如何取消振动：
示例 3
// 取消所有振动 navigator.vibrate(0); // 或者 navigator.vibrate([]);A. 致谢
工作组非常感谢 Justin Lebar、Mounir Lamouri、Jonas Sicking 和 Mozilla WebAPI 团队的贡献和提供 WebVibrator 原型作为初始输入。 感谢 Anne van Kesteren 建议如何使规范重用于其他文档。
B. 参考文献 B.1 规范性参考文献RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.3