跳至主内容
版本:0.82

振动

非官方测试版翻译

本页面由 PageTurner AI 翻译(测试版)。未经项目官方认可。 发现错误? 报告问题 →

使设备产生振动。

示例

信息

Android 应用应通过在 AndroidManifest.xml 中添加 <uses-permission android:name="android.permission.VIBRATE"/> 来请求 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 数组中的数字仅表示间隔时长。

参数:

NameTypeDefaultDescription
patternnumber
Android

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