Uma solicitação para reordenar uma lista de itens de mídia na fila.
Construtor
QueueReorderItemsRequest
novo QueueReorderItemsRequest(itemIdsToReorder)
Parâmetro
itemIdsToReorder
Matriz de números
Lista de códigos de itens de mídia para
reordenar. Não pode ser nulo ou vazio.
O valor não pode ser nulo.
Propriedades
customData
objeto anulável
Dados personalizados do aplicativo receptor.
insertBefore
número anulável
Código do item que será localizado imediatamente após a lista reordenada.
Se o valor for nulo ou não for encontrado, a lista reordenada será anexada ao final da
fila. Esse ID não pode ser um dos IDs da lista itemIds.
itemIds
não nulo Matriz de números
Lista de códigos de itens de mídia que serão reordenados, na nova ordem. Os itens não fornecidos manterão o pedido atual (sem que eles sejam reordenados). A lista fornecida será inserida na posição determinada
por insertBefore.
Exemplo:
Se insertBefore não for especificado
Fila existente: “A”,D”,”G”, “H”, “B”,”E”
itemIds: “D”,”H”,”B”
Nova ordem: “A””,G”,E”,“D”,”H”,”B”
Se insertBefore for “A”
Fila existente: “A””,D””,G”,”H”, “B”
itemIds: “D”,”H”,”B”
Nova ordem: “D””,H”, “B”,“A”,”G”,”E”
Se insertBefore for “G”
Fila existente: “A”, “D””,G”,”H”, “B”
itemIds: “D””,H”,”B”
Nova ordem: “A”,“D”, “H”, “B”, “G”,”E”
Se algum dos itens não existir, ele será ignorado.
Não pode ser nulo ou vazio.
[null,null,["Última atualização 2025-07-25 UTC."],[[["\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."]]