cast.
معلومات عنصر قائمة الانتظار. قد يحتاج مطورو التطبيقات إلى إنشاء QueueItem لإدراج عنصر قائمة الانتظار باستخدام Cast.framework.messages.InsertQueueItems. في هذه الحالة، يجب ألا يقدّم العنصر itemId (لأنّه سيتم تخصيص معرّف itemId الفعلي عند إدراج العنصر في قائمة الانتظار). ويمنع ذلك تضارب المعرّف مع العناصر التي تمت إضافتها من تطبيق المُرسِل.
الشركة المصنِّعة
QueueItem
new QueueItem(opt_itemId)
المَعلمة |
|
|---|---|
|
opt_itemId |
إجراء اختياري الرقم معرّف السلعة. |
أماكن إقامة
activeTrackIds
(مصفوفة أرقام غير فارغة أو غير محددة)
مصفوفة من معرّفات TrackId النشطة. وإذا لم تتوفر المصفوفة، ستكون المسارات التلقائية نشطة.
التشغيل التلقائي
(منطقية أو غير محدّدة)
إذا لم يتم تحديد معلَمة التشغيل التلقائي أو كانت صحيحة، سيبدأ مشغّل الوسائط في تشغيل العنصر في قائمة الانتظار عندما يصبح العنصر العنصر الحالي.
customData
(كائن قابل للقيم الفارغة أو غير محدّد)
يمكن للتطبيق تحديد أي معلومات إضافية مطلوبة عن عنصر قائمة الانتظار.
itemId
(رقم أو غير محدد)
المعرّف الفريد للسلعة في قائمة الانتظار. السمة اختيارية لأنّه يجب عدم تقديم السمة LOAD أو INSERT (لأنّها سيتم تخصيصها للمستلم عند إنشاء/إدراج عنصر لأول مرة).
وسائط
(cast.framework.messages.MediaInformation غير فارغة أو غير محدّدة)
البيانات الوصفية (بما في ذلك contentId) لعنصر قائمة التشغيل
orderId
(رقم أو غير محدد)
يتم استخدامه لتتبُّع الطلب الأصلي لعنصر في قائمة الانتظار للتراجع عن التبديل العشوائي.
preloadTime
(رقم أو غير محدد)
هذه المَعلمة هي تلميح للمستلم بتحميل عنصر الوسائط هذا مسبقًا قبل تشغيله. وتتيح هذه الميزة التنقّل بسلاسة بين العناصر التي يتم تشغيلها من قائمة المحتوى التالي. ويتم التعبير عن الوقت بالثواني، مقارنةً ببداية تشغيل هذا العنصر (عادةً ما تكون نهاية تشغيل العنصر السابق). على سبيل المثال، إذا كانت القيمة 10 ثوانٍ، سيتم تحميل هذا العنصر مسبقًا قبل 10 ثوانٍ من انتهاء العنصر السابق. سيحاول المستلِم استخدام هذه القيمة ولكنّه لن يضمنها. على سبيل المثال، إذا كانت القيمة أكبر من مدة العنصر السابقة، قد يحمّل المستلم هذا العنصر مسبقًا بعد وقت قصير من بدء تشغيل العنصر السابق (لن يتم أبدًا تحميل عنصرين مسبقًا بالتوازي). بالإضافة إلى ذلك، إذا تم إدراج عنصر في قائمة الانتظار بعد العنصر الحالي مباشرةً وكان وقت التحميل المُسبق أطول من الوقت المتبقي على العنصر الحالي، سيتم تنفيذ عملية التحميل المُسبق في أقرب وقت ممكن. وتعمل القيم السلبية على إيقاف التحميل المُسبق بشكلٍ صريح. وإذا كانت القيمة 0 أو غير محدّدة، سيبدأ تحميل الوسائط مسبقًا فور تنزيل العنصر السابق بالكامل بعد موضع التشغيل الخاص به.
startTime
(رقم أو غير محدد)
عدد الثواني منذ بداية المحتوى. إذا كان المحتوى عبارة عن محتوى مباشر ولم يتم تحديد وقت البدء، سيبدأ البث من الموضع المباشر.