Package com.gluonhq.charm.down.plugins

Interface VibrationService

public interface VibrationService

The vibration service enables access to the vibration functionality present on most devices. It allows alerting the user when notification through sound is inappropriate or unavailable.

Example

 Services.get(VibrationService.class).ifPresent(service -> {
      service.vibrate();
  });

Android Configuration

The permission android.permission.VIBRATE needs to be added.

 <manifest ...>
    <uses-permission android:name="android.permission.VIBRATE"/>
    ...
  </manifest>

iOS Configuration: none

Since:

3.0.0

Method Summary

Modifier and Type	Method	Description
void	vibrate()	Vibrates the device with the default pattern and duration
void	vibrate(long... pattern)	Vibrates the device with the given pattern, which represents the number of milliseconds to turn the vibration on for, followed by how long it should be off for.

Method Detail

vibrate

void vibrate()

Vibrates the device with the default pattern and duration

vibrate

void vibrate(long... pattern)

Vibrates the device with the given pattern, which represents the number of milliseconds to turn the vibration on for, followed by how long it should be off for.

In the simple case of a single vibration, a call of vibrate(2000) will result in the vibration running for 2 seconds before stopping.

If a pattern is desired, multiple durations can be provided, where each odd duration represents a vibration duration, and each even duration represents an amount of time to wait. For example, a call of vibrate(1000, 1000, 2000, 2000, 3000) will result in the following pattern:

• Vibrate for 1 second
• Wait for 1 second
• Vibrate for 2 seconds
• Wait for 2 seconds
• Vibrate for 3 seconds

Note: the availability of this functionality is platform-restricted, and at present only Android supports it. Calling this method on iOS will result in the same vibration as calling vibrate()

Parameters:

pattern - The pattern of durations to play the vibration for (with wait periods in between).