# MediaItem.RequestMetadata

# MediaItem.RequestMetadata

Artifact:[androidx.media3:media3-common](https://developer.android.com/jetpack/androidx/releases/media3)  
[View Source](https://cs.android.com/search?q=file:androidx/media3/common/MediaItem.java+class:androidx.media3.common.MediaItem.RequestMetadata)

*** ** * ** ***

Kotlin\|[Java](https://developer.android.com/reference/androidx/media3/common/MediaItem.RequestMetadata "View this page in Java")

<br />

```
class MediaItem.RequestMetadata
```

<br />

*** ** * ** ***

Metadata that helps the player to understand a playback request represented by a[MediaItem](https://developer.android.com/reference/kotlin/androidx/media3/common/MediaItem).

This metadata is most useful for cases where playback requests are forwarded to other player instances (e.g. from a`androidx.media3.session.MediaController`) and the player creating the request doesn't know the required[LocalConfiguration](https://developer.android.com/reference/kotlin/androidx/media3/common/MediaItem.LocalConfiguration)for playback.

## Summary

|                                                                                                                                       ### Nested types                                                                                                                                       |
|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `class `[MediaItem.RequestMetadata.Builder](https://developer.android.com/reference/kotlin/androidx/media3/common/MediaItem.RequestMetadata.Builder) Builder for[RequestMetadata](https://developer.android.com/reference/kotlin/androidx/media3/common/MediaItem.RequestMetadata)instances. |

|                                                              ### Constants                                                              |
|-----------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------|
| `const `[MediaItem.RequestMetadata](https://developer.android.com/reference/kotlin/androidx/media3/common/MediaItem.RequestMetadata)`!` | [EMPTY](https://developer.android.com/reference/kotlin/androidx/media3/common/MediaItem.RequestMetadata#EMPTY()) Empty request metadata. |

|                                                              ### Public functions                                                               |
|-------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| [MediaItem.RequestMetadata.Builder](https://developer.android.com/reference/kotlin/androidx/media3/common/MediaItem.RequestMetadata.Builder)`!` | [buildUpon](https://developer.android.com/reference/kotlin/androidx/media3/common/MediaItem.RequestMetadata#buildUpon())`()` Returns a[Builder](https://developer.android.com/reference/kotlin/androidx/media3/common/MediaItem.RequestMetadata.Builder)initialized with the values of this instance.                                                                                                                                                  |
| [Boolean](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-boolean/index.html)                                                             | [equals](https://developer.android.com/reference/kotlin/androidx/media3/common/MediaItem.RequestMetadata#equals(java.lang.Object))`(o: `[Any](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-any/index.html)`?)`                                                                                                                                                                                                                                |
| `java-static `[MediaItem.RequestMetadata](https://developer.android.com/reference/kotlin/androidx/media3/common/MediaItem.RequestMetadata)`!`   | `@`[UnstableApi](https://developer.android.com/reference/kotlin/androidx/media3/common/util/UnstableApi) [fromBundle](https://developer.android.com/reference/kotlin/androidx/media3/common/MediaItem.RequestMetadata#fromBundle(android.os.Bundle))`(bundle: `[Bundle](https://developer.android.com/reference/android/os/Bundle.html)`!)` Restores a`RequestMetadata`from a[Bundle](https://developer.android.com/reference/android/os/Bundle.html). |
| [Int](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html)                                                                     | [hashCode](https://developer.android.com/reference/kotlin/androidx/media3/common/MediaItem.RequestMetadata#hashCode())`()`                                                                                                                                                                                                                                                                                                                             |
| [Bundle](https://developer.android.com/reference/android/os/Bundle.html)`!`                                                                     | `@`[UnstableApi](https://developer.android.com/reference/kotlin/androidx/media3/common/util/UnstableApi) [toBundle](https://developer.android.com/reference/kotlin/androidx/media3/common/MediaItem.RequestMetadata#toBundle())`()`                                                                                                                                                                                                                    |

|                                ### Public properties                                 |
|--------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| [Bundle](https://developer.android.com/reference/android/os/Bundle.html)`?`          | [extras](https://developer.android.com/reference/kotlin/androidx/media3/common/MediaItem.RequestMetadata#extras()) Optional extras[Bundle](https://developer.android.com/reference/android/os/Bundle.html). |
| [Uri](https://developer.android.com/reference/android/net/Uri.html)`?`               | [mediaUri](https://developer.android.com/reference/kotlin/androidx/media3/common/MediaItem.RequestMetadata#mediaUri()) The URI of the requested media, or null if not known or applicable.                  |
| [String](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html)`?` | [searchQuery](https://developer.android.com/reference/kotlin/androidx/media3/common/MediaItem.RequestMetadata#searchQuery()) The search query for the requested media, or null if not applicable.           |

## Constants

### EMPTY

```
const val EMPTY: MediaItem.RequestMetadata!
```

Empty request metadata.  

## Public functions

### buildUpon

```
fun buildUpon(): MediaItem.RequestMetadata.Builder!
```

Returns a[Builder](https://developer.android.com/reference/kotlin/androidx/media3/common/MediaItem.RequestMetadata.Builder)initialized with the values of this instance.  

### equals

```
fun equals(o: Any?): Boolean
```  

### fromBundle

```
@UnstableApi
java-static fun fromBundle(bundle: Bundle!): MediaItem.RequestMetadata!
```

Restores a`RequestMetadata`from a[Bundle](https://developer.android.com/reference/android/os/Bundle.html).  

### hashCode

```
fun hashCode(): Int
```  

### toBundle

```
@UnstableApi
fun toBundle(): Bundle!
```  

## Public properties

### extras

```
val extras: Bundle?
```

Optional extras[Bundle](https://developer.android.com/reference/android/os/Bundle.html).

Given the complexities of checking the equality of two[Bundle](https://developer.android.com/reference/android/os/Bundle.html)instances, the contents of these extras are not considered in the[equals](https://developer.android.com/reference/kotlin/androidx/media3/common/MediaItem.RequestMetadata#equals(java.lang.Object))or[hashCode](https://developer.android.com/reference/kotlin/androidx/media3/common/MediaItem.RequestMetadata#hashCode())implementation.  

### mediaUri

```
val mediaUri: Uri?
```

The URI of the requested media, or null if not known or applicable.  

### searchQuery

```
val searchQuery: String?
```

The search query for the requested media, or null if not applicable.