PlayerManager

The provider that supplies the underlying player instance used for media playback.

Provides access to available ad breaks for content, also capable of converting stream time to content time and vice versa

Manages the available media tracks (such as audio and subtitles) during playback.

Manages the available playback queue next/previous items

Manages default user interface components related to media playback, if default is selected during initialization of PlayerManager.

A boolean value that indicates whether the player is muted.

The isMuted property allows you to mute or unmute the player. Setting this property to true mutes the audio, while setting it to false unmutes it.

The current stream time in seconds.

The currentTime property returns the current position of the playback in seconds(includes SSAI ads time if available, use adBreaksManager.timeConverter to exclude ads if needed). If no content is loaded or the current time is unavailable, this property returns nil.

The total duration in seconds

The duration property returns the full length of the content in seconds(includes SSAI ads time if available, use adBreaksManager.timeConverter to exclude ads if needed). If the duration is unavailable (e.g., for live streams or unbuffered content), this property returns nil.

The seekable range, represented as a start and end time in seconds.

The seekableRanges property provides the start and end points of the portion of the content(includes SSAI ads time if available, use adBreaksManager.timeConverter to exclude ads if needed)

The current playback rate of the player.

The playbackRate property reflects the speed at which the player is playing the content. A value of 1.0 indicates normal speed, while values greater than 1.0 indicate fast-forward, and values less than 1.0 indicate slow-motion playback.

The current state of the player, represented by a DorisPlayerState value.

The playerState property provides information about the current state of the player, such as whether it is playing, paused, buffering, failed etc. This state can be used to control the player behavior or update the UI based on the current state.

Loads the specified media source and begins playback.

The load method initializes the media player with the provided ResolvableSource and starts playback. This method can handle both on-demand and live content.

• Example:

  playerManager.load(source: myMediaSource) { error in
  if let error = error {
      print("Failed to resolve media: \(error)")
  }
  }
  

Unloads the currently loaded media, stopping playback, clears analytics services and releasing resources.

Equivalent of AVPlayer.replaceCurrentItem(with: nil)

The unload method stops the playback of the current media and releases any resources associated with it. This method can be used when the user navigates away from the media or when the app needs to free up memory.

Pauses the playback of the media.

The pause method temporarily halts playback, allowing it to be resumed later from the same position.

Starts or resumes the playback of the media.

The play method begins playing the loaded media. If the media is paused or stopped, this method resumes playback from the current position.

Seeks to a specified position in the media content.

The seek method allows you to move the playback position to a specified time or range within the content. This method can be used for fast-forwarding, rewinding, or jumping to a specific timestamp.

• Example:

  playerManager.seek(.position(30)) { isCompleted in
  if isCompleted {
      print("Seek completed successfully")
  } else {
      print("Seek failed")
  }
  }