Instance Property


The reason the player is currently waiting for playback to begin or resume.


var reasonForWaitingToPlay: AVPlayer.WaitingReason? { get }


When the value of the player’s timeControlStatus is AVPlayer.TimeControlStatus.waitingToPlayAtSpecifiedRate, you can use this property determine the reason the player is currently waiting for playback to begin or resume. Possible values for this property are:

The value of this property will be nil if the player’s timeControlStatus is a value other than AVPlayer.TimeControlStatus.waitingToPlayAtSpecifiedRate.

You can use the value of this property to conditionally show UI indicating the player's waiting state. This property is observable using Key-value observing.

See Also

Managing Automatic Waiting Behavior

var automaticallyWaitsToMinimizeStalling: Bool

A Boolean value that indicates whether the player should automatically delay playback in order to minimize stalling.

struct AVPlayer.WaitingReason

The reasons the player is waiting begin or resume playback.

var timeControlStatus: AVPlayer.TimeControlStatus

A status that indicates whether playback is currently in progress, paused indefinitely, or suspended while waiting for appropriate network conditions.

enum AVPlayer.TimeControlStatus

The player statuses indicating a playback rate change.

func playImmediately(atRate: Float)

Plays the available media data immediately, at the specified rate.

Beta Software

This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.

Learn more about using Apple's beta software