メインコンテンツにスキップ

Vibration（バイブレーション）

デバイスを振動させます。

例​

Androidアプリは、AndroidManifest.xml に <uses-permission android:name="android.permission.VIBRATE"/> を追加することで、android.permission.VIBRATE パーミッションをリクエストする必要があります。

Vibration APIは、iOSではAudioServicesPlaySystemSound(kSystemSoundID_Vibrate) 呼び出しとして実装されています。

リファレンス

メソッド​

cancel()​

static cancel();

繰り返しを有効にして vibrate() を呼び出した後に、振動を停止するには、これを呼び出します。

vibrate()​

static vibrate(
  pattern?: number | number[],
  repeat?: boolean
);

一定時間の振動をトリガーします。

**Androidでは、** 振動時間はデフォルトで400ミリ秒で、`pattern`引数に数値を渡すことで任意の振動時間を指定できます。 **iOSでは、** 振動時間は約400ミリ秒に固定されています。

vibrate() メソッドは、ミリ秒単位の時間を表す数値の配列を持つ `pattern` 引数を取ることができます。 `repeat` をtrueに設定すると、`cancel()` が呼び出されるまで、振動パターンがループで実行されます。

**Androidでは、** `pattern` 配列の奇数インデックスは振動時間を表し、偶数インデックスは分離時間を表します。 **iOSでは、** 振動時間が固定されているため、`pattern` 配列の数値は分離時間を表します。

パラメータ

名前タイプデフォルト説明
pattern数値
Android
数値の配列		400ミリ秒単位の振動時間。
ミリ秒単位の数値の配列としての振動パターン。
repeat真偽値falsecancel() まで振動パターンを繰り返します。