MediaQualityContract.SoundQuality


public static final class MediaQualityContract.SoundQuality
extends Object

java.lang.Object
   ↳ android.media.quality.MediaQualityContract.SoundQuality


Parameters for sound quality.

Summary

Constants

String PARAMETER_AUTO_VOLUME_CONTROL

Enable/disable auto volume control sound effect.

String PARAMETER_BALANCE

The audio volume balance.

String PARAMETER_BASS

The bass.

String PARAMETER_DIALOGUE_ENHANCER

Dialogue enhancer.

String PARAMETER_DIGITAL_OUTPUT_DELAY_MILLIS

Digital output delay in milliseconds.

String PARAMETER_DIGITAL_OUTPUT_MODE

Sets the digital audio output mode.

String PARAMETER_DOLBY_AUDIO_PROCESSING_DOLBY_ATMOS

Enables or disables Dolby Atmos processing.

String PARAMETER_DOLBY_AUDIO_PROCESSING_SOUND_MODE

Sets the sound mode for Dolby audio processing.

String PARAMETER_DOLBY_AUDIO_PROCESSING_SURROUND_VIRTUALIZER

Enable/disable the Surround Virtualizer.

String PARAMETER_DOLBY_AUDIO_PROCESSING_VOLUME_LEVELER

Enable/disable Volume Leveler.

String PARAMETER_DOWN_MIX_MODE

Sets the downmix mode for multi-channel audio.

String PARAMETER_DTS_DRC

Enable/disable dynamic range compression (DRC) of digital theater system (DTS).

String PARAMETER_DTS_VIRTUAL_X_DEFINITION

Enable/disable virtual X definition.

String PARAMETER_DTS_VIRTUAL_X_DIALOG_CLARITY

Enable/disable dialog clarity.

String PARAMETER_DTS_VIRTUAL_X_HEIGHT

Enable/disable the processing of virtual height channels.

String PARAMETER_DTS_VIRTUAL_X_LIMITER

Enable/disable audio limiter.

String PARAMETER_DTS_VIRTUAL_X_TBHDX

Enable/disable Total Bass Harmonic Distortion (X).

String PARAMETER_DTS_VIRTUAL_X_TRU_SURROUND_X

Enable/disable the core DTS Virtual:X surround sound processing.

String PARAMETER_DTS_VIRTUAL_X_TRU_VOLUME_HD

Enable/disable DTS TruVolume HD.

String PARAMETER_EARC

Enable/disable enhanced audio return channel (eARC).

String PARAMETER_SPEAKERS

Enable/disable speaker output.

String PARAMETER_SPEAKERS_DELAY_MILLIS

Speaker delay in milliseconds.

String PARAMETER_SURROUND_SOUND

Enable/disable surround sound.

String PARAMETER_TREBLE

The treble.

Inherited methods

Constants

PARAMETER_AUTO_VOLUME_CONTROL

Added in API level 36
public static final String PARAMETER_AUTO_VOLUME_CONTROL

Enable/disable auto volume control sound effect.

Type: BOOLEAN

Constant Value: "auto_volume_control"

PARAMETER_BALANCE

Added in API level 36
public static final String PARAMETER_BALANCE

The audio volume balance.

This parameter controls the balance between the left and right speakers. The valid range is -50 to 50 (inclusive), where: - Negative values shift the balance towards the left speaker. - Positive values shift the balance towards the right speaker. - 0 represents a balanced output.

Type: INTEGER

Constant Value: "balance"

PARAMETER_BASS

Added in API level 36
public static final String PARAMETER_BASS

The bass.

Bass controls the intensity of low-frequency sounds. The valid range is 0 - 100 (inclusive).

Type: INTEGER

Constant Value: "bass"

PARAMETER_DIALOGUE_ENHANCER

Added in API level 36
public static final String PARAMETER_DIALOGUE_ENHANCER

Dialogue enhancer.

Possible values:

The default value is MediaQualityContract.LEVEL_OFF.

Type: STRING

Constant Value: "dialogue_enhancer"

PARAMETER_DIGITAL_OUTPUT_DELAY_MILLIS

Added in API level 36
public static final String PARAMETER_DIGITAL_OUTPUT_DELAY_MILLIS

