AVPlayerLayer Class Reference

Overview

AVPlayerLayer is a subclass of CALayer to which an AVPlayer object can direct its visual output.

You can create a layer as illustrated in the following code fragment:

AVPlayer *player = <#A configured AVPlayer object#>;

CALayer *superlayer = <#Get a CALayer#>;

AVPlayerLayer *playerLayer = [AVPlayerLayer playerLayerWithPlayer:player];

[superlayer addSublayer:playerLayer];

The videoGravity property defines how the video content is displayed within the player layer’s bounds rect.

The value for the contents key of a player layer is opaque and effectively read-only.

During playback, AVPlayer may compensate for temporal drift between its visual output and its audible output to one or more independently-clocked audio output devices by adjusting the timing of its associated player layers. The effects of these adjustments are usually very small; however, clients that wish to remain entirely unaffected by such adjustments may wish to place other layers for which timing is important into independently timed subtrees of their layer trees.

You can create arbitrary numbers of player layers with the same AVPlayer object. Only the most-recently-created player layer will actually display the video content on-screen.