מאפייני תוכנית וידאו

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

תוכניות וידאו יכולות להיות אחד מהסוגים הבאים:

כדי ליצור תוכנית, משתמשים ב-PreviewProgram.Builder. במסמכי העזר של כל פרמטר הגדרה ב-builder מופיע מידע נוסף על הערכים האפשריים של כל שדה.

Kotlin

val program = PreviewProgram.Builder()
        .setChannelId(channelId)
        .setTitle(clip.getTitle())
        .setDescription(clip.getDescription())
        .setType(TvContractCompat.PreviewPrograms.TYPE_MOVIE)
        // Set required attributes
        .build()

Java

PreviewProgram program = new PreviewProgram.Builder()
        .setChannelId(channelId)
        .setTitle(clip.getTitle())
        .setDescription(clip.getDescription())
        .setType(TvContractCompat.PreviewPrograms.TYPE_MOVIE)
        // Set required attributes
        .build();

בטבלה הבאה מפורטים המאפיינים שאפשר להקצות לכל סוג של תוכנית וידאו. כל מאפיין מקשר לרכיב מגדיר המתאים של PreviewProgram.Builder חובה להוסיף מאפיינים שמסומנים באמצעות . אלו שמסומנים (✔) הם אופציונליים.

מאפיין סרט סדרות טלוויזיה עונה של סדרת טלוויזיה פרק בסדרת טלוויזיה קליפ אירוע ערוץ
מחבר/ת (✔)
זמינות (✔)(✔)(✔)(✔)(✔)(✔)(✔)
ז'אנרים קנוניים (✔)(✔)(✔)(✔)
מזהה הערוץ
Content ID (✔)
סיווגי תוכן (✔)(✔) (✔)(✔) (✔)(✔)(✔)
משך הזמן באלפיות השנייה (✔)
מספר הפרק
שם הפרק (✔)
ז'אנר (✔)(✔) (✔)(✔)
ה-URI של Intent
מספר אינטראקציות (✔)(✔)
סוג אינטראקציה (✔)(✔)
מזהה ספק פנימי (✔)(✔)(✔)(✔)(✔)(✔)(✔)
מספר הפריטים(✔) (✔)
פעיל (✔)(✔)(✔)(✔)(✔)
URI של לוגו (*) (✔)(✔)(✔)(✔)(✔)(✔)(✔)
תיאור תוכן הלוגו (*) (✔)(✔)(✔)(✔)(✔)(✔)(✔)
מחיר המבצע (✔)(✔)(✔)(✔)(✔)(✔)(✔)
יחס הגובה-רוחב של אומנות הפוסטר
URI של פוסטרים
תצוגה מקדימה של Video URI (✔)(✔)(✔)(✔)(✔)(✔)(✔)
תאריך פרסום (✔)(✔)(✔)(✔)(✔)(✔)
דירוג הביקורת (✔)(✔)(✔)(✔)(✔)
סגנון הדירוג של הביקורת (✔)(✔)(✔)(✔)(✔)
מספר התצוגה לעונה
תיאור קצר (✔)(✔)(✔)(✔)(✔)(✔)(✔)
שעת ההתחלה לפי שעון UTC באלפיות השנייה (*)
שעת סיום לפי שעון UTC באלפיות שנייה (*)
מחיר התחלתי (✔)(✔)(✔)(✔)(✔)(✔)(✔)
יחס גובה-רוחב של תמונות ממוזערות (✔)(✔)(✔)(✔)(✔)(✔)(✔)
URI של תמונה ממוזערת (✔)(✔)(✔)(✔)(✔)(✔)(✔)
שם
גובה הסרטון (✔)(✔)(✔)(✔)(✔)(✔)(✔)
רוחב הסרטון (✔)(✔)(✔)(✔)(✔)(✔)(✔)
משקל (✔)(✔)(✔)(✔)(✔)(✔)(✔)
תצוגה מקדימה של תמונות

הגדלים המומלצים לתמונות של תצוגה מקדימה הם:

מאפיין יחס גובה-רוחב רוחב גובה
ASPECT_RATIO_16_9 16:9 272 dp 153 dp
ASPECT_RATIO_3_2 ‎3:2 229.5 dp 153 dp
ASPECT_RATIO_4_3 4:3 204 dp 153 dp
ASPECT_RATIO_1_1 1:1 153 dp 153 dp
ASPECT_RATIO_2_3 2:3 102 dp 153 dp
ASPECT_RATIO_MOVIE_POSTER 1:1.441 106 dp 153 dp

כדי ליהנות מהאיכות הטובה ביותר, מומלץ להשתמש בסרטונים עם תצוגה מקדימה ביחס של 16:9 או 4:3 לפחות בגודל המתאים שצוינו בטבלה הזו. השתמשו בלוגו אטום לקבלת חוויית המשתמש הטובה ביותר.

אפשר לציין את הגודל המדויק של התצוגה המקדימה של הסרטון באמצעות VIDEO_WIDTH ו-VIDEO_HEIGHT.