cast.
بيانات طلب REORDER في قائمة انتظار أحداث الوسائط.
الشركة المصنِّعة
QueueReorderRequestData
new QueueReorderRequestData(itemIds)
المَعلمة |
|
|---|---|
|
itemIds |
مصفوفة أرقام معرّفات السلع المطلوب إعادة ترتيبها. يجب ألا تكون القيمة فارغة. |
أماكن إقامة
currentItemId
(رقم أو غير محدد)
معرّف عنصر الوسائط الحالي بعد إعادة الطلب (إذا لم يتم تقديمه، ستكون قيمة العنصر الحالي هي نفسها كما كانت قبل إعادة الطلب).
currentTime
(رقم أو غير محدد)
تمثّل هذه السمة ثوانٍ منذ بداية المحتوى لبدء تشغيل العنصر الحالي. وفي حال توفير هذه القيمة، سيتم منحها الأولوية على قيمة startTime المقدّمة على مستوى QueueItem ولكن في المرة الأولى فقط تشغيل العنصر. يتناول هذا الأمر الحالة الشائعة التي ينتقل فيها المستخدم إلى منتصف العنصر كي لا ينطبق الوقت الحالي على العنصر بشكل دائم كما ينطبق على QueueItem startTime. وتجنّب الحاجة إلى إعادة ضبط وقت البدء ديناميكيًا (قد لا يكون ذلك ممكنًا إذا كان الهاتف في وضع السكون).
customData
(كائن غير فارغ أو غير محدد)
البيانات الخاصة بالتطبيق لهذا الطلب. وتتيح هذه الخدمة للمرسِل والمستلِم توسيع بروتوكول الوسائط بسهولة بدون الحاجة إلى استخدام مساحة اسم جديدة مع الرسائل المخصّصة.
insertBefore
(رقم أو غير محدد)
رقم تعريف العنصر الذي سيتم العثور عليه مباشرةً بعد القائمة المُعاد ترتيبها. في حال عدم العثور على المعرّف أو عدم تقديمه، سيتم إلحاق القائمة المُعاد ترتيبها في نهاية القائمة الحالية.
itemIds
مصفوفة أرقام غير فارغة
معرّفات السلع التي ستتم إعادة ترتيبها، بالترتيب الجديد. وستبقى السلع التي لم يتمّ توفيرها للطلب الحالي. سيتم إدراج القائمة المتوفّرة في الموضع الذي يحدّده أمر insertFrom. مثال:
في حال عدم تحديد InsertFrom قائمة الانتظار الحالية: "A""",D"""G"""H"""B"""E" itemIds: "D"""H""B" طلب جديد: "A"""G"""E"""""H""B"
إذا كانت قيمة insertApply هي "أ" في قائمة الانتظار الحالية: "أ" و"د"""و"" و"ح"" و"ب" أرقام تعريف العناصر: "د""س"""ب" طلب جديد: "د""و""و"ب""آ"""""ه""
إذا كانت قيمة InsertIf تساوي "G" قائمة الانتظار الحالية: "أ" و"د""و"غ""""و""و"ب" أرقام تعريف العناصر: "د""و"""ب" طلب جديد: "أ" و"د""و""""""""""ه""
mediaSessionId
(رقم أو غير محدد)
رقم تعريف جلسة الوسائط التي ينطبق عليها الطلب.
requestId
الرقم
معرّف الطلب، يُستخدم لربط الطلب/الاستجابة.
sequenceNumber
(رقم أو غير محدد)
رقم لمزامنة جميع أوامر قائمة الانتظار. وفي حال توفير هذه الأداة لأحد طلبات قائمة المحتوى التالي، ستتحقّق حزمة تطوير البرامج (SDK) من تطابق أحدث رقم تسلسلي لقائمة الانتظار مع الطلب. يتم توفير التسلسل الحالي رقم كجزء من الرسائل التي تم تغييرها في قائمة الانتظار الصادرة.