Informationen zu Warteschlangenelementen. Anwendungsentwickler müssen möglicherweise ein QueueItem-Objekt erstellen, um ein Warteschlangenelement mithilfe von Cast.framework.messages.InsertQueueItems einzufügen. In diesem Fall sollte keine „itemId“ angegeben werden, da die tatsächliche itemId zugewiesen wird, wenn das Element in die Warteschlange aufgenommen wird. Dadurch werden ID-Konflikte mit Elementen verhindert, die aus einer Absenderanwendung hinzugefügt wurden.
Konstruktor
QueueItem
neu
QueueItem(opt_itemId)
Parameter
opt_itemId
Optional
Zahl
Die Artikel-ID.
Attribute
activeTrackIds
(Ungleich null Array mit Zahl oder nicht definiert)
Array der Track-IDs, die aktiv sind. Wenn das Array nicht angegeben ist, sind die Standard-Tracks aktiv.
Autoplay
(boolesch oder nicht definiert)
Ist der Parameter „autoplay“ nicht angegeben oder auf „true“ gesetzt, beginnt der Mediaplayer mit der Wiedergabe des Elements in der Warteschlange, sobald es zum aktuellen Element wird.
customData
(Objekt, für das Nullwerte zulässig sind oder nicht definiert)
Die Anwendung kann alle zusätzlichen benötigten Informationen zu Warteschlangenelementen definieren.
itemId
(Anzahl oder nicht definiert)
Eindeutige Kennung des Elements in der Warteschlange. Das Attribut ist optional, da für LOAD oder INSERT nicht angegeben werden sollte, da es vom Empfänger zugewiesen wird, wenn ein Element zum ersten Mal erstellt/eingefügt wird.
Metadaten (einschließlich contentId) des Playlist-Elements.
orderId
(Anzahl oder nicht definiert)
Hiermit wird die ursprüngliche Reihenfolge eines Elements in der Warteschlange verfolgt, um den Zufallsmix rückgängig zu machen.
preloadTime
(Anzahl oder nicht definiert)
Dieser Parameter weist den Empfänger darauf hin, dieses Medienelement vorab zu laden, bevor es abgespielt wird. Sie ermöglicht einen reibungslosen Übergang zwischen Elementen, die aus der Warteschlange abgespielt werden. Die Zeit wird in Sekunden bezogen auf den Beginn der Wiedergabe dieses Elements angegeben (normalerweise das Ende der vorherigen Elementwiedergabe). Wenn der Wert beispielsweise 10 Sekunden beträgt, wird dieses Element 10 Sekunden, bevor das vorherige Element beendet ist, vorab geladen. Der Empfänger versucht, diesen Wert zu berücksichtigen, garantiert ihn aber nicht. Wenn der Wert beispielsweise länger als die vorherige Elementdauer ist, lädt der Empfänger dieses Element einfach kurz nach Beginn der Wiedergabe des vorherigen Elements vorab. Es werden nie zwei Elemente gleichzeitig vorab geladen. Wenn ein Element direkt nach dem aktuellen Element in die Warteschlange eingefügt wird und die Zeit für das Vorabladen höher ist als die verbleibende Zeit für das aktuelle Element, wird das Vorabladen so schnell wie möglich durchgeführt. Negative Werte deaktivieren das Vorabladen explizit. Wenn der Wert 0 oder nicht definiert ist, wird das Medienelement vorab geladen, sobald das vorherige Element nach seiner Wiedergabeposition vollständig heruntergeladen wurde.
startTime
(Anzahl oder nicht definiert)
Sekunden seit Beginn des Inhalts. Wenn es sich bei dem Inhalt um Liveinhalte handelt und startTime nicht angegeben ist, startet der Stream an der Liveposition.
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Benötigte Informationen nicht gefunden","missingTheInformationINeed","thumb-down"],["Zu umständlich/zu viele Schritte","tooComplicatedTooManySteps","thumb-down"],["Nicht mehr aktuell","outOfDate","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Problem mit Beispielen/Code","samplesCodeIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2025-07-25 (UTC)."],[[["\u003cp\u003e\u003ccode\u003eQueueItem\u003c/code\u003e objects represent items within a media queue, holding information like media metadata, playback settings, and custom data.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can create \u003ccode\u003eQueueItem\u003c/code\u003e instances to insert elements into the queue, but should omit the \u003ccode\u003eitemId\u003c/code\u003e for new items to avoid conflicts.\u003c/p\u003e\n"],["\u003cp\u003eKey properties of a \u003ccode\u003eQueueItem\u003c/code\u003e include \u003ccode\u003emedia\u003c/code\u003e for content details, \u003ccode\u003eautoplay\u003c/code\u003e and \u003ccode\u003estartTime\u003c/code\u003e for playback control, and \u003ccode\u003epreloadTime\u003c/code\u003e to optimize transitions.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003ecustomData\u003c/code\u003e property allows developers to attach application-specific information to queue items for extended functionality.\u003c/p\u003e\n"],["\u003cp\u003eExisting queue items can be identified and managed using their unique \u003ccode\u003eitemId\u003c/code\u003e, assigned by the receiver upon insertion.\u003c/p\u003e\n"]]],["`QueueItem` stores queue element information. Developers create it for inserting queue elements, omitting `itemId` to prevent collisions. Key properties include: `activeTrackIds` (active track IDs), `autoplay` (automatic playback), `customData` (extra data), `media` (metadata), `orderId` (original order), `preloadTime` (preloading hint), and `startTime` (content start time). `itemId` is assigned by the receiver during creation/insertion, and `preloadTime` helps smooth transitions between queued items.\n"],null,["# Class: QueueItem\n\ncast.[framework](/cast/docs/reference/web_receiver/cast.framework).[messages](/cast/docs/reference/web_receiver/cast.framework.messages).QueueItem\n==================================================================================================================================================\n\nclass static\n\nQueue item information. Application developers may need to create a QueueItem\nto insert a queue element using\ncast.framework.messages.InsertQueueItems. In this case they should\nnot provide an itemId (as the actual itemId will be assigned when the item is\ninserted in the queue). This prevents ID collisions with items added from a\nsender app.\n\nConstructor\n-----------\n\n### QueueItem\n\nnew\nQueueItem(opt_itemId)\n\n| #### Parameter ||\n|------------|------------------------------|\n| opt_itemId | Optional number The item ID. |\n\nProperties\n----------\n\n### activeTrackIds\n\n(non-null Array of number or undefined)\n\nArray of Track trackIds that are active. If the array is not provided,\nthe default tracks will be active.\n\n### autoplay\n\n(boolean or undefined)\n\nIf the autoplay parameter is not specified or is true, the media player\nwill begin playing the element in the queue when the item becomes the\ncurrentItem.\n\n### customData\n\n(nullable Object or undefined)\n\nThe application can define any extra queue item information needed.\n\n### itemId\n\n(number or undefined)\n\nUnique identifier of the item in the queue. The attribute is optional\nbecause for LOAD or INSERT should not be provided (as it will be assigned\nby the receiver when an item is first created/inserted).\n\n### media\n\n(non-null [cast.framework.messages.MediaInformation](/cast/docs/reference/web_receiver/cast.framework.messages.MediaInformation) or undefined)\n\nMetadata (including contentId) of the playlist element.\n\n### orderId\n\n(number or undefined)\n\nUsed to track original order of an item in the queue to undo shuffle.\n\n### preloadTime\n\n(number or undefined)\n\nThis parameter is a hint for the receiver to preload this media item\nbefore it is played. It allows for a smooth transition between items\nplayed from the queue. The time is expressed in seconds, relative to the\nbeginning of this item playback (usually the end of the previous item\nplayback). For example, if the value is 10 seconds, this item will be\npreloaded 10 seconds before the previous item has finished. The receiver\nwill try to honor this value but will not guarantee it, for example if\nthe value is larger than the previous item duration the receiver may just\npreload this item shortly after the previous item has started playing\n(there will never be two items being preloaded in parallel). Also, if an\nitem is inserted in the queue just after the currentItem and the time to\npreload is higher than the time left on the currentItem, the preload will\njust happen as soon as possible. Negative values explicitly disable\npreloading. If the value is 0 or undefined, the media item will start to\npreload as soon as the previous item is fully downloaded after its\nplayback position.\n\n### startTime\n\n(number or undefined)\n\nSeconds since beginning of content. If the content is live content, and\nstartTime is not specified, the stream will start at the live position."]]
