Instance Property


A Boolean value that indicates whether the player should automatically switch to external playback mode while the external screen mode is active.


var usesExternalPlaybackWhileExternalScreenIsActive: Bool { get set }


The player will automatically switch back to the external screen mode once video playback concludes. A brief transition may be visible on the external display when automatically switching between the two modes. The default value of this property is false. The value of this property has no effect if allowsExternalPlayback is false.

See Also

Managing External Playback

var allowsExternalPlayback: Bool

A Boolean value that indicates whether the player allows switching to external playback mode.

var isExternalPlaybackActive: Bool

A Boolean value that indicates whether the player is currently playing video in external playback mode.

var externalPlaybackVideoGravity: AVLayerVideoGravity

The video gravity of the player for external playback mode only.

struct AVLayerVideoGravity

A value that defines how the video is displayed within a layer’s bounds rectangle.

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