Save the date! Android Dev Summit is coming to Mountain View, CA on November 7-8, 2018.
added in version 1.0.0
belongs to Maven artifact androidx.media:media:1.0.0-rc01

AudioAttributesCompat.Builder

public static class AudioAttributesCompat.Builder
extends Object

java.lang.Object
   ↳ androidx.media.AudioAttributesCompat.Builder


Builder class for AudioAttributesCompat objects.

example:

 new AudioAttributes.Builder()
 .setUsage(AudioAttributes.USAGE_MEDIA)
 .setContentType(AudioAttributes.CONTENT_TYPE_MUSIC)
 .build();
 

By default all types of information (usage, content type, flags) conveyed by an AudioAttributesCompat instance are set to "unknown". Unknown information will be interpreted as a default value that is dependent on the context of use, for instance a MediaPlayer will use a default usage of AudioAttributesCompat.USAGE_MEDIA. See also AudioAttributes.Builder.

Summary

Public constructors

AudioAttributesCompat.Builder()

Constructs a new Builder with the defaults.

AudioAttributesCompat.Builder(AudioAttributesCompat aa)

Constructs a new Builder from a given AudioAttributes

Public methods

AudioAttributesCompat build()

Combines all of the attributes that have been set and return a new AudioAttributesCompat object.

AudioAttributesCompat.Builder setContentType(int contentType)

Sets the attribute describing the content type of the audio signal, such as speech, or music.

AudioAttributesCompat.Builder setFlags(int flags)

Sets the combination of flags.

AudioAttributesCompat.Builder setLegacyStreamType(int streamType)

Create an AudioAttributesCompat that best approximates the specified AudioManager stream type constant.

AudioAttributesCompat.Builder setUsage(int usage)

Sets the attribute describing what is the intended use of the the audio signal, such as alarm or ringtone.

Inherited methods

Public constructors

AudioAttributesCompat.Builder

added in version 1.0.0
public AudioAttributesCompat.Builder ()

Constructs a new Builder with the defaults. By default, usage and content type are respectively AudioAttributesCompat.USAGE_UNKNOWN and AudioAttributesCompat.CONTENT_TYPE_UNKNOWN, and flags are 0. It is recommended to configure the usage (with setUsage(int)) or deriving attributes from a legacy stream type (with setLegacyStreamType(int)) before calling build() to override any default playback behavior in terms of routing and volume management.

AudioAttributesCompat.Builder

added in version 1.0.0
public AudioAttributesCompat.Builder (AudioAttributesCompat aa)

Constructs a new Builder from a given AudioAttributes

Parameters
aa AudioAttributesCompat: the AudioAttributesCompat object whose data will be reused in the new Builder.

Public methods

build

added in version 1.0.0
public AudioAttributesCompat build ()

Combines all of the attributes that have been set and return a new AudioAttributesCompat object.

Returns
AudioAttributesCompat a new AudioAttributesCompat object

setContentType

added in version 1.0.0
public AudioAttributesCompat.Builder setContentType (int contentType)

Sets the attribute describing the content type of the audio signal, such as speech, or music.

Parameters
contentType int: the content type values, one of AudioAttributesCompat.CONTENT_TYPE_MOVIE, AudioAttributesCompat.CONTENT_TYPE_MUSIC, AudioAttributesCompat.CONTENT_TYPE_SONIFICATION, AudioAttributesCompat.CONTENT_TYPE_SPEECH, AudioAttributesCompat.CONTENT_TYPE_UNKNOWN.

Returns
AudioAttributesCompat.Builder the same Builder instance.

setFlags

added in version 1.0.0
public AudioAttributesCompat.Builder setFlags (int flags)

Sets the combination of flags.

This is a bitwise OR with the existing flags.

Parameters
flags int: a combination of AudioAttributesCompat.FLAG_AUDIBILITY_ENFORCED, AudioAttributesCompat.FLAG_HW_AV_SYNC.

Returns
AudioAttributesCompat.Builder the same Builder instance.

setLegacyStreamType

added in version 1.0.0
public AudioAttributesCompat.Builder setLegacyStreamType (int streamType)

Create an AudioAttributesCompat that best approximates the specified AudioManager stream type constant.

Parameters
streamType int: one of AudioManager.STREAM_*

Returns
AudioAttributesCompat.Builder this same Builder

setUsage

added in version 1.0.0
public AudioAttributesCompat.Builder setUsage (int usage)

Sets the attribute describing what is the intended use of the the audio signal, such as alarm or ringtone.

Parameters
usage int: one of AudioAttributesCompat.USAGE_UNKNOWN, AudioAttributesCompat.USAGE_MEDIA, AudioAttributesCompat.USAGE_VOICE_COMMUNICATION, AudioAttributesCompat.USAGE_VOICE_COMMUNICATION_SIGNALLING, AudioAttributesCompat.USAGE_ALARM, AudioAttributesCompat.USAGE_NOTIFICATION, AudioAttributesCompat.USAGE_NOTIFICATION_RINGTONE, AudioAttributesCompat.USAGE_NOTIFICATION_COMMUNICATION_REQUEST, AudioAttributesCompat.USAGE_NOTIFICATION_COMMUNICATION_INSTANT, AudioAttributesCompat.USAGE_NOTIFICATION_COMMUNICATION_DELAYED, AudioAttributesCompat.USAGE_NOTIFICATION_EVENT, AudioAttributesCompat.USAGE_ASSISTANT, AudioAttributesCompat.USAGE_ASSISTANCE_ACCESSIBILITY, AudioAttributesCompat.USAGE_ASSISTANCE_NAVIGATION_GUIDANCE, AudioAttributesCompat.USAGE_ASSISTANCE_SONIFICATION, AudioAttributesCompat.USAGE_GAME.

Returns
AudioAttributesCompat.Builder the same Builder instance.