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

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

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

استخدِم 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) لصورة الملصقات
معاينة معرّف الموارد المنتظم (URI) للفيديو (✔)(✔)(✔)(✔)(✔)(✔)(✔)
تاريخ الإصدار (✔)(✔)(✔)(✔)(✔)(✔)
تقييم المراجعة (✔)(✔)(✔)(✔)(✔)
مراجعة نمط التقييم (✔)(✔)(✔)(✔)(✔)
الرقم المعروض للموسم
وصف قصير (✔)(✔)(✔)(✔)(✔)(✔)(✔)
وقت البدء بالتوقيت العالمي المنسّق (UTC بالمللي) (*)
وقت الانتهاء حسب التوقيت العالمي المنسّق بالمللي (*)
السعر الابتدائي (✔)(✔)(✔)(✔)(✔)(✔)(✔)
نسبة عرض الصورة المصغّرة (✔)(✔)(✔)(✔)(✔)(✔)(✔)
معرّف الموارد المنتظم (URI) للصورة المصغّرة (✔)(✔)(✔)(✔)(✔)(✔)(✔)
العنوان
طول الفيديو (✔)(✔)(✔)(✔)(✔)(✔)(✔)
عرض الفيديو (✔)(✔)(✔)(✔)(✔)(✔)(✔)
الوزن (✔)(✔)(✔)(✔)(✔)(✔)(✔)
معاينة الصور

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

السمة نسبة العرض إلى الارتفاع العرض الارتفاع
ASPECT_RATIO_16_9 16:9 272 بكسل مستقل الكثافة 153 بكسل مستقل الكثافة
ASPECT_RATIO_3_2 2:3 229.5 بكسل مستقل الكثافة 153 بكسل مستقل الكثافة
ASPECT_RATIO_4_3 3:4 204 بكسل مستقل الكثافة 153 بكسل مستقل الكثافة
ASPECT_RATIO_1_1 1:1 153 بكسل مستقل الكثافة 153 بكسل مستقل الكثافة
ASPECT_RATIO_2_3 2:3 102 بكسل مستقل الكثافة 153 بكسل مستقل الكثافة
ASPECT_RATIO_MOVIE_POSTER 1.441:1 106 بكسل مستقل الكثافة 153 بكسل مستقل الكثافة

للحصول على أفضل جودة، استخدِم فيديوهات معاينة بنسبة عرض إلى ارتفاع 16:9 أو 4:3 بأحجام محددة على الأقل في هذا الجدول. استخدِم شعارًا غير شفاف لتحقيق أفضل تجربة للمستخدم.

يمكنك تحديد أحجام معاينة الفيديو الدقيقة باستخدام VIDEO_WIDTH وVIDEO_HEIGHT.