跳到主要内容

振动

使设备振动。

示例

信息

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

备注

在 iOS 上,Vibration API 作为一次 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()