Skip to main content
Version: 0.61

Vibration

The Vibration API is exposed at Vibration.vibrate(). The vibration is synchronous so this method will return immediately.

There will be no effect on devices that do not support Vibration, eg. the simulator.

Note for Android: add <uses-permission android:name="android.permission.VIBRATE"/> to AndroidManifest.xml

The vibration duration in iOS is not configurable, so there are some differences with Android. In Android, if pattern is a number, it specifies the vibration duration in ms. If pattern is an array, those odd indices are the vibration duration, while the even ones are the separation time.

In iOS, invoking vibrate(duration) will ignore the duration and vibrate for a fixed time. While the pattern array is used to define the duration between each vibration. See below example for more.

Repeatable vibration is also supported, the vibration will repeat with defined pattern until cancel() is called.

Example:

const DURATION = 10000;
const PATTERN = [1000, 2000, 3000];

Vibration.vibrate(DURATION);
// Android: vibrate for 10s
// iOS: duration is not configurable, vibrate for fixed time (about 500ms)

Vibration.vibrate(PATTERN);
// Android: wait 1s -> vibrate 2s -> wait 3s
// iOS: wait 1s -> vibrate -> wait 2s -> vibrate -> wait 3s -> vibrate

Vibration.vibrate(PATTERN, true);
// Android: wait 1s -> vibrate 2s -> wait 3s -> wait 1s -> vibrate 2s -> wait 3s -> ...
// iOS: wait 1s -> vibrate -> wait 2s -> vibrate -> wait 3s -> vibrate -> wait 1s -> vibrate -> wait 2s -> vibrate -> wait 3s -> vibrate -> ...

Vibration.cancel();
// Android: vibration stopped
// iOS: vibration stopped

Reference

Methods​

vibrate()​

Vibration.vibrate(pattern: number, Array<number>, repeat: boolean)

Trigger a vibration with specified pattern.

Parameters:

NameTypeRequiredDescription
patternnumber or Array<number>YesVibration pattern, accept a number or an array of numbers. Default to 400ms.
repeatbooleanNoRepeat vibration pattern until cancel(), default to false.

cancel()​

Vibration.cancel();

Stop vibration.

Vibration.cancel()