سمات برنامج الفيديو

تعتمد سمات برنامج الفيديو على نوع المحتوى الذي يتضمّنه. يحدد نوع البرنامج نوع البيانات الوصفية التي يتوقعها النظام حتى يمكن ملء واجهة المستخدم بشكل مناسب.

يمكن أن تكون برامج الفيديو من أحد الأنواع التالية:

استخدِم 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. السمات التي تحمل العلامة مطلوبة، أما تلك التي تحمل العلامة (✔) فهي اختيارية.

السمة فيلم مسلسل تلفزيوني موسم تلفزيوني حلقة تلفزيونية مقطع الحدث القناة
المؤلف (✔)
مدى التوفّر (✔)(✔)(✔)(✔)(✔)(✔)(✔)
الأنواع الأساسية (✔)(✔)(✔)(✔)
معرّف القناة
Content ID (✔)
التقييمات حسب الفئة العمرية (✔)(✔) (✔)(✔) (✔)(✔)(✔)
DurationMillis (✔)
رقم الحلقة
عنوان الحلقة (✔)
النوع (✔)(✔) (✔)(✔)
معرّف الموارد المنتظم (URI) للنية
عدد التفاعلات (✔)(✔)
نوع التفاعل (✔)(✔)
معرّف المزوّد الداخلي (✔)(✔)(✔)(✔)(✔)(✔)(✔)
عدد العناصر(✔) (✔)
بث مباشر (✔)(✔)(✔)(✔)(✔)
معرّف الموارد المنتظم (URI) الخاص بالشعار (*) (✔)(✔)(✔)(✔)(✔)(✔)(✔)
وصف محتوى الشعار (*) (✔)(✔)(✔)(✔)(✔)(✔)(✔)
سعر العرض (✔)(✔)(✔)(✔)(✔)(✔)(✔)
نسبة العرض إلى الارتفاع للعمل الفني الخاص بالملصق
معرّف الموارد المنتظم (URI) للعمل الفني للملصق
معرّف الموارد المنتظم (URI) الخاص بفيديو المعاينة (✔)(✔)(✔)(✔)(✔)(✔)(✔)
تاريخ الإصدار (✔)(✔)(✔)(✔)(✔)(✔)
تقييم المراجعة (✔)(✔)(✔)(✔)(✔)
نمط تقييم المراجعة (✔)(✔)(✔)(✔)(✔)
رقم الموسم المعروض
Short Description (✔)(✔)(✔)(✔)(✔)(✔)(✔)
وقت البدء بالملّي ثانية حسب التوقيت العالمي المنسَّق (*)
وقت الانتهاء بالملّي ثانية حسب التوقيت العالمي المنسَّق (*)
السعر المبدئي (✔)(✔)(✔)(✔)(✔)(✔)(✔)
نسبة العرض إلى الارتفاع في الصورة المصغّرة (✔)(✔)(✔)(✔)(✔)(✔)(✔)
معرّف الموارد المنتظم (URI) الخاص بالصورة المصغّرة (✔)(✔)(✔)(✔)(✔)(✔)(✔)
اللقب
ارتفاع الفيديو (✔)(✔)(✔)(✔)(✔)(✔)(✔)
عرض الفيديو (✔)(✔)(✔)(✔)(✔)(✔)(✔)
الوزن (✔)(✔)(✔)(✔)(✔)(✔)(✔)
صور المعاينة

في ما يلي الأحجام المقترَحة لصور المعاينة:

السمة نسبة العرض إلى الارتفاع العرض الارتفاع
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.