تعتمد سمات برنامج الفيديو على نوع المحتوى الذي يتضمّنه. يحدد نوع البرنامج نوع البيانات الوصفية التي يتوقعها النظام حتى يمكن ملء واجهة المستخدم بشكل مناسب.
يمكن أن تكون برامج الفيديو من أحد الأنواع التالية:
استخدِم PreviewProgram.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.
السمات التي تحمل العلامة ✔ مطلوبة، أما تلك التي تحمل العلامة (✔) فهي اختيارية.
صور المعاينة
في ما يلي الأحجام المقترَحة لصور المعاينة:
| السمة | نسبة العرض إلى الارتفاع | العرض | الارتفاع |
ASPECT_RATIO_16_9 |
16:9 | 272 وحدة بكسل مستقلة الكثافة | 153 وحدة بكسل مستقلة الكثافة |
ASPECT_RATIO_3_2 |
3:2 | 229.5 وحدة بكسل مستقلة الكثافة | 153 وحدة بكسل مستقلة الكثافة |
ASPECT_RATIO_4_3 |
4:3 | 204 نقطة | 153 وحدة بكسل مستقلة الكثافة |
ASPECT_RATIO_1_1 |
1:1 | 153 وحدة بكسل مستقلة الكثافة | 153 وحدة بكسل مستقلة الكثافة |
ASPECT_RATIO_2_3 |
2:3 | 102 وحدة بكسل مستقلة الكثافة | 153 وحدة بكسل مستقلة الكثافة |
ASPECT_RATIO_MOVIE_POSTER |
1:1.441 | 106 وحدة بكسل مستقلة الكثافة | 153 وحدة بكسل مستقلة الكثافة |
للحصول على أفضل جودة، استخدم مقاطع فيديو معاينة بنسبة 16:9 أو 4:3 والتي تكون على الأقل بالأحجام المحددة في هذا الجدول. استخدِم شعارًا غير شفاف للحصول على أفضل تجربة للمستخدم.
يمكنك تحديد أحجام معاينات الفيديو الدقيقة باستخدام VIDEO_WIDTH وVIDEO_HEIGHT.