1# @system.vibrator (振动) 2 3vibrator模块提供控制马达振动的能力，主要包含灯的列表查询、打开灯、关闭灯等接口，振动器的列表查询、振动器的振动器效果查询、触发/关闭振动器等接口。 4 5控制类小器件指的是设备上的LED灯和振动器。其中，LED灯主要用作指示（如充电状态）、闪烁功能（如三色灯）等；振动器主要用于闹钟、开关机振动、来电振动等场景。 6 7 8> **说明：** 9> - 本模块首批接口从API version 3开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 10> - 从API Version 8开始，该接口不再维护，推荐使用新接口[`@ohos.vibrator`](js-apis-vibrator.md)。 11> - 该功能使用需要对应硬件支持，仅支持真机调试。 12 13 14## 导入模块 15 16 17``` 18import vibrator from '@system.vibrator'; 19``` 20 21## vibrator.vibrate 22 23 vibrate(options?: VibrateOptions): void 24 25触发设备振动。 26 27**需要权限**：ohos.permission.VIBRATE 28 29**系统能力**：SystemCapability.Sensors.MiscDevice.Lite 30 31**参数：** 32 33| 参数名 | 类型 | 必填 | 说明 | 34| ------- | --------------------------------- | ---- | ---------- | 35| options | [VibrateOptions](#vibrateoptions) | 否 | 振动模式。 | 36 37**示例：** 38 39```ts 40import vibrator from '@system.vibrator'; 41import { VibrateOptions } from '@system.vibrator'; 42 43let vibrateOptions: VibrateOptions = { 44 mode: 'short', 45 success: () => { 46 console.info('Succeed in vibrating'); 47 }, 48 fail: (data: string, code: number) => { 49 console.info(`Failed to vibrate. Data: ${data}, code: ${code}`); 50 }, 51 complete: () => { 52 console.info('completed in vibrating'); 53 } 54}; 55vibrator.vibrate(vibrateOptions); 56``` 57 58## VibrateOptions 59 60振动模式。 61 62**需要权限**：ohos.permission.VIBRATE 63 64**系统能力**：SystemCapability.Sensors.MiscDevice.Lite 65 66| 名称 | 类型 | 必填 | 说明 | 67| -------- | -------- | ---- | ------------------------------------------------------------ | 68| mode | string | 否 | 振动的模式，其中long表示长振动，short表示短振动，默认值为long。 | 69| success | Function | 否 | 感应到振动数据变化后的回调函数。 | 70| fail | Function | 否 | 接口调用失败的回调函数。 | 71| complete | Function | 否 | 接口调用结束的回调函数。 |