Add RequestMetadata to MediaItem

These fields can be used to transport additional request properties
when the requester doesn't know the details needed for the actual
playback (i.e. the LocalConfiguration).

PiperOrigin-RevId: 451857093

libraries/common/src/test/java/androidx/media3/common/MediaItemTest.java

@@ -19,6 +19,8 @@ import static com.google.common.truth.Truth.assertThat;
 import static org.junit.Assert.assertThrows;
 
 import android.net.Uri;
+import android.os.Bundle;
+import androidx.media3.common.MediaItem.RequestMetadata;
 import androidx.test.ext.junit.runners.AndroidJUnit4;
 import com.google.common.collect.ImmutableList;
 import com.google.common.collect.ImmutableMap;
@@ -580,6 +582,24 @@ public class MediaItemTest {
   }
 
   @Test
+  public void builder_setRequestMetadata_setsRequestMetadata() {
+    Bundle extras = new Bundle();
+    extras.putString("key", "value");
+    RequestMetadata requestMetadata =
+        new RequestMetadata.Builder()
+            .setMediaUri(Uri.parse("http://test.test"))
+            .setSearchQuery("Play media!")
+            .setExtras(extras)
+            .build();
+
+    MediaItem mediaItem =
+        new MediaItem.Builder().setMediaId("mediaID").setRequestMetadata(requestMetadata).build();
+
+    assertThat(mediaItem.requestMetadata).isEqualTo(requestMetadata);
+    assertThat(mediaItem.requestMetadata.extras.getString("key")).isEqualTo("value");
+  }
+
+  @Test
   @SuppressWarnings("deprecation") // Testing deprecated setter methods
   public void buildUpon_individualSetters_equalsToOriginal() {
     MediaItem mediaItem =
@@ -677,6 +697,11 @@ public class MediaItemTest {
                         .setLabel("label")
                         .setId("id")
                         .build()))
+            .setRequestMetadata(
+                new RequestMetadata.Builder()
+                    .setMediaUri(Uri.parse("http://test.test"))
+                    .setSearchQuery("search")
+                    .build())
             .setTag(new Object())
             .build();
 
@@ -704,6 +729,11 @@ public class MediaItemTest {
             .setClipRelativeToDefaultPosition(true)
             .setClipRelativeToLiveWindow(true)
             .setClipStartsAtKeyFrame(true)
+            .setRequestMetadata(
+                new RequestMetadata.Builder()
+                    .setMediaUri(Uri.parse("http://test.test"))
+                    .setSearchQuery("search")
+                    .build())
             .build();
 
     assertThat(mediaItem.localConfiguration).isNull();