Digital output delay in milliseconds.

Type: INTEGER

Constant Value: "digital_output_delay_millis"

PARAMETER_DIGITAL_OUTPUT_MODE

Added in API level 36
public static final String PARAMETER_DIGITAL_OUTPUT_MODE

Sets the digital audio output mode.

This parameter controls the audio format sent to a digital output like HDMI or S/PDIF. This allows the user to select a specific audio format or let the system decide automatically. The supported values are:

  • "Auto": The system automatically selects the preferred format supported by the connected device. (Default)
  • "Bypass": The encoded audio stream is sent directly to the output without being decoded by this device.
  • "PCM": Audio is decoded to uncompressed Pulse-Code Modulation.
  • "Dolby Digital Plus"
  • "Dolby Digital"
  • "Dolby MAT"

Type: STRING

Constant Value: "digital_output_mode"

PARAMETER_DOLBY_AUDIO_PROCESSING_DOLBY_ATMOS

Added in API level 36
public static final String PARAMETER_DOLBY_AUDIO_PROCESSING_DOLBY_ATMOS

Enables or disables Dolby Atmos processing.

Dolby Atmos creates a more immersive and realistic sound experience by adding a height dimension to surround sound. It allows sound to be placed and moved precisely around you, including overhead.

When set to true, Dolby Atmos processing is enabled. When set to false, it is disabled, and the audio will be processed using other standard settings. Disabling this parameter does not change the list of available audio formats presented to the audio framework.

Note: This setting is only effective on devices that support Dolby Atmos; on unsupported systems, this option may be ignored or hidden. To experience Dolby Atmos, you need content specifically mixed for it. The immersive effect can be delivered through a dedicated Dolby Atmos sound system or through virtualization technologies for headphones and built-in speakers.

Type: BOOLEAN

Constant Value: "dolby_audio_processing_dolby_atmos"

PARAMETER_DOLBY_AUDIO_PROCESSING_SOUND_MODE

Added in API level 36
public static final String PARAMETER_DOLBY_AUDIO_PROCESSING_SOUND_MODE

Sets the sound mode for Dolby audio processing.

This parameter allows the selection of a preset audio profile to optimize the listening experience for different types of content. The supported values are:

  • "Game"
  • "Movie"
  • "Music"
  • "News"
  • "Stadium"
  • "Standard"
  • "User"

The default value is "Standard".

Type: STRING

Constant Value: "dolby_audio_processing_sound_mode"

PARAMETER_DOLBY_AUDIO_PROCESSING_SURROUND_VIRTUALIZER

Added in API level 36
public static final String PARAMETER_DOLBY_AUDIO_PROCESSING_SURROUND_VIRTUALIZER

Enable/disable the Surround Virtualizer.

The Surround Virtualizer creates a virtual surround sound experience when playing back Atmos, surround, and stereo content over two-channel endpoints like TV built-in speakers and headphones. It expands the soundstage and adds depth to the audio, creating an immersive effect without a multi-speaker setup. Note: When Dolby Atoms playback streams are active, this will always be true.

Type: BOOLEAN

Constant Value: "dolby_audio_processing_surround_virtualizer"

PARAMETER_DOLBY_AUDIO_PROCESSING_VOLUME_LEVELER

Added in API level 36
public static final String PARAMETER_DOLBY_AUDIO_PROCESSING_VOLUME_LEVELER

Enable/disable Volume Leveler.

Volume Leveler helps to maintain a consistent volume level across different types of content and even within the same program. It minimizes the jarring jumps between loud commercials or action sequences and quiet dialogue.

Type: BOOLEAN

Constant Value: "dolby_audio_processing_volume_leveler"

PARAMETER_DOWN_MIX_MODE

Added in API level 36
public static final String PARAMETER_DOWN_MIX_MODE

Sets the downmix mode for multi-channel audio.

This parameter determines how multi-channel audio (e.g., 5.1) is converted to a two-channel stereo output. This is useful when the playback device, like headphones or TV speakers, has fewer channels than the source audio.

The supported string values are:

  • "Stereo": A standard downmix (Lo/Ro) suitable for most stereo playback devices. (Default)
  • "Surround": A downmix that is matrix-encoded with surround sound information (Lt/Rt).

