קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
במסך הבית של Android TV מוצג תוכן מומלץ באמצעות ערוצים וגם
תוכניות. הערוצים מוצגים כשורות נפרדות במסך הבית, כאשר
כרטיסים שמציגים את כל התוכניות הזמינות בערוץ.
לאפליקציה שלך צריך להיות ערוץ אחד לפחות. הערוץ הראשון
האפליקציה הופכת לערוץ ברירת המחדל שלה,
ו-Android TV מציג את הערוץ הזה באופן אוטומטי במסך הבית. האפליקציה שלך
יכול להציע ערוצים אחרים, אבל המשתמש צריך לבחור ולאשר את הערוצים האלה
לפני ההוספה למסך הבית.
אם באפליקציה מוצגים תוכניות טלוויזיה, סרטים או תוכן וידאו אחר, מומלץ
תומכים בתצוגה מקדימה של סרטונים
לשלב את הערוץ בערוץ 'במה לצפות עכשיו'.
הערוץ 'במה לצפות עכשיו' נשלט על ידי מערכת Android. האפליקציה שלך יכולה להוסיף
תוכניות שקשורות למשתמשים בערוץ הזה, כמו תוכניות שהמשתמש סימן כתוכניות
מעניינות, הפסיקו לצפות באמצע או שקשורות לתוכן
שהמשתמש צופה בו (למשל, בפרק הבא בסדרה או בעונה הבאה של
מציגים).
בדיקת תאימות
המלצות במסך הבית מוצגות בשתי דרכים שונות, בהתאם
הגרסה של Android:
בגרסה Android 8.0 (רמת API 26) ואילך, אפליקציות יכולות להציג המלצות
ערוצים נוספים שמופיעים בשורות נפרדות. ערוץ אחד (ערוץ ברירת המחדל)
מופיעה תמיד. המשתמש יכול למצוא את הערוצים האחרים ולהוסיף אותם לבית שלו.
מסך. איך יוצרים ערוצי המלצות
במסך הבית.
לפני Android 8.0, מערכת Android TV מציגה את כל ההמלצות בקובץ אחד
שורת ההמלצות שמופיעה תמיד במסך. נלמד איך ליצור
שורת ההמלצות בדף הבית
מסך.
כדי שתהיה אפשרות להציג המלצות בכל הגרסאות של Android TV, האפליקציה שלך
צריך להטמיע את שני ממשקי ה-API של ההמלצות. לבדוק את רמת ה-API הנוכחית של המערכת
להשתמש ב-API המתאים כדי ליצור את השורה או הערוצים של ההמלצות.
Kotlin
if(android.os.Build.VERSION.SDK_INT>=Build.VERSION_CODES.O){// Use the home screen recommendation channels API}else{// Use the recommendations row API}
Java
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. ההתנהגות של ההמלצות הקודמות תואמת לעתיד.
אבל מוגבל:
שורת ההמלצות עוברת המרה באופן אוטומטי ומופיעה כשורה חדשה
במסך הבית.
התוכניות בערוץ שעבר המרה מגיבות לעדכונים
Recommendations,
אך המשתמש אינו יכול להשתמש בממשק המשתמש של הטלוויזיה כדי לתמרן את התוכניות בערוץ
(הוספה/הסרה של תוכניות, העתקת תוכניות לערוץ 'במה לצפות עכשיו').
אם מעדכנים את האפליקציה לרמת API 26, הערוץ שהומר
עדיין מופיע בטלוויזיות שפועלת בהן API 26. הטלוויזיה מסירה את הערוץ שעבר המרה
מופיע במסך בפעם הראשונה שהאפליקציה מציגה ערוץ שנוצר באמצעות ממשק ה-API החדש.
זה קורה מיד אם האפליקציה יוצרת
default channel,
או מאוחר יותר כשהמשתמש יבחר ויוסיף ערוץ אחר שנוצר על ידי האפליקציה שלך.
דוגמאות התוכן והקוד שבדף הזה כפופות לרישיונות המפורטים בקטע רישיון לתוכן. Java ו-OpenJDK הם סימנים מסחריים או סימנים מסחריים רשומים של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-07-27 (שעון UTC).
[null,null,["עדכון אחרון: 2025-07-27 (שעון UTC)."],[],[],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."]]
