Added in API level 1

Summary: Constants | Methods | Inherited Methods

Vibrator

Kotlin |Java

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.

Summary

Constants
`int`	`VIBRATION_EFFECT_SUPPORT_NO` Vibration effect support: unsupported This effect is not supported by the underlying hardware.
`int`	`VIBRATION_EFFECT_SUPPORT_UNKNOWN` Vibration effect support: unknown The hardware doesn't report it's supported effects, so we can't determine whether the effect is supported or not.
`int`	`VIBRATION_EFFECT_SUPPORT_YES` Vibration effect support: supported This effect is supported by the underlying hardware.

Public methods
`final int`	`areAllEffectsSupported(int... effectIds)` Query whether the vibrator supports all of the given effects.
`final boolean`	`areAllPrimitivesSupported(int... primitiveIds)` Query whether the vibrator supports all of the given primitives.
`int[]`	`areEffectsSupported(int... effectIds)` Query whether the vibrator supports the given effects.
`boolean[]`	`arePrimitivesSupported(int... primitiveIds)` Query whether the vibrator supports the given primitives.
`abstract void`	`cancel()` Turn the vibrator off.
`abstract boolean`	`hasAmplitudeControl()` Check whether the vibrator has amplitude control.
`abstract boolean`	`hasVibrator()` Check whether the hardware has a vibrator.
`void`	`vibrate(long milliseconds)` This method was deprecated in API level 26. Use `vibrate(android.os.VibrationEffect)` instead.
`void`	`vibrate(long[] pattern, int repeat)` This method was deprecated in API level 26. Use `vibrate(android.os.VibrationEffect)` instead.
`void`	`vibrate(VibrationEffect vibe, AudioAttributes attributes)` Requires `Manifest.permission.VIBRATE`
`void`	`vibrate(long milliseconds, AudioAttributes attributes)` This method was deprecated in API level 26. Use `vibrate(android.os.VibrationEffect, android.media.AudioAttributes)` instead.
`void`	`vibrate(VibrationEffect vibe)` Requires `Manifest.permission.VIBRATE`
`void`	`vibrate(long[] pattern, int repeat, AudioAttributes attributes)` This method was deprecated in API level 26. Use `vibrate(android.os.VibrationEffect, android.media.AudioAttributes)` instead.

Inherited methods

From class


        
          java.lang.Object

`Object`	`clone()` Creates and returns a copy of this object.
`boolean`	`equals(Object obj)` Indicates whether some other object is "equal to" this one.
`void`	`finalize()` Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.
`final Class<?>`	`getClass()` Returns the runtime class of this `Object`.
`int`	`hashCode()` Returns a hash code value for the object.
`final void`	`notify()` Wakes up a single thread that is waiting on this object's monitor.
`final void`	`notifyAll()` Wakes up all threads that are waiting on this object's monitor.
`String`	`toString()` Returns a string representation of the object.
`final void`	`wait(long timeout, int nanos)` Causes the current thread to wait until another thread invokes the `notify()` method or the `notifyAll()` method for this object, or some other thread interrupts the current thread, or a certain amount of real time has elapsed.
`final void`	`wait(long timeout)` Causes the current thread to wait until either another thread invokes the `notify()` method or the `notifyAll()` method for this object, or a specified amount of time has elapsed.
`final void`	`wait()` Causes the current thread to wait until another thread invokes the `notify()` method or the `notifyAll()` method for this object.

Constants

VIBRATION_EFFECT_SUPPORT_NO

Added in API level 30

public static final int VIBRATION_EFFECT_SUPPORT_NO

Vibration effect support: unsupported This effect is not supported by the underlying hardware.

Constant Value: 2 (0x00000002)

VIBRATION_EFFECT_SUPPORT_UNKNOWN

Added in API level 30

public static final int VIBRATION_EFFECT_SUPPORT_UNKNOWN

Vibration effect support: unknown The hardware doesn't report it's supported effects, so we can't determine whether the effect is supported or not.

