TestPlayerRunHelper (ExoPlayer library)

java.lang.Object
- com.google.android.exoplayer2.robolectric.TestPlayerRunHelper

```
public class TestPlayerRunHelper
extends Object
```
Helper methods to block the calling thread until the provided SimpleExoPlayer instance reaches a particular state.

Method Summary

All Methods Static Methods Concrete Methods
Modifier and Type	Method	Description
`static void`	`playUntilPosition(ExoPlayer player, int windowIndex, long positionMs)`	Calls `Player.play()`, runs tasks of the main `Looper` until the `player` reaches the specified position and then pauses the `player`.
`static void`	`playUntilStartOfWindow(ExoPlayer player, int windowIndex)`	Calls `Player.play()`, runs tasks of the main `Looper` until the `player` reaches the specified window and then pauses the `player`.
`static ExoPlaybackException`	`runUntilError(Player player)`	Runs tasks of the main `Looper` until a player error occurred.
`static void`	`runUntilPendingCommandsAreFullyHandled(ExoPlayer player)`	Runs tasks of the main `Looper` until the player completely handled all previously issued commands on the internal playback thread.
`static void`	`runUntilPlaybackState(Player player, int expectedState)`	Runs tasks of the main `Looper` until `Player.getPlaybackState()` matches the expected state.
`static void`	`runUntilPlayWhenReady(Player player, boolean expectedPlayWhenReady)`	Runs tasks of the main `Looper` until `Player.getPlayWhenReady()` matches the expected value.
`static void`	`runUntilPositionDiscontinuity(Player player, int expectedReason)`	Runs tasks of the main `Looper` until a `Player.EventListener.onPositionDiscontinuity(int)` callback with the specified `Player.DiscontinuityReason` occurred.
`static boolean`	`runUntilReceiveOffloadSchedulingEnabledNewState(Player player)`	Runs tasks of the main `Looper` until a `Player.EventListener.onExperimentalOffloadSchedulingEnabledChanged(boolean)` callback occurred.
`static void`	`runUntilRenderedFirstFrame(SimpleExoPlayer player)`	Runs tasks of the main `Looper` until the `VideoListener.onRenderedFirstFrame()` callback has been called.
`static void`	`runUntilSleepingForOffload(Player player, boolean expectedSleepForOffload)`	Runs tasks of the main `Looper` until a `Player.EventListener.onExperimentalSleepingForOffloadChanged(boolean)` callback occurred.
`static Timeline`	`runUntilTimelineChanged(Player player)`	Runs tasks of the main `Looper` until a timeline change occurred.
`static void`	`runUntilTimelineChanged(Player player, Timeline expectedTimeline)`	Runs tasks of the main `Looper` until `Player.getCurrentTimeline()` matches the expected timeline.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Method Detail
  - runUntilPlaybackState
```
public static void runUntilPlaybackState(Player player,
                                         @State
                                         int expectedState)
                                  throws TimeoutException
```
    Runs tasks of the main Looper until Player.getPlaybackState() matches the expected state.
    
    Parameters:
    
    player - The Player.
    
    expectedState - The expected Player.State.
    
    Throws:
    
    TimeoutException - If the default timeout is exceeded.
  - runUntilPlayWhenReady
```
public static void runUntilPlayWhenReady(Player player,
                                         boolean expectedPlayWhenReady)
                                  throws TimeoutException
```
    Runs tasks of the main Looper until Player.getPlayWhenReady() matches the expected value.
    
    Parameters:
    
    player - The Player.
    
    expectedPlayWhenReady - The expected value for Player.getPlayWhenReady().
    
    Throws:
    
    TimeoutException - If the default timeout is exceeded.
  - runUntilTimelineChanged
```
public static void runUntilTimelineChanged(Player player,
                                           Timeline expectedTimeline)
                                    throws TimeoutException
```
    Runs tasks of the main Looper until Player.getCurrentTimeline() matches the expected timeline.
    
    Parameters:
    
    player - The Player.
    
    expectedTimeline - The expected Timeline.
    
    Throws:
    
    TimeoutException - If the default timeout is exceeded.
  - runUntilTimelineChanged
