Fast Channel Zapping

Fast Channel Zapping allows seamless switching between streams with minimal start up time (for both LIVE and VOD streams). This guide outlines the steps for integration, ensuring efficient playback transitions.

Steps to Preload Content

• Retrieve the playback URL and license URL (for DRM-protected content) by making a contentAuthorization call, similar to traditional playback.
• Build a player instance and keep track of it for later playback.
• Register a listener to handle playback state changes.
• Once the player is initialized, call player.load() to start content preloading.

  val playbackPropertiesBuilder = PlaybackProperties.Builder()
  playbackPropertiesBuilder.autoPlayOnLoad(false) // By default it's set to false at SDK level.
  val playbackProperties = playbackPropertiesBuilder.build()
  val playerBuilder = PlayerBuilder()
  .mediaURL(contentUrl)
  .mediaType(mediaType)
  .drmScheme(drmScheme)
  .playbackProperties(playbackProperties)
  .drmLicenseURL(drmLicenseURL)

  val simplePlayer = playerBuilder.build(context)

  val player = composablePlayerWith(simplePlayer)
  
  player.addListener(listener)
  player.load()

note

set autoPlayOnLoad false for pre-loaded contents which is by default false.

Steps to Start Playback of Preloaded Content

• Release previous player before switching content
• Use the player instance that was created during preloading.
• Once the player view is available, attach the renderer view.
• Wait for LOADED State and call play()

    val renderingContext = VideoRenderingContext(
                this@PlayerMultiviewFragment.playerRoot,
                FrameLayout.LayoutParams(
                    ViewGroup.LayoutParams.MATCH_PARENT,
                    ViewGroup.LayoutParams.MATCH_PARENT
                )
            )
    player.attachRendererView(
        renderingContext.renderer,
        renderingContext.rendererLayoutParams
    )
    player.play()

Important Considerations

• Release previous player before switching content.
• Attach renderer only when player view is available. If the view is not ready, wait until it is available.
• Playback should only begin when the player is fully loaded - wait for LOADED state.
• Introduce a short delay (100ms) only if any decoder issue is observed

Summary

Name	Action
Preload Content	Fetch content and DRM license URLs → Create Player → Attach Listener → Call load()
Start Playback	Release Previous Player → Ensure Renderer Ready → Wait for LOADED State → Call play()