Constant Value: 0 (0x00000000)

VIBRATION_EFFECT_SUPPORT_YES

Added in API level 30

public static final int VIBRATION_EFFECT_SUPPORT_YES

Vibration effect support: supported This effect is supported by the underlying hardware.

Constant Value: 1 (0x00000001)

Public methods

areAllEffectsSupported

Added in API level 30

public final int areAllEffectsSupported (int... effectIds)

Query whether the vibrator supports all of the given effects. Not all hardware reports its effect capabilities, so the system may not necessarily know whether an effect is supported or not. If the result is VIBRATION_EFFECT_SUPPORT_YES, all effects in the query are supported by the hardware. If the result is VIBRATION_EFFECT_SUPPORT_NO, at least one of the effects in the query is not supported. If the result is VIBRATION_EFFECT_SUPPORT_UNKNOWN, the system doesn't know whether all of the effects are supported. It may support any or all of the queried effects, but there's no way to programmatically know whether a vibrate(VibrationEffect) call will successfully cause a vibration. It's guaranteed, however, that none of the queried effects are definitively unsupported by the hardware.

Parameters
`effectIds`	`int`: Which effects to query for. This value cannot be `null`. Value is `VibrationEffect.EFFECT_TICK`, `VibrationEffect.EFFECT_CLICK`, `VibrationEffect.EFFECT_HEAVY_CLICK`, or `VibrationEffect.EFFECT_DOUBLE_CLICK`

Returns
`int`	Whether all of the effects are supported. Value is `VIBRATION_EFFECT_SUPPORT_UNKNOWN`, `VIBRATION_EFFECT_SUPPORT_YES`, or `VIBRATION_EFFECT_SUPPORT_NO`

areAllPrimitivesSupported

Added in API level 30

public final boolean areAllPrimitivesSupported (int... primitiveIds)

Query whether the vibrator supports all of the given primitives.

Parameters

Parameters
`primitiveIds`	`int`: Which primitives to query for. This value cannot be `null`. Value is `VibrationEffect.Composition.PRIMITIVE_CLICK`, android.os.VibrationEffect.Composition.PRIMITIVE_THUD, android.os.VibrationEffect.Composition.PRIMITIVE_SPIN, `VibrationEffect.Composition.PRIMITIVE_QUICK_RISE`, `VibrationEffect.Composition.PRIMITIVE_SLOW_RISE`, `VibrationEffect.Composition.PRIMITIVE_QUICK_FALL`, or `VibrationEffect.Composition.PRIMITIVE_TICK`

primitiveIds

int: Which primitives to query for. This value cannot be null. Value is VibrationEffect.Composition.PRIMITIVE_CLICK, android.os.VibrationEffect.Composition.PRIMITIVE_THUD, android.os.VibrationEffect.Composition.PRIMITIVE_SPIN, VibrationEffect.Composition.PRIMITIVE_QUICK_RISE, VibrationEffect.Composition.PRIMITIVE_SLOW_RISE, VibrationEffect.Composition.PRIMITIVE_QUICK_FALL, or VibrationEffect.Composition.PRIMITIVE_TICK

Returns
`boolean`	Whether primitives effects are supported.

areEffectsSupported

Added in API level 30

public int[] areEffectsSupported (int... effectIds)

Query whether the vibrator supports the given effects. Not all hardware reports its effect capabilities, so the system may not necessarily know whether an effect is supported or not. The returned array will be the same length as the query array and the value at a given index will contain VIBRATION_EFFECT_SUPPORT_YES if the effect at that same index in the querying array is supported, VIBRATION_EFFECT_SUPPORT_NO if it isn't supported, or VIBRATION_EFFECT_SUPPORT_UNKNOWN if the system can't determine whether it's supported or not.

Parameters
`effectIds`	`int`: Which effects to query for. This value cannot be `null`. Value is `VibrationEffect.EFFECT_TICK`, `VibrationEffect.EFFECT_CLICK`, `VibrationEffect.EFFECT_HEAVY_CLICK`, or `VibrationEffect.EFFECT_DOUBLE_CLICK`

