cast.
بيانات طلب INSERT قائمة انتظار أحداث الوسائط.
الشركة المصنِّعة
QueueInsertRequestData
new QueueInsertRequestData(items)
المَعلمة |
|
|---|---|
|
عناصر |
مصفوفة cast.framework.messages.QueueItem غير الفارغة قائمة عناصر قائمة الانتظار يجب أن يكون حقل معرّف السلعة فارغًا، وإلا سيتعذّر تنفيذ الطلب مع ظهور خطأ INVALID_PARAMS. يتم ترتيب العنصر (سيتم تشغيل العنصر الأول أولاً). يجب ألا تكون القيمة فارغة. |
أماكن إقامة
currentItemId
(رقم أو غير محدد)
رقم تعريف عنصر الوسائط الحالي بعد الإدراج (إذا لم يتم توفيره، ستكون قيمة العنصر الحالي هي نفسها القيمة قبل الإدراج).
currentItemIndex
(رقم أو غير محدد)
الفهرس (بالنسبة إلى مصفوفة العناصر، يبدأ بالرقم 0) لعنصر الوسائط الحالي الجديد. بالنسبة إلى العناصر المدرجة، نستخدم الفهرس (يشبه startIndex في QUEUE_LOAD) وليس currentItemId، لأنّ معرّف itemId غير معروف إلى أن يتم إدراج العناصر. في حال عدم توفير القيمة، ستكون قيمة currentItem نفسها هي نفسها القيمة التي كانت عليها قبل الإدراج (ما لم يتم تقديم معرّف Currents الحالي). تسمح هذه المعلَمة بإنشاء حالة الاستخدام الشائعة لإدراج عنصر وتشغيله.
currentTime
(رقم أو غير محدد)
تمثّل هذه السمة ثوانٍ منذ بداية المحتوى لبدء تشغيل العنصر الحالي. وفي حال توفير هذه القيمة، سيتم منحها الأولوية على قيمة startTime المقدّمة على مستوى QueueItem ولكن في المرة الأولى فقط تشغيل العنصر. يتناول هذا الأمر الحالة الشائعة التي ينتقل فيها المستخدم إلى منتصف العنصر كي لا ينطبق الوقت الحالي على العنصر بشكل دائم كما ينطبق على QueueItem startTime. وتجنّب الحاجة إلى إعادة ضبط وقت البدء ديناميكيًا (قد لا يكون ذلك ممكنًا إذا كان الهاتف في وضع السكون).
customData
(كائن غير فارغ أو غير محدد)
البيانات الخاصة بالتطبيق لهذا الطلب. وتتيح هذه الخدمة للمرسِل والمستلِم توسيع بروتوكول الوسائط بسهولة بدون الحاجة إلى استخدام مساحة اسم جديدة مع الرسائل المخصّصة.
insertBefore
(رقم أو غير محدد)
رقم تعريف العنصر الذي سيتم وضعه بعد القائمة المدرجة مباشرةً. إذا لم يتم العثور على المعرّف أو لم يتم تقديمه، سيتمّ إلحاق القائمة في نهاية القائمة الحالية.
عناصر
مصفوفة cast.framework.messages.QueueItem غير فارغة
قائمة عناصر قائمة الانتظار يجب أن يكون حقل itemId للعناصر فارغًا. يتم ترتيب العنصر (سيتم تشغيل العنصر الأول أولاً).
mediaSessionId
(رقم أو غير محدد)
رقم تعريف جلسة الوسائط التي ينطبق عليها الطلب.
requestId
الرقم
معرّف الطلب، يُستخدم لربط الطلب/الاستجابة.
sequenceNumber
(رقم أو غير محدد)
رقم لمزامنة جميع أوامر قائمة الانتظار. وفي حال توفير هذه الأداة لأحد طلبات قائمة المحتوى التالي، ستتحقّق حزمة تطوير البرامج (SDK) من تطابق أحدث رقم تسلسلي لقائمة الانتظار مع الطلب. يتم توفير التسلسل الحالي رقم كجزء من الرسائل التي تم تغييرها في قائمة الانتظار الصادرة.