재정렬 후 현재 미디어 항목의 ID입니다. 제공하지 않으면 currentItem 값은 재정렬 전과 동일합니다.
currentTime
(숫자 또는 정의되지 않음)
콘텐츠 시작 후 현재 항목의 재생을 시작한 후 경과된 시간(초)입니다. 제공되는 경우 이 값은 QueueItem 수준에서 제공된 startTime 값보다 우선하지만 항목이 처음 재생될 때만 적용됩니다. 이는 QueueItem startTime처럼 사용자가 항목의 중간으로 이동하는 일반적인 사례를 다루므로 currentTime이 항목에 영구적으로 적용되지 않습니다. startTime을 동적으로 재설정할 필요가 없습니다 (휴대전화가 절전 모드로 전환된 경우에는 불가능할 수 있음).
customData
(null이 아닌 객체 또는 정의되지 않음)
이 요청에 대한 애플리케이션별 데이터입니다. 이를 통해 발신자와 수신자는 맞춤 메시지에 새 네임스페이스를 사용하지 않고도 미디어 프로토콜을 쉽게 확장할 수 있습니다.
[null,null,["최종 업데이트: 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)"]]