Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Le framework Cast fournit des API de mise en file d'attente qui permettent de créer des listes
éléments de contenu, tels que des flux vidéo ou audio, à lire de manière séquentielle sur le Web
Récepteur. La file d'attente des éléments de contenu peut être modifiée, réorganisée, mise à jour, etc.
avant.
Le SDK Web Receiver gère la file d'attente et répond aux opérations effectuées sur le
de la file d'attente tant qu'elle contient au moins un élément actif (en cours de lecture ou
en pause). Les expéditeurs peuvent rejoindre la session et ajouter des éléments à la file d'attente. Le destinataire
maintient une session pour les éléments de la file d'attente jusqu'à la fin de la lecture du dernier élément ou
l'émetteur arrête la lecture et met fin à la session, ou jusqu'à ce qu'un expéditeur
charge une nouvelle file d'attente sur le récepteur. Le récepteur ne gère pas
des informations sur les files d'attente
arrêtées par défaut. Une fois que le dernier élément de la file d'attente
se termine, la session multimédia se termine
et la file d'attente disparaît.
Créer et charger des éléments de file d'attente multimédia
Sous iOS, un élément de file d'attente multimédia est représenté dans le framework Cast sous la forme d'un
Instance GCKMediaQueueItem.
Lorsque vous créez un élément de file d'attente multimédia avec du contenu adaptatif, vous pouvez définir le paramètre
temps de préchargement afin que le lecteur puisse commencer à mettre en mémoire tampon l'élément de la file d'attente
la lecture de l'élément qui précède dans la file d'attente est terminée. En savoir plus sur le préchargement dans
la
Guide de préchargement de Web Receiver
Définir la lecture automatique de l'élément
sur "true" permet au récepteur Web de la lire automatiquement. Par exemple :
Vous pouvez utiliser un format de compilateur pour créer un élément de file d'attente multimédia comme suit:
<ph type="x-smartling-placeholder"></ph>
<ph type="x-smartling-placeholder"></ph>
Swift
Chargez un tableau d'éléments de file d'attente de médias dans la file d'attente à l'aide de la classe
Méthode queueLoadItems de
GCKRemoteMediaClient
.
Recevoir une mise à jour de l'état de la file d'attente multimédia
Lorsque le récepteur Web charge un élément de file d'attente multimédia, il attribue un identifiant unique au paramètre
qui persiste pendant toute la durée de la session (et la durée de vie de la file d'attente).
Vous pouvez connaître l'état de la file d'attente indiquant quel élément est actuellement chargé.
(il se peut qu'elle ne soit pas en cours de lecture), en cours de chargement ou préchargée. Vous pouvez également obtenir une commande
liste de tous les éléments de la file d'attente. La
GCKMediaStatus
fournit les informations d'état suivantes:
preloadedItemID
propriété : identifiant de l'élément actuellement préchargé, le cas échéant.
loadingItemID
propriété : identifiant de l'élément en cours de chargement.
currentItemID
propriété : identifiant de l'élément de file d'attente actuel, le cas échéant.
queueItemCount
method : renvoie le nombre d'éléments dans la file d'attente de lecture.
queueItemAtIndex
method : renvoie l'élément à l'index spécifié dans la file d'attente de lecture.
Combinez ces membres avec les autres membres du statut des médias pour informer
l'état de la file d'attente et des éléments qui y sont placés. En plus de
des mises à jour de l'état du contenu multimédia à partir de Web Receiver, vous pouvez écouter les modifications
file d'attente en implémentant -[remoteMediaClientDidUpdateQueue:]GCKRemoteMediaClientListener
Modifier la file d'attente
Pour gérer les éléments de la file d'attente, utilisez les méthodes de file d'attente de
GCKRemoteMediaClient
vous disposez de plusieurs API. Ceux-ci vous permettent de charger un tableau
d'éléments dans une nouvelle file d'attente,
insérer des éléments dans une file d'attente existante, mettre à jour les propriétés des éléments dans
faire avancer ou reculer la file d'attente, définir les propriétés de
La file d'attente elle-même (par exemple, modifiez le repeatMode qui sélectionne la
article), supprimer des éléments de la file d'attente et les réorganiser.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/25 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Il n'y a pas l'information dont j'ai besoin","missingTheInformationINeed","thumb-down"],["Trop compliqué/Trop d'étapes","tooComplicatedTooManySteps","thumb-down"],["Obsolète","outOfDate","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Mauvais exemple/Erreur de code","samplesCodeIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 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."]]