diff --git a/libraries/test_utils_robolectric/src/main/java/androidx/media3/test/utils/robolectric/TestPlayerRunHelper.java b/libraries/test_utils_robolectric/src/main/java/androidx/media3/test/utils/robolectric/TestPlayerRunHelper.java index 1e15c895350..684917e17b8 100644 --- a/libraries/test_utils_robolectric/src/main/java/androidx/media3/test/utils/robolectric/TestPlayerRunHelper.java +++ b/libraries/test_utils_robolectric/src/main/java/androidx/media3/test/utils/robolectric/TestPlayerRunHelper.java @@ -340,8 +340,12 @@ public static void playUntilPosition(ExoPlayer player, int mediaItemIndex, long /** * Calls {@link Player#play()}, runs tasks of the main {@link Looper} until the {@code player} - * reaches the specified media item or a playback error occurs, and then pauses the {@code - * player}. + * reaches the specified media item or a playback error occurs. + * + *
The playback thread is automatically blocked from making further progress after reaching the + * media item and will only be unblocked by other {@code run/playUntil...} methods, custom {@link + * RobolectricUtil#runMainLooperUntil} conditions or an explicit {@link + * ThreadTestUtil#unblockThreadsWaitingForProgressOnCurrentLooper()} on the main thread. * *
If a playback error occurs it will be thrown wrapped in an {@link IllegalStateException}. *