Overview

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

You can create arbitrary numbers of player layers with the same AVPlayer object. 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 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.