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 30 31**参数：** 32 33| 参数名 | 类型 | 必填 | 说明 | 34| ------- | --------------------------------- | ---- | ---------- | 35| options | [VibrateOptions](#vibrateoptions) | 否 | 振动模式。 | 36 37**示例：** 38 39```js 40vibrator.vibrate({ 41 mode: 'short', 42 success: function() { 43 console.log('vibrate is successful'); 44 }, 45 fail: function(data, code) { 46 console.log("vibrate is failed, data: " + data + ", code: " + code); 47 }, 48 complete: function() { 49 console.log('vibrate is completed'); 50 } 51}); 52``` 53 54## VibrateOptions 55 56振动模式。 57 58**需要权限**：ohos.permission.VIBRATE 59 60**系统能力**：SystemCapability.Sensors.MiscDevice 61 62| 名称 | 类型 | 必填 | 说明 | 63| -------- | -------- | ---- | ------------------------------------------------------------ | 64| mode | string | 否 | 振动的模式，其中long表示长振动，short表示短振动，默认值为long。 | 65| success | Function | 否 | 感应到振动数据变化后的回调函数。 | 66| fail | Function | 否 | 接口调用失败的回调函数。 | 67| complete | Function | 否 | 接口调用结束的回调函数。 |