استخدام حزمة تطوير البرامج لإعلانات الوسائط التفاعلية لنظام التشغيل Android مع Android TV

نقترح العديد من أفضل الممارسات لضمان عمل تطبيقك بشكل سليم على Android TV عند استخدام حزمة تطوير البرامج لإعلانات الوسائط التفاعلية لنظام التشغيل Android.

ابدأ بالتعرّف على تطوير تطبيقات التلفزيون لنظام التشغيل Android. على وجه التحديد، احرص على إعداد نشاطك للتلفزيون كما هو موضّح في دليل البدء. عليك أيضًا التعامل مع التنقّل في التلفزيون لمحاولة التأكّد من أنّه بإمكان المستخدمين التنقّل في تطبيقك بشكل جيد على Android TV.

التعامل مع الإعلانات القابلة للتخطي

تعمل حزمة تطوير البرامج (SDK) على تحسين التنسيقات القابلة للتخطّي على الأجهزة المشابهة للتلفزيون، على سبيل المثال، من خلال إزالة إمكانية التفاعل مع الزر مزيد من المعلومات. بشكلٍ تلقائي، تُركّز حزمة تطوير البرامج (SDK) على زر التخطّي عندما يكون التخطّي متاحًا حتى يمكن تخطّي الإعلان على Android TV. وبالتالي، ليس عليك بذل أي جهد إضافي لتفعيل الإعلانات التي يمكن تخطّيها.

يمكنك ضبط ذلك من خلال الاتصال بالرقم AdsRenderingSettings.setFocusSkipButtonWhenAvailable().

لمزيد من المعلومات حول الإعلانات المتوافقة، اطّلِع على جدول التوافق.

معالجة الصور الاحتياطية لرمز VAST

ترصد حزمة تطوير البرامج (SDK) لإعلانات الوسائط التفاعلية تفاعل المستخدِم مع رمز VAST ويعرضه ويعالجه، وكذلك الصور الاحتياطية. يجب أن يستمع تطبيقك إلى الحدثَين ICON_TAPPED وICON_FALLBACK_IMAGE_CLOSED للتعامل مع تشغيل الإعلانات التي تستخدم "لماذا هذا الإعلان؟" (WTA).

أضِف قيمة منطقية لتتبُّع ما إذا كانت صورة احتياطية لرمز VAST تظهر. بعد ذلك، استمِع إلى ICON_TAPPED وICON_FALLBACK_IMAGE_CLOSED للتعامل مع تشغيل الإعلانات حول الصورة الاحتياطية لرمز VAST. اطّلِع على مقتطف الرمز البرمجي التالي للحصول على مثال على كيفية التعامل مع ذلك في المثال المتقدّم.

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;