Instance Method

playableContentManager(_:initializePlaybackQueueWithCompletionHandler:)

Asks the delegate to prepare suggested content for playback.

Declaration

optional func playableContentManager(_ contentManager: MPPlayableContentManager, initializePlaybackQueueWithCompletionHandler completionHandler: @escaping (Error?) -> Void)

Parameters

contentManager

The content manager that initiated the request.

completionHandler

A block to call after content is ready for playback.

The block takes the following parameter:

error

If you have successfully prepared content for playback, pass nil. If you cannot prepare content due to an error, pass an NSError object.

Discussion

iOS calls this method when the user performs an action that, in context, might indicate intent to begin playing content using your app. For example, if the user frequently listens to audio content in your app with headphones while at a particular location, iOS might call this method upon plugging in headphones when the user is at that location. Your app responds by choosing appropriate content, performing any app-specific actions necessary to prepare the content for playback, and setting the nowPlayingInfo property of the shared MPNowPlayingInfoCenter object to indicate to the user that this content is ready to play.

After preparing content for playing, call the provided completionHandler block with an argument of nil; or, if your app cannot prepare content, call the completion handler with an NSError object describing the error.

See Also

Suggesting Content for Playback