Cast 프레임워크는 현재 콘텐츠 목록 생성을 지원하는 큐 API를 제공합니다.
웹에서 순서대로 재생될 동영상 또는 오디오 스트림 등의 콘텐츠 항목
수신자입니다. 콘텐츠 항목의 대기열은 수정, 재정렬, 업데이트 등을 할 수 있으며
합니다.
웹 수신기 SDK는 큐를 유지하고
있는 경우 현재 재생목록에 현재 하나 이상의 항목 (재생 중 또는
일시중지됨). 발신자는 세션에 참여하고 항목을 대기열에 추가할 수 있습니다. 수신자
마지막 항목이 재생을 완료할 때까지 또는
발신자가 재생을 중지하고 세션을 종료하거나, 또는 발신자가
수신자에 새 큐를 로드합니다. 수신자는
기본적으로 종료된 큐에 대한 정보 대기열의 마지막 항목이
완료되면 미디어 세션이 종료되고 대기열이 사라집니다.
미디어 대기열 항목 만들기 및 로드
iOS에서 미디어 큐 항목은 Cast 프레임워크에서
GCKMediaQueueItem 인스턴스
적응형 콘텐츠로 미디어 대기열 항목을 만들 때
미리 로드 시간을 사용하여 플레이어가 미디어 대기열 항목 버퍼링을 시작할 수 있도록 합니다.
재생이 완료될 때까지 기다릴 필요가 없습니다. 다음에서 미리 로드에 관해 자세히 알아보기
웹 수신기 미리 로드 가이드
항목의 자동재생 설정
속성을 true로 설정하면 웹 수신기가 동영상을 자동으로 재생할 수 있습니다. 예를 들어
다음과 같이 빌더 패턴을 사용하여 미디어 대기열 항목을 만들 수 있습니다.
<ph type="x-smartling-placeholder"></ph>
<ph type="x-smartling-placeholder"></ph>
Swift
웹 수신기는 미디어 대기열 항목을 로드할 때
세션 기간 (및 대기열의 수명) 동안 지속되는 항목입니다.
현재 로드되어 있는 항목을 나타내는 대기열의 상태를 알 수 있습니다.
로드 중 또는 미리 로드되어 있지 않을 수 있습니다. 또한 주문 상품을
할 수 있습니다. 이
GCKMediaStatus 드림
클래스는 다음 상태 정보를 제공합니다.
이 회원을 다른 미디어 상태 구성원과 함께 사용하여
앱에 대기열 상태 및 항목의 상태를 알립니다. 또한
미디어 상태 업데이트를 수신하면
-[remoteMediaClientDidUpdateQueue:]를 구현하여 큐에
GCKRemoteMediaClientListener
현재 재생목록 수정
큐의 항목으로 작업하려면
GCKRemoteMediaClient
API가 여러 개 있습니다 이를 통해 항목 배열을 새 큐에 로드하고
기존 대기열에 항목을 삽입하거나,
대기열에서 항목을 앞뒤로 건너뛰게 하고,
큐 자체 (예: 다음 객체를 선택하는 repeatMode 변경)
항목을 찾고, 대기열에서 항목을 삭제한 다음, 대기열의 항목을 재정렬하는 것입니다.
[null,null,["최종 업데이트: 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."]]
