AVSynchronizedLayer Class Reference

Inherits from
Conforms to
Framework
/System/Library/Frameworks/AVFoundation.framework
Availability
Available in iOS 4.0 and later.
Companion guide
Declared in
AVSynchronizedLayer.h

Overview

AVSynchronizedLayer a subclass of CALayer with layer timing that synchronizes with a specific AVPlayerItem.

You can create an arbitrary number of synchronized layers from the same AVPlayerItem object.

A synchronized layer is similar to a CATransformLayer object in that it doesn't display anything itself, it just confers state upon its layer subtree. AVSynchronizedLayer confers its timing state, synchronizing the timing of layers in its subtree with that of a player item.

You might use a layer as shown in the following example:

AVPlayerItem *playerItem = <#Get a player item#>;
CALayer *superLayer =  <#Get a layer#>;
// Set up a synchronized layer to sync the layer timing of its subtree
// with the playback of the playerItem/
AVSynchronizedLayer *syncLayer = [AVSynchronizedLayer synchronizedLayerWithPlayerItem:playerItem];
[syncLayer addSublayer:<#Another layer#>];    // These sublayers will be synchronized.
[superLayer addSublayer:syncLayer];

Tasks

Creating a Synchronized Layer

Managing the Player Item

Properties

playerItem

The player item to which the timing of the layer is synchronized.

@property(nonatomic, retain) AVPlayerItem *playerItem
Availability
  • Available in iOS 4.0 and later.
Declared In
AVSynchronizedLayer.h

Class Methods

synchronizedLayerWithPlayerItem:

Returns a new synchronized layer with timing synchronized with a given player item.

+ (AVSynchronizedLayer *)synchronizedLayerWithPlayerItem:(AVPlayerItem *)playerItem
Parameters
playerItem

A player item.

Return Value

A new synchronized layer with timing synchronized with playerItem.

Availability
  • Available in iOS 4.0 and later.
Declared In
AVSynchronizedLayer.h