Vibration

使设备振动。

¥Vibrates the device.

示例

¥Example

Android 应用应通过将 <uses-permission android:name="android.permission.VIBRATE"/> 添加到 AndroidManifest.xml 来请求 android.permission.VIBRATE 权限。

¥Android apps should request the android.permission.VIBRATE permission by adding <uses-permission android:name="android.permission.VIBRATE"/> to AndroidManifest.xml.

振动 API 在 iOS 上作为 AudioServicesPlaySystemSound(kSystemSoundID_Vibrate) 调用实现。

¥The Vibration API is implemented as a AudioServicesPlaySystemSound(kSystemSoundID_Vibrate) call on iOS.

---

参考

¥Reference

方法

¥Methods

cancel()

static cancel();

在启用重复的情况下调用 vibrate() 后，调用此命令可停止振动。

¥Call this to stop vibrating after having invoked vibrate() with repetition enabled.

---

vibrate()

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

触发固定持续时间的振动。

¥Triggers a vibration with a fixed duration.

在 Android 上，振动持续时间默认为 400 毫秒，并且可以通过传递数字作为 pattern 参数的值来指定任意振动持续时间。在 iOS 上，振动持续时间固定为大约 400 毫秒。

¥On Android, the vibration duration defaults to 400 milliseconds, and an arbitrary vibration duration can be specified by passing a number as the value for the pattern argument. On iOS, the vibration duration is fixed at roughly 400 milliseconds.

vibrate() 方法可以采用 pattern 参数以及表示时间（以毫秒为单位）的数字数组。你可以将 repeat 设置为 true 以循环运行振动模式，直到调用 cancel()。

¥The vibrate() method can take a pattern argument with an array of numbers that represent time in milliseconds. You may set repeat to true to run through the vibration pattern in a loop until cancel() is called.

在 Android 上，pattern 数组的奇数索引代表振动持续时间，而偶数索引代表分离时间。在 iOS 上，pattern 数组中的数字代表分离时间，因为振动持续时间是固定的。

¥On Android, the odd indices of the pattern array represent the vibration duration, while the even ones represent the separation time. On iOS, the numbers in the pattern array represent the separation time, as the vibration duration is fixed.

参数：

¥Parameters:

名称	类型	默认	描述
pattern	number Android 数字数组	400	振动持续时间（以毫秒为单位）。 振动模式为以毫秒为单位的数字数组。
repeat	boolean	false	重复振动模式直到 cancel()。