跳到主要内容
版本:Next

振动

使设备振动。

示例

信息

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

备注

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


参考

方法

cancel()

React TSX
static cancel();

在以启用重复的方式调用了 vibrate() 之后,使用此方法停止振动。


vibrate()

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

触发固定时长的振动。

在 Android 上, 振动时长默认为 400 毫秒,也可以通过向 pattern 参数传递一个数字来指定任意振动时长。在 iOS 上, 振动时长固定为大约 400 毫秒。

vibrate() 方法可以接收一个 pattern 参数,该参数为由毫秒时间组成的数组。你可以将 repeat 设置为 true,以循环执行振动模式,直到调用 cancel()

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

参数:

名称类型默认值描述
patternnumber
Android

array of numbers
400毫秒单位的振动时长。
以毫秒为单位的数字数组形式的振动模式。
repeatbooleanfalse重复振动模式,直到调用 cancel()