VibrationAttributes
class VibrationAttributes : Parcelable
| kotlin.Any | |
| ↳ | android.os.VibrationAttributes |
Encapsulates a collection of attributes describing information about a vibration.
Summary
| Nested classes | |
|---|---|
|
Builder class for |
|
| Constants | |
|---|---|
| static Int |
Flag requesting vibration effect to be played even under limited interruptions. |
| static Int |
Usage value to use for accessibility vibrations, such as with a screen reader. |
| static Int |
Usage value to use for alarm vibrations. |
| static Int |
Vibration usage class value to use when the vibration is initiated to catch user's attention, such as alarm, ringtone, and notification vibrations. |
| static Int |
Vibration usage class value to use when the vibration is initiated as a response to user's actions, such as emulation of physical effects, and texting feedback vibration. |
| static Int |
Mask for vibration usage class value. |
| static Int |
Vibration usage class value to use when the vibration is part of media, such as music, movie, soundtrack, game or animations. |
| static Int |
Vibration usage class value to use when the vibration usage class is unknown. |
| static Int |
Usage value to use for vibrations which mean a request to enter/end a communication with the user, such as a voice prompt. |
| static Int |
Usage value to use for vibrations performed as feedback for a user's gesture input. |
| static Int |
Usage value to use for vibrations which provide a feedback for hardware component interaction, such as a fingerprint sensor. |
| static Int |
Usage value to use for media vibrations, such as music, movie, soundtrack, animations, games, or any interactive media that isn't for touch feedback specifically. |
| static Int |
Usage value to use for notification vibrations. |
| static Int |
Usage value to use for vibrations which emulate physical hardware reactions, such as edge squeeze. |
| static Int |
Usage value to use for ringtone vibrations. |
| static Int |
Usage value to use for touch vibrations. |
| static Int |
Usage value to use when usage is unknown. |
| Inherited constants | |
|---|---|
| Public methods | |
|---|---|
| static VibrationAttributes |
createForUsage(usage: Int)Creates a new |
| Int | |
| Boolean |
Indicates whether some other object is "equal to" this one. |
| Int |
getFlags()Return the flags. |
| Int |
getUsage()Return the vibration usage. |
| Int |
Return the vibration usage class. |
| Int |
hashCode() |
| Boolean |
Check whether a flag is set |
| String |
toString() |
| Unit |
writeToParcel(dest: Parcel, flags: Int)Flatten this object in to a Parcel. |
| Properties | |
|---|---|
| static Parcelable.Creator<VibrationAttributes!> | |
Constants
FLAG_BYPASS_INTERRUPTION_POLICY
static val FLAG_BYPASS_INTERRUPTION_POLICY: Int
Flag requesting vibration effect to be played even under limited interruptions.
Only privileged apps can ignore user settings that limit interruptions, and this flag will be ignored otherwise.
Value: 1USAGE_ACCESSIBILITY
static val USAGE_ACCESSIBILITY: Int
Usage value to use for accessibility vibrations, such as with a screen reader.
Value: 66USAGE_ALARM
static val USAGE_ALARM: Int
Usage value to use for alarm vibrations.
Value: 17USAGE_CLASS_ALARM
static val USAGE_CLASS_ALARM: Int
Vibration usage class value to use when the vibration is initiated to catch user's attention, such as alarm, ringtone, and notification vibrations.
Value: 1USAGE_CLASS_FEEDBACK
static val USAGE_CLASS_FEEDBACK: Int
Vibration usage class value to use when the vibration is initiated as a response to user's actions, such as emulation of physical effects, and texting feedback vibration.
Value: 2USAGE_CLASS_MASK
static val USAGE_CLASS_MASK: Int
Mask for vibration usage class value.
Value: 15USAGE_CLASS_MEDIA
static val USAGE_CLASS_MEDIA: Int
Vibration usage class value to use when the vibration is part of media, such as music, movie, soundtrack, game or animations.
Value: 3USAGE_CLASS_UNKNOWN
static val USAGE_CLASS_UNKNOWN: Int
Vibration usage class value to use when the vibration usage class is unknown.
Value: 0USAGE_COMMUNICATION_REQUEST
static val USAGE_COMMUNICATION_REQUEST: Int
Usage value to use for vibrations which mean a request to enter/end a communication with the user, such as a voice prompt.
Value: 65USAGE_GESTURE_INPUT
static val USAGE_GESTURE_INPUT: Int
Usage value to use for vibrations performed as feedback for a user's gesture input.
A gesture input is broadly defined as a user input that falls outside the direct usage of a physical InputDevice. Note that the gesture input may involve interacting with an InputDevice, but the input itself is a user gesture that is not a direct application of the InputDevice.
The exact definition of a gesture input varies across form-factors and input modalities. For example, on Wearable devices, it could be a hand-based gesture provided by the user without touching any physical InputDevice. Another example is a pinch gesture on a touchscreen.
Value: 98USAGE_HARDWARE_FEEDBACK
static val USAGE_HARDWARE_FEEDBACK: Int
Usage value to use for vibrations which provide a feedback for hardware component interaction, such as a fingerprint sensor.
Value: 50USAGE_MEDIA
static val USAGE_MEDIA: Int
Usage value to use for media vibrations, such as music, movie, soundtrack, animations, games, or any interactive media that isn't for touch feedback specifically.
Value: 19USAGE_NOTIFICATION
static val USAGE_NOTIFICATION: Int
Usage value to use for notification vibrations.
Value: 49USAGE_PHYSICAL_EMULATION
static val USAGE_PHYSICAL_EMULATION: Int
Usage value to use for vibrations which emulate physical hardware reactions, such as edge squeeze.
Note that normal screen-touch feedback "click" effects would typically be classed as USAGE_TOUCH, and that on-screen "physical" animations like bouncing would be USAGE_MEDIA.
Value: 34USAGE_RINGTONE
static val USAGE_RINGTONE: Int
Usage value to use for ringtone vibrations.
Value: 33USAGE_TOUCH
static val USAGE_TOUCH: Int
Usage value to use for touch vibrations.
Most typical haptic feedback should be classed as touch feedback. Examples include vibrations for tap, long press, drag and scroll.
Value: 18USAGE_UNKNOWN
static val USAGE_UNKNOWN: Int
Usage value to use when usage is unknown.
Value: 0Public methods
createForUsage
static fun createForUsage(usage: Int): VibrationAttributes
Creates a new VibrationAttributes instance with given usage.
| Return | |
|---|---|
VibrationAttributes |
This value cannot be null. |
describeContents
fun describeContents(): Int
| Return | |
|---|---|
Int |
a bitmask indicating the set of special object types marshaled by this Parcelable object instance. Value is either 0 or android.os.Parcelable#CONTENTS_FILE_DESCRIPTOR |
equals
fun equals(other: Any?): Boolean
Indicates whether some other object is "equal to" this one.
The equals method implements an equivalence relation on non-null object references:
- It is reflexive: for any non-null reference value
x,x.equals(x)should returntrue. - It is symmetric: for any non-null reference values
xandy,x.equals(y)should returntrueif and only ify.equals(x)returnstrue. - It is transitive: for any non-null reference values
x,y, andz, ifx.equals(y)returnstrueandy.equals(z)returnstrue, thenx.equals(z)should returntrue. - It is consistent: for any non-null reference values
xandy, multiple invocations ofx.equals(y)consistently returntrueor consistently returnfalse, provided no information used inequalscomparisons on the objects is modified. - For any non-null reference value
x,x.equals(null)should returnfalse.
An equivalence relation partitions the elements it operates on into equivalence classes; all the members of an equivalence class are equal to each other. Members of an equivalence class are substitutable for each other, at least for some purposes.
| Parameters | |
|---|---|
obj |
the reference object with which to compare. |
o |
This value may be null. |
| Return | |
|---|---|
Boolean |
true if this object is the same as the obj argument; false otherwise. |
getFlags
fun getFlags(): Int
Return the flags.
| Return | |
|---|---|
Int |
a combined mask of all flags Value is either 0 or a combination of android.os.VibrationAttributes#FLAG_BYPASS_INTERRUPTION_POLICY, android.os.VibrationAttributes.FLAG_BYPASS_USER_VIBRATION_INTENSITY_OFF, android.os.VibrationAttributes.FLAG_INVALIDATE_SETTINGS_CACHE, and android.os.VibrationAttributes.FLAG_PIPELINED_EFFECT |
getUsage
fun getUsage(): Int
Return the vibration usage.
getUsageClass
fun getUsageClass(): Int
Return the vibration usage class.
isFlagSet
fun isFlagSet(flag: Int): Boolean
Check whether a flag is set
| Parameters | |
|---|---|
flag |
Int: Value is either 0 or a combination of android.os.VibrationAttributes#FLAG_BYPASS_INTERRUPTION_POLICY, android.os.VibrationAttributes.FLAG_BYPASS_USER_VIBRATION_INTENSITY_OFF, android.os.VibrationAttributes.FLAG_INVALIDATE_SETTINGS_CACHE, and android.os.VibrationAttributes.FLAG_PIPELINED_EFFECT |
| Return | |
|---|---|
Boolean |
true if a flag is set and false otherwise |
toString
fun toString(): String
| Return | |
|---|---|
String |
a string representation of the object. |
writeToParcel
fun writeToParcel(
dest: Parcel,
flags: Int
): Unit
Flatten this object in to a Parcel.
| Parameters | |
|---|---|
dest |
Parcel: This value cannot be null. |
flags |
Int: Additional flags about how the object should be written. May be 0 or PARCELABLE_WRITE_RETURN_VALUE. Value is either 0 or a combination of android.os.Parcelable#PARCELABLE_WRITE_RETURN_VALUE, and android.os.Parcelable.PARCELABLE_ELIDE_DUPLICATES |