המלצות על תוכן במסך הבית

במסך הבית של Android TV מוצג תוכן מומלץ באמצעות ערוצים ותוכניות. הערוצים מוצגים כשורה נפרדת במסך הבית, עם כרטיסים שבהם מוצגות כל התוכניות שזמינות בערוץ הזה.

באפליקציה צריך להיות לפחות ערוץ אחד. הערוץ הראשון שהאפליקציה יוצרת הופך לערוץ ברירת המחדל שלה, ו-Android TV מציג את הערוץ הזה באופן אוטומטי במסך הבית. האפליקציה יכולה להציע ערוצים אחרים, אבל המשתמש צריך לבחור ולאשר את הערוצים האלה לפני שהם יתווספו למסך הבית.

אם האפליקציה כוללת תוכניות טלוויזיה, סרטים או קטע וידאו אחר, מומלץ לתמוך בתצוגות מקדימות של סרטונים ולשלב את הערוץ "הצעות לצפייה". הערוץ "הצעות לצפייה" נשלט על ידי מערכת Android. האפליקציה יכולה להוסיף לערוץ הזה תוכניות שקשורות למשתמש, כמו תוכניות שהמשתמש סימן כמעניינות, הפסיק לצפות בהן באמצע או שקשורות לתוכן שהמשתמש צופה בו (כמו הפרק הבא בסדרה או העונה הבאה של תוכנית).

בדיקת תאימות

במסך הבית מוצגות המלצות בשתי דרכים שונות, בהתאם לגרסת Android:

• ב-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.
}
Recommendations.kt

אם האפליקציה שלכם קומפלה באמצעות רמת API‏ 25 או גרסה קודמת, היא עדיין יכולה לפעול ב-Android TV ברמה 26. ההתנהגות הישנה של ההמלצות תואמת קדימה, אבל מוגבלת:

• שורת ההמלצות מומרת באופן אוטומטי ומופיעה כערוץ חדש במסך הבית.
• התוכניות בערוץ שהומר מגיבות לעדכונים משירות ההמלצות, אבל המשתמש לא יכול להשתמש בממשק המשתמש של הטלוויזיה כדי לשנות את התוכניות בערוץ (להוסיף או להסיר תוכניות, להעתיק תוכניות לערוץ 'הצעות לצפייה').
• אם מעדכנים את האפליקציה לרמת API‏ 26, הערוץ שהומר עדיין מופיע בטלוויזיות עם API‏ 26. הערוץ שהומר יוסר מהמסך בפעם הראשונה שהאפליקציה תציג ערוץ שנוצר באמצעות ה-API החדש. זה קורה מיד אם האפליקציה יוצרת ערוץ ברירת מחדל, או מאוחר יותר כשהמשתמש בוחר ומוסיף ערוץ אחר שנוצר על ידי האפליקציה.

הערה: ההתנהגות הזו של תאימות קדימה היא זמנית, והיא תוסר בעתיד. כדי להבטיח תאימות, השיטה המומלצת היא להטמיע את שני ממשקי ה-API, כמו שמתואר בקטע הזה.