Pakiet IMA SDK na Androida z Androidem TV

Aby zapewnić prawidłowe działanie aplikacji na Androidzie TV podczas korzystania z pakietu IMA SDK na Androida, zalecamy stosowanie kilku sprawdzonych metod.

Zacznij od zapoznania się z informacjami o tworzeniu aplikacji telewizyjnych na Androida. Sprawdź, czy aktywność jest skonfigurowana dla telewizji w sposób opisany w przewodniku dla początkujących. Musisz też obsługiwać nawigację po telewizorach, aby użytkownicy mogli sprawnie poruszać się po Twojej aplikacji na Androidzie TV.

Obsługa reklam możliwych do pominięcia

Pakiet SDK optymalizuje formaty, które można pominąć, na urządzeniach podobnych do telewizorów, np. przez usunięcie możliwości interakcji za pomocą przycisku Więcej informacji. Domyślnie pakiet SDK ustawia fokus na przycisku pominięcia, gdy jest on dostępny, aby można było pominąć reklamę na Androidzie TV. Dlatego nie musisz nic robić, aby wyświetlać reklamy pomijalne.

Aby to skonfigurować, wywołaj AdsRenderingSettings.setFocusSkipButtonWhenAvailable().

Więcej informacji o obsługiwanych reklamach znajdziesz w tabeli zgodności.

Obsługa obrazów zastępczych ikony VAST

Pakiet IMA SDK wykrywa, renderuje i obsługuje interakcję użytkownika z obrazami zastępczymi ikony VAST. Aplikacja powinna nasłuchiwać zdarzeń ICON_TAPPED i ICON_FALLBACK_IMAGE_CLOSED, aby obsługiwać odtwarzanie reklam, które korzystają z przycisku „Dlaczego ta reklama?” (WTA).

Dodaj wartość logiczną, aby śledzić, czy wyświetla się obraz zastępczy ikony VAST. Następnie czekaj na żądania ICON_TAPPED i ICON_FALLBACK_IMAGE_CLOSED, aby obsłużyć odtwarzanie reklamy wokół obrazu kreacji zastępczej ikony VAST. Poniżej znajdziesz fragment kodu, który pokazuje, jak to działa w przykładzie zaawansowanym.

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;