Type: STRING

Constant Value: "down_mix_mode"

PARAMETER_DTS_DRC

Added in API level 36
public static final String PARAMETER_DTS_DRC

Enable/disable dynamic range compression (DRC) of digital theater system (DTS).

Type: BOOLEAN

Constant Value: "dts_drc"

PARAMETER_DTS_VIRTUAL_X_DEFINITION

Added in API level 36
public static final String PARAMETER_DTS_VIRTUAL_X_DEFINITION

Enable/disable virtual X definition.

It applies audio processing to improve overall sound definition and clarity.

Type: BOOLEAN

Constant Value: "dts_virtual_x_definition"

PARAMETER_DTS_VIRTUAL_X_DIALOG_CLARITY

Added in API level 36
public static final String PARAMETER_DTS_VIRTUAL_X_DIALOG_CLARITY

Enable/disable dialog clarity.

It enhances the clarity and intelligibility of speech in audio content.

Type: BOOLEAN

Constant Value: "dts_virtual_x_dialog_clarity"

PARAMETER_DTS_VIRTUAL_X_HEIGHT

Added in API level 36
public static final String PARAMETER_DTS_VIRTUAL_X_HEIGHT

Enable/disable the processing of virtual height channels.

It creates a more immersive audio experience by simulating sounds from above.

Type: BOOLEAN

Constant Value: "dts_virtual_x_height"

PARAMETER_DTS_VIRTUAL_X_LIMITER

Added in API level 36
public static final String PARAMETER_DTS_VIRTUAL_X_LIMITER

Enable/disable audio limiter.

It prevents excessive volume peaks that could cause distortion or speaker damage.

Type: BOOLEAN

Constant Value: "dts_virtual_x_limiter"

PARAMETER_DTS_VIRTUAL_X_TBHDX

Added in API level 36
public static final String PARAMETER_DTS_VIRTUAL_X_TBHDX

Enable/disable Total Bass Harmonic Distortion (X).

TBHDX bass enhancement provides a richer low-frequency experience, simulating deeper bass.

Type: BOOLEAN

Constant Value: "dts_virtual_x_tbhdx"

PARAMETER_DTS_VIRTUAL_X_TRU_SURROUND_X

Added in API level 36
public static final String PARAMETER_DTS_VIRTUAL_X_TRU_SURROUND_X

Enable/disable the core DTS Virtual:X surround sound processing.

It creates an immersive, multi-channel audio experience from the speaker configuration.

Type: BOOLEAN

Constant Value: "dts_virtual_x_tru_surround_x"

PARAMETER_DTS_VIRTUAL_X_TRU_VOLUME_HD

Added in API level 36
public static final String PARAMETER_DTS_VIRTUAL_X_TRU_VOLUME_HD

Enable/disable DTS TruVolume HD.

It reduces the dynamic range of audio, minimizing loudness variations between content and channels.

Type: BOOLEAN

Constant Value: "dts_virtual_x_tru_volume_hd"

PARAMETER_EARC

Added in API level 36
public static final String PARAMETER_EARC

Enable/disable enhanced audio return channel (eARC).

eARC allows for higher bandwidth audio transmission over HDMI.

Type: BOOLEAN

Constant Value: "earc"

PARAMETER_SPEAKERS

Added in API level 36
public static final String PARAMETER_SPEAKERS

Enable/disable speaker output.

Type: BOOLEAN

Constant Value: "speakers"

PARAMETER_SPEAKERS_DELAY_MILLIS

Added in API level 36
public static final String PARAMETER_SPEAKERS_DELAY_MILLIS

Speaker delay in milliseconds.

Type: INTEGER

Constant Value: "speakers_delay_millis"

PARAMETER_SURROUND_SOUND

Added in API level 36
public static final String PARAMETER_SURROUND_SOUND

Enable/disable surround sound. Stereo Pulse-Code Modulation to apply a customizable filter. There is no difference on any use cases.

Type: BOOLEAN

Constant Value: "surround_sound"

PARAMETER_TREBLE

Added in API level 36
public static final String PARAMETER_TREBLE

The treble.

Treble controls the intensity of high-frequency sounds. The valid range is 0 - 100 (inclusive).

Type: INTEGER

Constant Value: "treble"