Set up a player (iOS)

To set up a player, use either JWPlayerViewController(iOS) or JWCinematicViewController(tvOS). Like any UIViewController, either view controller can be presented in the following ways:

• Presented directly (full screen)
• Embedded in a container view (partial screen)<sup>1
  1. The JWCinematicViewController is intended to only be presented directly in full screen.</sup>

Both view controllers use the default JWP user interface. If you subclass the view controller, you can listen for all of the events related to the player and the user interface.

Implementation

Use the following steps to set up a player with the JWPlayerViewController or JWCinematicViewController:

Using Player APIs

Content Handling APIs

To use the player content handling APIs, the playerIsReady (iOS | tvOS) event must have already been initiated. The playerIsReady event is called once the player property of the JWPlayerViewController or JWCinematicViewController object has finished setup. Then, the event is sent to the JWPlayerDelegate.

Unless set to another object, the JWPlayerDelegate is set to the JWPlayerViewController.

🚧

When subclassing either view controller, do not override the delegates in JWPlayerView or JWPlayer.

Values related to the currently loaded item such as player.currentItem will be set once the didLoadPlaylistItem delegate method is called.

   // MARK: - JWPlayerDelegate
 
   // Player is ready
   override func jwplayerIsReady(_ player: JWPlayer) {
   }
 
   // Setup error, player is not ready
   override func jwplayer(_ player: JWPlayer, failedWithSetupError code: UInt, message: String) {
   }

The content handling APIs are listed below:

Non-content Handling APIs

APIs that do not relate to content handling can be accessed and used prior to the playerIsReady event being initiated.

The non-content handling APIs are listed in the following table.