# MediaQualityManager

Added in[API level 36](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  
Summary:[Nested Classes](https://developer.android.com/reference/android/media/quality/MediaQualityManager#nestedclasses)\|[Methods](https://developer.android.com/reference/android/media/quality/MediaQualityManager#pubmethods)\|[Inherited Methods](https://developer.android.com/reference/android/media/quality/MediaQualityManager#inhmethods)  

# MediaQualityManager

*** ** * ** ***

[Kotlin](https://developer.android.com/reference/kotlin/android/media/quality/MediaQualityManager "View this page in Kotlin")\|Java

`
public

final

class
MediaQualityManager
`  
`

extends `[Object](https://developer.android.com/reference/java/lang/Object)`


``


`

|---|-------------------------------------------|
| [java.lang.Object](https://developer.android.com/reference/java/lang/Object) ||
| ↳ | android.media.quality.MediaQualityManager |

<br />

*** ** * ** ***

Central system API to the overall media quality, which arbitrates interaction between applications and media quality service.

## Summary

|                                                                                                       ### Nested classes                                                                                                       ||
|--------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| ` interface` | [MediaQualityManager.AmbientBacklightCallback](https://developer.android.com/reference/android/media/quality/MediaQualityManager.AmbientBacklightCallback) Callback used to monitor status of ambient backlight. |
| ` class`     | [MediaQualityManager.PictureProfileCallback](https://developer.android.com/reference/android/media/quality/MediaQualityManager.PictureProfileCallback) Callback used to monitor status of picture profiles       |
| ` class`     | [MediaQualityManager.ProfileQueryParams](https://developer.android.com/reference/android/media/quality/MediaQualityManager.ProfileQueryParams) Options for profile queries.                                      |
| ` class`     | [MediaQualityManager.SoundProfileCallback](https://developer.android.com/reference/android/media/quality/MediaQualityManager.SoundProfileCallback) Callback used to monitor status of sound profiles.            |

|                                                                                                                                                                                                                                                                                                                                                                                                                                                          ### Public methods                                                                                                                                                                                                                                                                                                                                                                                                                                                          ||
|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| ` void`                                                                                                                                                                         | ` `[addActiveProcessingPictureListener](https://developer.android.com/reference/android/media/quality/MediaQualityManager#addActiveProcessingPictureListener(java.util.concurrent.Executor,%20java.util.function.Consumer<java.util.List<android.media.quality.ActiveProcessingPicture>>))`(`[Executor](https://developer.android.com/reference/java/util/concurrent/Executor)` executor, `[Consumer](https://developer.android.com/reference/java/util/function/Consumer)`<`[List](https://developer.android.com/reference/java/util/List)`<`[ActiveProcessingPicture](https://developer.android.com/reference/android/media/quality/ActiveProcessingPicture)`>> listener) ` Adds an active picture listener for the contents owner by the caller. |
| ` void`                                                                                                                                                                         | ` `[createPictureProfile](https://developer.android.com/reference/android/media/quality/MediaQualityManager#createPictureProfile(android.media.quality.PictureProfile))`(`[PictureProfile](https://developer.android.com/reference/android/media/quality/PictureProfile)` pp) ` Creates a picture profile and store it in the system.                                                                                                                                                                                                                                                                                                                                                                                                               |
| ` void`                                                                                                                                                                         | ` `[createSoundProfile](https://developer.android.com/reference/android/media/quality/MediaQualityManager#createSoundProfile(android.media.quality.SoundProfile))`(`[SoundProfile](https://developer.android.com/reference/android/media/quality/SoundProfile)` sp) ` Creates a sound profile and store it in the system.                                                                                                                                                                                                                                                                                                                                                                                                                           |
| ` `[List](https://developer.android.com/reference/java/util/List)`<`[PictureProfile](https://developer.android.com/reference/android/media/quality/PictureProfile)`>`           | ` `[getAvailablePictureProfiles](https://developer.android.com/reference/android/media/quality/MediaQualityManager#getAvailablePictureProfiles(android.media.quality.MediaQualityManager.ProfileQueryParams))`(`[MediaQualityManager.ProfileQueryParams](https://developer.android.com/reference/android/media/quality/MediaQualityManager.ProfileQueryParams)` options) ` Gets profiles that available to the caller.                                                                                                                                                                                                                                                                                                                              |
| ` `[List](https://developer.android.com/reference/java/util/List)`<`[SoundProfile](https://developer.android.com/reference/android/media/quality/SoundProfile)`>`               | ` `[getAvailableSoundProfiles](https://developer.android.com/reference/android/media/quality/MediaQualityManager#getAvailableSoundProfiles(android.media.quality.MediaQualityManager.ProfileQueryParams))`(`[MediaQualityManager.ProfileQueryParams](https://developer.android.com/reference/android/media/quality/MediaQualityManager.ProfileQueryParams)` options) ` Gets profiles that available to the caller package.                                                                                                                                                                                                                                                                                                                          |
| ` `[List](https://developer.android.com/reference/java/util/List)`<`[ParameterCapability](https://developer.android.com/reference/android/media/quality/ParameterCapability)`>` | ` `[getParameterCapabilities](https://developer.android.com/reference/android/media/quality/MediaQualityManager#getParameterCapabilities(java.util.List<java.lang.String>))`(`[List](https://developer.android.com/reference/java/util/List)`<`[String](https://developer.android.com/reference/java/lang/String)`> names) ` Gets capability information of the given parameters.                                                                                                                                                                                                                                                                                                                                                                   |
| ` `[PictureProfile](https://developer.android.com/reference/android/media/quality/PictureProfile)                                                                               | ` `[getPictureProfile](https://developer.android.com/reference/android/media/quality/MediaQualityManager#getPictureProfile(int,%20java.lang.String,%20android.media.quality.MediaQualityManager.ProfileQueryParams))`(int type, `[String](https://developer.android.com/reference/java/lang/String)` name, `[MediaQualityManager.ProfileQueryParams](https://developer.android.com/reference/android/media/quality/MediaQualityManager.ProfileQueryParams)` options) ` Gets picture profile by given profile type and name.                                                                                                                                                                                                                         |
| ` `[SoundProfile](https://developer.android.com/reference/android/media/quality/SoundProfile)                                                                                   | ` `[getSoundProfile](https://developer.android.com/reference/android/media/quality/MediaQualityManager#getSoundProfile(int,%20java.lang.String,%20android.media.quality.MediaQualityManager.ProfileQueryParams))`(int type, `[String](https://developer.android.com/reference/java/lang/String)` name, `[MediaQualityManager.ProfileQueryParams](https://developer.android.com/reference/android/media/quality/MediaQualityManager.ProfileQueryParams)` options) ` Gets sound profile by given profile type and name.                                                                                                                                                                                                                               |
| ` boolean`                                                                                                                                                                      | ` `[isAmbientBacklightEnabled](https://developer.android.com/reference/android/media/quality/MediaQualityManager#isAmbientBacklightEnabled())`() ` Returns`true`if ambient backlight is enabled;`false`otherwise.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| ` boolean`                                                                                                                                                                      | ` `[isAutoPictureQualityEnabled](https://developer.android.com/reference/android/media/quality/MediaQualityManager#isAutoPictureQualityEnabled())`() ` Returns`true`if auto picture quality is enabled;`false`otherwise.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| ` boolean`                                                                                                                                                                      | ` `[isAutoSoundQualityEnabled](https://developer.android.com/reference/android/media/quality/MediaQualityManager#isAutoSoundQualityEnabled())`() ` Returns`true`if auto sound quality is enabled;`false`otherwise.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| ` boolean`                                                                                                                                                                      | ` `[isSuperResolutionEnabled](https://developer.android.com/reference/android/media/quality/MediaQualityManager#isSuperResolutionEnabled())`() ` Returns`true`if super resolution is enabled;`false`otherwise.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| ` void`                                                                                                                                                                         | ` `[registerAmbientBacklightCallback](https://developer.android.com/reference/android/media/quality/MediaQualityManager#registerAmbientBacklightCallback(java.util.concurrent.Executor,%20android.media.quality.MediaQualityManager.AmbientBacklightCallback))`(`[Executor](https://developer.android.com/reference/java/util/concurrent/Executor)` executor, `[MediaQualityManager.AmbientBacklightCallback](https://developer.android.com/reference/android/media/quality/MediaQualityManager.AmbientBacklightCallback)` callback) ` Registers a[AmbientBacklightCallback](https://developer.android.com/reference/android/media/quality/MediaQualityManager.AmbientBacklightCallback).                                                           |
| ` void`                                                                                                                                                                         | ` `[registerPictureProfileCallback](https://developer.android.com/reference/android/media/quality/MediaQualityManager#registerPictureProfileCallback(java.util.concurrent.Executor,%20android.media.quality.MediaQualityManager.PictureProfileCallback))`(`[Executor](https://developer.android.com/reference/java/util/concurrent/Executor)` executor, `[MediaQualityManager.PictureProfileCallback](https://developer.android.com/reference/android/media/quality/MediaQualityManager.PictureProfileCallback)` callback) ` Registers a[PictureProfileCallback](https://developer.android.com/reference/android/media/quality/MediaQualityManager.PictureProfileCallback).                                                                         |
| ` void`                                                                                                                                                                         | ` `[registerSoundProfileCallback](https://developer.android.com/reference/android/media/quality/MediaQualityManager#registerSoundProfileCallback(java.util.concurrent.Executor,%20android.media.quality.MediaQualityManager.SoundProfileCallback))`(`[Executor](https://developer.android.com/reference/java/util/concurrent/Executor)` executor, `[MediaQualityManager.SoundProfileCallback](https://developer.android.com/reference/android/media/quality/MediaQualityManager.SoundProfileCallback)` callback) ` Registers a[SoundProfileCallback](https://developer.android.com/reference/android/media/quality/MediaQualityManager.SoundProfileCallback).                                                                                       |
| ` void`                                                                                                                                                                         | ` `[removeActiveProcessingPictureListener](https://developer.android.com/reference/android/media/quality/MediaQualityManager#removeActiveProcessingPictureListener(java.util.function.Consumer<java.util.List<android.media.quality.ActiveProcessingPicture>>))`(`[Consumer](https://developer.android.com/reference/java/util/function/Consumer)`<`[List](https://developer.android.com/reference/java/util/List)`<`[ActiveProcessingPicture](https://developer.android.com/reference/android/media/quality/ActiveProcessingPicture)`>> listener) ` Removes an active picture listener for the contents.                                                                                                                                           |
| ` void`                                                                                                                                                                         | ` `[removePictureProfile](https://developer.android.com/reference/android/media/quality/MediaQualityManager#removePictureProfile(java.lang.String))`(`[String](https://developer.android.com/reference/java/lang/String)` profileId) ` Removes a picture profile from the system.                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| ` void`                                                                                                                                                                         | ` `[removeSoundProfile](https://developer.android.com/reference/android/media/quality/MediaQualityManager#removeSoundProfile(java.lang.String))`(`[String](https://developer.android.com/reference/java/lang/String)` profileId) ` Removes a sound profile from the system.                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| ` void`                                                                                                                                                                         | ` `[setAmbientBacklightEnabled](https://developer.android.com/reference/android/media/quality/MediaQualityManager#setAmbientBacklightEnabled(boolean))`(boolean enabled) ` Enables or disables the ambient backlight detection.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| ` void`                                                                                                                                                                         | ` `[setAmbientBacklightSettings](https://developer.android.com/reference/android/media/quality/MediaQualityManager#setAmbientBacklightSettings(android.media.quality.AmbientBacklightSettings))`(`[AmbientBacklightSettings](https://developer.android.com/reference/android/media/quality/AmbientBacklightSettings)` settings) ` Set the ambient backlight settings.                                                                                                                                                                                                                                                                                                                                                                               |
| ` void`                                                                                                                                                                         | ` `[unregisterAmbientBacklightCallback](https://developer.android.com/reference/android/media/quality/MediaQualityManager#unregisterAmbientBacklightCallback(android.media.quality.MediaQualityManager.AmbientBacklightCallback))`(`[MediaQualityManager.AmbientBacklightCallback](https://developer.android.com/reference/android/media/quality/MediaQualityManager.AmbientBacklightCallback)` callback) ` Unregisters the existing[AmbientBacklightCallback](https://developer.android.com/reference/android/media/quality/MediaQualityManager.AmbientBacklightCallback).                                                                                                                                                                         |
| ` void`                                                                                                                                                                         | ` `[unregisterPictureProfileCallback](https://developer.android.com/reference/android/media/quality/MediaQualityManager#unregisterPictureProfileCallback(android.media.quality.MediaQualityManager.PictureProfileCallback))`(`[MediaQualityManager.PictureProfileCallback](https://developer.android.com/reference/android/media/quality/MediaQualityManager.PictureProfileCallback)` callback) ` Unregisters the existing[PictureProfileCallback](https://developer.android.com/reference/android/media/quality/MediaQualityManager.PictureProfileCallback).                                                                                                                                                                                       |
| ` void`                                                                                                                                                                         | ` `[unregisterSoundProfileCallback](https://developer.android.com/reference/android/media/quality/MediaQualityManager#unregisterSoundProfileCallback(android.media.quality.MediaQualityManager.SoundProfileCallback))`(`[MediaQualityManager.SoundProfileCallback](https://developer.android.com/reference/android/media/quality/MediaQualityManager.SoundProfileCallback)` callback) ` Unregisters the existing[SoundProfileCallback](https://developer.android.com/reference/android/media/quality/MediaQualityManager.SoundProfileCallback).                                                                                                                                                                                                     |
| ` void`                                                                                                                                                                         | ` `[updatePictureProfile](https://developer.android.com/reference/android/media/quality/MediaQualityManager#updatePictureProfile(java.lang.String,%20android.media.quality.PictureProfile))`(`[String](https://developer.android.com/reference/java/lang/String)` profileId, `[PictureProfile](https://developer.android.com/reference/android/media/quality/PictureProfile)` pp) ` Updates an existing picture profile and store it in the system.                                                                                                                                                                                                                                                                                                 |
| ` void`                                                                                                                                                                         | ` `[updateSoundProfile](https://developer.android.com/reference/android/media/quality/MediaQualityManager#updateSoundProfile(java.lang.String,%20android.media.quality.SoundProfile))`(`[String](https://developer.android.com/reference/java/lang/String)` profileId, `[SoundProfile](https://developer.android.com/reference/android/media/quality/SoundProfile)` sp) ` Updates an existing sound profile and store it in the system.                                                                                                                                                                                                                                                                                                             |

| ### 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*.                                                                                             | ||

## Public methods

### addActiveProcessingPictureListener

Added in[API level 36](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  

```
public void addActiveProcessingPictureListener (Executor executor, 
                Consumer<List<ActiveProcessingPicture>> listener)
```

Adds an active picture listener for the contents owner by the caller.

<br />

|                                                                                                                                                                                                                                                                                               Parameters                                                                                                                                                                                                                                                                                                ||
|------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `executor` | `Executor`: Callback and listener events are dispatched through this[Executor](https://developer.android.com/reference/java/util/concurrent/Executor), providing an easy way to control which thread is used. To dispatch events through the main thread of your application, you can use[Context.getMainExecutor()](https://developer.android.com/reference/android/content/Context#getMainExecutor()). Otherwise, provide an[Executor](https://developer.android.com/reference/java/util/concurrent/Executor)that dispatches to an appropriate thread. This value cannot be`null`. <br /> |
| `listener` | `Consumer`: This value cannot be`null`. <br />                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |

### createPictureProfile

Added in[API level 36](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  

```
public void createPictureProfile (PictureProfile pp)
```

Creates a picture profile and store it in the system.

If the profile is created successfully,[PictureProfileCallback.onPictureProfileAdded(String, PictureProfile)](https://developer.android.com/reference/android/media/quality/MediaQualityManager.PictureProfileCallback#onPictureProfileAdded(java.lang.String,%20android.media.quality.PictureProfile))is invoked.

<br />

|                                                                                    Parameters                                                                                     ||
|------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `pp` | `PictureProfile`: the[PictureProfile](https://developer.android.com/reference/android/media/quality/PictureProfile)object to be created. This value cannot be`null`. <br /> |

### createSoundProfile

Added in[API level 36](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  

```
public void createSoundProfile (SoundProfile sp)
```

Creates a sound profile and store it in the system.

If the profile is created successfully,[SoundProfileCallback.onSoundProfileAdded(String, SoundProfile)](https://developer.android.com/reference/android/media/quality/MediaQualityManager.SoundProfileCallback#onSoundProfileAdded(java.lang.String,%20android.media.quality.SoundProfile))is invoked.

<br />

|                                                                                 Parameters                                                                                  ||
|------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `sp` | `SoundProfile`: the[SoundProfile](https://developer.android.com/reference/android/media/quality/SoundProfile)object to be created. This value cannot be`null`. <br /> |

### getAvailablePictureProfiles

Added in[API level 36](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  

```
public List<PictureProfile> getAvailablePictureProfiles (MediaQualityManager.ProfileQueryParams options)
```

Gets profiles that available to the caller.

If[ProfileQueryParams.areParametersIncluded()](https://developer.android.com/reference/android/media/quality/MediaQualityManager.ProfileQueryParams#areParametersIncluded())is`false`,[PictureProfile.getParameters()](https://developer.android.com/reference/android/media/quality/PictureProfile#getParameters())of the returned profiles are empty bundles.

<br />

|                                                       Parameters                                                        ||
|-----------|--------------------------------------------------------------------------------------------------------------|
| `options` | `MediaQualityManager.ProfileQueryParams`: the options of the query.`null`if default options are used. <br /> |

|                                                                                                                          Returns                                                                                                                           ||
|--------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------|
| [List](https://developer.android.com/reference/java/util/List)`<`[PictureProfile](https://developer.android.com/reference/android/media/quality/PictureProfile)`>` | the corresponding picture profile if available;`null`if the name doesn't exist. <br /> |

### getAvailableSoundProfiles

Added in[API level 36](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  

```
public List<SoundProfile> getAvailableSoundProfiles (MediaQualityManager.ProfileQueryParams options)
```

Gets profiles that available to the caller package.

If[ProfileQueryParams.areParametersIncluded()](https://developer.android.com/reference/android/media/quality/MediaQualityManager.ProfileQueryParams#areParametersIncluded())is`false`,[SoundProfile.getParameters()](https://developer.android.com/reference/android/media/quality/SoundProfile#getParameters())of the returned profiles are empty bundles.

<br />

|                                                       Parameters                                                        ||
|-----------|--------------------------------------------------------------------------------------------------------------|
| `options` | `MediaQualityManager.ProfileQueryParams`: the options of the query.`null`if default options are used. <br /> |

|                                                                                                                     Returns                                                                                                                      ||
|----------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------|
| [List](https://developer.android.com/reference/java/util/List)`<`[SoundProfile](https://developer.android.com/reference/android/media/quality/SoundProfile)`>` | the corresponding sound profile if available;`null`if the none available. <br /> |

### getParameterCapabilities

Added in[API level 36](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  

```
public List<ParameterCapability> getParameterCapabilities (List<String> names)
```

Gets capability information of the given parameters.

If a name isn't found, a corresponding[ParameterCapability](https://developer.android.com/reference/android/media/quality/ParameterCapability)instance is in the return list, and[ParameterCapability.isSupported()](https://developer.android.com/reference/android/media/quality/ParameterCapability#isSupported())is`false`.

<br />

|                                                                                                                            Parameters                                                                                                                            ||
|---------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `names` | `List`: the parameter names. Commonly used names can be found in[MediaQualityContract](https://developer.android.com/reference/android/media/quality/MediaQualityContract). Vendor-defined names are also permitted. This value cannot be`null`. <br /> |

|                                                                                                     Returns                                                                                                      ||
|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------|
| [List](https://developer.android.com/reference/java/util/List)`<`[ParameterCapability](https://developer.android.com/reference/android/media/quality/ParameterCapability)`>` | This value cannot be`null`. <br /> |

### getPictureProfile

Added in[API level 36](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  

```
public PictureProfile getPictureProfile (int type, 
                String name, 
                MediaQualityManager.ProfileQueryParams options)
```

Gets picture profile by given profile type and name.

If[ProfileQueryParams.areParametersIncluded()](https://developer.android.com/reference/android/media/quality/MediaQualityManager.ProfileQueryParams#areParametersIncluded())is`false`,[PictureProfile.getParameters()](https://developer.android.com/reference/android/media/quality/PictureProfile#getParameters())of the returned profile is an empty bundle.

<br />

|                                                                                                                                                      Parameters                                                                                                                                                      ||
|-----------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `type`    | `int`: the type of the profile. Value is[PictureProfile.TYPE_SYSTEM](https://developer.android.com/reference/android/media/quality/PictureProfile#TYPE_SYSTEM), or[PictureProfile.TYPE_APPLICATION](https://developer.android.com/reference/android/media/quality/PictureProfile#TYPE_APPLICATION) <br /> |
| `name`    | `String`: the name of the profile. This value cannot be`null`. <br />                                                                                                                                                                                                                                     |
| `options` | `MediaQualityManager.ProfileQueryParams`: the options of the query.`null`if default options are used. <br />                                                                                                                                                                                              |

|                                                                                        Returns                                                                                         ||
|------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------|
| [PictureProfile](https://developer.android.com/reference/android/media/quality/PictureProfile) | the corresponding picture profile if available;`null`if the name doesn't exist. <br /> |

### getSoundProfile

Added in[API level 36](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  

```
public SoundProfile getSoundProfile (int type, 
                String name, 
                MediaQualityManager.ProfileQueryParams options)
```

Gets sound profile by given profile type and name.

If[ProfileQueryParams.areParametersIncluded()](https://developer.android.com/reference/android/media/quality/MediaQualityManager.ProfileQueryParams#areParametersIncluded())is`false`,[SoundProfile.getParameters()](https://developer.android.com/reference/android/media/quality/SoundProfile#getParameters())of the returned profile is an empty bundle.

<br />

|                                                                                                                                                  Parameters                                                                                                                                                  ||
|-----------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `type`    | `int`: the type of the profile. Value is[SoundProfile.TYPE_SYSTEM](https://developer.android.com/reference/android/media/quality/SoundProfile#TYPE_SYSTEM), or[SoundProfile.TYPE_APPLICATION](https://developer.android.com/reference/android/media/quality/SoundProfile#TYPE_APPLICATION) <br /> |
| `name`    | `String`: the name of the profile. This value cannot be`null`. <br />                                                                                                                                                                                                                             |
| `options` | `MediaQualityManager.ProfileQueryParams`: the options of the query.`null`if default options are used. <br />                                                                                                                                                                                      |

|                                                                                     Returns                                                                                      ||
|--------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------|
| [SoundProfile](https://developer.android.com/reference/android/media/quality/SoundProfile) | the corresponding sound profile if available;`null`if the name doesn't exist. <br /> |

### isAmbientBacklightEnabled

Added in[API level 36](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  

```
public boolean isAmbientBacklightEnabled ()
```

Returns`true`if ambient backlight is enabled;`false`otherwise.

<br />

|      Returns      ||
|-----------|--------|
| `boolean` | <br /> |

### isAutoPictureQualityEnabled

Added in[API level 36](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  

```
public boolean isAutoPictureQualityEnabled ()
```

Returns`true`if auto picture quality is enabled;`false`otherwise.

<br />

|      Returns      ||
|-----------|--------|
| `boolean` | <br /> |

### isAutoSoundQualityEnabled

Added in[API level 36](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  

```
public boolean isAutoSoundQualityEnabled ()
```

Returns`true`if auto sound quality is enabled;`false`otherwise.

<br />

|      Returns      ||
|-----------|--------|
| `boolean` | <br /> |

### isSuperResolutionEnabled

Added in[API level 36](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  

```
public boolean isSuperResolutionEnabled ()
```

Returns`true`if super resolution is enabled;`false`otherwise.

<br />

|      Returns      ||
|-----------|--------|
| `boolean` | <br /> |

### registerAmbientBacklightCallback

Added in[API level 36](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  

```
public void registerAmbientBacklightCallback (Executor executor, 
                MediaQualityManager.AmbientBacklightCallback callback)
```

Registers a[AmbientBacklightCallback](https://developer.android.com/reference/android/media/quality/MediaQualityManager.AmbientBacklightCallback).

<br />

|                                                                                                                                                                                                                                                                                               Parameters                                                                                                                                                                                                                                                                                                ||
|------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `executor` | `Executor`: This value cannot be`null`. Callback and listener events are dispatched through this[Executor](https://developer.android.com/reference/java/util/concurrent/Executor), providing an easy way to control which thread is used. To dispatch events through the main thread of your application, you can use[Context.getMainExecutor()](https://developer.android.com/reference/android/content/Context#getMainExecutor()). Otherwise, provide an[Executor](https://developer.android.com/reference/java/util/concurrent/Executor)that dispatches to an appropriate thread. <br /> |
| `callback` | `MediaQualityManager.AmbientBacklightCallback`: This value cannot be`null`. <br />                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |

### registerPictureProfileCallback

Added in[API level 36](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  

```
public void registerPictureProfileCallback (Executor executor, 
                MediaQualityManager.PictureProfileCallback callback)
```

Registers a[PictureProfileCallback](https://developer.android.com/reference/android/media/quality/MediaQualityManager.PictureProfileCallback).

<br />

|                                                                                                                                                                                                                                                                                               Parameters                                                                                                                                                                                                                                                                                                ||
|------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `executor` | `Executor`: This value cannot be`null`. Callback and listener events are dispatched through this[Executor](https://developer.android.com/reference/java/util/concurrent/Executor), providing an easy way to control which thread is used. To dispatch events through the main thread of your application, you can use[Context.getMainExecutor()](https://developer.android.com/reference/android/content/Context#getMainExecutor()). Otherwise, provide an[Executor](https://developer.android.com/reference/java/util/concurrent/Executor)that dispatches to an appropriate thread. <br /> |
| `callback` | `MediaQualityManager.PictureProfileCallback`: This value cannot be`null`. <br />                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |

### registerSoundProfileCallback

Added in[API level 36](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  

```
public void registerSoundProfileCallback (Executor executor, 
                MediaQualityManager.SoundProfileCallback callback)
```

Registers a[SoundProfileCallback](https://developer.android.com/reference/android/media/quality/MediaQualityManager.SoundProfileCallback).

<br />

|                                                                                                                                                                                                                                                                                               Parameters                                                                                                                                                                                                                                                                                                ||
|------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `executor` | `Executor`: This value cannot be`null`. Callback and listener events are dispatched through this[Executor](https://developer.android.com/reference/java/util/concurrent/Executor), providing an easy way to control which thread is used. To dispatch events through the main thread of your application, you can use[Context.getMainExecutor()](https://developer.android.com/reference/android/content/Context#getMainExecutor()). Otherwise, provide an[Executor](https://developer.android.com/reference/java/util/concurrent/Executor)that dispatches to an appropriate thread. <br /> |
| `callback` | `MediaQualityManager.SoundProfileCallback`: This value cannot be`null`. <br />                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |

### removeActiveProcessingPictureListener

Added in[API level 36](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  

```
public void removeActiveProcessingPictureListener (Consumer<List<ActiveProcessingPicture>> listener)
```

Removes an active picture listener for the contents.

<br />

|                         Parameters                         ||
|------------|------------------------------------------------|
| `listener` | `Consumer`: This value cannot be`null`. <br /> |

### removePictureProfile

Added in[API level 36](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  

```
public void removePictureProfile (String profileId)
```

Removes a picture profile from the system.

<br />

|                                          Parameters                                           ||
|-------------|----------------------------------------------------------------------------------|
| `profileId` | `String`: the id of the object to be removed. This value cannot be`null`. <br /> |

### removeSoundProfile

Added in[API level 36](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  

```
public void removeSoundProfile (String profileId)
```

Removes a sound profile from the system.

<br />

|                                          Parameters                                           ||
|-------------|----------------------------------------------------------------------------------|
| `profileId` | `String`: the id of the object to be removed. This value cannot be`null`. <br /> |

### setAmbientBacklightEnabled

Added in[API level 36](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  

```
public void setAmbientBacklightEnabled (boolean enabled)
```

Enables or disables the ambient backlight detection.

<br />

|                           Parameters                           ||
|-----------|-----------------------------------------------------|
| `enabled` | `boolean`:`true`to enable,`false`to disable. <br /> |

### setAmbientBacklightSettings

Added in[API level 36](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  

```
public void setAmbientBacklightSettings (AmbientBacklightSettings settings)
```

Set the ambient backlight settings.

<br />

|                                                         Parameters                                                         ||
|------------|----------------------------------------------------------------------------------------------------------------|
| `settings` | `AmbientBacklightSettings`: The settings to use for the backlight detector. This value cannot be`null`. <br /> |

### unregisterAmbientBacklightCallback

Added in[API level 36](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  

```
public void unregisterAmbientBacklightCallback (MediaQualityManager.AmbientBacklightCallback callback)
```

Unregisters the existing[AmbientBacklightCallback](https://developer.android.com/reference/android/media/quality/MediaQualityManager.AmbientBacklightCallback).

<br />

|                                           Parameters                                           ||
|------------|------------------------------------------------------------------------------------|
| `callback` | `MediaQualityManager.AmbientBacklightCallback`: This value cannot be`null`. <br /> |

### unregisterPictureProfileCallback

Added in[API level 36](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  

```
public void unregisterPictureProfileCallback (MediaQualityManager.PictureProfileCallback callback)
```

Unregisters the existing[PictureProfileCallback](https://developer.android.com/reference/android/media/quality/MediaQualityManager.PictureProfileCallback).

<br />

|                                          Parameters                                          ||
|------------|----------------------------------------------------------------------------------|
| `callback` | `MediaQualityManager.PictureProfileCallback`: This value cannot be`null`. <br /> |

### unregisterSoundProfileCallback

Added in[API level 36](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  

```
public void unregisterSoundProfileCallback (MediaQualityManager.SoundProfileCallback callback)
```

Unregisters the existing[SoundProfileCallback](https://developer.android.com/reference/android/media/quality/MediaQualityManager.SoundProfileCallback).

<br />

|                                         Parameters                                         ||
|------------|--------------------------------------------------------------------------------|
| `callback` | `MediaQualityManager.SoundProfileCallback`: This value cannot be`null`. <br /> |

### updatePictureProfile

Added in[API level 36](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  

```
public void updatePictureProfile (String profileId, 
                PictureProfile pp)
```

Updates an existing picture profile and store it in the system.

<br />

|                                                                                        Parameters                                                                                        ||
|-------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `profileId` | `String`: the id of the object to be updated. This value cannot be`null`. <br />                                                                                            |
| `pp`        | `PictureProfile`: the[PictureProfile](https://developer.android.com/reference/android/media/quality/PictureProfile)object to be updated. This value cannot be`null`. <br /> |

### updateSoundProfile

Added in[API level 36](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  

```
public void updateSoundProfile (String profileId, 
                SoundProfile sp)
```

Updates an existing sound profile and store it in the system.

<br />

|                                                                                     Parameters                                                                                     ||
|-------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `profileId` | `String`: the id of the object to be updated. This value cannot be`null`. <br />                                                                                      |
| `sp`        | `SoundProfile`: the[SoundProfile](https://developer.android.com/reference/android/media/quality/SoundProfile)object to be updated. This value cannot be`null`. <br /> |