跳到主内容

Vibration

使设备震动。

示例

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

在 iOS 上,震动 API 是通过调用 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()