Danh sách các mục trong hàng đợi.
Trường itemId của các mặt hàng phải để trống, nếu không yêu cầu sẽ không thành công
kèm theo lỗi INVALID_PARAMS. Thẻ này được sắp xếp (phần tử đầu tiên sẽ được phát trước).
Mã nhận dạng của Mục nội dung đa phương tiện hiện tại sau khi chèn (nếu không được cung cấp, giá trị currentItem sẽ giống như trước khi chèn).
currentItemIndex
(số hoặc không xác định)
Chỉ mục (tương ứng với mảng items, bắt đầu bằng 0) của Mục nội dung đa phương tiện mới hiện tại. Đối với các mục được chèn, chúng tôi sử dụng chỉ mục (tương tự như startIndex trong
Periodic_LOAD) chứ không phải là currentItemId, vì itemId là không xác định cho đến khi
các mục đó được chèn. Nếu không được cung cấp, giá trị currentItem sẽ giữ nguyên như trước khi chèn (trừ khi bạn cung cấp currentItemId).
Tham số này cho phép biến nguyên tử làm trường hợp sử dụng phổ biến để chèn và phát một mục.
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ục sẽ nằm ngay sau danh sách được chèn.
Nếu bạn không tìm thấy hoặc không cung cấp mã nhận dạng, danh sách này sẽ được thêm vào
cuối danh sách hiện có.
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.
[null,null,["Cập nhật lần gần đây nhất: 2025-07-25 UTC."],[[["\u003cp\u003e\u003ccode\u003eQueueInsertRequestData\u003c/code\u003e is used to request insertion of media items into the queue.\u003c/p\u003e\n"],["\u003cp\u003eIt provides parameters to specify the items to be inserted, their position in the queue, and playback behavior.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eitems\u003c/code\u003e field is mandatory and contains an array of \u003ccode\u003eQueueItem\u003c/code\u003e objects representing the media to be inserted.\u003c/p\u003e\n"],["\u003cp\u003eProperties such as \u003ccode\u003ecurrentItemId\u003c/code\u003e, \u003ccode\u003ecurrentItemIndex\u003c/code\u003e, and \u003ccode\u003ecurrentTime\u003c/code\u003e allow for controlling playback after insertion.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003einsertBefore\u003c/code\u003e enables specifying the insertion point within the existing queue.\u003c/p\u003e\n"]]],[],null,["# Class: QueueInsertRequestData\n\ncast.[framework](/cast/docs/reference/web_receiver/cast.framework).[messages](/cast/docs/reference/web_receiver/cast.framework.messages).QueueInsertRequestData\n===============================================================================================================================================================\n\nclass static\n\nMedia event queue INSERT request data.\n\nConstructor\n-----------\n\n### QueueInsertRequestData\n\nnew\nQueueInsertRequestData(items)\n\n| #### Parameter ||\n|-------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| items | Array of non-null [cast.framework.messages.QueueItem](/cast/docs/reference/web_receiver/cast.framework.messages.QueueItem) List of queue items. The itemId field of the items should be empty or the request will fail with an INVALID_PARAMS error. It is sorted (first element will be played first). 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 insertion (if not provided, the\ncurrentItem value will be the same as before the insertion).\n\n### currentItemIndex\n\n(number or undefined)\n\nIndex (relative to the items array, starting with 0) of the new current\nmedia Item. For inserted items we use the index (similar to startIndex in\nQUEUE_LOAD) and not currentItemId, because the itemId is unknown until\nthe items are inserted. If not provided, the currentItem value will be\nthe same as before the insertion (unless currentItemId is provided).\nThis param allows to make atomic the common use case of insert and play\nan item.\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 inserted list.\nIf the ID is not found or it is not provided, the list will be appended\nat the end of the existing list.\n\n### items\n\nnon-null Array of non-null [cast.framework.messages.QueueItem](/cast/docs/reference/web_receiver/cast.framework.messages.QueueItem)\n\nList of queue items. The itemId field of the items should be empty. It is\nsorted (first element will be played first).\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)"]]
