preroll(atRate:completionHandler:)
Begins loading media data to prime the media pipelines for playback.
Declaration
nonisolated func preroll(atRate rate: Float, completionHandler: (@Sendable (Bool) -> Void)? = nil)nonisolated func preroll(atRate rate: Float) async -> BoolParameters
- 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 True if the data was loaded or False if there was a problem. For example, the value might be False 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 AVPlayer.Status.readyToPlay), this method throws an exception.