StuckPlayerException

Kotlin |Java

@UnstableApi
public final class StuckPlayerException extends IllegalStateException

java.lang.Object
↳	kotlin.Throwable
	↳	java.lang.Exception
		↳	java.lang.RuntimeException
			↳	java.lang.IllegalStateException
				↳	androidx.media3.common.util.StuckPlayerException

Exception thrown when the player is stuck in STATE_READY or STATE_BUFFERING while getPlayWhenReady is true without observable progress and no means of unblocking itself.

Summary

Nested types
`@Documented @Retention(value = RetentionPolicy.SOURCE) @Target(value = ElementType.TYPE_USE) @IntDef(value = ) public annotation StuckPlayerException.StuckType` The type of stuck playback.

Constants
`static final int`	`STUCK_BUFFERING_NOT_LOADING = 0` The player is stuck because it's in `STATE_BUFFERING`, needs to load more data to make progress, but is not loading.
`static final int`	`STUCK_BUFFERING_NO_PROGRESS = 1` The player is stuck because it's in `STATE_BUFFERING`, but no loading progress is made and the player is also not able to become ready.
`static final int`	`STUCK_PLAYING_NOT_ENDING = 3` The player is stuck because it's in `STATE_READY`, but it's not able to end playback despite exceeding the declared duration.
`static final int`	`STUCK_PLAYING_NO_PROGRESS = 2` The player is stuck because it's in `STATE_READY`, but no progress is made.
`static final int`	`STUCK_SUPPRESSED = 4` The player is stuck with a suppression reason other than `PLAYBACK_SUPPRESSION_REASON_NONE` or `PLAYBACK_SUPPRESSION_REASON_TRANSIENT_AUDIO_FOCUS_LOSS`.

Public fields
`final int`	`@StuckPlayerException.StuckType stuckType` The type of stuck playback.
`final int`	`timeoutMs` The timeout after which the exception was triggered, in milliseconds.

Public constructors
`StuckPlayerException( @StuckPlayerException.StuckType int stuckType, int timeoutMs )` Creates an instance.

Public methods
`boolean`	`equals(@Nullable Object obj)`
`int`	`hashCode()`

Inherited methods

From java.lang.Throwable

`synchronized final void`	`addSuppressed(Throwable exception)`
`synchronized Throwable`	`fillInStackTrace()`
`synchronized Throwable`	`getCause()`
`String`	`getLocalizedMessage()`
`String`	`getMessage()`
`StackTraceElement[]`	`getStackTrace()`
`synchronized final Throwable[]`	`getSuppressed()`
`synchronized Throwable`	`initCause(Throwable cause)`
`void`	`printStackTrace()`
`void`	`setStackTrace(StackTraceElement[] stackTrace)`
`String`	`toString()`

Constants

STUCK_BUFFERING_NOT_LOADING

public static final int STUCK_BUFFERING_NOT_LOADING = 0

The player is stuck because it's in STATE_BUFFERING, needs to load more data to make progress, but is not loading.

STUCK_BUFFERING_NO_PROGRESS

public static final int STUCK_BUFFERING_NO_PROGRESS = 1

The player is stuck because it's in STATE_BUFFERING, but no loading progress is made and the player is also not able to become ready.

STUCK_PLAYING_NOT_ENDING

public static final int STUCK_PLAYING_NOT_ENDING = 3

The player is stuck because it's in STATE_READY, but it's not able to end playback despite exceeding the declared duration.

STUCK_PLAYING_NO_PROGRESS

public static final int STUCK_PLAYING_NO_PROGRESS = 2

The player is stuck because it's in STATE_READY, but no progress is made.

STUCK_SUPPRESSED

public static final int STUCK_SUPPRESSED = 4

The player is stuck with a suppression reason other than PLAYBACK_SUPPRESSION_REASON_NONE or PLAYBACK_SUPPRESSION_REASON_TRANSIENT_AUDIO_FOCUS_LOSS.

Public fields

stuckType

@StuckPlayerException.StuckType
public final int stuckType

The type of stuck playback.

timeoutMs

public final int timeoutMs

The timeout after which the exception was triggered, in milliseconds.

Public constructors