Returns
`int[]`	An array containing the systems current knowledge about whether the given effects are supported or not. This value cannot be `null`. Value is `VIBRATION_EFFECT_SUPPORT_UNKNOWN`, `VIBRATION_EFFECT_SUPPORT_YES`, or `VIBRATION_EFFECT_SUPPORT_NO`

arePrimitivesSupported

Added in API level 30

public boolean[] arePrimitivesSupported (int... primitiveIds)

Query whether the vibrator supports the given primitives. The returned array will be the same length as the query array and the value at a given index will contain whether the effect at that same index in the querying array is supported or not.

Parameters

Parameters
`primitiveIds`	`int`: Which primitives to query for. This value cannot be `null`. Value is `VibrationEffect.Composition.PRIMITIVE_CLICK`, android.os.VibrationEffect.Composition.PRIMITIVE_THUD, android.os.VibrationEffect.Composition.PRIMITIVE_SPIN, `VibrationEffect.Composition.PRIMITIVE_QUICK_RISE`, `VibrationEffect.Composition.PRIMITIVE_SLOW_RISE`, `VibrationEffect.Composition.PRIMITIVE_QUICK_FALL`, or `VibrationEffect.Composition.PRIMITIVE_TICK`

primitiveIds

Returns
`boolean[]`	Whether the primitives are supported. This value cannot be `null`.

cancel

Added in API level 1

public abstract void cancel ()

Turn the vibrator off.
Requires Manifest.permission.VIBRATE

hasAmplitudeControl

Added in API level 26

public abstract boolean hasAmplitudeControl ()

Check whether the vibrator has amplitude control.

Returns
`boolean`	True if the hardware can control the amplitude of the vibrations, otherwise false.

hasVibrator

Added in API level 11

public abstract 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
Deprecated in API level 26

public void vibrate (long milliseconds)

This method was deprecated in API level 26.
Use vibrate(android.os.VibrationEffect) instead.

Vibrate constantly for the specified period of time.
Requires Manifest.permission.VIBRATE

Parameters
`milliseconds`	`long`: The number of milliseconds to vibrate.

vibrate

Added in API level 1
Deprecated in API level 26

public void vibrate (long[] pattern, 
                int repeat)

This method was deprecated in API level 26.
Use vibrate(android.os.VibrationEffect) instead.

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.

Requires Manifest.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 26

public void vibrate (VibrationEffect vibe, 
                AudioAttributes attributes)

Requires Manifest.permission.VIBRATE

Parameters
`vibe`	`VibrationEffect`
`attributes`	`AudioAttributes`

vibrate

Added in API level 21
Deprecated in API level 26

public void vibrate (long milliseconds, 
                AudioAttributes attributes)

This method was deprecated in API level 26.
Use vibrate(android.os.VibrationEffect, android.media.AudioAttributes) instead.

Vibrate constantly for the specified period of time.
Requires Manifest.permission.VIBRATE

Parameters
`milliseconds`	`long`: The number of milliseconds to vibrate.
`attributes`	`AudioAttributes`: `AudioAttributes` corresponding to the vibration. For example, specify `AudioAttributes#USAGE_ALARM` for alarm vibrations or `AudioAttributes#USAGE_NOTIFICATION_RINGTONE` for vibrations associated with incoming calls.

vibrate

Added in API level 26

public void vibrate (VibrationEffect vibe)

Requires Manifest.permission.VIBRATE

Parameters
`vibe`	`VibrationEffect`

vibrate

Added in API level 21
Deprecated in API level 26

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

This method was deprecated in API level 26.
Use vibrate(android.os.VibrationEffect, android.media.AudioAttributes) instead.

Vibrate with a given pattern.

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

Requires Manifest.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 `AudioAttributes#USAGE_ALARM` for alarm vibrations or `AudioAttributes#USAGE_NOTIFICATION_RINGTONE` for vibrations associated with incoming calls.