Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
El framework de Cast proporciona APIs en cola que admiten la creación de listas de
elementos de contenido, como reproducciones de audio o video, para que se reproduzcan secuencialmente en la Web
Receptor. La fila de elementos de contenido se puede editar, reordenar, actualizar, etc.
de un proyecto.
El SDK del receptor web mantiene la cola y responde a las operaciones en la
en espera, siempre que esta tenga al menos un elemento activo (en reproducción o
se pausó). Los remitentes pueden unirse a la sesión y agregar elementos a la cola. El receptor
mantiene una sesión para los elementos en cola hasta que el último elemento complete la reproducción o
el emisor detiene la reproducción y finaliza la sesión, o hasta que
carga una nueva cola en el receptor. El receptor no mantiene
información sobre colas finalizadas de forma predeterminada. Cuando el último elemento en la fila
finaliza la sesión multimedia y desaparece la cola.
Cómo crear y cargar elementos de la fila de medios
En iOS, un elemento de la cola de contenido multimedia se representa en el framework de Cast como un
Instancia GCKMediaQueueItem.
Cuando creas un elemento de la fila de contenido multimedia con contenido adaptable, puedes configurar
tiempo de precarga para que el reproductor pueda comenzar a almacenar en búfer el elemento de la cola de medios antes de
el elemento que se encuentra delante de él en la fila termina de reproducirse. Más información sobre la precarga en
el
Guía de precarga de Receptor web.
Configuración de la reproducción automática del elemento
como verdadero, permite que el receptor web lo reproduzca automáticamente. Por ejemplo:
puedes usar un patrón de compilador para crear tu elemento de cola de contenido multimedia de la siguiente manera:
Para cargar un array de elementos de la cola de contenido multimedia en la cola, usa el archivo
método queueLoadItems de la
GCKRemoteMediaClient
.
Recibir actualización del estado de la fila de medios
Cuando el receptor web carga un elemento de la cola de medios, asigna un ID único al
elemento que persiste durante toda la sesión (y la vida de la cola).
Puedes conocer el estado de la cola que indica qué elemento está cargado actualmente
(es posible que no se esté reproduciendo), cargando o precargado. También puedes obtener un pedido
una lista de todos los elementos en la fila. El
GCKMediaStatus
proporciona la siguiente información de estado:
preloadedItemID
propiedad: el ID del elemento que está precargado actualmente, si lo hay.
loadingItemID
propiedad: el ID del elemento que se está cargando en ese momento
currentItemID
propiedad: el ID del elemento de la fila actual, si lo hay.
queueItemCount
método: Muestra el número de elementos en la cola de reproducción.
queueItemAtIndex
método: Muestra el elemento en el índice especificado en la cola de reproducción.
Usa estos miembros junto con otros miembros de tu estado en los medios para informar
app sobre el estado y los elementos en esta. Además de
actualizaciones de estado del contenido multimedia del receptor web, puedes detectar los cambios en el
mediante la implementación de -[remoteMediaClientDidUpdateQueue:] de las
GCKRemoteMediaClientListener
Editar la cola
Para trabajar con los elementos en la cola, usa los métodos de cola de
GCKRemoteMediaClient
tienes varias APIs. Esto te permite cargar un array de elementos en una cola nueva
insertar elementos en una cola existente, actualizar las propiedades de los elementos en la
hacer que un elemento avance o retroceda en la cola, definir las propiedades de
la cola en sí (por ejemplo, cambia el repeatMode que selecciona el siguiente
elemento), quitarlos de la fila y reordenarlos en la fila.
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Falta la información que necesito","missingTheInformationINeed","thumb-down"],["Muy complicado o demasiados pasos","tooComplicatedTooManySteps","thumb-down"],["Desactualizado","outOfDate","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Problema con las muestras o los códigos","samplesCodeIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-07-25 (UTC)"],[[["\u003cp\u003eThe Google Cast framework enables the creation and management of media queues on Web Receivers for sequential playback of audio or video content.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can build media queue items, set autoplay and preload times, and load them into the queue using the \u003ccode\u003eGCKRemoteMediaClient\u003c/code\u003e class.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eGCKMediaStatus\u003c/code\u003e class provides information about the queue's status, including the currently playing, loading, and preloaded items.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eGCKRemoteMediaClient\u003c/code\u003e offers various methods to edit the queue, such as inserting, updating, removing, and reordering items, as well as controlling queue behavior.\u003c/p\u003e\n"],["\u003cp\u003eSender applications should display the upcoming autoplay item from the queue in their user interface to enhance the user experience.\u003c/p\u003e\n"]]],["The Cast framework enables sequential playback of content items (like audio/video) via queueing APIs. Senders can create, edit, reorder, and update queues. The Web Receiver manages the queue as long as it has an active item, maintaining session until the last item finishes or the session is terminated. In iOS, `GCKMediaQueueItem` represents queue items, with options for autoplay and preloading. `GCKMediaStatus` provides information about the loaded, loading, or preloaded item and the queue status. `GCKRemoteMediaClient` allows to load, insert, update, remove, and reorder items.\n"],null,["# Queueing\n\nThe Cast framework provides queueing APIs that support the creation of lists of\ncontent items, such as video or audio streams, to play sequentially on the Web\nReceiver. The queue of content items may be edited, reordered, updated, and so\nforth.\n| **Note:** Review the [Google Cast Autoplay](/cast/docs/design_checklist/cast-autoplay) for best practices when designing an autoplay or queueing experience for Cast.\n\nThe Web Receiver SDK maintains the queue and responds to operations on the\nqueue as long as the queue has at least one item currently active (playing or\npaused). Senders can join the session and add items to the queue. The receiver\nmaintains a session for queue items until the last item completes playback or\nthe sender stops the playback and terminates the session, or until a sender\nloads a new queue on the receiver. The receiver does not maintain any\ninformation about terminated queues by default. Once the last item in the queue\nfinishes, the media session ends and the queue vanishes.\n| **Note:** The [Styled](/cast/docs/styled_receiver) and [Default Media](/cast/docs/web_receiver#default_media_web_receiver) Receivers only support a queue of audio or video streams. To use a queue of images, you must develop a [Custom Receiver](/cast/docs/web_receiver/basic).\n\nCreate and load media queue items\n---------------------------------\n\nIn iOS, a media queue item is represented in the Cast framework as a\n[`GCKMediaQueueItem` instance](/cast/docs/reference/ios/interface_g_c_k_media_queue_item).\nWhen you create a media queue item with adaptive content, you can set the\npreload time so that the player can begin buffering the media queue item before\nthe item ahead of it in the queue finishes playing. See more about preloading in\nthe\n[Web Receiver preloading guide](/cast/docs/web_receiver/core_features#content_preload).\n\nSetting the item's autoplay\nattribute to true allows the Web Receiver to play it automatically. For example,\nyou can use a builder pattern to create your media queue item as follows:\nSwift \n\n```swift\nlet builder = GCKMediaQueueItemBuilder.init()\nbuilder.mediaInformation = mediaInformation\nbuilder.autoplay = true\nbuilder.preloadTime = 8.0\nlet newItem = builder.build()\n```\nObjective-C \n\n```objective-c\nGCKMediaQueueItemBuilder *builder = [[GCKMediaQueueItemBuilder alloc] init];\nbuilder.mediaInformation = self.mediaInformation;\nbuilder.autoplay = YES;\nbuilder.preloadTime = 8.0;\nGCKMediaQueueItem *newItem = [builder build];\n```\n\nLoad an array of media queue items in the queue by using the appropriate\n`queueLoadItems` method of the\n[`GCKRemoteMediaClient`](/cast/docs/reference/ios/interface_g_c_k_remote_media_client)\nclass.\n\nReceive media queue status update\n---------------------------------\n\nWhen the Web Receiver loads a media queue item, it assigns a unique ID to the\nitem that persists for the duration of the session (and the life of the queue).\nYou can learn the status of the queue indicating which item is currently loaded\n(it might not be playing), loading, or preloaded. You can also get an ordered\nlist of all the items in the queue. The\n[`GCKMediaStatus`](/cast/docs/reference/ios/interface_g_c_k_media_status)\nclass provides this status information:\n\n- [`preloadedItemID`](/cast/docs/reference/ios/interface_g_c_k_media_status#aca544cb983806b859c0d62c6e1438150) property - The ID of the item that is currently preloaded, if any.\n- [`loadingItemID`](/cast/docs/reference/ios/interface_g_c_k_media_status#a0676da67792f35cbea8de2bc9015b05d) property - The ID of the item that is currently loading,\n- [`currentItemID`](/cast/docs/reference/ios/interface_g_c_k_media_status#a1818b62cd378f6648d06042dce494c58) property - The ID of the current queue item, if any.\n- [`queueItemCount`](/cast/docs/reference/ios/interface_g_c_k_media_status#a2ba0ff0a3da66b18520c2858388bc58d) method - Returns the number of items in the playback queue.\n- [`queueItemAtIndex`](/cast/docs/reference/ios/interface_g_c_k_media_status#ad1417e02dca50f0cfd5841c614bd41fa) method - Returns the item at the specified index in the playback queue.\n\nUse these members together with the other media status members to inform your\napp about the status of the queue and the items in the queue. In addition to\nmedia status updates from the Web Receiver, you can listen for changes to the\nqueue by implementing `-[remoteMediaClientDidUpdateQueue:]` of the\n[`GCKRemoteMediaClientListener`](/cast/docs/reference/ios/protocol_g_c_k_remote_media_client_listener-p).\n| **Note:** To provide the best user experience, the sender app must show the next autoplay item in the queue in the sender UI.\n\nEdit the queue\n--------------\n\nTo work with the items in the queue, use the queue methods of\n[`GCKRemoteMediaClient`](/cast/docs/reference/ios/interface_g_c_k_remote_media_client).\nyou have several APIs. These let you load an array of items into a new queue,\ninsert items into an existing queue, update the properties of items in the\nqueue, make an item jump forward or backward in the queue, set the properties of\nthe queue itself (for example, change the `repeatMode` that selects the next\nitem), remove items from the queue, and reorder the items in the queue."]]
