با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
صفحه اصلی 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 جدید را نمایش می‌دهد، تلویزیون کانال تبدیل‌شده را از صفحه حذف می‌کند. اگر برنامه یک کانال پیش‌فرض ایجاد کند، یا بعداً وقتی کاربر هر کانال دیگری را که توسط برنامه شما ایجاد شده است را انتخاب و اضافه کند، بلافاصله این اتفاق می‌افتد.
محتوا و نمونه کدها در این صفحه مشمول پروانههای توصیفشده در پروانه محتوا هستند. جاوا و OpenJDK علامتهای تجاری یا علامتهای تجاری ثبتشده Oracle و/یا وابستههای آن هستند.
تاریخ آخرین به‌روزرسانی 2025-07-29 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین به‌روزرسانی 2025-07-29 بهوقت ساعت هماهنگ جهانی."],[],[],null,["# Recommend content on the home screen\n\nThe Android TV *home screen* displays recommended content using *channels* and\n*programs*. Channels are displayed as individual rows on the home screen, with\ncards that display all of the available programs for that channel.\n\nYour app should have at least one channel. The first channel your\napp creates becomes its [default channel](/training/tv/discovery/recommendations-channel#default-channel),\nand Android TV displays that channel automatically on the home screen. Your app\ncan offer other channels, but the user must select and approve those channels\nbefore they are added to the home screen.\n\nIf your app features TV shows, movies, or other video content, we recommend that\nyou support [video previews](/training/tv/discovery/preview-videos) and\nintegrate with the [Watch Next channel](/training/tv/discovery/recommendations-channel#watch-next).\nThe Watch Next channel is controlled by the Android system. Your app can add\nuser-related programs to this channel, such as programs that the user marked as\ninteresting, stopped watching in the middle, or that are related to the content\nthe user is watching (like the next episode in a series or next season of a\nshow).\n\nEnsure compatibility\n--------------------\n\nThe home screen displays recommendations two different ways depending on the\nversion of Android:\n\n- In Android 8.0 (API level 26) and later, apps can show recommendations in one or more channels that appear on separate rows. One channel (the default channel) always appears. The user can discover and add the other channels to their home screen. Learn how to create [recommendation channels](/training/tv/discovery/recommendations-channel) on the home screen.\n- Before Android 8.0, Android TV shows all recommendations in a single recommendations row that always appears on the screen. Learn how to create the [recommendation row](/training/tv/discovery/recommendations-row) on the home screen.\n\nTo be able to show recommendations on all versions of Android TV, your app\nshould implement both recommendation APIs. Test the current system API level and\nuse the appropriate API to build the recommendation row or channels. \n\n### Kotlin\n\n```kotlin\nif (android.os.Build.VERSION.SDK_INT \u003e= Build.VERSION_CODES.O) {\n // Use the home screen recommendation channels API\n} else {\n // Use the recommendations row API\n}\n```\n\n### Java\n\n```java\nif (android.os.Build.VERSION.SDK_INT \u003e= Build.VERSION_CODES.O) {\n // Use the home screen recommendation channels API\n} else {\n // Use the recommendations row API\n}\n```\n\nIf your app was compiled using API level 25 or earlier, it can still run on\nAndroid TV in level 26. The old recommendations behavior is forward-compatible,\nbut constrained:\n\n- The recommendations row is automatically converted and appears as a new channel on the home screen.\n- The programs on the converted channel respond to updates from your [recommendation service](/training/tv/discovery/recommendations-row#service), but the user cannot use the TV's UI to manipulate the programs on the channel (add/remove programs, copy programs to the Watch Next channel).\n- If you update the app to API level 26, the converted channel still appears on TVs running API 26. The TV removes the converted channel from the screen the first time your app displays a channel created with the new API. This happens immediately if the app creates a [default channel](/training/tv/discovery/recommendations-channel#the_default_channel), or later when the user selects and adds any other channel created by your app.\n\n| **Note:** This forward-compatible behavior is temporary, it will be removed sometime in the future. To ensure compatibility, the best practice is to implement both APIs, as described above."]]
