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

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

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

• TYPE_MOVIE
• TYPE_TV_SERIES
• TYPE_TV_SEASON
• TYPE_TV_EPISODE
• TYPE_CLIP
• TYPE_EVENT
• TYPE_CHANNEL

לְהִשְׁתַמֵשׁPreviewProgram.Builder לבנות תוכנית. ניתן לקרוא עוד על ערכים אפשריים עבור כל שדה במסמכי הייחוס עבור כל setter בבונה.

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					(✔)
סיווגי תוכן	(✔)	(✔)	(✔)	(✔)	(✔)	(✔)	(✔)
DurationMillis	✔			✔	✔	(✔)
מספר פרק				✔
כותרת הפרק				(✔)
ז'אנר	(✔)	(✔)	(✔)	(✔)
URI של הרציונל	✔	✔	✔	✔	✔	✔	✔
מספר האינטראקציות					(✔)	(✔)
סוג אינטראקציה					(✔)	(✔)
מזהה פנימי של ספק	(✔)	(✔)	(✔)	(✔)	(✔)	(✔)	(✔)
ספירת פריטים		(✔)	(✔)
בשידור חי	(✔)			(✔)	(✔)	(✔)	(✔)
כתובת ה-URI של הלוגו (*)	(✔)	(✔)	(✔)	(✔)	(✔)	(✔)	(✔)
תיאור תוכן הלוגו (*)	(✔)	(✔)	(✔)	(✔)	(✔)	(✔)	(✔)
מחיר מבצע	(✔)	(✔)	(✔)	(✔)	(✔)	(✔)	(✔)
יחס גובה-רוחב של הגרפיקה של הפוסטר	✔	✔	✔	✔	✔	✔	✔
URI של פוסטר	✔	✔	✔	✔	✔	✔	✔
Preview Video URI	(✔)	(✔)	(✔)	(✔)	(✔)	(✔)	(✔)
תאריך השקה	(✔)	(✔)	(✔)	(✔)	(✔)	(✔)
דירוג הביקורת	(✔)	(✔)	(✔)	(✔)			(✔)
סגנון דירוג הביקורת	(✔)	(✔)	(✔)	(✔)			(✔)
מספר התצוגה של העונה			✔	✔
תיאור קצר	(✔)	(✔)	(✔)	(✔)	(✔)	(✔)	(✔)
שעת התחלה UTC מילישניות (*)	✔			✔	✔	✔
שעת סיום במילישניות לפי שעון UTC (*)	✔			✔	✔	✔
המחיר ההתחלתי	(✔)	(✔)	(✔)	(✔)	(✔)	(✔)	(✔)
יחס גובה-רוחב של התמונה הממוזערת	(✔)	(✔)	(✔)	(✔)	(✔)	(✔)	(✔)
כתובת ה-URI של התמונה הממוזערת	(✔)	(✔)	(✔)	(✔)	(✔)	(✔)	(✔)
Title	✔	✔	✔	✔	✔	✔	✔
גובה הסרטון	(✔)	(✔)	(✔)	(✔)	(✔)	(✔)	(✔)
רוחב הסרטון	(✔)	(✔)	(✔)	(✔)	(✔)	(✔)	(✔)
משקל	(✔)	(✔)	(✔)	(✔)	(✔)	(✔)	(✔)

הערה: (*) LOGO_CONTENT_DESCRIPTION נדרש כשמשתמשים ב-LOGO_URI. המאפיינים START ו-END מופיעים במסך רק כשהערך של המאפיין LIVE הוא true.

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

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

מאפיין	יחס גובה-רוחב	רוחב	גובה
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 נקודות זכות	‫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 נקודות זכות	‫153 dp

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

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