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
public static final String PARAMETER_AUTO_VOLUME_CONTROL
Enable/disable auto volume control sound effect.
Type: BOOLEAN
Constant Value: "auto_volume_control"
PARAMETER_BALANCE
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
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
public static final String PARAMETER_DIALOGUE_ENHANCER
Dialogue enhancer.
Possible values:
MediaQualityContract.LEVEL_LOW
MediaQualityContract.LEVEL_MEDIUM
MediaQualityContract.LEVEL_HIGH
MediaQualityContract.LEVEL_OFF
MediaQualityContract.LEVEL_OFF
.
Type: STRING
Constant Value: "dialogue_enhancer"
PARAMETER_DIGITAL_OUTPUT_DELAY_MILLIS
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
public static final String PARAMETER_SPEAKERS
Enable/disable speaker output.
Type: BOOLEAN
Constant Value: "speakers"
PARAMETER_SPEAKERS_DELAY_MILLIS
public static final String PARAMETER_SPEAKERS_DELAY_MILLIS
Speaker delay in milliseconds.
Type: INTEGER
Constant Value: "speakers_delay_millis"
PARAMETER_SURROUND_SOUND
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
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"