صفحه اصلی Android TV محتوای توصیه‌شده را بااستفاده از کانال‌ها و برنامه‌ها نمایش می‌دهد. کانال‌ها به‌صورت ردیف‌های جداگانه در صفحه اصلی نمایش داده می‌شوند و کارت‌هایی دارند که همه برنامه‌های دردسترس آن کانال را نمایش می‌دهند.
برنامه شما باید حداقل یک کانال داشته باشد. اولین کانالی که برنامه‌تان ایجاد می‌کند، کانال پیش‌فرض آن می‌شود، و Android TV آن کانال را به‌طور خودکار در صفحه اصلی نمایش می‌دهد. برنامه شما می‌تواند کانال‌های دیگری را ارائه دهد، اما کاربر باید آن کانال‌ها را قبل‌از اضافه شدن به صفحه اصلی انتخاب و تأیید کند.
اگر برنامه‌تان نمایش‌های تلویزیونی، فیلم، یا محتوای ویدیویی دیگری را ارائه می‌دهد، توصیه می‌کنیم از پیش‌نمایش‌های ویدیویی پشتیبانی کنید و با کانال «تماشای بعدی» ادغام کنید. کانال «برای تماشا برای بعد» توسط سیستم Android کنترل می‌شود. برنامه شما می‌تواند برنامه‌های مرتبط با کاربر را به این کانال اضافه کند، مثلاً برنامه‌هایی که کاربر به‌عنوان جالب علامت‌گذاری کرده است، تماشای آن‌ها را در وسط متوقف کرده است، یا برنامه‌هایی که با محتوایی که کاربر درحال تماشا است مرتبط هستند (مانند قسمت بعدی در یک مجموعه یا فصل بعدی یک نمایش).
اطمینان از سازگاری
صفحه اصلی توصیه‌ها را به دو روش مختلف بسته به نسخه Android نمایش می‌دهد:
- در Android 8.0 (سطح میانای برنامه‌سازی کاربردی ۲۶) و نسخه‌های جدیدتر، برنامه‌ها می‌توانند توصیه‌ها را در یک یا چند کانال که در ردیف‌های جداگانه نشان داده می‌شوند نمایش دهند. یک کانال (کانال پیش‌فرض) همیشه نشان داده می‌شود. کاربر می‌تواند کانال‌های دیگر را کاوش کند و به صفحه اصلی‌اش اضافه کند. با نحوه ایجاد کانال‌های توصیه‌شده در صفحه اصلی آشنا شوید.
- قبل‌از Android 8.0، Android TV همه توصیه‌ها را در یک ردیف توصیه‌ها نشان می‌دهد که همیشه روی صفحه ظاهر می‌شود. با نحوه ایجاد ردیف توصیه‌ها در صفحه اصلی آشنا شوید.
برای اینکه بتوانید توصیه‌ها را در همه نسخه‌های Android TV نشان دهید، برنامه‌تان باید هر دو میانای برنامه‌سازی کاربردی توصیه را پیاده‌سازی کند. سطح میانای برنامه‌سازی کاربردی سیستم فعلی را آزمایش کنید و از میانای برنامه‌سازی کاربردی مناسب برای ساختن ردیف یا کانال‌های توصیه استفاده کنید.
if (android.os.Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) { // Use the home screen recommendation channels API. } else { // Use the recommendations row API. }
اگر برنامه‌تان بااستفاده از سطح میانای برنامه‌سازی کاربردی ۲۵ یا قدیمی‌تر کامپایل شده باشد، همچنان می‌تواند در Android TV در سطح ۲۶ اجرا شود. رفتار توصیه‌های قدیمی سازگار با نسخه‌های بعدی است، اما محدود است:
- ردیف توصیه‌ها به‌طور خودکار تبدیل می‌شود و به‌عنوان کانال جدیدی در صفحه اصلی ظاهر می‌شود.
- برنامه‌های کانال تبدیل‌شده به به‌روزرسانی‌های سرویس توصیه‌تان پاسخ می‌دهند، اما کاربر نمی‌تواند از واسط کاربر تلویزیون برای دستکاری برنامه‌های کانال استفاده کند (افزودن/ برداشتن برنامه‌ها، کپی کردن برنامه‌ها در کانال «تماشای بعدی»).
- اگر برنامه را به سطح میانای برنامه‌سازی کاربردی ۲۶ به‌روز کنید، کانال تبدیل‌شده همچنان در تلویزیون‌های دارای میانای برنامه‌سازی کاربردی ۲۶ نشان داده می‌شود. اولین‌باری که برنامه‌تان کانال ایجادشده با میانای برنامه‌سازی کاربردی جدید را نمایش می‌دهد، تلویزیون کانال تبدیل‌شده را از صفحه‌نمایش برمی‌دارد. این اتفاق بلافاصله پس‌از ایجاد کانال پیش‌فرض توسط برنامه، یا بعداً وقتی کاربر کانال دیگری را که توسط برنامه شما ایجاد شده است انتخاب و اضافه می‌کند، رخ می‌دهد.