バイブレーションAPI

Edit New

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] ガラケーの中には、HTML の vibration 属性や 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 の実装報告によると、 Firefox と Chrome が対応しています。

[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/>

Updated: