Utilizzare l'SDK IMA per Android con Android TV

Quando utilizzi l'SDK IMA per Android, ti consigliamo diverse best practice per assicurarti che la tua app funzioni correttamente su Android TV.

Per iniziare, familiarizza con lo sviluppo di app TV per Android. In particolare, assicurati che la tua Attività sia configurata per la TV come spiegato nella guida introduttiva. Inoltre, devi gestire la navigazione sulla TV per assicurarti che gli utenti possano navigare facilmente nella tua app su Android TV.

Gestire gli annunci ignorabili

L'SDK ottimizza i formati ignorabili per i dispositivi simili a TV, ad esempiorimuovendo la possibilità di interagire con un pulsante Scopri di più. Per impostazione predefinita, l'SDK imposta lo stato attivo sul pulsante di avanzamento quando è disponibile, in modo che l'annuncio possa essere saltato su Android TV. Di conseguenza, non è necessaria alcuna operazione aggiuntiva per supportare gli annunci ignorabili.

Puoi configurarlo chiamando AdsRenderingSettings.setFocusSkipButtonWhenAvailable().

Per ulteriori informazioni sugli annunci supportati, consulta la matrice di compatibilità.

Gestire le immagini di riserva delle icone VAST

L'SDK IMA rileva, esegue il rendering e gestisce l'interazione dell'utente con le immagini di riserva dell'icona VAST. La tua app deve ascoltare gli eventi ICON_TAPPED e ICON_FALLBACK_IMAGE_CLOSED per gestire la riproduzione degli annunci che utilizzano "Perché questo annuncio?" (WTA).

Aggiungi un valore booleano per monitorare se viene visualizzata un'immagine di riserva dell'icona VAST. Poi, ascolta i controlli ICON_TAPPED e ICON_FALLBACK_IMAGE_CLOSED per gestire la riproduzione dell'annuncio intorno all'immagine di riserva dell'icona VAST. Vedi il seguente snippet di codice per un esempio di come viene gestito questo comportamento in Esempio avanzato.

app/src/main/java/com/google/ads/interactivemedia/v3/samples/videoplayerapp/VideoPlayerController.java

// Copyright 2014 Google Inc. All Rights Reserved.

package com.google.ads.interactivemedia.v3.samples.videoplayerapp;

import android.app.UiModeManager;
import android.content.Context;

...

// Tracks if the SDK is playing an ad, since the SDK might not necessarily use
// the video player provided to play the video ad.
private boolean isAdPlaying;

// Tracks whether the SDK has a VAST icon fallback image showing.
private boolean isConnectedTvFallbackImageShowing = false;

// View that handles taps to toggle ad pause/resume during video playback.
private View playPauseToggle;

// View that we can write log messages to, to display in the UI.
private Logger log;

...

    adsManager.addAdEventListener(
        new AdEvent.AdEventListener() {
          /** Responds to AdEvents. */
          @Override
          public void onAdEvent(AdEvent adEvent) {

              ...

              case CONTENT_RESUME_REQUESTED:
                // AdEventType.CONTENT_RESUME_REQUESTED is fired when the ad is
                // completed and you should start playing your content.
                resumeContent();
                break;
              case ICON_TAPPED:
                // The user has tapped a VAST icon fallback image. On Android
                // mobile apps, the SDK will navigate to the landing page. On
                // Connected TV devices, the SDK will present a modal dialog
                // containing the VAST icon fallback image.

                // Check if the app is running on a TV device.
                UiModeManager uiModeManager = (UiModeManager) getSystemService(UI_MODE_SERVICE);
                if (uiModeManager.getCurrentModeType() == Configuration.UI_MODE_TYPE_TELEVISION) {
                  isConnectedTvFallbackImageShowing = true;
                }

                // Focus the IMA WebView for easier access to ad UI elements.
                adsManager.focus();
                break;
              case PAUSED:
                if (isConnectedTvFallbackImageShowing) {
                  // Do not show the controls; continue to leave the controls in
                  // the hands of the ads SDK.
                  break;
                }
                isAdPlaying = false;
                videoPlayerWithAdPlayback.enableControls();
                break;
              case ICON_FALLBACK_IMAGE_CLOSED:
                // The user has closed the VAST icon fallback image. This may
                // be a good time to resume ad playback if the user is ready to
                // continue playing the ad. This event only fires for Connected
                // TV devices.


                isConnectedTvFallbackImageShowing = false;
                adsManager.resume();
                break;
              case RESUMED:
                isAdPlaying = true;
                videoPlayerWithAdPlayback.disableControls();
                break;