تعتمد سمات البرامج الصوتية على نوع المحتوى. يحدّد نوع البرنامج البيانات الوصفية التي يتوقّعها النظام حتى يمكن ملء واجهة المستخدم بشكل مناسب. يمكن أن تكون البرامج الصوتية أحد الأنواع التالية:
استخدِم 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 | (✔) | (✔) | (✔) | (✔) | (✔) |
| المدة | ✔ | ||||
| النوع | (✔) | (✔) | (✔) | (✔) | (✔) |
| Intent URI | ✔ | ✔ | ✔ | ✔ | ✔ |
| عدد التفاعلات | (✔) | (✔) | (✔) | ||
| نوع التفاعل | (✔) | (✔) | (✔) | ||
| معرّف المزوّد الداخلي | (✔) | (✔) | (✔) | (✔) | (✔) |
| بث مباشر | (✔) | ||||
| Logo URI (*) | (✔) | ||||
| وصف محتوى الشعار (*) | (✔) | ||||
| سعر العرض | (✔) | (✔) | (✔) | (✔) | (✔) |
| نسبة أبعاد فن الملصق | ✔ | ✔ | ✔ | ✔ | ✔ |
| معرّف الموارد المنتظم (URI) للعمل الفني للملصق | ✔ | ✔ | ✔ | ✔ | ✔ |
| معرّف الموارد المنتظم (URI) الخاص بمعاينة الصوت | (✔) | (✔) | (✔) | (✔) | (✔) |
| معرّف الموارد المنتظم (URI) الخاص بفيديو المعاينة | (✔) | (✔) | (✔) | (✔) | (✔) |
| تاريخ الإصدار | (✔) | (✔) | |||
| Short Description | (✔) | (✔) | (✔) | (✔) | (✔) |
| السعر المبدئي | (✔) | (✔) | (✔) | (✔) | (✔) |
| نسبة العرض إلى الارتفاع في الصورة المصغّرة | (✔) | (✔) | (✔) | (✔) | (✔) |
| معرّف الموارد المنتظم (URI) الخاص بالصورة المصغّرة | (✔) | (✔) | (✔) | (✔) | (✔) |
| اللقب | ✔ | ✔ | ✔ | ✔ | ✔ |
| ارتفاع الفيديو | (✔) | (✔) | (✔) | (✔) | (✔) |
| عرض الفيديو | (✔) | (✔) | (✔) | (✔) | (✔) |
| الوزن | (✔) | (✔) | (✔) | (✔) | (✔) |