Sử dụng SDK IMA cho Android với Android TV

Bạn nên áp dụng một số phương pháp hay nhất để đảm bảo ứng dụng của mình hoạt động đúng cách trên Android TV khi sử dụng SDK IMA cho Android.

Hãy bắt đầu bằng cách làm quen với việc phát triển ứng dụng cho TV trên Android. Cụ thể, hãy đảm bảo rằng bạn đã thiết lập Hoạt động cho TV như được giải thích trong hướng dẫn bắt đầu. Bạn cũng nên xử lý điều hướng trên TV để đảm bảo người dùng có thể thao tác tốt trong ứng dụng của bạn trên Android TV.

Xử lý quảng cáo có thể bỏ qua

Ví dụ: SDK tối ưu hoá các định dạng có thể bỏ qua cho các thiết bị giống TV bằng cách loại bỏ khả năng tương tác với nút Tìm hiểu thêm. Theo mặc định, SDK đặt tiêu điểm vào nút bỏ qua khi có thể bỏ qua để có thể bỏ qua quảng cáo trên Android TV. Do đó, bạn không cần làm gì thêm để hỗ trợ quảng cáo có thể bỏ qua.

Bạn có thể định cấu hình cho thuộc tính này bằng cách gọi AdsRenderingSettings.setFocusSkipButtonWhenAvailable().

Để biết thêm thông tin về những quảng cáo được hỗ trợ, hãy xem ma trận tương thích.

Xử lý hình ảnh dự phòng biểu tượng VAST

SDK IMA phát hiện, hiển thị và xử lý hoạt động tương tác của người dùng với hình ảnh dự phòng của biểu tượng VAST. Ứng dụng của bạn nên theo dõi các sự kiện ICON_TAPPEDICON_FALLBACK_IMAGE_CLOSED để xử lý việc phát quảng cáo cho những quảng cáo sử dụng tính năng "Lý do cho quảng cáo này" (WTA).

Thêm một boolean để theo dõi xem hình ảnh dự phòng của biểu tượng VAST có hiển thị hay không. Sau đó, hãy nghe ICON_TAPPEDICON_FALLBACK_IMAGE_CLOSED để xử lý việc phát quảng cáo xung quanh hình ảnh dự phòng biểu tượng VAST. Hãy xem đoạn mã sau đây để biết ví dụ về cách xử lý vấn đề này trong Ví dụ nâng cao.

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;