vibrator模块提供控制马达振动的能力，主要包含灯的列表查询、打开灯、关闭灯等接口，振动器的列表查询、振动效果查询、触发/关闭等接口。

控制类小器件指的是设备上的LED灯和振动器。其中，LED灯主要用作指示（如充电状态）、闪烁功能（如三色灯）等；振动器主要用于闹钟、开关机振动、来电振动等场景。

说明

* 模块维护策略：
  + 对于Lite Wearable设备类型，该模块长期维护，正常使用。
  + 对于支持该模块的其他设备类型，该模块从API version 8开始不再维护，推荐使用新接口[@ohos.vibrator](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-vibrator)。
* 本模块首批接口从API version 3开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
* 该功能使用需要对应硬件支持，仅支持真机调试。

## 导入模块

WearableLite Wearable



```
1. import { Vibrator } from '@kit.SensorServiceKit';
```

## Vibrator.vibrate

WearableLite Wearable

vibrate(options?: VibrateOptions): void

触发设备振动。

除Lite Wearable外，从API Version8开始，推荐使用[vibrator.startVibration()](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-vibrator#vibratorstartvibration9)。

**需要权限**：ohos.permission.VIBRATE

**系统能力**：SystemCapability.Sensors.MiscDevice.Lite

**参数**：

展开

| 参数名 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| options | [VibrateOptions](/consumer/cn/doc/harmonyos-references/js-apis-system-vibrate#vibrateoptions) | 否 | 振动模式。 |

**示例**：



```
1. import { Vibrator, VibrateOptions } from '@kit.SensorServiceKit';

3. let vibrateOptions: VibrateOptions = {
4. mode: 'short',
5. success: () => {
6. console.info('Succeed in vibrating');
7. },
8. fail: (data: string, code: number) => {
9. console.error(`Failed to vibrate. Data: ${data}, code: ${code}`);
10. },
11. complete: () => {
12. console.info('completed in vibrating');
13. }
14. };
15. Vibrator.vibrate(vibrateOptions);
```

## VibrateOptions

WearableLite Wearable

振动模式。

**需要权限**：ohos.permission.VIBRATE

**系统能力**：SystemCapability.Sensors.MiscDevice.Lite

展开

| 名称 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| mode | string | 否 | 振动的模式，其中long表示长振动，short表示短振动，默认值为long。 |
| success | Function | 否 | 感应到振动数据变化后的回调函数。 |
| fail | Function | 否 | 接口调用失败的回调函数。 |
| complete | Function | 否 | 接口调用结束的回调函数。 |