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

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

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

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

از سازگاری اطمینان حاصل کنید

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

• در 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 جدید را نمایش می‌دهد، تلویزیون کانال تبدیل‌شده را از صفحه حذف می‌کند. اگر برنامه یک کانال پیش‌فرض ایجاد کند، یا بعداً وقتی کاربر هر کانال دیگری را که توسط برنامه شما ایجاد شده است را انتخاب و اضافه کند، بلافاصله این اتفاق می‌افتد.