跳到主要内容
新架构实战课 实操 + 基建 + 原理全维度包揽,抢先掌握 React Native 新架构精髓 立即查看 >

Vibration

使设备振动。

示例

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

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


文档

方法

cancel()

static cancel();

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


vibrate()

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

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

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

vibrate()方法可以接受一个包含数字数组的pattern参数,这些数字代表以毫秒为单位的时间。你可以设置repeat为 true,在调用cancel()之前循环运行振动模式。

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

参数:

NameTypeDefaultDescription
patternnumber
Android

array of numbers
400Vibration duration in milliseconds.
Vibration pattern as an array of numbers in milliseconds.
repeatbooleanfalseRepeat vibration pattern until cancel().