تعتمد سمات البرامج الصوتية على نوع المحتوى. يُعلم نوع البرنامج النظام ببيانات التعريف المتوقّعة حتى تتم تعبئة واجهة المستخدم بشكل مناسب. يمكن أن تكون البرامج الصوتية من أحد الأنواع التالية:
استخدِم PreviewProgram.Builder
لإنشاء برنامج. يمكنك الاطّلاع على مزيد من المعلومات حول القيم المحتملة لكل حقل في
مستندات Java لكلّ طريقة ضبط في أداة الإنشاء.
يوضّح المثال التالي كيفية استخدام PreviewProgram.Builder:
PreviewProgram program = new PreviewProgram.Builder()
.setChannelId(channelId)
.setTitle(clip.getTitle())
.setDescription(clip.getDescription())
.setType(TvContractCompat.PreviewPrograms.TYPE_ALBUM)
// Set required attributes
.build();
يوضّح الجدول التالي السمات التي يمكن تعيينها لكل نوع من
برامج الصوت، والروابط المؤدية إلى أداة الضبط المقابلة في
PreviewProgram.Builder. السمات التي تحمل علامة ✔ مطلوبة، أمّا السمات التي تحمل العلامة (✔) فهي اختيارية.
| السمة | مسار | ألبوم | الفنّان | قائمة تشغيل | المحطة |
|---|---|---|---|---|---|
| المؤلف | (✔) | (✔) | (✔) | ||
| مدى التوفّر | (✔) | (✔) | (✔) | (✔) | (✔) |
| معرّف القناة | ✔ | ✔ | ✔ | ✔ | ✔ |
| Content ID | (✔) | (✔) | (✔) | (✔) | (✔) |
| المدة | ✔ | ||||
| النوع | (✔) | (✔) | (✔) | (✔) | (✔) |
| عنوان URI للنية | ✔ | ✔ | ✔ | ✔ | ✔ |
| عدد التفاعلات | (✔) | (✔) | (✔) | ||
| نوع التفاعل | (✔) | (✔) | (✔) | ||
| رقم تعريف موفّر الخدمة الداخلي | (✔) | (✔) | (✔) | (✔) | (✔) |
| محادثة مباشرة | (✔) | ||||
| معرّف الموارد المنتظم (URI) للشعار (*) | (✔) | ||||
| وصف محتوى الشعار (*) | (✔) | ||||
| سعر العرض | (✔) | (✔) | (✔) | (✔) | (✔) |
| نسبة العرض إلى الارتفاع للعمل الفني للملصق | ✔ | ✔ | ✔ | ✔ | ✔ |
| معرّف الموارد المنتظم (URI) لعمل فني الملصقات | ✔ | ✔ | ✔ | ✔ | ✔ |
| معرّف الموارد المنتظم (URI) الخاص بالصوت | (✔) | (✔) | (✔) | (✔) | (✔) |
| معرّف الموارد المنتظم (URI) لفيديو المعاينة | (✔) | (✔) | (✔) | (✔) | (✔) |
| تاريخ الإصدار | (✔) | (✔) | |||
| Short Description | (✔) | (✔) | (✔) | (✔) | (✔) |
| السعر المبدئي | (✔) | (✔) | (✔) | (✔) | (✔) |
| نسبة العرض إلى الارتفاع للصورة المصغّرة | (✔) | (✔) | (✔) | (✔) | (✔) |
| معرّف الموارد المنتظم (URI) للصورة المصغّرة | (✔) | (✔) | (✔) | (✔) | (✔) |
| العنوان | ✔ | ✔ | ✔ | ✔ | ✔ |
| ارتفاع الفيديو | (✔) | (✔) | (✔) | (✔) | (✔) |
| عرض الفيديو | (✔) | (✔) | (✔) | (✔) | (✔) |
| الوزن | (✔) | (✔) | (✔) | (✔) | (✔) |