# MediaMetadataCompat.Builder

Artifact: [androidx.media:media](https://developer.android.com/jetpack/androidx/releases/media) [View Source](https://cs.android.com/search?q=file:android/support/v4/media/MediaMetadataCompat.java+class:android.support.v4.media.MediaMetadataCompat.Builder) Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/media#1.1.0) Deprecated in [1.8.0](https://developer.android.com/jetpack/androidx/releases/media#1.8.0)

*** ** * ** ***


```
class MediaMetadataCompat.Builder
```

<br />

*** ** * ** ***

> [!CAUTION]
> **This class is deprecated.**   
>
> androidx.media is deprecated. Please migrate to [androidx.media3](https://developer.android.com/media/media3).

Use to build MediaMetadata objects. The system defined metadata keys must use the appropriate data type.

## Summary

| ### Public constructors |
|---|
| `[Builder](https://developer.android.com/reference/kotlin/android/support/v4/media/MediaMetadataCompat.Builder#Builder())()` **This function is deprecated.** Deprecated in Java |
| `[Builder](https://developer.android.com/reference/kotlin/android/support/v4/media/MediaMetadataCompat.Builder#Builder(android.support.v4.media.MediaMetadataCompat))(source: https://developer.android.com/reference/kotlin/android/support/v4/media/MediaMetadataCompat!)` **This function is deprecated.** Deprecated in Java |

| ### Public functions |
|---|---|
| `https://developer.android.com/reference/kotlin/android/support/v4/media/MediaMetadataCompat!` | `[build](https://developer.android.com/reference/kotlin/android/support/v4/media/MediaMetadataCompat.Builder#build())()` **This function is deprecated.** Deprecated in Java |
| `https://developer.android.com/reference/kotlin/android/support/v4/media/MediaMetadataCompat.Builder!` | `[putBitmap](https://developer.android.com/reference/kotlin/android/support/v4/media/MediaMetadataCompat.Builder#putBitmap(java.lang.String,android.graphics.Bitmap))(key: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html!, value: https://developer.android.com/reference/android/graphics/Bitmap.html!)` **This function is deprecated.** Deprecated in Java |
| `https://developer.android.com/reference/kotlin/android/support/v4/media/MediaMetadataCompat.Builder!` | `[putLong](https://developer.android.com/reference/kotlin/android/support/v4/media/MediaMetadataCompat.Builder#putLong(java.lang.String,long))(key: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html!, value: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-long/index.html)` **This function is deprecated.** Deprecated in Java |
| `https://developer.android.com/reference/kotlin/android/support/v4/media/MediaMetadataCompat.Builder!` | `[putRating](https://developer.android.com/reference/kotlin/android/support/v4/media/MediaMetadataCompat.Builder#putRating(java.lang.String,android.support.v4.media.RatingCompat))(key: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html!, value: https://developer.android.com/reference/kotlin/android/support/v4/media/RatingCompat!)` **This function is deprecated.** Deprecated in Java |
| `https://developer.android.com/reference/kotlin/android/support/v4/media/MediaMetadataCompat.Builder!` | `[putString](https://developer.android.com/reference/kotlin/android/support/v4/media/MediaMetadataCompat.Builder#putString(java.lang.String,java.lang.String))(key: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html!, value: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html!)` **This function is deprecated.** Deprecated in Java |
| `https://developer.android.com/reference/kotlin/android/support/v4/media/MediaMetadataCompat.Builder!` | `[putText](https://developer.android.com/reference/kotlin/android/support/v4/media/MediaMetadataCompat.Builder#putText(java.lang.String,java.lang.CharSequence))(key: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html!, value: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-char-sequence/index.html!)` **This function is deprecated.** Deprecated in Java |

## Public constructors

### Builder

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/media#1.1.0) Deprecated in [1.8.0](https://developer.android.com/jetpack/androidx/releases/media#1.8.0)

```
[Builder](https://developer.android.com/reference/kotlin/android/support/v4/media/MediaMetadataCompat.Builder#Builder())()
```

> [!CAUTION]
> **This function is deprecated.**   
> Deprecated in Java

Create an empty Builder. Any field that should be included in the `https://developer.android.com/reference/kotlin/android/support/v4/media/MediaMetadataCompat` must be added.

### Builder

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/media#1.1.0) Deprecated in [1.8.0](https://developer.android.com/jetpack/androidx/releases/media#1.8.0)

```
[Builder](https://developer.android.com/reference/kotlin/android/support/v4/media/MediaMetadataCompat.Builder#Builder(android.support.v4.media.MediaMetadataCompat))(source: MediaMetadataCompat!)
```

> [!CAUTION]
> **This function is deprecated.**   
> Deprecated in Java

Create a Builder using a `https://developer.android.com/reference/kotlin/android/support/v4/media/MediaMetadataCompat` instance to set the initial values. All fields in the source metadata will be included in the new metadata. Fields can be overwritten by adding the same key.

| Parameters |
|---|---|
| `source: https://developer.android.com/reference/kotlin/android/support/v4/media/MediaMetadataCompat!` |   |

## Public functions

### build

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/media#1.1.0) Deprecated in [1.8.0](https://developer.android.com/jetpack/androidx/releases/media#1.8.0)

```
fun [build](https://developer.android.com/reference/kotlin/android/support/v4/media/MediaMetadataCompat.Builder#build())(): MediaMetadataCompat!
```

> [!CAUTION]
> **This function is deprecated.**   
> Deprecated in Java

Creates a `https://developer.android.com/reference/kotlin/android/support/v4/media/MediaMetadataCompat` instance with the specified fields.

| Returns |
|---|---|
| `https://developer.android.com/reference/kotlin/android/support/v4/media/MediaMetadataCompat!` | The new MediaMetadata instance |

### putBitmap

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/media#1.1.0) Deprecated in [1.8.0](https://developer.android.com/jetpack/androidx/releases/media#1.8.0)

```
fun [putBitmap](https://developer.android.com/reference/kotlin/android/support/v4/media/MediaMetadataCompat.Builder#putBitmap(java.lang.String,android.graphics.Bitmap))(key: String!, value: Bitmap!): MediaMetadataCompat.Builder!
```

> [!CAUTION]
> **This function is deprecated.**   
> Deprecated in Java

Put a `https://developer.android.com/reference/android/graphics/Bitmap.html` into the metadata. Custom keys may be used, but if the METADATA_KEYs defined in this class are used they may only be one of the following:

- `https://developer.android.com/reference/kotlin/android/support/v4/media/MediaMetadataCompat#METADATA_KEY_ART()`
- `https://developer.android.com/reference/kotlin/android/support/v4/media/MediaMetadataCompat#METADATA_KEY_ALBUM_ART()`
- `https://developer.android.com/reference/kotlin/android/support/v4/media/MediaMetadataCompat#METADATA_KEY_DISPLAY_ICON()`

Large bitmaps may be scaled down when `https://developer.android.com/reference/kotlin/android/support/v4/media/session/MediaSessionCompat#setMetadata(android.support.v4.media.MediaMetadataCompat)` is called. To pass full resolution images `https://developer.android.com/reference/android/net/Uri.html` should be used with `https://developer.android.com/reference/kotlin/android/support/v4/media/MediaMetadataCompat.Builder#putString(java.lang.String,java.lang.String)`.

| Parameters |
|---|---|
| `key: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html!` | The key for referencing this value |
| `value: https://developer.android.com/reference/android/graphics/Bitmap.html!` | The Bitmap to store |

| Returns |
|---|---|
| `https://developer.android.com/reference/kotlin/android/support/v4/media/MediaMetadataCompat.Builder!` | The Builder to allow chaining |

### putLong

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/media#1.1.0) Deprecated in [1.8.0](https://developer.android.com/jetpack/androidx/releases/media#1.8.0)

```
fun [putLong](https://developer.android.com/reference/kotlin/android/support/v4/media/MediaMetadataCompat.Builder#putLong(java.lang.String,long))(key: String!, value: Long): MediaMetadataCompat.Builder!
```

> [!CAUTION]
> **This function is deprecated.**   
> Deprecated in Java

Put a long value into the metadata. Custom keys may be used, but if the METADATA_KEYs defined in this class are used they may only be one of the following:

- `https://developer.android.com/reference/kotlin/android/support/v4/media/MediaMetadataCompat#METADATA_KEY_DURATION()`
- `https://developer.android.com/reference/kotlin/android/support/v4/media/MediaMetadataCompat#METADATA_KEY_TRACK_NUMBER()`
- `https://developer.android.com/reference/kotlin/android/support/v4/media/MediaMetadataCompat#METADATA_KEY_NUM_TRACKS()`
- `https://developer.android.com/reference/kotlin/android/support/v4/media/MediaMetadataCompat#METADATA_KEY_DISC_NUMBER()`
- `https://developer.android.com/reference/kotlin/android/support/v4/media/MediaMetadataCompat#METADATA_KEY_YEAR()`
- `https://developer.android.com/reference/kotlin/android/support/v4/media/MediaMetadataCompat#METADATA_KEY_BT_FOLDER_TYPE()`
- `https://developer.android.com/reference/kotlin/android/support/v4/media/MediaMetadataCompat#METADATA_KEY_ADVERTISEMENT()`
- `https://developer.android.com/reference/kotlin/android/support/v4/media/MediaMetadataCompat#METADATA_KEY_DOWNLOAD_STATUS()`

| Parameters |
|---|---|
| `key: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html!` | The key for referencing this value |
| `value: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-long/index.html` | The String value to store |

| Returns |
|---|---|
| `https://developer.android.com/reference/kotlin/android/support/v4/media/MediaMetadataCompat.Builder!` | The Builder to allow chaining |

### putRating

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/media#1.1.0) Deprecated in [1.8.0](https://developer.android.com/jetpack/androidx/releases/media#1.8.0)

```
fun [putRating](https://developer.android.com/reference/kotlin/android/support/v4/media/MediaMetadataCompat.Builder#putRating(java.lang.String,android.support.v4.media.RatingCompat))(key: String!, value: RatingCompat!): MediaMetadataCompat.Builder!
```

> [!CAUTION]
> **This function is deprecated.**   
> Deprecated in Java

Put a `https://developer.android.com/reference/kotlin/android/support/v4/media/RatingCompat` into the metadata. Custom keys may be used, but if the METADATA_KEYs defined in this class are used they may only be one of the following:

- `https://developer.android.com/reference/kotlin/android/support/v4/media/MediaMetadataCompat#METADATA_KEY_RATING()`
- `https://developer.android.com/reference/kotlin/android/support/v4/media/MediaMetadataCompat#METADATA_KEY_USER_RATING()`

| Parameters |
|---|---|
| `key: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html!` | The key for referencing this value |
| `value: https://developer.android.com/reference/kotlin/android/support/v4/media/RatingCompat!` | The String value to store |

| Returns |
|---|---|
| `https://developer.android.com/reference/kotlin/android/support/v4/media/MediaMetadataCompat.Builder!` | The Builder to allow chaining |

### putString

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/media#1.1.0) Deprecated in [1.8.0](https://developer.android.com/jetpack/androidx/releases/media#1.8.0)

```
fun [putString](https://developer.android.com/reference/kotlin/android/support/v4/media/MediaMetadataCompat.Builder#putString(java.lang.String,java.lang.String))(key: String!, value: String!): MediaMetadataCompat.Builder!
```

> [!CAUTION]
> **This function is deprecated.**   
> Deprecated in Java

Put a String value into the metadata. Custom keys may be used, but if the METADATA_KEYs defined in this class are used they may only be one of the following:

- `https://developer.android.com/reference/kotlin/android/support/v4/media/MediaMetadataCompat#METADATA_KEY_TITLE()`
- `https://developer.android.com/reference/kotlin/android/support/v4/media/MediaMetadataCompat#METADATA_KEY_ARTIST()`
- `https://developer.android.com/reference/kotlin/android/support/v4/media/MediaMetadataCompat#METADATA_KEY_ALBUM()`
- `https://developer.android.com/reference/kotlin/android/support/v4/media/MediaMetadataCompat#METADATA_KEY_AUTHOR()`
- `https://developer.android.com/reference/kotlin/android/support/v4/media/MediaMetadataCompat#METADATA_KEY_WRITER()`
- `https://developer.android.com/reference/kotlin/android/support/v4/media/MediaMetadataCompat#METADATA_KEY_COMPOSER()`
- `https://developer.android.com/reference/kotlin/android/support/v4/media/MediaMetadataCompat#METADATA_KEY_DATE()`
- `https://developer.android.com/reference/kotlin/android/support/v4/media/MediaMetadataCompat#METADATA_KEY_GENRE()`
- `https://developer.android.com/reference/kotlin/android/support/v4/media/MediaMetadataCompat#METADATA_KEY_ALBUM_ARTIST()`
- `https://developer.android.com/reference/kotlin/android/support/v4/media/MediaMetadataCompat#METADATA_KEY_ART_URI()`
- `https://developer.android.com/reference/kotlin/android/support/v4/media/MediaMetadataCompat#METADATA_KEY_ALBUM_ART_URI()`
- `https://developer.android.com/reference/kotlin/android/support/v4/media/MediaMetadataCompat#METADATA_KEY_DISPLAY_TITLE()`
- `https://developer.android.com/reference/kotlin/android/support/v4/media/MediaMetadataCompat#METADATA_KEY_DISPLAY_SUBTITLE()`
- `https://developer.android.com/reference/kotlin/android/support/v4/media/MediaMetadataCompat#METADATA_KEY_DISPLAY_DESCRIPTION()`
- `https://developer.android.com/reference/kotlin/android/support/v4/media/MediaMetadataCompat#METADATA_KEY_DISPLAY_ICON_URI()`

| Parameters |
|---|---|
| `key: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html!` | The key for referencing this value |
| `value: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html!` | The String value to store |

| Returns |
|---|---|
| `https://developer.android.com/reference/kotlin/android/support/v4/media/MediaMetadataCompat.Builder!` | The Builder to allow chaining |

### putText

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/media#1.1.0) Deprecated in [1.8.0](https://developer.android.com/jetpack/androidx/releases/media#1.8.0)

```
fun [putText](https://developer.android.com/reference/kotlin/android/support/v4/media/MediaMetadataCompat.Builder#putText(java.lang.String,java.lang.CharSequence))(key: String!, value: CharSequence!): MediaMetadataCompat.Builder!
```

> [!CAUTION]
> **This function is deprecated.**   
> Deprecated in Java

Put a CharSequence value into the metadata. Custom keys may be used, but if the METADATA_KEYs defined in this class are used they may only be one of the following:

- `https://developer.android.com/reference/kotlin/android/support/v4/media/MediaMetadataCompat#METADATA_KEY_TITLE()`
- `https://developer.android.com/reference/kotlin/android/support/v4/media/MediaMetadataCompat#METADATA_KEY_ARTIST()`
- `https://developer.android.com/reference/kotlin/android/support/v4/media/MediaMetadataCompat#METADATA_KEY_ALBUM()`
- `https://developer.android.com/reference/kotlin/android/support/v4/media/MediaMetadataCompat#METADATA_KEY_AUTHOR()`
- `https://developer.android.com/reference/kotlin/android/support/v4/media/MediaMetadataCompat#METADATA_KEY_WRITER()`
- `https://developer.android.com/reference/kotlin/android/support/v4/media/MediaMetadataCompat#METADATA_KEY_COMPOSER()`
- `https://developer.android.com/reference/kotlin/android/support/v4/media/MediaMetadataCompat#METADATA_KEY_DATE()`
- `https://developer.android.com/reference/kotlin/android/support/v4/media/MediaMetadataCompat#METADATA_KEY_GENRE()`
- `https://developer.android.com/reference/kotlin/android/support/v4/media/MediaMetadataCompat#METADATA_KEY_ALBUM_ARTIST()`
- `https://developer.android.com/reference/kotlin/android/support/v4/media/MediaMetadataCompat#METADATA_KEY_ART_URI()`
- `https://developer.android.com/reference/kotlin/android/support/v4/media/MediaMetadataCompat#METADATA_KEY_ALBUM_ART_URI()`
- `https://developer.android.com/reference/kotlin/android/support/v4/media/MediaMetadataCompat#METADATA_KEY_DISPLAY_TITLE()`
- `https://developer.android.com/reference/kotlin/android/support/v4/media/MediaMetadataCompat#METADATA_KEY_DISPLAY_SUBTITLE()`
- `https://developer.android.com/reference/kotlin/android/support/v4/media/MediaMetadataCompat#METADATA_KEY_DISPLAY_DESCRIPTION()`
- `https://developer.android.com/reference/kotlin/android/support/v4/media/MediaMetadataCompat#METADATA_KEY_DISPLAY_ICON_URI()`

| Parameters |
|---|---|
| `key: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html!` | The key for referencing this value |
| `value: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-char-sequence/index.html!` | The CharSequence value to store |

| Returns |
|---|---|
| `https://developer.android.com/reference/kotlin/android/support/v4/media/MediaMetadataCompat.Builder!` | The Builder to allow chaining |