Add getter for ShuffleOrder

Author: nift4

libraries/exoplayer/src/main/java/androidx/media3/exoplayer/ExoPlayer.java

@@ -1381,6 +1381,15 @@ void setMediaSources(
   @UnstableApi
   void setShuffleOrder(ShuffleOrder shuffleOrder);
 
+  /**
+   * Gets the shuffle order.
+   *
+   * <p>The {@link ShuffleOrder} returned will have the same length as the current playlist ({@link
+   * Player#getMediaItemCount()}).
+   */
+  @UnstableApi
+  ShuffleOrder getShuffleOrder();
+
   /**
    * Sets the {@linkplain PreloadConfiguration preload configuration} to configure playlist
    * preloading.

libraries/exoplayer/src/main/java/androidx/media3/exoplayer/ExoPlayerImpl.java

@@ -787,6 +787,12 @@ public void setShuffleOrder(ShuffleOrder shuffleOrder) {
         /* repeatCurrentMediaItem= */ false);
   }
 
+  @Override
+  public ShuffleOrder getShuffleOrder() {
+    verifyApplicationThread();
+    return shuffleOrder;
+  }
+
   @Override
   public void setPauseAtEndOfMediaItems(boolean pauseAtEndOfMediaItems) {
     verifyApplicationThread();

libraries/exoplayer/src/main/java/androidx/media3/exoplayer/SimpleExoPlayer.java

@@ -941,6 +941,12 @@ public void setShuffleOrder(ShuffleOrder shuffleOrder) {
     player.setShuffleOrder(shuffleOrder);
   }
 
+  @Override
+  public ShuffleOrder getShuffleOrder() {
+    blockUntilConstructorFinished();
+    return player.getShuffleOrder();
+  }
+
   @Override
   public void setPlayWhenReady(boolean playWhenReady) {
     blockUntilConstructorFinished();

libraries/test_utils/src/main/java/androidx/media3/test/utils/StubExoPlayer.java

@@ -176,6 +176,11 @@ public void setShuffleOrder(ShuffleOrder shuffleOrder) {
     throw new UnsupportedOperationException();
   }
 
+  @Override
+  public ShuffleOrder getShuffleOrder() {
+    throw new UnsupportedOperationException();
+  }
+
   @Override
   public void setAudioAttributes(AudioAttributes audioAttributes, boolean handleAudioFocus) {
     throw new UnsupportedOperationException();