```
public static Timeline runUntilTimelineChanged(Player player)
                                        throws TimeoutException
```
    Runs tasks of the main Looper until a timeline change occurred.
    
    Parameters:
    
    player - The Player.
    
    Returns:
    
    The new Timeline.
    
    Throws:
    
    TimeoutException - If the default timeout is exceeded.
  - runUntilPositionDiscontinuity
```
public static void runUntilPositionDiscontinuity(Player player,
                                                 @DiscontinuityReason
                                                 int expectedReason)
                                          throws TimeoutException
```
    Runs tasks of the main Looper until a Player.EventListener.onPositionDiscontinuity(int) callback with the specified Player.DiscontinuityReason occurred.
    
    Parameters:
    
    player - The Player.
    
    expectedReason - The expected Player.DiscontinuityReason.
    
    Throws:
    
    TimeoutException - If the default timeout is exceeded.
  - runUntilError
```
public static ExoPlaybackException runUntilError(Player player)
                                          throws TimeoutException
```
    Runs tasks of the main Looper until a player error occurred.
    
    Parameters:
    
    player - The Player.
    
    Returns:
    
    The raised ExoPlaybackException.
    
    Throws:
    
    TimeoutException - If the default timeout is exceeded.
  - runUntilReceiveOffloadSchedulingEnabledNewState
```
public static boolean runUntilReceiveOffloadSchedulingEnabledNewState(Player player)
                                                               throws TimeoutException
```
    Runs tasks of the main Looper until a Player.EventListener.onExperimentalOffloadSchedulingEnabledChanged(boolean) callback occurred.
    
    Parameters:
    
    player - The Player.
    
    Returns:
    
    The new offloadSchedulingEnabled state.
    
    Throws:
    
    TimeoutException - If the default timeout is exceeded.
  - runUntilSleepingForOffload
```
public static void runUntilSleepingForOffload(Player player,
                                              boolean expectedSleepForOffload)
                                       throws TimeoutException
```
    Runs tasks of the main Looper until a Player.EventListener.onExperimentalSleepingForOffloadChanged(boolean) callback occurred.
    
    Parameters:
    
    player - The Player.
    
    expectedSleepForOffload - The expected sleep of offload state.
    
    Throws:
    
    TimeoutException - If the default timeout is exceeded.
  - runUntilRenderedFirstFrame
```
public static void runUntilRenderedFirstFrame(SimpleExoPlayer player)
                                       throws TimeoutException
```
    Runs tasks of the main Looper until the VideoListener.onRenderedFirstFrame() callback has been called.
    
    Parameters:
    
    player - The Player.
    
    Throws:
    
    TimeoutException - If the default timeout is exceeded.
  - playUntilPosition
```
public static void playUntilPosition(ExoPlayer player,
                                     int windowIndex,
                                     long positionMs)
                              throws TimeoutException
```
    Calls Player.play(), runs tasks of the main Looper until the player reaches the specified position and then pauses the player.
    
    Parameters:
    
    player - The Player.
    
    windowIndex - The window.
    
    positionMs - The position within the window, in milliseconds.
    
    Throws:
    
    TimeoutException - If the default timeout is exceeded.
  - playUntilStartOfWindow
```
public static void playUntilStartOfWindow(ExoPlayer player,
                                          int windowIndex)
                                   throws TimeoutException
```
    Calls Player.play(), runs tasks of the main Looper until the player reaches the specified window and then pauses the player.
    
    Parameters:
    
    player - The Player.
    
    windowIndex - The window.
    
    Throws:
    
    TimeoutException - If the default timeout is exceeded.
  - runUntilPendingCommandsAreFullyHandled
```
public static void runUntilPendingCommandsAreFullyHandled(ExoPlayer player)
                                                   throws TimeoutException
```
    Runs tasks of the main Looper until the player completely handled all previously issued commands on the internal playback thread.
    
    Parameters:
    
    player - The Player.
    
    Throws:
    
    TimeoutException - If the default timeout is exceeded.

Class TestPlayerRunHelper

Method Summary

Methods inherited from class java.lang.Object

Method Detail

runUntilPlaybackState

runUntilPlayWhenReady

runUntilTimelineChanged

runUntilTimelineChanged

runUntilPositionDiscontinuity

runUntilError

runUntilReceiveOffloadSchedulingEnabledNewState

runUntilSleepingForOffload

runUntilRenderedFirstFrame

playUntilPosition

playUntilStartOfWindow

runUntilPendingCommandsAreFullyHandled