درخواست برای سفارش مجدد فهرستی از آیتم های رسانه در صف.
سازنده
QueueReorderItemsRequest
جدید QueueReorderItemsRequest(itemIdsToReorder)
پارامتر
itemIdsToReorder
آرایه اعداد
فهرست شناسه‌های آیتم‌های رسانه‌ای که می‌خواهید مرتب شوند. نباید پوچ یا خالی باشد.
مقدار نباید صفر باشد.
خواص
داده های سفارشی
شیء پوچ
داده های سفارشی برای برنامه گیرنده.
درج قبل از
عدد پوچ
شناسه موردی که بلافاصله پس از فهرست سفارش‌دهی مجدد قرار می‌گیرد. اگر تهی یا یافت نشد، لیست دوباره ترتیب داده شده در انتهای صف اضافه می شود. این شناسه نمی تواند یکی از شناسه های موجود در لیست ItemIds باشد.
ItemIds
آرایه اعداد غیر تهی
فهرست شناسه‌های آیتم‌های رسانه‌ای برای سفارش مجدد، به ترتیب جدید. اقلامی که ارائه نشده اند، سفارش موجود خود را حفظ می کنند (بدون اینکه اقلام دوباره سفارش داده شوند). لیست ارائه شده در موقعیت تعیین شده توسط insertBefore درج می شود.
مثلا:
اگر insertBefore مشخص نشده باشد صف موجود: «A»، «D»، «G»، «H»، «B»، «E» itemIds: «D»، «H»، «B» ترتیب جدید: «A» "G"، "E"، "D"، "H"، "B"
اگر insertBefore "A" باشد صف موجود: "A", "D", "G", "H", "B" itemIds: "D", "H", "B" ترتیب جدید: "D","H "B"، "A"، "G"، "E"
اگر insertBefore "G" باشد صف موجود: "A", "D", "G", "H", "B" itemIds: "D", "H", "B" ترتیب جدید: "A", "D" "H"، "B"، "G"، "E"
اگر هر یک از موارد وجود نداشته باشد نادیده گرفته می شود. نباید پوچ یا خالی باشد.
تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003e\u003ccode\u003echrome.cast.media.QueueReorderItemsRequest\u003c/code\u003e is used to change the playback order of media items within a queue on a cast receiver.\u003c/p\u003e\n"],["\u003cp\u003eIt requires a list of media item IDs (\u003ccode\u003eitemIds\u003c/code\u003e) to reorder and optionally an \u003ccode\u003einsertBefore\u003c/code\u003e item ID to specify the position in the queue.\u003c/p\u003e\n"],["\u003cp\u003eItems not specified in the \u003ccode\u003eitemIds\u003c/code\u003e array retain their original order relative to each other, with the reordered items inserted as a block.\u003c/p\u003e\n"],["\u003cp\u003eThe reordered items are placed before the item specified by \u003ccode\u003einsertBefore\u003c/code\u003e, or appended to the end of the queue if \u003ccode\u003einsertBefore\u003c/code\u003e is not provided or is invalid.\u003c/p\u003e\n"],["\u003cp\u003eCustom data can be passed to the receiver application using the \u003ccode\u003ecustomData\u003c/code\u003e property.\u003c/p\u003e\n"]]],["The `QueueReorderItemsRequest` class is used to rearrange media items within a queue. It requires an array of `itemIds` to specify the items and their new order. The `insertBefore` property determines where to place the reordered list; if null, it's appended to the end. Items not listed retain their positions, while non-existent items are ignored. Custom data for the receiver can be set. The reordered list will be in the position as specified in the `insertBefore` property.\n"],null,["# Class: QueueReorderItemsRequest\n\nchrome.[cast](/cast/docs/reference/web_sender/chrome.cast).[media](/cast/docs/reference/web_sender/chrome.cast.media).QueueReorderItemsRequest\n==============================================================================================================================================\n\nclass static\n\nA request to reorder a list of media items in the queue.\n\nConstructor\n-----------\n\n### QueueReorderItemsRequest\n\nnew\nQueueReorderItemsRequest(itemIdsToReorder)\n\n| #### Parameter ||\n|------------------|-----------------------------------------------------------------------------------------------------------|\n| itemIdsToReorder | Array of number The list of media item IDs to reorder. Must not be null or empty. Value must not be null. |\n\nProperties\n----------\n\n### customData\n\nnullable Object\n\nCustom data for the receiver application.\n\n### insertBefore\n\nnullable number\n\nID of the item that will be located immediately after the reordered list.\nIf null or not found, the reordered list will be appended at the end of\nthe queue. This ID can not be one of the IDs in the itemIds list.\n\n### itemIds\n\nnon-null Array of number\n\nThe list of media item IDs to reorder, in the new order. Items not\nprovided will keep their existing order (without the items being\nreordered). The provided list will be inserted at the position determined\nby insertBefore.\n\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\nIf any of the items does not exist it will be ignored.\nMust not be null or empty."]]
