Instance Method

prerollAtRate:completionHandler:

Begins loading media data to prime the media pipelines for playback.

Declaration

- (void)prerollAtRate:(float)rate completionHandler:(void (^)(BOOL finished))completionHandler;

Parameters

rate

The playback rate to use when determining how much data to load.

completionHandler

A block to execute when the player finishes the load attempt. This block takes a single Boolean parameter that contains YES if the data was loaded or NO if there was a problem. For example, the value might be NO if the preroll was interrupted by a time change or incompatible rate change.

Discussion

This method loads data starting at the item’s current playback time. The current rate for the playback item should always be 0 prior to calling this method. After the method calls the completion handler, you can change the item’s playback rate to begin playback.

If the player object is not ready to play (its status property is not AVPlayerStatusReadyToPlay), this method throws an exception.

See Also

Synchronizing Playback to an External Source

- setRate:time:atHostTime:

Synchronizes the playback rate and time of the current item with an external source.

- cancelPendingPrerolls

Cancels any pending preroll requests and invokes the corresponding completion handlers if present.

masterClock

The master clock used for item time bases.