cast.
بيانات طلب تحميل قائمة انتظار أحداث الوسائط
الشركة المصنِّعة
QueueLoadRequestData
new QueueLoadRequestData(items)
المَعلمة |
|
|---|---|
|
عناصر |
مصفوفة cast.framework.messages.QueueItem غير الفارغة قائمة عناصر قائمة الانتظار يجب أن يكون حقل معرّف السلعة فارغًا، وإلا سيتعذّر تنفيذ الطلب مع ظهور خطأ INVALID_PARAMS. يتم ترتيب العنصر (سيتم تشغيل العنصر الأول أولاً). يجب ألا تكون القيمة فارغة. |
أماكن إقامة
currentTime
(رقم أو غير محدد)
الثواني (منذ بداية المحتوى) لبدء تشغيل أول عنصر سيتم تشغيله. وفي حال توفير هذه القيمة، سيكون لها الأولوية على قيمة startTime المقدّمة على مستوى QueueItem ولكن في المرة الأولى فقط تشغيل العنصر. وينطبق هذا على الحالة الشائعة التي يحوّل فيها المستخدم العنصر الذي كان يجري تشغيله محليًا، ولذلك لا ينطبق الوقت الحالي على العنصر بشكل دائم كما هو الحال بالنسبة إلى وقت بدء عنصر QueueItem. وتجنّب الحاجة إلى إعادة ضبط وقت البدء ديناميكيًا (قد لا يكون ذلك ممكنًا إذا كان الهاتف في وضع السكون).
customData
(كائن غير فارغ أو غير محدد)
البيانات الخاصة بالتطبيق لهذا الطلب. وتتيح هذه الخدمة للمرسِل والمستلِم توسيع بروتوكول الوسائط بسهولة بدون الحاجة إلى استخدام مساحة اسم جديدة مع الرسائل المخصّصة.
عناصر
مصفوفة cast.framework.messages.QueueItem غير فارغة
مصفوفة من عناصر قائمة الانتظار. تم فرزه (سيتم تشغيل العنصر الأول أولاً).
mediaSessionId
(رقم أو غير محدد)
رقم تعريف جلسة الوسائط التي ينطبق عليها الطلب.
repeatMode
(cast.framework.messages.RepeatMode أو غير محدّد)
سلوك قائمة الانتظار عند تشغيل جميع العناصر
requestId
الرقم
معرّف الطلب، يُستخدم لربط الطلب/الاستجابة.
sequenceNumber
(رقم أو غير محدد)
رقم لمزامنة جميع أوامر قائمة الانتظار. وفي حال توفير هذه الأداة لأحد طلبات قائمة المحتوى التالي، ستتحقّق حزمة تطوير البرامج (SDK) من تطابق أحدث رقم تسلسلي لقائمة الانتظار مع الطلب. يتم توفير التسلسل الحالي رقم كجزء من الرسائل التي تم تغييرها في قائمة الانتظار الصادرة.
startIndex
(رقم أو غير محدد)
فهرس العنصر في مصفوفة السلع الذي يجب أن يكون أول عنصر حالي (العنصر الذي سيتم تشغيله أولاً). يُرجى العِلم أنّ هذا هو فهرس المصفوفة (يبدأ بـ 0) وليس itemId (لأنّه لا يكون معروفًا حتى يتم إنشاء قائمة الانتظار). إذا تم ضبط RePEAT_OFF على REPEAT_OFF وسينتهي التشغيل عند تشغيل آخر عنصر في المصفوفة (لن يتم تشغيل العناصر السابقة لفهرس startIndex). قد يكون ذلك مفيدًا لسيناريوهات الحالات التي يكون فيها المستخدم يستخدم تطبيق المُرسِل، وفي المنتصف يقرِّر البث. وبهذه الطريقة، لا يحتاج تطبيق المرسِل إلى الربط بين مواضع قائمة الانتظار المحلية والبعيدة أو حفظ طلب QUEUE_UPDATE إضافي.