public abstract class Vibrator extends Object
If your process exits, any vibration you started will stop.
To obtain an instance of the system vibrator, callContext.getSystemService(java.lang.String)
with Context.VIBRATOR_SERVICE
as the argument.Modifier | Constructor and Description |
---|---|
|
Vibrator() |
protected |
Vibrator(Context context) |
Modifier and Type | Method and Description |
---|---|
abstract void |
cancel()
Turn the vibrator off.
|
abstract boolean |
hasVibrator()
Check whether the hardware has a vibrator.
|
abstract void |
vibrate(int uid,
String opPkg,
long[] pattern,
int repeat,
AudioAttributes attributes) |
abstract void |
vibrate(int uid,
String opPkg,
long milliseconds,
AudioAttributes attributes) |
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.
|
public Vibrator()
protected Vibrator(Context context)
public abstract boolean hasVibrator()
public void vibrate(long milliseconds)
This method requires the caller to hold the permission
android.Manifest.permission#VIBRATE
.
milliseconds
- The number of milliseconds to vibrate.public void vibrate(long milliseconds, AudioAttributes attributes)
This method requires the caller to hold the permission
android.Manifest.permission#VIBRATE
.
milliseconds
- The number of milliseconds to vibrate.attributes
- 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.public void vibrate(long[] pattern, int repeat)
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
android.Manifest.permission#VIBRATE
.
pattern
- an array of longs of times for which to turn the vibrator on or off.repeat
- the index into pattern at which to repeat, or -1 if
you don't want to repeat.public void vibrate(long[] pattern, int repeat, AudioAttributes attributes)
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
android.Manifest.permission#VIBRATE
.
pattern
- an array of longs of times for which to turn the vibrator on or off.repeat
- the index into pattern at which to repeat, or -1 if
you don't want to repeat.attributes
- 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.public abstract void vibrate(int uid, String opPkg, long milliseconds, AudioAttributes attributes)
public abstract void vibrate(int uid, String opPkg, long[] pattern, int repeat, AudioAttributes attributes)
public abstract void cancel()
This method requires the caller to hold the permission
android.Manifest.permission#VIBRATE
.