ویژگی های یک برنامه ویدیویی به نوع محتوای آن بستگی دارد. نوع برنامه به سیستم می‌گوید چه ابرداده‌هایی باید انتظار داشته باشد تا UI بتواند به درستی پر شود.
برنامه های ویدیویی می توانند یکی از انواع زیر باشند:
برای ساختن یک برنامه PreviewProgram.Builder استفاده کنید. می‌توانید در مورد مقادیر ممکن برای هر فیلد در اسناد مرجع برای هر تنظیم کننده در سازنده اطلاعات بیشتری کسب کنید.
کاتلین
val program = PreviewProgram.Builder()
.setChannelId(channelId)
.setTitle(clip.getTitle())
.setDescription(clip.getDescription())
.setType(TvContractCompat.PreviewPrograms.TYPE_MOVIE)
// Set required attributes
.build()
جاوا
PreviewProgram program = new PreviewProgram.Builder()
.setChannelId(channelId)
.setTitle(clip.getTitle())
.setDescription(clip.getDescription())
.setType(TvContractCompat.PreviewPrograms.TYPE_MOVIE)
// Set required attributes
.build();
جدول زیر ویژگی هایی را نشان می دهد که می توان به هر نوع برنامه ویدیویی نسبت داد. هر ویژگی به تنظیم کننده مربوطه در PreviewProgram.Builder پیوند دارد. ویژگی های علامت گذاری شده ✔ الزامی است. مواردی که (✔) علامت گذاری شده اند اختیاری هستند.
| صفت | فیلم | سریال های تلویزیونی | فصل تلویزیون | اپیزود تلویزیونی | کلیپ | رویداد | کانال |
|---|---|---|---|---|---|---|---|
| نویسنده | (✔) | ||||||
| در دسترس بودن | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| ژانرهای متعارف | (✔) | (✔) | (✔) | (✔) | |||
| آیدی کانال | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
| شناسه محتوا | (✔) | ||||||
| رتبه بندی محتوا | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| مدت زمان میلیس | ✔ | ✔ | ✔ | (✔) | |||
| شماره قسمت | ✔ | ||||||
| عنوان اپیزود | (✔) | ||||||
| ژانر | (✔) | (✔) | (✔) | (✔) | |||
| URI قصد | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
| تعداد تعامل | (✔) | (✔) | |||||
| نوع تعامل | (✔) | (✔) | |||||
| شناسه ارائه دهنده داخلی | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| تعداد آیتم ها | (✔) | (✔) | |||||
| زندگی کنید | (✔) | (✔) | (✔) | (✔) | (✔) | ||
| نشان‌واره URI (*) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| شرح محتوای لوگو (*) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| قیمت پیشنهادی | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| نسبت ابعاد هنری پوستر | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
| URI هنر پوستر | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
| پیش نمایش URI ویدیو | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| تاریخ انتشار | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | |
| بررسی رتبه | (✔) | (✔) | (✔) | (✔) | (✔) | ||
| بررسی سبک رتبه بندی | (✔) | (✔) | (✔) | (✔) | (✔) | ||
| شماره نمایش فصل | ✔ | ✔ | |||||
| توضیحات کوتاه | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| زمان شروع UTC Millis (*) | ✔ | ✔ | ✔ | ✔ | |||
| زمان پایان 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 مشخص کنید.