Mã nhận dạng của Mục nội dung đa phương tiện hiện tại sau khi sắp xếp lại (nếu không được cung cấp, giá trị currentItem sẽ giống như trước khi sắp xếp lại thứ tự).
currentTime
(số hoặc không xác định)
Số giây kể từ khi bắt đầu nội dung để bắt đầu phát mục hiện tại. Nếu được cung cấp, giá trị này sẽ được ưu tiên hơn giá trị startTime được cung cấp ở cấp ShowcaseItem nhưng chỉ trong lần đầu tiên phát mục đó. Đây là cách để xử lý trường hợp phổ biến khi người dùng chuyển đến giữa một mục để currentTime không áp dụng vĩnh viễn cho mục như Hàng đợi startTime. Thao tác này giúp tránh phải đặt lại thời gian bắt đầu một cách linh động (điều này có thể không thực hiện được nếu điện thoại đã chuyển sang chế độ ngủ).
customData
(Đối tượng không rỗng hoặc không xác định)
Dữ liệu dành riêng cho ứng dụng của yêu cầu này. Phương thức này giúp người gửi và người nhận dễ dàng mở rộng giao thức truyền thông mà không phải sử dụng không gian tên mới với các thông báo tuỳ chỉnh.
Mã của mặt hàng sẽ được đặt ngay sau danh sách được sắp xếp lại.
Nếu không tìm thấy hoặc không cung cấp mã, thì danh sách đã sắp xếp lại sẽ được thêm vào cuối danh sách hiện có.
itemIds
mảng số không rỗng
Mã của các mặt hàng cần sắp xếp lại theo thứ tự mới. Các mặt hàng bạn không cung cấp
sẽ được giữ nguyên đơn đặt hàng hiện có. Danh sách đã cung cấp sẽ được chèn vào vị trí do insertBefore xác định.
Ví dụ:
Nếu không chỉ định insertbefore
Hàng đợi hiện có: “A”,”D”,”G”,”H”,”B”,”E”
itemIds: “D”,”H”,”B”
Đơn đặt hàng mới: “A”,”G”,”E”,“D”,”H”,”B”
Nếu insertTrước là "A"
Hàng đợi hiện có: “A”,”D”,”G”,”H”,”B”
itemIds: “D”,”H”,”B”
Đơn đặt hàng mới: “D”,”H”,”B”,“A”,”G”,”E”
Nếu insertTrước là "G"
Hàng đợi hiện có: “A”,”D”,”G”,”H”,”B”
itemIds: “D”,”H”,”B”
Đơn đặt hàng mới: “A”,“D”,”H”,”B”,”G”,”E”
mediaSessionId
(số hoặc không xác định)
Mã của phiên phát nội dung đa phương tiện mà yêu cầu áp dụng.
Một số để đồng bộ hoá tất cả các lệnh trong hàng đợi.
Nếu được cung cấp cho một lệnh trong hàng đợi, SDK sẽ xác minh số thứ tự mới nhất của hàng đợi khớp với yêu cầu.
Hiện tạiseqNumber được cung cấp như một phần của các thông báo đã thay đổi trong hàng đợi gửi đi.
[[["Dễ hiểu","easyToUnderstand","thumb-up"],["Giúp tôi giải quyết được vấn đề","solvedMyProblem","thumb-up"],["Khác","otherUp","thumb-up"]],[["Thiếu thông tin tôi cần","missingTheInformationINeed","thumb-down"],["Quá phức tạp/quá nhiều bước","tooComplicatedTooManySteps","thumb-down"],["Đã lỗi thời","outOfDate","thumb-down"],["Vấn đề về bản dịch","translationIssue","thumb-down"],["Vấn đề về mẫu/mã","samplesCodeIssue","thumb-down"],["Khác","otherDown","thumb-down"]],["Cập nhật lần gần đây nhất: 2025-07-25 UTC."],[[["\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)"]]
