@system.vibrator (Vibrator)

The Vibrator module provides APIs for controlling LED lights and vibrators. You can use the APIs to query the LED light list, turn on and off the LED light, query the vibrator list, query the vibrator effect, and trigger and turn off the vibrator.

Misc devices refer to LED lights and vibrators on devices. LED lights are mainly used for indication (for example, indicating the charging state) and blinking (such as tri-colored lights). Vibrators are mainly used in scenarios such as the alarm clock, power-on/off, and incoming call vibration.

NOTE

• The initial APIs of this module are supported since API version 3. Newly added APIs will be marked with a superscript to indicate their earliest API version.
• The APIs of this module are no longer maintained since API version 8. You are advised to use @ohos.vibrator instead.
• This module requires hardware support and can only be debugged on real devices.

Modules to Import

import vibrator from '@system.vibrator';

vibrator.vibrate

vibrate(options?: VibrateOptions): void

Triggers device vibration.

Required permissions: ohos.permission.VIBRATE

System capability: SystemCapability.Sensors.MiscDevice

Parameters

Example

vibrator.vibrate({
  mode: 'short',
  success: function() {
    console.log('vibrate is successful');
  },
  fail: function(data, code) {
    console.log("vibrate is failed, data: " + data + ", code: " + code);
  },
  complete: function() {
    console.log('vibrate is completed');
  }
});

VibrateOptions

Defines the vibration options.

Required permissions: ohos.permission.VIBRATE

System capability: SystemCapability.Sensors.MiscDevice