محتوا را در صفحه اصلی توصیه کنید

صفحه اصلی تلویزیون اندروید، محتوای پیشنهادی را با استفاده از کانال‌ها و برنامه‌ها نمایش می‌دهد. کانال‌ها به صورت ردیف‌های جداگانه در صفحه اصلی نمایش داده می‌شوند، به همراه کارت‌هایی که تمام برنامه‌های موجود برای آن کانال را نمایش می‌دهند.

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

اگر برنامه شما شامل برنامه‌های تلویزیونی، فیلم یا سایر محتوای ویدیویی است، توصیه می‌کنیم از پیش‌نمایش ویدیو پشتیبانی کنید و آن را با کانال «Watch Next» ادغام کنید. کانال «Watch Next» توسط سیستم اندروید کنترل می‌شود. برنامه شما می‌تواند برنامه‌های مرتبط با کاربر را به این کانال اضافه کند، مانند برنامه‌هایی که کاربر آنها را به عنوان جالب علامت‌گذاری کرده، تماشای آنها را در وسط متوقف کرده یا برنامه‌هایی که به محتوایی که کاربر تماشا می‌کند مرتبط هستند (مانند قسمت بعدی یک سریال یا فصل بعدی یک نمایش).

اطمینان از سازگاری

صفحه اصلی بسته به نسخه اندروید، توصیه‌ها را به دو روش مختلف نمایش می‌دهد:

  • در اندروید ۸.۰ (سطح API ۲۶) و بالاتر، برنامه‌ها می‌توانند توصیه‌ها را در یک یا چند کانال که در ردیف‌های جداگانه ظاهر می‌شوند، نشان دهند. یک کانال (کانال پیش‌فرض) همیشه ظاهر می‌شود. کاربر می‌تواند کانال‌های دیگر را کشف و به صفحه اصلی خود اضافه کند. یاد بگیرید که چگونه کانال‌های توصیه را در صفحه اصلی ایجاد کنید.
  • قبل از اندروید ۸.۰، اندروید تی‌وی همه توصیه‌ها را در یک ردیف توصیه که همیشه روی صفحه نمایش داده می‌شد، نشان می‌داد. یاد بگیرید که چگونه ردیف توصیه‌ها را در صفحه اصلی ایجاد کنید.

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

کاتلین

if (android.os.Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
  // Use the home screen recommendation channels API
} else {
  // Use the recommendations row API
}

جاوا

if (android.os.Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
  // Use the home screen recommendation channels API
} else {
  // Use the recommendations row API
}

اگر برنامه شما با استفاده از API سطح ۲۵ یا قبل از آن کامپایل شده باشد، همچنان می‌تواند در Android TV در سطح ۲۶ اجرا شود. رفتار توصیه‌های قدیمی با نسخه‌های بعدی سازگار است، اما محدود شده است:

  • ردیف توصیه‌ها به‌طور خودکار تبدیل می‌شود و به‌عنوان یک کانال جدید در صفحه اصلی ظاهر می‌شود.
  • برنامه‌های کانال تبدیل‌شده به به‌روزرسانی‌های سرویس توصیه شما پاسخ می‌دهند، اما کاربر نمی‌تواند از رابط کاربری تلویزیون برای دستکاری برنامه‌های کانال (افزودن/حذف برنامه‌ها، کپی کردن برنامه‌ها به کانال Watch Next) استفاده کند.
  • اگر برنامه را به سطح API 26 به‌روزرسانی کنید، کانال تبدیل‌شده همچنان در تلویزیون‌هایی که API 26 را اجرا می‌کنند، نمایش داده می‌شود. تلویزیون اولین باری که برنامه شما کانالی ایجاد شده با API جدید را نمایش می‌دهد، کانال تبدیل‌شده را از صفحه حذف می‌کند. این اتفاق بلافاصله در صورتی که برنامه یک کانال پیش‌فرض ایجاد کند یا بعداً زمانی که کاربر هر کانال دیگری را که توسط برنامه شما ایجاد شده است انتخاب و اضافه کند، رخ می‌دهد.