Class ImaAdsLoader

    • Method Detail

      • getAdsLoader

        @Nullable
        public com.google.ads.interactivemedia.v3.api.AdsLoader getAdsLoader()
        Returns the underlying AdsLoader wrapped by this instance, or null if ads have not been requested yet.
      • getAdDisplayContainer

        @Nullable
        public com.google.ads.interactivemedia.v3.api.AdDisplayContainer getAdDisplayContainer()
        Returns the AdDisplayContainer used by this loader, or null if ads have not been requested yet.

        Note: any video controls overlays registered via BaseDisplayContainer.registerFriendlyObstruction(FriendlyObstruction) will be unregistered automatically when the media source detaches from this instance. It is therefore necessary to re-register views each time the ads loader is reused. Alternatively, provide overlay views via the AdViewProvider when creating the media source to benefit from automatic registration.

      • requestAds

        public void requestAds​(DataSpec adTagDataSpec,
                               Object adsId,
                               @Nullable
                               ViewGroup adViewGroup)
        Requests ads, if they have not already been requested. Must be called on the main thread.

        Ads will be requested automatically when the player is prepared if this method has not been called, so it is only necessary to call this method if you want to request ads before preparing the player.

        Parameters:
        adTagDataSpec - The data specification of the ad tag to load. See class javadoc for information about compatible ad tag formats.
        adsId - A opaque identifier for the ad playback state across start/stop calls.
        adViewGroup - A ViewGroup on top of the player that will show any ad UI, or null if playing audio-only ads.
      • skipAd

        public void skipAd()
        Skips the current ad.

        This method is intended for apps that play audio-only ads and so need to provide their own UI for users to skip skippable ads. Apps showing video ads should not call this method, as the IMA SDK provides the UI to skip ads in the ad view group passed via AdViewProvider.

      • focusSkipButton

        public void focusSkipButton()
        Moves UI focus to the skip button (or other interactive elements), if currently shown. See BaseManager.focus().
      • setPlayer

        public void setPlayer​(@Nullable
                              Player player)
        Description copied from interface: AdsLoader
        Sets the player that will play the loaded ads.

        This method must be called before the player is prepared with media using this ads loader.

        This method must also be called on the main thread and only players which are accessed on the main thread are supported (player.getApplicationLooper() == Looper.getMainLooper()).

        Specified by:
        setPlayer in interface AdsLoader
        Parameters:
        player - The player instance that will play the loaded ads. May be null to delete the reference to a previously set player.
      • start

        public void start​(AdsMediaSource adsMediaSource,
                          DataSpec adTagDataSpec,
                          Object adsId,
                          AdViewProvider adViewProvider,
                          AdsLoader.EventListener eventListener)
        Description copied from interface: AdsLoader
        Starts using the ads loader for playback. Called on the main thread by AdsMediaSource.
        Specified by:
        start in interface AdsLoader
        Parameters:
        adsMediaSource - The ads media source requesting to start loading ads.
        adTagDataSpec - A data spec for the ad tag to load.
        adsId - An opaque identifier for the ad playback state across start/stop calls.
        adViewProvider - Provider of views for the ad UI.
        eventListener - Listener for ads loader events.
      • stop

        public void stop​(AdsMediaSource adsMediaSource,
                         AdsLoader.EventListener eventListener)
        Description copied from interface: AdsLoader
        Stops using the ads loader for playback and deregisters the event listener. Called on the main thread by AdsMediaSource.
        Specified by:
        stop in interface AdsLoader
        Parameters:
        adsMediaSource - The ads media source requesting to stop loading/playing ads.
        eventListener - The ads media source's listener for ads loader events.
      • release

        public void release()
        Description copied from interface: AdsLoader
        Releases the loader. Must be called by the application on the main thread when the instance is no longer needed.
        Specified by:
        release in interface AdsLoader
      • handlePrepareComplete

        public void handlePrepareComplete​(AdsMediaSource adsMediaSource,
                                          int adGroupIndex,
                                          int adIndexInAdGroup)
        Description copied from interface: AdsLoader
        Notifies the ads loader that preparation of an ad media period is complete. Called on the main thread by AdsMediaSource.
        Specified by:
        handlePrepareComplete in interface AdsLoader
        Parameters:
        adsMediaSource - The ads media source for which preparation of ad media completed.
        adGroupIndex - The index of the ad group.
        adIndexInAdGroup - The index of the ad in the ad group.
      • handlePrepareError

        public void handlePrepareError​(AdsMediaSource adsMediaSource,
                                       int adGroupIndex,
                                       int adIndexInAdGroup,
                                       IOException exception)
        Description copied from interface: AdsLoader
        Notifies the ads loader that the player was not able to prepare media for a given ad. Implementations should update the ad playback state as the specified ad has failed to load. Called on the main thread by AdsMediaSource.
        Specified by:
        handlePrepareError in interface AdsLoader
        Parameters:
        adsMediaSource - The ads media source for which preparation of ad media failed.
        adGroupIndex - The index of the ad group.
        adIndexInAdGroup - The index of the ad in the ad group.
        exception - The preparation error.