バイブレーションAPI

Navigator インターフェイス vibrate メソッド (DOM)

[34] Navigator インターフェイスvibrate は、バイブレーションの実行、 つまり装置振動させることを指示するものです。

仕様書

引数

[23] vibrate メソッドは、必須VibratePattern 引数を1つ持ちます >>16。 これは実行する振動のパターンを指定するものです。

返り値

[24] vibrate メソッド戻り値は、 boolean です >>16。この値はバイブレーションを実施できたかどうかを表しています。

処理

[25] vibrate メソッドは、次のようにしなければなりません >>16

  1. [36] パターンを、必須の第1引数を VibratePattern として解釈した結果に設定します。
  2. [35] バイブレーションパターンの処理 (processing vibration patterns)
    1. [37] 正規パターンを、パターン検証および正規化した結果に設定します。
    2. [26] 文脈オブジェクト最上位閲覧文脈に関する可視性状態の決定の結果が visible でなく、 プラットフォームと深く統合され特権を持ったアプリケーションでもないなら、
      1. [40] を返し、ここで停止します。
    3. [38] 正規パターンについてバイブレーションを実施した結果を返します。

[39] 仕様書可視性状態が変化した時バイブレーションパターンの処理を停止することを求めています >>16 が、実質的にはバイブレーションパターンの実施を停止させるものです。

[27] 旧版の仕様書は、どの文書の状態を参照するべきなのか明確ではありませんでした。

歴史

ガラケー時代

[17] ガラケーの中には、HTMLvibration 属性viblength 属性によってバイブレーションの挙動を指定できるものもありました。

[20] この2つの属性は、 a 要素input 要素img 要素に存在していました。

[19] img 要素vibration 属性は、対応機種のサポート終了により2010年4月の2.1.0版で削除されました。 (他の要素では存続。)

[18] これらの属性は標準化されることなく、ガラケーの衰退により使われなくなりました。

[41] a/input vibration Softbank 3.9.1., 3.12.2.

[42] a/input viblength Softbank 3.9.1., 3.10.1., 3.12.2.

Vibration API

[1] Vibration API ( ( 版)) <http://www.w3.org/TR/2011/WD-vibration-20111117/>

[2] Bug 679966 – WebVibrator ( ( 版)) <https://bugzilla.mozilla.org/show_bug.cgi?id=679966>

[3] Vibration API ( ( 版)) <http://www.w3.org/TR/2012/CR-vibration-20120508/>

[4] cordova-plugin-vibration/doc/index.md at master · apache/cordova-plugin-vibration · GitHub ( ( 版)) <https://github.com/apache/cordova-plugin-vibration/blob/master/doc/index.md>

[5] Cordova and w3c spec Algnment - Vibration Gap Analysis ( (Lisa Seacat DeLuca 著, 版)) <http://lists.w3.org/Archives/Public/public-webapps/2014AprJun/0868.html>

[8] Vibration API ( ( 版)) <http://www.w3.org/TR/2012/WD-vibration-20120202/>

[9] Vibration API ( ( 版)) <http://www.w3.org/TR/2013/WD-vibration-20130523/>

[10] Vibration API ( ( 版)) <http://www.w3.org/TR/2013/CR-vibration-20130723/>

[11] Vibration API ( ( 版)) <http://www.w3.org/TR/2014/WD-vibration-20140211/>

[12] Vibration API ( ( 版)) <http://www.w3.org/TR/2014/WD-vibration-20140619/>

[13] Vibration API ( ( 版)) <http://www.w3.org/TR/2014/CR-vibration-20140909/>

[15] Vibration ( (Anne van Kesteren 著, 版)) <http://lists.w3.org/Archives/Public/www-archive/2014Oct/0000.html>

[14] Integrate vibration · f57831c · whatwg/notifications ( ( 版)) <https://github.com/whatwg/notifications/commit/f57831c11f90ec31b01a042508580bd45d74bb6c>

[6] Vibration API ( ( 版)) <http://www.w3.org/TR/2014/PR-vibration-20141209/>

[7] Vibration API ( ( 版)) <http://www.w3.org/TR/2015/REC-vibration-20150210/>

[21] Vibration API: All Results ( 版) <http://w3c.github.io/test-results/vibration/20141118.html>

[22] >>21実装報告によると、 FirefoxChrome が対応しています。

[28] Add Notification.prototype.vibrate. Fixes #43. · whatwg/notifications@4661293 ( 版) <https://github.com/whatwg/notifications/commit/4661293aa4e2dcd46c9db5e163f3781914835f87>

[29] Vibration API ( 版) <https://w3c.github.io/vibration/>

[30] Use [SameObject] Notification's vibrate attribute ( (annevk著, )) <https://github.com/whatwg/notifications/commit/40a08aa722d3c5b2eff3888292ca918b3ea8a9bf>

[31] Block navigator.vibrate in cross-origin iframes · Issue #25 · WICG/interventions () <https://github.com/WICG/interventions/issues/25>

[32] Vibration API () <https://www.w3.org/TR/2016/PER-vibration-20160818/>

[33] Vibration API (Second Edition) () <https://www.w3.org/TR/2016/REC-vibration-20161018/>