Skip to content

Most visited

Recently visited

navigation
Added in API level 1

Vibrator

public abstract class Vibrator
extends Object

java.lang.Object
   ↳ android.os.Vibrator


Class that operates the vibrator on the device.

If your process exits, any vibration you started will stop.

To obtain an instance of the system vibrator, call getSystemService(Class) with VIBRATOR_SERVICE as the argument.

Summary

Public methods

abstract void cancel()

Turn the vibrator off.

abstract boolean hasVibrator()

Check whether the hardware has a vibrator.

void vibrate(long milliseconds)

Vibrate constantly for the specified period of time.

void vibrate(long[] pattern, int repeat)

Vibrate with a given pattern.

void vibrate(long[] pattern, int repeat, AudioAttributes attributes)

Vibrate with a given pattern.

void vibrate(long milliseconds, AudioAttributes attributes)

Vibrate constantly for the specified period of time.

Inherited methods

From class java.lang.Object

Public methods

cancel

Added in API level 1
void cancel ()

Turn the vibrator off.

This method requires the caller to hold the permission VIBRATE.

hasVibrator

Added in API level 11
boolean hasVibrator ()

Check whether the hardware has a vibrator.

Returns
boolean True if the hardware has a vibrator, else false.

vibrate

Added in API level 1
void vibrate (long milliseconds)

Vibrate constantly for the specified period of time.

This method requires the caller to hold the permission VIBRATE.

Parameters
milliseconds long: The number of milliseconds to vibrate.

vibrate

Added in API level 1
void vibrate (long[] pattern, 
                int repeat)

Vibrate with a given pattern.

Pass in an array of ints that are the durations for which to turn on or off the vibrator in milliseconds. The first value indicates the number of milliseconds to wait before turning the vibrator on. The next value indicates the number of milliseconds for which to keep the vibrator on before turning it off. Subsequent values alternate between durations in milliseconds to turn the vibrator off or to turn the vibrator on.

To cause the pattern to repeat, pass the index into the pattern array at which to start the repeat, or -1 to disable repeating.

This method requires the caller to hold the permission VIBRATE.

Parameters
pattern long: an array of longs of times for which to turn the vibrator on or off.
repeat int: the index into pattern at which to repeat, or -1 if you don't want to repeat.

vibrate

Added in API level 21
void vibrate (long[] pattern, 
                int repeat, 
                AudioAttributes attributes)

Vibrate with a given pattern.

Pass in an array of ints that are the durations for which to turn on or off the vibrator in milliseconds. The first value indicates the number of milliseconds to wait before turning the vibrator on. The next value indicates the number of milliseconds for which to keep the vibrator on before turning it off. Subsequent values alternate between durations in milliseconds to turn the vibrator off or to turn the vibrator on.

To cause the pattern to repeat, pass the index into the pattern array at which to start the repeat, or -1 to disable repeating.

This method requires the caller to hold the permission VIBRATE.

Parameters
pattern long: an array of longs of times for which to turn the vibrator on or off.
repeat int: the index into pattern at which to repeat, or -1 if you don't want to repeat.
attributes AudioAttributes: AudioAttributes corresponding to the vibration. For example, specify USAGE_ALARM for alarm vibrations or USAGE_NOTIFICATION_RINGTONE for vibrations associated with incoming calls.

vibrate

Added in API level 21
void vibrate (long milliseconds, 
                AudioAttributes attributes)

Vibrate constantly for the specified period of time.

This method requires the caller to hold the permission VIBRATE.

Parameters
milliseconds long: The number of milliseconds to vibrate.
attributes AudioAttributes: AudioAttributes corresponding to the vibration. For example, specify USAGE_ALARM for alarm vibrations or USAGE_NOTIFICATION_RINGTONE for vibrations associated with incoming calls.
This site uses cookies to store your preferences for site-specific language and display options.

Hooray!

This class requires API level or higher

This doc is hidden because your selected API level for the documentation is . You can change the documentation API level with the selector above the left navigation.

For more information about specifying the API level your app requires, read Supporting Different Platform Versions.