跳到主要內容

震動

使裝置震動。

範例

Android 應用程式應請求 `android.permission.VIBRATE` 權限,方法是在 `AndroidManifest.xml` 中加入 ``。

Vibration API 在 iOS 上以 `AudioServicesPlaySystemSound(kSystemSoundID_Vibrate)` 呼叫實作。


參考

方法

cancel()

tsx
static cancel();

在啟用重複的情況下調用 `vibrate()` 後,調用此方法可停止震動。


vibrate()

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

觸發固定時長的震動。

在 Android 上,震動時長預設為 400 毫秒,且可透過傳遞數字作為 `pattern` 參數的值來指定任意震動時長。在 iOS 上,震動時長固定為約 400 毫秒。

`vibrate()` 方法可以接受一個 `pattern` 參數,其中包含代表毫秒時間的數字陣列。您可以將 `repeat` 設定為 true,以循環執行震動模式,直到調用 `cancel()` 為止。

在 Android 上,`pattern` 陣列的奇數索引代表震動時長,而偶數索引代表間隔時間。在 iOS 上,`pattern` 陣列中的數字代表間隔時間,因為震動時長是固定的。

參數

名稱類型預設描述
patternnumber
Android

數字陣列
400震動時長,以毫秒為單位。
震動模式,以毫秒為單位的數字陣列。
repeatbooleanfalse重複震動模式直到 `cancel()`。