Added in API level 30

Builder

class Builder
kotlin.Any
   ↳ android.os.VibrationAttributes.Builder

Builder class for VibrationAttributes objects. By default, all information is set to UNKNOWN.

Summary

Public constructors

Constructs a new Builder with the defaults.

Constructs a new Builder from AudioAttributes.

Constructs a new Builder from a given VibrationAttributes.
Public methods
VibrationAttributes

Combines all of the attributes that have been set and returns a new VibrationAttributes object.
VibrationAttributes.Builder
setFlags(flags: Int, mask: Int)

Sets only the flags specified in the bitmask, leaving the other supported flag values unchanged in the builder.
VibrationAttributes.Builder
setUsage(usage: Int)

Sets the attribute describing the type of the corresponding vibration.

Public constructors

Builder

Added in API level 30
Builder()

Constructs a new Builder with the defaults.

Builder

Added in API level 33
Builder(audio: AudioAttributes)

Constructs a new Builder from AudioAttributes.

Parameters
audio AudioAttributes: This value cannot be null.

Builder

Added in API level 30
Builder(vib: VibrationAttributes?)

Constructs a new Builder from a given VibrationAttributes.

Parameters
vib VibrationAttributes?: This value may be null.

Public methods

build

Added in API level 30
fun build(): VibrationAttributes

Combines all of the attributes that have been set and returns a new VibrationAttributes object.

Return
VibrationAttributes a new VibrationAttributes object This value cannot be null.

setFlags

Added in API level 30
fun setFlags(
    flags: Int, 
    mask: Int
): VibrationAttributes.Builder

Sets only the flags specified in the bitmask, leaving the other supported flag values unchanged in the builder.

Parameters
flags Int: Combination of flags to be set. 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
mask Int: Bit range that should be changed.
Return
VibrationAttributes.Builder the same Builder instance. This value cannot be null.

setUsage

Added in API level 30
fun setUsage(usage: Int): VibrationAttributes.Builder

Sets the attribute describing the type of the corresponding vibration.

Parameters
usage Int: The type of usage for the vibration Value is android.os.VibrationAttributes#USAGE_UNKNOWN, android.os.VibrationAttributes#USAGE_ACCESSIBILITY, android.os.VibrationAttributes#USAGE_ALARM, android.os.VibrationAttributes#USAGE_COMMUNICATION_REQUEST, android.os.VibrationAttributes#USAGE_HARDWARE_FEEDBACK, android.os.VibrationAttributes#USAGE_MEDIA, android.os.VibrationAttributes#USAGE_NOTIFICATION, android.os.VibrationAttributes#USAGE_PHYSICAL_EMULATION, android.os.VibrationAttributes#USAGE_RINGTONE, android.os.VibrationAttributes#USAGE_TOUCH, android.os.VibrationAttributes.USAGE_IME_FEEDBACK, or android.os.VibrationAttributes#USAGE_GESTURE_INPUT
Return
VibrationAttributes.Builder the same Builder instance. This value cannot be null.