MDN’s new design is in Beta! A sneak peek: https://blog.mozilla.org/opendesign/mdns-new-design-beta/

Vibration API

現代のモバイルデバイスはたいていバイブレーションハードウェアを内蔵しており、デバイスを振動させることによりソフトウェアのコードがユーザに物理的なフィードバックを与えることを可能にします。バイブレーションハードウェアを搭載している場合は Vibration API で、Web アプリがこのハードウェアにアクセスできるようにします。なお、デバイスがバイブレーションをサポートしない場合は何も行いません。

バイブレーションの表現

バイブレーションはオン・オフのパルスのパターンで表され、それはさまざまな長さになるでしょう。パターンは振動するミリ秒数を示す整数 1 つ、あるいはバイブレーションと休止時間のパターンを示す整数の配列で構成します。バイブレーションは 1 つのメソッドで制御します: Navigator.vibrate() です。

1 回のバイブレーション

1 個の値、または 1 個だけの値で構成される配列を指定することにより、バイブレーションハードウェアを 1 回振動させることができます:

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

どちらの例も、デバイスを 200 ミリ秒間振動させます。

バイブレーションパターン

値の配列は、デバイスが振動する時間と振動しない時間を交互に示します。配列内の各値は整数値に変換されて、デバイスを振動させるミリ秒数および振動させないミリ秒数として交互に解釈されます。例えば:

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

これはデバイスを 200 ミリ秒間振動させて、その後再び 200 ミリ秒間振動させる前に 100 ミリ秒間振動を止めます。

バイブレーション/休止のペアは好きなだけ多く指定でき、またエントリ数は偶数・奇数のどちらでも可能です。各バイブレーション時間の終端で自動的にバイブレーションを止めますので、休止時間を最後のエントリとして与えなくてもよいことは注目に値します。

実行中のバイブレーションを取り消す

0、空の配列、あるいはすべての値が 0 の配列 を指定して Navigator.vibrate() を呼び出すと、現在進行中のバイブレーションパターンを取り消します。

継続的なバイブレーション

基本的な setInterval および clearInterval のアクションにより、継続的なバイブレーションを生成できます:

var vibrateInterval;

// 渡されたレベルでバイブレーションを開始
function startVibrate(duration) {
	navigator.vibrate(duration);
}

// バイブレーションを停止
function stopVibrate() {
	// インターバルをクリアして継続的なバイブレーションを停止 
	if(vibrateInterval) clearInterval(vibrateInterval);
	navigator.vibrate(0);
}

// 与えられた時間とインターバルによる継続的なバイブレーションを開始
// 数値が与えられるものとする
function startPeristentVibrate(duration, interval) {
	vibrateInterval = setInterval(function() {
		startVibrate(duration);
	}, interval);
}

当然ながら、上記のコードスニペットは配列によるバイブレーションを考慮していません。配列に基づく継続的なバイブレーションでは、配列のアイテムの総数を計算して、その値を基にしてインターバル (おそらく、遅延時間を付加して) を作成することが必要でしょう。

なぜ Vibration API を使用するか?

この API は、明らかにモバイルデバイスをターゲットにしています。Vibration API はモバイル Web アプリケーションでの通知に有用であり、また特にゲームやメディア重視のアプリケーションで使用するときにすばらしいものでしょう。モバイルデバイスで動画を見ていて、爆発シーンでデバイスが少し振動すると想像してみましょう。あるいはボンバーマンをプレイしていて、ブロックが爆発するときに穏やかな衝撃を感じると想像してみましょう!

仕様

仕様書 策定状況 コメント
Vibration API 勧告 リンク先は最新の Editor's Draft です。W3C 版は勧告になりました。

ブラウザ実装状況

機能 Chrome Firefox (Gecko) Internet Explorer Opera Safari
基本サポート (有) webkit 11.0 moz
16
未サポート 未サポート 未サポート
機能 Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
基本サポート (有) webkit 11.0 moz 未サポート 未サポート 未サポート

関連情報

ドキュメントのタグと貢献者

 このページの貢献者: yyss
 最終更新者: yyss,