بهینه‌سازی برای Android TV

توصیه می‌کنیم چندین روال مطلوب را برای اطمینان از عملکرد صحیح برنامه شما در Android TV هنگام استفاده از «کیت توسعه نرم‌افزار IMA برای Android» رعایت کنید.

برای شروع، با توسعه برنامه‌های تلویزیون برای Android آشنا شوید. به‌طور مشخص، مطمئن شوید «فعالیت» شما برای تلویزیون تنظیم شده باشد، همان‌طور که در راهنمای شروع توضیح داده شده است. همچنین می‌خواهید پیمایش تلویزیون را مدیریت کنید تا مطمئن شوید کاربران می‌توانند به‌خوبی در برنامه شما در Android TV پیمایش کنند.

مدیریت آگهی‌های ردشدنی

کیت توسعه نرم‌افزار قالب‌های قابل‌رد شدن را برای دستگاه‌های شبیه تلویزیون بهینه‌سازی می‌کند، برای مثال با برداشتن امکان تعامل با دکمه بیشتر بدانید. به‌طور پیش‌فرض، «کیت توسعه نرم‌افزار» وقتی رد کردن دردسترس باشد، تمرکز را روی دکمه رد کردن تنظیم می‌کند تا آگهی بتواند در Android TV رد شود. بنابراین، برای پشتیبانی از آگهی‌های قابل رد کردن، کار اضافی لازم نیست.

می‌توانید این مورد را با فراخوانی AdsRenderingSettings.setFocusSkipButtonWhenAvailable() پیکربندی کنید.

برای اطلاعات بیشتر درباره اینکه از چه آگهی‌هایی پشتیبانی می‌شود، ماتریس سازگاری را بررسی کنید.

مدیریت تصاویر جایگزین نماد VAST

«کیت توسعه نرم‌افزار IMA» تعامل کاربر با نماد VAST تصاویر جایگزین را شناسایی، پردازش، و مدیریت می‌کند. برنامه شما باید به رویدادهای ICON_TAPPED و ICON_FALLBACK_IMAGE_CLOSED گوش دهد تا پخش آگهی را برای آگهی‌هایی که از «چرا این آگهی» (WTA) استفاده می‌کنند مدیریت کند.

یک مقدار بولی اضافه کنید تا ردیابی کنید که آیا تصویر جایگزین نماد VAST نمایش داده می‌شود یا نه. سپس، به ICON_TAPPED و ICON_FALLBACK_IMAGE_CLOSED گوش دهید تا پخش آگهی را در اطراف تصویر جایگزین نماد VAST مدیریت کنید. برای نمونه‌ای از نحوه مدیریت این موضوع در نمونه پیشرفته، تکه‌کد زیر را ببینید.

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;