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

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

• در Android 8.0 (سطح API 26) و جدیدتر، برنامه‌ها می‌توانند توصیه‌هایی را در یک یا چند کانال که در ردیف‌های جداگانه ظاهر می‌شوند، نشان دهند. یک کانال (کانال پیش فرض) همیشه ظاهر می شود. کاربر می تواند کانال های دیگر را پیدا کرده و به صفحه اصلی خود اضافه کند. با نحوه ایجاد کانال های توصیه در صفحه اصلی آشنا شوید.
• قبل از Android 8.0، Android TV همه توصیه‌ها را در یک ردیف توصیه‌ها نشان می‌دهد که همیشه روی صفحه ظاهر می‌شود. با نحوه ایجاد ردیف توصیه در صفحه اصلی آشنا شوید.

برای اینکه بتوانید توصیه‌هایی را در همه نسخه‌های 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 25 یا قبل از آن کامپایل شده است، همچنان می‌تواند در Android TV در سطح 26 اجرا شود. رفتار توصیه‌های قدیمی سازگار با جلو است، اما محدود است:

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