StuckPlayerException

Artifact: androidx.media3:media3-common

View Source

---

Kotlin |Java

@UnstableApi
class StuckPlayerException : IllegalStateException

kotlin.Any
↳	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 = ) annotation StuckPlayerException.StuckType The type of stuck playback.

Constants
const 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.
const 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.
const 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.
const Int	STUCK_PLAYING_NO_PROGRESS = 2 The player is stuck because it's in STATE_READY, but no progress is made.
const 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 constructors
StuckPlayerException(     @StuckPlayerException.StuckType stuckType: Int,     timeoutMs: Int ) Creates an instance.

Public functions
Boolean	equals(obj: Any?)
Int	hashCode()

Public properties
Int	@StuckPlayerException.StuckType stuckType The type of stuck playback.
Int	timeoutMs The timeout after which the exception was triggered, in milliseconds.

Inherited functions

From java.lang.Throwable synchronized Unit addSuppressed(exception: Throwable!) synchronized Throwable! fillInStackTrace() synchronized Throwable! getCause() String! getLocalizedMessage() String! getMessage() Array<StackTraceElement!>! getStackTrace() synchronized Array<Throwable!>! getSuppressed() synchronized Throwable! initCause(cause: Throwable!) Unit printStackTrace() Unit setStackTrace(stackTrace: Array<StackTraceElement!>!) String! toString()

Constants

STUCK_BUFFERING_NOT_LOADING

const val STUCK_BUFFERING_NOT_LOADING = 0: Int

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

const val STUCK_BUFFERING_NO_PROGRESS = 1: Int

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

const val STUCK_PLAYING_NOT_ENDING = 3: Int

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

const val STUCK_PLAYING_NO_PROGRESS = 2: Int

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

STUCK_SUPPRESSED

const val STUCK_SUPPRESSED = 4: Int

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

Public constructors

StuckPlayerException

StuckPlayerException(
    @StuckPlayerException.StuckType stuckType: Int,
    timeoutMs: Int
)

Creates an instance.

Parameters
@StuckPlayerException.StuckType stuckType: Int	The type of stuck playback.
timeoutMs: Int	The timeout after which the exception was triggered, in milliseconds.

Public functions

equals

fun equals(obj: Any?): Boolean

hashCode

fun hashCode(): Int

Public properties

stuckType

@StuckPlayerException.StuckType
val stuckType: Int

The type of stuck playback.

timeoutMs

val timeoutMs: Int

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