From 4a6f431f01bd4cdb6754d5a897cad307eebe4d34 Mon Sep 17 00:00:00 2001
From: ibaker <ibaker@google.com>
Date: Wed, 8 Jun 2022 08:31:29 +0000
Subject: [PATCH] Clarify that `ShuffleOrder` must be consistent in both
 directions

#minor-release

PiperOrigin-RevId: 453622964
---
 .../java/androidx/media3/exoplayer/source/ShuffleOrder.java    | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/libraries/exoplayer/src/main/java/androidx/media3/exoplayer/source/ShuffleOrder.java b/libraries/exoplayer/src/main/java/androidx/media3/exoplayer/source/ShuffleOrder.java
index 6d75f13b53..e6e2e1b2dc 100644
--- a/libraries/exoplayer/src/main/java/androidx/media3/exoplayer/source/ShuffleOrder.java
+++ b/libraries/exoplayer/src/main/java/androidx/media3/exoplayer/source/ShuffleOrder.java
@@ -24,6 +24,9 @@ import java.util.Random;
  * Shuffled order of indices.
  *
  * <p>The shuffle order must be immutable to ensure thread safety.
+ *
+ * <p>The order must be consistent when traversed both {@linkplain #getNextIndex(int) forwards} and
+ * {@linkplain #getPreviousIndex(int) backwards}.
  */
 @UnstableApi
 public interface ShuffleOrder {