# MediaQualityContract.SoundQuality
Added in[API level 36](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
Summary:[Constants](https://developer.android.com/reference/android/media/quality/MediaQualityContract.SoundQuality#constants)\|[Inherited Methods](https://developer.android.com/reference/android/media/quality/MediaQualityContract.SoundQuality#inhmethods)
# MediaQualityContract.SoundQuality
*** ** * ** ***
[Kotlin](https://developer.android.com/reference/kotlin/android/media/quality/MediaQualityContract.SoundQuality "View this page in Kotlin")\|Java
`
public
static
final
class
MediaQualityContract.SoundQuality
`
`
extends `[Object](https://developer.android.com/reference/java/lang/Object)`
``
`
|---|---------------------------------------------------------|
| [java.lang.Object](https://developer.android.com/reference/java/lang/Object) ||
| ↳ | android.media.quality.MediaQualityContract.SoundQuality |
*** ** * ** ***
Parameters for sound quality.
## Summary
| ### Constants ||
|--------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| [String](https://developer.android.com/reference/java/lang/String) | [PARAMETER_AUTO_VOLUME_CONTROL](https://developer.android.com/reference/android/media/quality/MediaQualityContract.SoundQuality#PARAMETER_AUTO_VOLUME_CONTROL) Enable/disable auto volume control sound effect. |
| [String](https://developer.android.com/reference/java/lang/String) | [PARAMETER_BALANCE](https://developer.android.com/reference/android/media/quality/MediaQualityContract.SoundQuality#PARAMETER_BALANCE) The audio volume balance. |
| [String](https://developer.android.com/reference/java/lang/String) | [PARAMETER_BASS](https://developer.android.com/reference/android/media/quality/MediaQualityContract.SoundQuality#PARAMETER_BASS) The bass. |
| [String](https://developer.android.com/reference/java/lang/String) | [PARAMETER_DIALOGUE_ENHANCER](https://developer.android.com/reference/android/media/quality/MediaQualityContract.SoundQuality#PARAMETER_DIALOGUE_ENHANCER) Dialogue enhancer. |
| [String](https://developer.android.com/reference/java/lang/String) | [PARAMETER_DIGITAL_OUTPUT_DELAY_MILLIS](https://developer.android.com/reference/android/media/quality/MediaQualityContract.SoundQuality#PARAMETER_DIGITAL_OUTPUT_DELAY_MILLIS) Digital output delay in milliseconds. |
| [String](https://developer.android.com/reference/java/lang/String) | [PARAMETER_DIGITAL_OUTPUT_MODE](https://developer.android.com/reference/android/media/quality/MediaQualityContract.SoundQuality#PARAMETER_DIGITAL_OUTPUT_MODE) Sets the digital audio output mode. |
| [String](https://developer.android.com/reference/java/lang/String) | [PARAMETER_DOLBY_AUDIO_PROCESSING_DOLBY_ATMOS](https://developer.android.com/reference/android/media/quality/MediaQualityContract.SoundQuality#PARAMETER_DOLBY_AUDIO_PROCESSING_DOLBY_ATMOS) Enables or disables Dolby Atmos processing. |
| [String](https://developer.android.com/reference/java/lang/String) | [PARAMETER_DOLBY_AUDIO_PROCESSING_SOUND_MODE](https://developer.android.com/reference/android/media/quality/MediaQualityContract.SoundQuality#PARAMETER_DOLBY_AUDIO_PROCESSING_SOUND_MODE) Sets the sound mode for Dolby audio processing. |
| [String](https://developer.android.com/reference/java/lang/String) | [PARAMETER_DOLBY_AUDIO_PROCESSING_SURROUND_VIRTUALIZER](https://developer.android.com/reference/android/media/quality/MediaQualityContract.SoundQuality#PARAMETER_DOLBY_AUDIO_PROCESSING_SURROUND_VIRTUALIZER) Enable/disable the Surround Virtualizer. |
| [String](https://developer.android.com/reference/java/lang/String) | [PARAMETER_DOLBY_AUDIO_PROCESSING_VOLUME_LEVELER](https://developer.android.com/reference/android/media/quality/MediaQualityContract.SoundQuality#PARAMETER_DOLBY_AUDIO_PROCESSING_VOLUME_LEVELER) Enable/disable Volume Leveler. |
| [String](https://developer.android.com/reference/java/lang/String) | [PARAMETER_DOWN_MIX_MODE](https://developer.android.com/reference/android/media/quality/MediaQualityContract.SoundQuality#PARAMETER_DOWN_MIX_MODE) Sets the downmix mode for multi-channel audio. |
| [String](https://developer.android.com/reference/java/lang/String) | [PARAMETER_DTS_DRC](https://developer.android.com/reference/android/media/quality/MediaQualityContract.SoundQuality#PARAMETER_DTS_DRC) Enable/disable dynamic range compression (DRC) of digital theater system (DTS). |
| [String](https://developer.android.com/reference/java/lang/String) | [PARAMETER_DTS_VIRTUAL_X_DEFINITION](https://developer.android.com/reference/android/media/quality/MediaQualityContract.SoundQuality#PARAMETER_DTS_VIRTUAL_X_DEFINITION) Enable/disable virtual X definition. |
| [String](https://developer.android.com/reference/java/lang/String) | [PARAMETER_DTS_VIRTUAL_X_DIALOG_CLARITY](https://developer.android.com/reference/android/media/quality/MediaQualityContract.SoundQuality#PARAMETER_DTS_VIRTUAL_X_DIALOG_CLARITY) Enable/disable dialog clarity. |
| [String](https://developer.android.com/reference/java/lang/String) | [PARAMETER_DTS_VIRTUAL_X_HEIGHT](https://developer.android.com/reference/android/media/quality/MediaQualityContract.SoundQuality#PARAMETER_DTS_VIRTUAL_X_HEIGHT) Enable/disable the processing of virtual height channels. |
| [String](https://developer.android.com/reference/java/lang/String) | [PARAMETER_DTS_VIRTUAL_X_LIMITER](https://developer.android.com/reference/android/media/quality/MediaQualityContract.SoundQuality#PARAMETER_DTS_VIRTUAL_X_LIMITER) Enable/disable audio limiter. |
| [String](https://developer.android.com/reference/java/lang/String) | [PARAMETER_DTS_VIRTUAL_X_TBHDX](https://developer.android.com/reference/android/media/quality/MediaQualityContract.SoundQuality#PARAMETER_DTS_VIRTUAL_X_TBHDX) Enable/disable Total Bass Harmonic Distortion (X). |
| [String](https://developer.android.com/reference/java/lang/String) | [PARAMETER_DTS_VIRTUAL_X_TRU_SURROUND_X](https://developer.android.com/reference/android/media/quality/MediaQualityContract.SoundQuality#PARAMETER_DTS_VIRTUAL_X_TRU_SURROUND_X) Enable/disable the core DTS Virtual:X surround sound processing. |
| [String](https://developer.android.com/reference/java/lang/String) | [PARAMETER_DTS_VIRTUAL_X_TRU_VOLUME_HD](https://developer.android.com/reference/android/media/quality/MediaQualityContract.SoundQuality#PARAMETER_DTS_VIRTUAL_X_TRU_VOLUME_HD) Enable/disable DTS TruVolume HD. |
| [String](https://developer.android.com/reference/java/lang/String) | [PARAMETER_EARC](https://developer.android.com/reference/android/media/quality/MediaQualityContract.SoundQuality#PARAMETER_EARC) Enable/disable enhanced audio return channel (eARC). |
| [String](https://developer.android.com/reference/java/lang/String) | [PARAMETER_SPEAKERS](https://developer.android.com/reference/android/media/quality/MediaQualityContract.SoundQuality#PARAMETER_SPEAKERS) Enable/disable speaker output. |
| [String](https://developer.android.com/reference/java/lang/String) | [PARAMETER_SPEAKERS_DELAY_MILLIS](https://developer.android.com/reference/android/media/quality/MediaQualityContract.SoundQuality#PARAMETER_SPEAKERS_DELAY_MILLIS) Speaker delay in milliseconds. |
| [String](https://developer.android.com/reference/java/lang/String) | [PARAMETER_SURROUND_SOUND](https://developer.android.com/reference/android/media/quality/MediaQualityContract.SoundQuality#PARAMETER_SURROUND_SOUND) Enable/disable surround sound. |
| [String](https://developer.android.com/reference/java/lang/String) | [PARAMETER_TREBLE](https://developer.android.com/reference/android/media/quality/MediaQualityContract.SoundQuality#PARAMETER_TREBLE) The treble. |
| ### Inherited methods |
|-----------------------|---|
| From class` `[java.lang.Object](https://developer.android.com/reference/java/lang/Object)` ` |--------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | ` `[Object](https://developer.android.com/reference/java/lang/Object) | ` `[clone](https://developer.android.com/reference/java/lang/Object#clone())`() ` Creates and returns a copy of this object. | | ` boolean` | ` `[equals](https://developer.android.com/reference/java/lang/Object#equals(java.lang.Object))`(`[Object](https://developer.android.com/reference/java/lang/Object)` obj) ` Indicates whether some other object is "equal to" this one. | | ` void` | ` `[finalize](https://developer.android.com/reference/java/lang/Object#finalize())`() ` Called by the garbage collector on an object when garbage collection determines that there are no more references to the object. | | ` final `[Class](https://developer.android.com/reference/java/lang/Class)`` | ` `[getClass](https://developer.android.com/reference/java/lang/Object#getClass())`() ` Returns the runtime class of this`Object`. | | ` int` | ` `[hashCode](https://developer.android.com/reference/java/lang/Object#hashCode())`() ` Returns a hash code value for the object. | | ` final void` | ` `[notify](https://developer.android.com/reference/java/lang/Object#notify())`() ` Wakes up a single thread that is waiting on this object's monitor. | | ` final void` | ` `[notifyAll](https://developer.android.com/reference/java/lang/Object#notifyAll())`() ` Wakes up all threads that are waiting on this object's monitor. | | ` `[String](https://developer.android.com/reference/java/lang/String) | ` `[toString](https://developer.android.com/reference/java/lang/Object#toString())`() ` Returns a string representation of the object. | | ` final void` | ` `[wait](https://developer.android.com/reference/java/lang/Object#wait(long,%20int))`(long timeoutMillis, int nanos) ` Causes the current thread to wait until it is awakened, typically by being*notified* or*interrupted*, or until a certain amount of real time has elapsed. | | ` final void` | ` `[wait](https://developer.android.com/reference/java/lang/Object#wait(long))`(long timeoutMillis) ` Causes the current thread to wait until it is awakened, typically by being*notified* or*interrupted*, or until a certain amount of real time has elapsed. | | ` final void` | ` `[wait](https://developer.android.com/reference/java/lang/Object#wait())`() ` Causes the current thread to wait until it is awakened, typically by being*notified* or*interrupted*. | ||
## Constants
### PARAMETER_AUTO_VOLUME_CONTROL
Added in[API level 36](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
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](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
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](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
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](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final String PARAMETER_DIALOGUE_ENHANCER
```
Dialogue enhancer.
Possible values:
- [MediaQualityContract.LEVEL_LOW](https://developer.android.com/reference/android/media/quality/MediaQualityContract#LEVEL_LOW)
- [MediaQualityContract.LEVEL_MEDIUM](https://developer.android.com/reference/android/media/quality/MediaQualityContract#LEVEL_MEDIUM)
- [MediaQualityContract.LEVEL_HIGH](https://developer.android.com/reference/android/media/quality/MediaQualityContract#LEVEL_HIGH)
- [MediaQualityContract.LEVEL_OFF](https://developer.android.com/reference/android/media/quality/MediaQualityContract#LEVEL_OFF)
The default value is[MediaQualityContract.LEVEL_OFF](https://developer.android.com/reference/android/media/quality/MediaQualityContract#LEVEL_OFF).
Type: STRING
Constant Value: "dialogue_enhancer"
### PARAMETER_DIGITAL_OUTPUT_DELAY_MILLIS
Added in[API level 36](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
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](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
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](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
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](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
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](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
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](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
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](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
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](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
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](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
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](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
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](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
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](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
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](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
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](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
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](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
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](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
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](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static final String PARAMETER_SPEAKERS
```
Enable/disable speaker output.
Type: BOOLEAN
Constant Value: "speakers"
### PARAMETER_SPEAKERS_DELAY_MILLIS
Added in[API level 36](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
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](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
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](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
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"