ویژگیهای یک برنامه ویدیویی به نوع محتوای آن بستگی دارد. نوع برنامه به سیستم میگوید که چه فرادادهای را باید انتظار داشته باشد تا رابط کاربری بتواند به طور مناسب پر شود.
برنامههای ویدیویی میتوانند یکی از انواع زیر باشند:
برای ساخت یک برنامه 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 پیوند دارد. ویژگیهایی که با ✔ مشخص شدهاند الزامی هستند؛ آنهایی که با (✔) مشخص شدهاند اختیاری هستند.
| ویژگی | فیلم | سریالهای تلویزیونی | فصل تلویزیون | قسمت تلویزیونی | کلیپ | رویداد | کانال |
|---|---|---|---|---|---|---|---|
| نویسنده | (✔) | ||||||
| در دسترس بودن | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| ژانرهای متعارف | (✔) | (✔) | (✔) | (✔) | |||
| شناسه کانال | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
| شناسه محتوا | (✔) | ||||||
| رتبهبندی محتوا | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| مدت زمان میلیس | ✔ | ✔ | ✔ | (✔) | |||
| شماره قسمت | ✔ | ||||||
| عنوان قسمت | (✔) | ||||||
| ژانر | (✔) | (✔) | (✔) | (✔) | |||
| آدرس اینترنتی هدف | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
| تعداد تعاملات | (✔) | (✔) | |||||
| نوع تعامل | (✔) | (✔) | |||||
| شناسه ارائه دهنده داخلی | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| تعداد اقلام | (✔) | (✔) | |||||
| زنده | (✔) | (✔) | (✔) | (✔) | (✔) | ||
| آدرس اینترنتی لوگو (*) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| توضیحات محتوای لوگو (*) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| قیمت پیشنهادی | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| نسبت ابعاد پوستر هنری | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
| آدرس اینترنتی هنر پوستر | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
| پیشنمایش آدرس ویدیو | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| تاریخ انتشار | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | |
| رتبهبندی نقد و بررسی | (✔) | (✔) | (✔) | (✔) | (✔) | ||
| سبک رتبهبندی نقد و بررسی | (✔) | (✔) | (✔) | (✔) | (✔) | ||
| شماره نمایش فصل | ✔ | ✔ | |||||
| شرح مختصر | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| زمان شروع UTC میلی ثانیه (*) | ✔ | ✔ | ✔ | ✔ | |||
| زمان پایان UTC Millis (*) | ✔ | ✔ | ✔ | ✔ | |||
| قیمت پایه | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| نسبت ابعاد تصویر بندانگشتی | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| آدرس تصویر بندانگشتی | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| عنوان | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
| ارتفاع ویدئو | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| عرض ویدئو | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| وزن | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
پیشنمایش تصاویر
اندازههای پیشنهادی برای تصاویر پیشنمایش به شرح زیر است:
| ویژگی | نسبت ابعاد | عرض | ارتفاع |
ASPECT_RATIO_16_9 | ۱۶:۹ | ۲۷۲ نقطه در اینچ | ۱۵۳ نقطه در اینچ |
ASPECT_RATIO_3_2 | ۳:۲ | ۲۲۹.۵ نقطه در اینچ | ۱۵۳ نقطه در اینچ |
ASPECT_RATIO_4_3 | ۴:۳ | ۲۰۴ نقطه در اینچ | ۱۵۳ نقطه در اینچ |
ASPECT_RATIO_1_1 | ۱:۱ | ۱۵۳ نقطه در اینچ | ۱۵۳ نقطه در اینچ |
ASPECT_RATIO_2_3 | ۲:۳ | ۱۰۲ نقطه در اینچ | ۱۵۳ نقطه در اینچ |
ASPECT_RATIO_MOVIE_POSTER | ۱:۱.۴۴۱ | ۱۰۶ نقطه در اینچ | ۱۵۳ نقطه در اینچ |
برای بهترین کیفیت، از ویدیوهای پیشنمایش ۱۶:۹ یا ۴:۳ که حداقل اندازههای مشخصشده در این جدول را دارند، استفاده کنید. برای بهترین تجربه کاربری، از یک لوگوی مات استفاده کنید.
شما میتوانید اندازه دقیق ویدیوی پیشنمایش را با استفاده از VIDEO_WIDTH و VIDEO_HEIGHT مشخص کنید.
ویژگیهای یک برنامه ویدیویی به نوع محتوای آن بستگی دارد. نوع برنامه به سیستم میگوید که چه فرادادهای را باید انتظار داشته باشد تا رابط کاربری بتواند به طور مناسب پر شود.
برنامههای ویدیویی میتوانند یکی از انواع زیر باشند:
برای ساخت یک برنامه 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 پیوند دارد. ویژگیهایی که با ✔ مشخص شدهاند الزامی هستند؛ آنهایی که با (✔) مشخص شدهاند اختیاری هستند.
| ویژگی | فیلم | سریالهای تلویزیونی | فصل تلویزیون | قسمت تلویزیونی | کلیپ | رویداد | کانال |
|---|---|---|---|---|---|---|---|
| نویسنده | (✔) | ||||||
| در دسترس بودن | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| ژانرهای متعارف | (✔) | (✔) | (✔) | (✔) | |||
| شناسه کانال | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
| شناسه محتوا | (✔) | ||||||
| رتبهبندی محتوا | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| مدت زمان میلیس | ✔ | ✔ | ✔ | (✔) | |||
| شماره قسمت | ✔ | ||||||
| عنوان قسمت | (✔) | ||||||
| ژانر | (✔) | (✔) | (✔) | (✔) | |||
| آدرس اینترنتی هدف | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
| تعداد تعاملات | (✔) | (✔) | |||||
| نوع تعامل | (✔) | (✔) | |||||
| شناسه ارائه دهنده داخلی | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| تعداد اقلام | (✔) | (✔) | |||||
| زنده | (✔) | (✔) | (✔) | (✔) | (✔) | ||
| آدرس اینترنتی لوگو (*) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| توضیحات محتوای لوگو (*) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| قیمت پیشنهادی | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| نسبت ابعاد پوستر هنری | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
| آدرس اینترنتی هنر پوستر | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
| پیشنمایش آدرس ویدیو | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| تاریخ انتشار | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | |
| رتبهبندی نقد و بررسی | (✔) | (✔) | (✔) | (✔) | (✔) | ||
| سبک رتبهبندی نقد و بررسی | (✔) | (✔) | (✔) | (✔) | (✔) | ||
| شماره نمایش فصل | ✔ | ✔ | |||||
| شرح مختصر | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| زمان شروع UTC میلی ثانیه (*) | ✔ | ✔ | ✔ | ✔ | |||
| زمان پایان UTC Millis (*) | ✔ | ✔ | ✔ | ✔ | |||
| قیمت پایه | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| نسبت ابعاد تصویر بندانگشتی | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| آدرس تصویر بندانگشتی | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| عنوان | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
| ارتفاع ویدئو | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| عرض ویدئو | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| وزن | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
پیشنمایش تصاویر
اندازههای پیشنهادی برای تصاویر پیشنمایش به شرح زیر است:
| ویژگی | نسبت ابعاد | عرض | ارتفاع |
ASPECT_RATIO_16_9 | ۱۶:۹ | ۲۷۲ نقطه در اینچ | ۱۵۳ نقطه در اینچ |
ASPECT_RATIO_3_2 | ۳:۲ | ۲۲۹.۵ نقطه در اینچ | ۱۵۳ نقطه در اینچ |
ASPECT_RATIO_4_3 | ۴:۳ | ۲۰۴ نقطه در اینچ | ۱۵۳ نقطه در اینچ |
ASPECT_RATIO_1_1 | ۱:۱ | ۱۵۳ نقطه در اینچ | ۱۵۳ نقطه در اینچ |
ASPECT_RATIO_2_3 | ۲:۳ | ۱۰۲ نقطه در اینچ | ۱۵۳ نقطه در اینچ |
ASPECT_RATIO_MOVIE_POSTER | ۱:۱.۴۴۱ | ۱۰۶ نقطه در اینچ | ۱۵۳ نقطه در اینچ |
برای بهترین کیفیت، از ویدیوهای پیشنمایش ۱۶:۹ یا ۴:۳ که حداقل اندازههای مشخصشده در این جدول را دارند، استفاده کنید. برای بهترین تجربه کاربری، از یک لوگوی مات استفاده کنید.
شما میتوانید اندازه دقیق ویدیوی پیشنمایش را با استفاده از VIDEO_WIDTH و VIDEO_HEIGHT مشخص کنید.