شناسه مورد رسانه فعلی پس از تغییرات (در صورت عدم ارائه یا یافتن نشدن، مقدار currentItem مانند قبل از بهروزرسانی خواهد بود).
زمان جاری
(تعداد یا تعریف نشده)
چند ثانیه از شروع محتوا برای شروع پخش مورد فعلی. اگر ارائه شود، این مقدار بر مقدار startTime ارائه شده در سطح QueueItem ارجحیت خواهد داشت، اما فقط اولین باری که آیتم پخش می شود. این برای پوشش حالت معمولی است که در آن کاربر به وسط یک آیتم میپرد، به طوری که CurrentTime برای همیشه مانند QueueItem startTime برای آن مورد اعمال نمیشود. از بازنشانی زمان شروع به صورت پویا جلوگیری می کند (اگر تلفن به حالت خواب رفته باشد، ممکن است این امکان پذیر نباشد).
داده های سفارشی
(شیء غیر تهی یا تعریف نشده)
داده های ویژه برنامه برای این درخواست. فرستنده و گیرنده را قادر می سازد تا به راحتی پروتکل رسانه را بدون نیاز به استفاده از فضای نام جدید با پیام های سفارشی گسترش دهند.
لیست موارد صف که باید به روز شوند. هیچ سفارش مجددی انجام نخواهد شد، اقلام نظم موجود را حفظ خواهند کرد.
پرش
(تعداد یا تعریف نشده)
پرش/برگشت تعداد آیتم ها با توجه به موقعیت فعلی آیتم (می تواند منفی باشد). اگر خارج از مرزها باشد، CurrentItem آیتم منطقی بعدی در صف بسته بندی در اطراف مرزها خواهد بود. موقعیت جدید currentItem از قوانین رفتار تکرار صف پیروی می کند.
mediaSessionId
(تعداد یا تعریف نشده)
شناسه جلسه رسانه ای که درخواست برای آن اعمال می شود.
عددی برای همگام سازی تمام دستورات صف. اگر برای یک فرمان صف ارائه شده باشد، SDK تأیید خواهد کرد که آخرین شماره دنباله صف مطابق با درخواست است. sequenceNumber فعلی به عنوان بخشی از پیام های تغییر صف خروجی ارائه می شود.
تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","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"]],["تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003e\u003ccode\u003eQueueUpdateRequestData\u003c/code\u003e is used to send requests for updating the media queue, such as changing the current item, playback time, or reordering items.\u003c/p\u003e\n"],["\u003cp\u003eIt includes properties for specifying the desired changes, like \u003ccode\u003ecurrentItemId\u003c/code\u003e, \u003ccode\u003ecurrentTime\u003c/code\u003e, \u003ccode\u003eitems\u003c/code\u003e, \u003ccode\u003erepeatMode\u003c/code\u003e, and \u003ccode\u003eshuffle\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003ecustomData\u003c/code\u003e enables the sender and receiver to exchange application-specific information alongside the queue update request.\u003c/p\u003e\n"],["\u003cp\u003eThe request also includes properties for identification and synchronization, like \u003ccode\u003erequestId\u003c/code\u003e, \u003ccode\u003emediaSessionId\u003c/code\u003e, and \u003ccode\u003esequenceNumber\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can use this data structure to build robust media playback experiences with features like queue management, playback control, and custom application logic.\u003c/p\u003e\n"]]],["`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"],null,[]]