رقم تعريف عنصر الوسائط الحالي بعد التغييرات (إذا لم يتم تقديمه أو لم يتم العثور عليه، ستظل قيمة currentItem نفسها كما كانت قبل التعديل).
currentTime
(رقم أو غير محدد)
تمثّل هذه السمة ثوانٍ منذ بداية المحتوى لبدء تشغيل العنصر الحالي. وفي حال توفير هذه القيمة، سيتم منحها الأولوية على قيمة startTime
المقدّمة على مستوى QueueItem ولكن في المرة الأولى فقط
تشغيل العنصر. يتناول هذا الأمر الحالة الشائعة التي ينتقل فيها المستخدم إلى منتصف العنصر كي لا ينطبق الوقت الحالي على العنصر بشكل دائم كما ينطبق على QueueItem startTime. وتجنّب الحاجة إلى إعادة ضبط وقت البدء ديناميكيًا (قد لا يكون ذلك ممكنًا إذا كان الهاتف في وضع السكون).
customData
(كائن غير فارغ أو غير محدد)
البيانات الخاصة بالتطبيق لهذا الطلب. وتتيح هذه الخدمة للمرسِل والمستلِم توسيع بروتوكول الوسائط بسهولة بدون الحاجة إلى استخدام مساحة اسم جديدة مع الرسائل المخصّصة.
قائمة بعناصر قائمة الانتظار المطلوب تعديلها لن تتم إعادة الطلب، بل ستحتفظ
السلع بالطلب الحالي.
jump
(رقم أو غير محدد)
التخطّي/الرجوع إلى عدد العناصر السابقة بالنسبة إلى موضع العنصر الحالي (يمكن أن يكون سالبًا). إذا كانت خارج الحدود، سيكون العنصر الحالي العنصر المنطقي التالي في قائمة الانتظار والذي يلتف حول الحدود. سيتّبع موضع العنصر الحالي الجديد قواعد السلوك المتكرر في قائمة الانتظار.
رقم لمزامنة جميع أوامر قائمة الانتظار.
وفي حال توفير هذه الأداة لأحد طلبات قائمة المحتوى التالي، ستتحقّق حزمة تطوير البرامج (SDK) من تطابق أحدث رقم تسلسلي لقائمة الانتظار مع الطلب.
يتم توفير التسلسل الحالي رقم كجزء من الرسائل التي تم تغييرها في قائمة الانتظار الصادرة.
تاريخ التعديل الأخير: 2023-12-02 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2023-12-02 (حسب التوقيت العالمي المتفَّق عليه)"],[[["`QueueUpdateRequestData` is used to send requests for updating the media queue, such as changing the current item, playback time, or reordering items."],["It includes properties for specifying the desired changes, like `currentItemId`, `currentTime`, `items`, `repeatMode`, and `shuffle`."],["`customData` enables the sender and receiver to exchange application-specific information alongside the queue update request."],["The request also includes properties for identification and synchronization, like `requestId`, `mediaSessionId`, and `sequenceNumber`."],["Developers can use this data structure to build robust media playback experiences with features like queue management, playback control, and custom application logic."]]],["`QueueUpdateRequestData` manages updates to a media queue. Key actions include defining the `currentItemId`, adjusting `currentTime` for playback start, and using `customData` for extending the protocol. It allows updating `items` while retaining their order and setting the `repeatMode`. Additionally, it manages jumping/skipping with the `jump`, and shuffling the `items` with the option shuffle. It uses `requestId`, `mediaSessionId`, and `sequenceNumber` for synchronization.\n"]]
