Class POBVideoRenderer

  • All Implemented Interfaces:
    com.pubmatic.sdk.common.ui.POBBannerRendering , com.pubmatic.sdk.video.player.POBVastPlayerListener , com.pubmatic.sdk.video.renderer.POBVideoRendering , com.pubmatic.sdk.webrendering.ui.POBOnSkipOptionUpdateListener , com.pubmatic.sdk.webrendering.ui.POBViewabilityTracker.OnViewabilityChangedListener

    
    public class POBVideoRenderer
     implements POBVideoRendering, POBVastPlayerListener, POBViewabilityTracker.OnViewabilityChangedListener, POBOnSkipOptionUpdateListener
                        

    Renderer class handles the Video Rendering and provides related callbacks

    • Nested Class Summary

      Nested Classes 
      Modifier and Type Class Description
    • Constructor Summary

      Constructors 
      Constructor Description
      POBVideoRenderer(POBVastPlayer vastPlayer, POBViewabilityTracker viewabilityTracker, String placementType, POBTrackerHandler trackerHandler) Constructs video renderer by using vast player, registers to setVastPlayerListener and set max threshold for wrapper calls and set the linearity for the vast player
    • Enum Constant Summary

      Enum Constants 
      Enum Constant Description
    • Constructor Detail

      • POBVideoRenderer

        POBVideoRenderer(POBVastPlayer vastPlayer, POBViewabilityTracker viewabilityTracker, String placementType, POBTrackerHandler trackerHandler)
        Constructs video renderer by using vast player, registers to setVastPlayerListener and set max threshold for wrapper calls and set the linearity for the vast player
        Parameters:
        vastPlayer - Vast Player instance
        viewabilityTracker - instance of POBViewabilityTracker to track view visibility
        placementType - Placement type either 'interstitial' or 'inline'
        trackerHandler - instance of POBTrackerHandler to handle tracker URL execution
    • Method Detail

      • renderAd

         void renderAd(@NonNull() POBAdDescriptor descriptor)

        Callback method gets called to prepare ad play inside Vast player

        Parameters:
        descriptor - ad descriptor
      • setAdRendererListener

         void setAdRendererListener(@Nullable() POBAdRendererListener listener)

        Registers to POBAdRendererListener

        Parameters:
        listener - ad renderer listener
      • proceedAdSkip

         void proceedAdSkip(boolean skip)

        Method to notify video renderer to proceed to skip depending on skip parameter value.

        Parameters:
        skip - Value for skip
      • destroy

         void destroy()

        To do cleanup

      • onReadyToPlay

         void onReadyToPlay(@Nullable() POBVastAd vastAd, float skipOffset)

        Callback method, gets called when content is available and Vast player is ready to ad Also notifies it to reference of POBAdRendererListener

      • onPlaybackCompleted

         void onPlaybackCompleted(float duration)

        Notifies when video content is played completely and end card is about to show.

        Parameters:
        duration - selected media file duration
      • onFailedToPlay

         void onFailedToPlay(@NonNull() POBError error)

        Callback method, gets called when failed to load/play vast ad Also notifies it to reference of POBAdRendererListener

        Parameters:
        error - the error of POBVastError which has specific error codes with its specific error
      • onOpenLandingPage

         void onOpenLandingPage(@Nullable() String url)

        Callback method, gets called when landing page is about to open Open the url either in internal browser/ external browser or opens up specific app if url is deep link supported and notifies specific POBAdRendererListener callbacks

        Parameters:
        url - the url which gets called on landing page
      • onIndustryIconClick

         void onIndustryIconClick(@Nullable() String url)

        Callback method, gets called when landing page is about to open on industry icon click.

        Parameters:
        url - the url which gets called on landing page
      • shouldForwardClickEvent

         void shouldForwardClickEvent()

        Notifies whether click should be forwarded or not Note: This event should be fired in case of MRAID end card click

      • onDsaInfoIconClick

         void onDsaInfoIconClick()

        Notifies to show the DSA info detail screen

      • onSkip

         void onSkip()

        Callback method, gets called when skip button is about to click

      • onClose

         void onClose()

        Callback method which notifies interaction callback to POBAdRendererListener reference

      • onVideoStarted

         void onVideoStarted(float duration, float playerVolume)

        Notifies when first frame of video is rendered.

        Parameters:
        duration - selected media file duration
        playerVolume - media player volume
      • setMeasurementProvider

         void setMeasurementProvider(@Nullable() POBVideoMeasurementProvider measurementProvider)

        Set measurement provider to manage video viewability.

        Parameters:
        measurementProvider - the reference of POBVideoMeasurementProvider
      • setExpirationTimeout

         void setExpirationTimeout(long timeOut)

        Sets an Ad expiration time out value in milli seconds.

        Parameters:
        timeOut - Expiration time out value in milli seconds