Add JavaDoc to some undocumented methods and move them

PiperOrigin-RevId: 527870443

Author: marcbaechinger

libraries/session/src/main/java/androidx/media3/session/MediaUtils.java

@@ -1427,13 +1427,7 @@ public static Pair<PlayerInfo, BundlingExclusions> mergePlayerInfo(
     return new Pair<>(mergedPlayerInfo, mergedBundlingExclusions);
   }
 
-  private static byte[] convertToByteArray(Bitmap bitmap) throws IOException {
-    try (ByteArrayOutputStream stream = new ByteArrayOutputStream()) {
-      bitmap.compress(Bitmap.CompressFormat.PNG, /* ignored */ 0, stream);
-      return stream.toByteArray();
-    }
-  }
-
+  /** Generates an array of {@code n} indices. */
   public static int[] generateUnshuffledIndices(int n) {
     int[] indices = new int[n];
     for (int i = 0; i < n; i++) {
@@ -1442,6 +1436,10 @@ public static int[] generateUnshuffledIndices(int n) {
     return indices;
   }
 
+  /**
+   * Calculates the buffered percentage of the given buffered position and the duration in
+   * milliseconds.
+   */
   public static int calculateBufferedPercentage(long bufferedPositionMs, long durationMs) {
     return bufferedPositionMs == C.TIME_UNSET || durationMs == C.TIME_UNSET
         ? 0
@@ -1450,26 +1448,38 @@ public static int calculateBufferedPercentage(long bufferedPositionMs, long dura
             : Util.constrainValue((int) ((bufferedPositionMs * 100) / durationMs), 0, 100);
   }
 
+  /**
+   * Sets media items with start index and position for the given {@link Player} by honoring the
+   * available commands.
+   *
+   * @param player The player to set the media items.
+   * @param mediaItemsWithStartPosition The media items, the index and the position to set.
+   */
   public static void setMediaItemsWithStartIndexAndPosition(
-      PlayerWrapper player, MediaSession.MediaItemsWithStartPosition mediaItemsWithStartPosition) {
+      Player player, MediaSession.MediaItemsWithStartPosition mediaItemsWithStartPosition) {
     if (mediaItemsWithStartPosition.startIndex == C.INDEX_UNSET) {
       if (player.isCommandAvailable(COMMAND_CHANGE_MEDIA_ITEMS)) {
         player.setMediaItems(mediaItemsWithStartPosition.mediaItems, /* resetPosition= */ true);
       } else if (!mediaItemsWithStartPosition.mediaItems.isEmpty()) {
         player.setMediaItem(
             mediaItemsWithStartPosition.mediaItems.get(0), /* resetPosition= */ true);
       }
-    } else {
-      if (player.isCommandAvailable(COMMAND_CHANGE_MEDIA_ITEMS)) {
-        player.setMediaItems(
-            mediaItemsWithStartPosition.mediaItems,
-            mediaItemsWithStartPosition.startIndex,
-            mediaItemsWithStartPosition.startPositionMs);
-      } else if (!mediaItemsWithStartPosition.mediaItems.isEmpty()) {
-        player.setMediaItem(
-            mediaItemsWithStartPosition.mediaItems.get(0),
-            mediaItemsWithStartPosition.startPositionMs);
-      }
+    } else if (player.isCommandAvailable(COMMAND_CHANGE_MEDIA_ITEMS)) {
+      player.setMediaItems(
+          mediaItemsWithStartPosition.mediaItems,
+          mediaItemsWithStartPosition.startIndex,
+          mediaItemsWithStartPosition.startPositionMs);
+    } else if (!mediaItemsWithStartPosition.mediaItems.isEmpty()) {
+      player.setMediaItem(
+          mediaItemsWithStartPosition.mediaItems.get(0),
+          mediaItemsWithStartPosition.startPositionMs);
+    }
+  }
+
+  private static byte[] convertToByteArray(Bitmap bitmap) throws IOException {
+    try (ByteArrayOutputStream stream = new ByteArrayOutputStream()) {
+      bitmap.compress(Bitmap.CompressFormat.PNG, /* ignored */ 0, stream);
+      return stream.toByteArray();
     }
   }