معرّف عنصر الوسائط الحالي بعد إعادة الطلب (إذا لم يتم تقديمه، ستكون قيمة العنصر الحالي
هي نفسها كما كانت قبل إعادة الطلب).
currentTime
(رقم أو غير محدد)
تمثّل هذه السمة ثوانٍ منذ بداية المحتوى لبدء تشغيل العنصر الحالي. وفي حال توفير هذه القيمة، سيتم منحها الأولوية على قيمة startTime
المقدّمة على مستوى QueueItem ولكن في المرة الأولى فقط
تشغيل العنصر. يتناول هذا الأمر الحالة الشائعة التي ينتقل فيها المستخدم إلى منتصف العنصر كي لا ينطبق الوقت الحالي على العنصر بشكل دائم كما ينطبق على QueueItem startTime. وتجنّب الحاجة إلى إعادة ضبط وقت البدء ديناميكيًا (قد لا يكون ذلك ممكنًا إذا كان الهاتف في وضع السكون).
customData
(كائن غير فارغ أو غير محدد)
البيانات الخاصة بالتطبيق لهذا الطلب. وتتيح هذه الخدمة للمرسِل والمستلِم توسيع بروتوكول الوسائط بسهولة بدون الحاجة إلى استخدام مساحة اسم جديدة مع الرسائل المخصّصة.
رقم تعريف العنصر الذي سيتم العثور عليه مباشرةً بعد القائمة المُعاد ترتيبها.
في حال عدم العثور على المعرّف أو عدم تقديمه، سيتم إلحاق القائمة المُعاد ترتيبها في نهاية القائمة الحالية.
itemIds
مصفوفة أرقام غير فارغة
معرّفات السلع التي ستتم إعادة ترتيبها، بالترتيب الجديد. وستبقى السلع التي لم يتمّ توفيرها
للطلب الحالي. سيتم إدراج القائمة المتوفّرة في الموضع الذي يحدّده أمر insertFrom.
مثال:
في حال عدم تحديد InsertFrom
قائمة الانتظار الحالية: "A""",D"""G"""H"""B"""E" itemIds: "D"""H""B"
طلب جديد: "A"""G"""E"""""H""B"
إذا كانت قيمة insertApply هي "أ"
في قائمة الانتظار الحالية: "أ" و"د"""و"" و"ح"" و"ب"
أرقام تعريف العناصر: "د""س"""ب"
طلب جديد: "د""و""و"ب""آ"""""ه""
إذا كانت قيمة InsertIf تساوي "G"
قائمة الانتظار الحالية: "أ" و"د""و"غ""""و""و"ب"
أرقام تعريف العناصر: "د""و"""ب"
طلب جديد: "أ" و"د""و""""""""""ه""
رقم لمزامنة جميع أوامر قائمة الانتظار.
وفي حال توفير هذه الأداة لأحد طلبات قائمة المحتوى التالي، ستتحقّق حزمة تطوير البرامج (SDK) من تطابق أحدث رقم تسلسلي لقائمة الانتظار مع الطلب.
يتم توفير التسلسل الحالي رقم كجزء من الرسائل التي تم تغييرها في قائمة الانتظار الصادرة.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003e\u003ccode\u003eQueueReorderRequestData\u003c/code\u003e is used to request reordering of items in a media queue.\u003c/p\u003e\n"],["\u003cp\u003eIt allows specifying the \u003ccode\u003eitemIds\u003c/code\u003e to be reordered and optionally the \u003ccode\u003einsertBefore\u003c/code\u003e position.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003ecurrentItemId\u003c/code\u003e and \u003ccode\u003ecurrentTime\u003c/code\u003e can be provided to control playback after the reorder.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003ecustomData\u003c/code\u003e can be included for application-specific needs.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003emediaSessionId\u003c/code\u003e, \u003ccode\u003erequestId\u003c/code\u003e, and \u003ccode\u003esequenceNumber\u003c/code\u003e are inherited properties for request management and synchronization.\u003c/p\u003e\n"]]],[],null,["# Class: QueueReorderRequestData\n\ncast.[framework](/cast/docs/reference/web_receiver/cast.framework).[messages](/cast/docs/reference/web_receiver/cast.framework.messages).QueueReorderRequestData\n================================================================================================================================================================\n\nclass static\n\nMedia event queue REORDER request data.\n\nConstructor\n-----------\n\n### QueueReorderRequestData\n\nnew\nQueueReorderRequestData(itemIds)\n\n| #### Parameter ||\n|---------|--------------------------------------------------------------------------|\n| itemIds | Array of number The IDs of the items to reorder. Value must not be null. |\n\nExtends\n: [cast.framework.messages.RequestData](/cast/docs/reference/web_receiver/cast.framework.messages.RequestData)\n\nProperties\n----------\n\n### currentItemId\n\n(number or undefined)\n\nID of the current media Item after the reorder (if not provided, the\ncurrentItem value will be the same as before the reorder).\n\n### currentTime\n\n(number or undefined)\n\nSeconds since the beginning of content to start playback of the current\nitem. If provided, this value will take precedence over the startTime\nvalue provided at the QueueItem level but only the first time the item is\nplayed. This is to cover the common case where the user jumps to the\nmiddle of an item so the currentTime does not apply to the item\npermanently like the QueueItem startTime does. It avoids having to reset\nthe startTime dynamically (that may not be possible if the phone has gone\nto sleep).\n\n### customData\n\n(non-null Object or undefined)\n\nApplication-specific data for this request. It enables the sender and\nreceiver to easily extend the media protocol without having to use a new\nnamespace with custom messages.\n\nInherited from\n: [cast.framework.messages.RequestData#customData](/cast/docs/reference/web_receiver/cast.framework.messages.RequestData#customData)\n\n### insertBefore\n\n(number or undefined)\n\nID of the item that will be located immediately after the reordered list.\nIf the ID is not found or it is not provided, the reordered list will be\nappended at the end of the existing list.\n\n### itemIds\n\nnon-null Array of number\n\nIDs of the items to be reordered, in the new order. Items not provided\nwill keep their existing order. The provided list will be inserted at the\nposition determined by insertBefore.\nFor example:\n\nIf insertBefore is not specified\nExisting queue: \"A\",\"D\",\"G\",\"H\",\"B\",\"E\"\nitemIds: \"D\",\"H\",\"B\"\nNew Order: \"A\",\"G\",\"E\",\"D\",\"H\",\"B\"\n\nIf insertBefore is \"A\"\nExisting queue: \"A\",\"D\",\"G\",\"H\",\"B\"\nitemIds: \"D\",\"H\",\"B\"\nNew Order: \"D\",\"H\",\"B\",\"A\",\"G\",\"E\"\n\nIf insertBefore is \"G\"\nExisting queue: \"A\",\"D\",\"G\",\"H\",\"B\"\nitemIds: \"D\",\"H\",\"B\"\nNew Order: \"A\",\"D\",\"H\",\"B\",\"G\",\"E\"\n\n### mediaSessionId\n\n(number or undefined)\n\nId of the media session that the request applies to.\n\nInherited from\n: [cast.framework.messages.RequestData#mediaSessionId](/cast/docs/reference/web_receiver/cast.framework.messages.RequestData#mediaSessionId)\n\n### requestId\n\nnumber\n\nId of the request, used to correlate request/response.\n\nInherited from\n: [cast.framework.messages.RequestData#requestId](/cast/docs/reference/web_receiver/cast.framework.messages.RequestData#requestId)\n\n### sequenceNumber\n\n(number or undefined)\n\nA number to synchronize all queue commands.\nIf provided for a queue command, the SDK will verify the queue latest\nsequence number match the request.\nCurrent sequenceNumber is provided as part of outgoing queue changed\nmessages.\n\nInherited from\n: [cast.framework.messages.RequestData#sequenceNumber](/cast/docs/reference/web_receiver/cast.framework.messages.RequestData#sequenceNumber)"]]
