הוספת תוכניות לערוץ 'במה לצפות עכשיו'

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

לערוץ "הצעות לצפייה" יש כמה מגבלות: האפליקציה לא יכולה להזיז, להסיר או להסתיר את השורה של הערוץ "הצעות לצפייה".

צעדים

הוספת תוכניות לערוץ "הצעות לצפייה" דומה להוספת תוכניות לערוץ שלכם. בקטעים הבאים מפורטים פרטים ספציפיים לגבי הצעות לצפייה.

כשמוסיפים תוכן לערוץ "הצעות לצפייה", צריך לפעול לפי ההנחיות הבאות:

בוחרים את סוג התוכנית.

יש ארבעה סוגים של תוכניות "הצעות לצפייה". בוחרים את הסוג המתאים:

סוג הערות
WATCH_NEXT_TYPE_CONTINUE המשתמש הפסיק לצפות בתוכן.
WATCH_NEXT_TYPE_NEXT התוכנית הבאה בסדרה שהמשתמש צופה בה זמינה. לדוגמה, אם המשתמש צופה בפרק 3 של סדרה, האפליקציה יכולה להציע לו לצפות בפרק 4.
WATCH_NEXT_TYPE_NEW עכשיו יש תוכן חדש שקשור באופן ברור למה שהמשתמש צופה בו. לדוגמה, המשתמש צופה בפרק מספר 5 בסדרה, ופרק 6 הופך להיות זמין לצפייה.
WATCH_NEXT_TYPE_WATCHLIST המערכת או האפליקציה מוסיפות את המאפיין הזה כשהמשתמש שומר תוכנית.

מידע נוסף זמין במאמר מאפיינים של "הצעות לצפייה".

שימוש בכלי ליצירת WatchNextProgram

שימוש בWatchNextProgram.Builder. מידע נוסף זמין במאמר מאפיינים של "הצעות לצפייה".

val builder = WatchNextProgram.Builder()
builder.setType(TvContractCompat.WatchNextPrograms.TYPE_MOVIE)
    .setWatchNextType(TvContractCompat.WatchNextPrograms.WATCH_NEXT_TYPE_CONTINUE)
    .setLastEngagementTimeUtcMillis(time)
    .setTitle("Title")
    .setDescription("Program description")
    .setPosterArtUri(uri)
    .setIntentUri(uri)
    .setInternalProviderId(appProgramId)

val watchNextProgramUri = context.contentResolver
    .insert(
        TvContractCompat.WatchNextPrograms.CONTENT_URI,
        builder.build().toContentValues()
    )

משתמשים ב-TvContractCompat.buildWatchNextProgramUri(long watchNextProgramId) כדי ליצור את ה-Uri שצריך כדי לעדכן תוכנית ב-"הצעות לצפייה".

כשהמשתמש מוסיף תוכנית לערוץ "הצעות לצפייה", המערכת מעתיקה את התוכנית לשורה. הוא שולח את ה-intent‏ TvContractCompat.ACTION_PREVIEW_PROGRAM_ADDED_TO_WATCH_NEXT כדי להודיע לאפליקציה שהתוכנית נוספה. ה-intent כולל שני תוספים: מזהה התוכנית שהועתק ומזהה התוכנית שנוצר בשביל התוכנית בערוץ "הצעות לצפייה".