Klasse: Media

Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Konstruktor

Medien

new Media(sessionId, mediaSessionId)

Parameter

sessionId

String

Die Sitzungs-ID.

mediaSessionId (Mediensitzungs-ID)

Zahl

Die Medienkennung.

Attribute

ActiveTrackIds

Nullwert-Array von Zahl

Liste der IDs, die den aktiven Tracks entsprechen.

PauseStatus

(chrome.cast.media.BreakStatus ist nicht null oder nicht definiert)

Status einer Pause, wenn eine Pause auf dem Empfänger abgespielt wird. Dieses Feld wird definiert, wenn der Empfänger eine Pause ausführt, leer ist, wenn keine Pause stattfindet, aber im Inhalt vorhanden ist, und nicht definiert, wenn der Inhalt keine Pausen enthält.

currentItemId (Aktuelle Artikel-ID)

Nullwerte zulässig

Artikel-ID des Artikels, der zum Zeitpunkt der Änderung des Medienstatus in der Warteschlange aktiv war (wird möglicherweise nicht wiedergegeben).

currentTime (Aktuelle Uhrzeit)

Zahl

Die aktuelle Wiedergabeposition in Sekunden seit Beginn des Mediums. Dieses Mitglied wird nur sporadisch aktualisiert, sodass sein Wert häufig veraltet ist. Mit der Methode getEstimatedTime kannst du eine Schätzung der tatsächlichen Wiedergabeposition anhand der letzten vom Empfänger gemeldeten Informationen abrufen.

Verworfen
Verwenden Sie stattdessen „getestimatedTime“.

CustomData

Nullable Object

Benutzerdefiniertes Dataset der Empfängeranwendung.

Inaktivitätsgrund

Nullwert chrome.cast.media.IdleReason

Inaktiver Grund, wenn der Empfänger dies weiß.

items

Nullable-Array von chrome.cast.media.QueueItem, das nicht null ist

Array von sortierten Elementen in der Warteschlange.

liveSeekableRange

(chrome.cast.media.LiveSeekableRange undefiniert oder nicht definiert)

Durchsuchbarer Bereich eines Live- oder Ereignisstreams. Es wird die relative Medienzeit in Sekunden verwendet. Für VOD-Streams ist er nicht definiert.

Laden-Artikel-ID

Nullwerte zulässig

Artikel-ID des Artikels, der gerade auf dem Empfänger geladen wird. Null, wenn gerade kein Element geladen wird.

medien

Nullwert chrome.cast.media.MediaInfo

Medienbeschreibung.

mediaSessionId (Mediensitzungs-ID)

Zahl

Kennzeichnet das Medienelement.

Wiedergaberate

Zahl

Die Wiedergaberate. 1.0 steht für die normale Wiedergabe.

Spielerstatus

chrome.cast.media.PlayerState ungleich null

Entspricht dem Player-Status.

preloadedItemId

Nullwerte zulässig

ID des nächsten Elements, nur verfügbar, wenn es vorab geladen wurde. Auf den Empfängermedien können die Elemente vorab geladen und vorübergehend im Cache gespeichert werden, sodass sie später schneller geladen werden, da die Medien nicht aus dem Netzwerk abgerufen werden müssen.

Warteschlangedaten

(chrome.cast.media.QueueData oder nicht definiert)

Warteschlangendaten.

Wiederholungsmodus

chrome.cast.media.RepeatMode (nicht null)

Der Wiederholungsmodus zum Abspielen der Warteschlange.

sessionId

String

Kennzeichnet die Sitzung, in der die Medien gehostet werden.

Unterstützte Medienbefehle

Nicht-null-Array von chrome.cast.media.MediaCommand

Die vom Mediaplayer unterstützten Medienbefehle.

Videoinfo

(chrome.cast.media.VideoInformation ungleich null oder nicht definiert)

Die Videoinformationen.

Volumen

chrome.cast.Volume ungleich null

Die Lautstärke des Medienstreams. „volume.level“ und „volume.muted“ werden immer festgelegt.

Methoden

addUpdateListener

addUpdateListener(listener)

Fügt einen Listener hinzu, der aufgerufen wird, wenn sich der Status des Mediums geändert hat. Änderungen an den folgenden Eigenschaften lösen den Listener aus: currentTime, Volume, Metadaten, playRate, playerState, customData. Ein erfolgreicher Aufruf der Methode getStatus der Medien löst auch den Listener aus.

Parameter

Listener

Funktion(boolesch)

Der hinzuzufügende Listener. Der Parameter gibt an, ob das Mediaobjekt noch aktiv ist.

Informationen zu Tracks bearbeiten

editTracksInfo(editTracksInfoRequest, successCallback, errorCallback)

Ändert den Stil der Texttracks oder ändert den Status des Tracks. Wenn eine trackId nicht mit den vorhandenen trackIds übereinstimmt, schlägt die gesamte Anfrage fehl und der Status ändert sich nicht.

Parameter

„EditTracksInfoRequest“

chrome.cast.media.EditTracksInfoRequest

Der Wert darf nicht null sein.

Erfolgsrückruf

function()

Wird bei Erfolg aufgerufen.

Fehler: Callback

function(non-null chrome.cast.Error)

Wird wegen Fehlers aufgerufen. Mögliche Fehler sind TIMEOUT, API_NOT_INITIALIZED, INVALID_PARAMETER, CHANNEL_ERROR, SESSION_ERROR und EXTENSION_MISSING.

GeschätzteSchaltzeit (ClipTime)

getestimatedBreakClipTime() (Anzahl oder nicht definiert)

Schätzt die Position des aktuellen Clips auf Grundlage der letzten vom Empfänger gemeldeten Informationen.

Gibt Folgendes zurück:

(number or undefined): Eine Schätzung der aktuellen Position des Break-Clips in Sekunden seit Beginn des Mediums. Gibt „undefined“ zurück, wenn „breakStatus“ oder „currentBreakClipTime“ nicht definiert ist, wenn keine Pause stattfindet.

Geschätzte Pause

getestimatedBreakTime() (gibt zurück, wenn Anzahl oder nicht definiert)

Schätzt die aktuelle Position der Pause auf der Grundlage der letzten vom Empfänger gemeldeten Informationen.

Gibt Folgendes zurück:

(number or undefined): Eine Schätzung der aktuellen Pausenposition in Sekunden seit Beginn des Mediums. Gibt „undefined“ zurück, wenn „breakStatus“ oder „currentBreakTime“ nicht definiert sind (wenn keine Pause stattfindet).

getGeschätzterLiveSeekableRange

getestimatedLiveSeekableRange() (chrome.cast.media.LiveSeekableRange oder nicht definiert)

Schätzt den Start von liveSeekableRange auf der Grundlage der letzten vom Empfänger gemeldeten Informationen in Sekunden.

Gibt Folgendes zurück:

(non-null chrome.cast.media.LiveSeekableRange or undefined): Eine Schätzung der aktuellen liveSeekableRange. Gibt undefiniert zurück, wenn liveSeekableRange, liveSeekableRange.start oder liveSeekableRange.end nicht definiert sind, wenn der Inhalt nicht live ist.

Geschätzte Zeit

getestimatedTime() – Nummer zurückgegeben

Schätzt die aktuelle Wiedergabeposition anhand der letzten vom Empfänger gemeldeten Informationen.

Gibt Folgendes zurück:

number: Eine Schätzung der aktuellen Wiedergabeposition in Sekunden seit Beginn des Mediums.

getStatus

getStatus(getStatusRequest, successCallback, errorCallback)

Ruft den Status des Medienelements aus der Empfängeranwendung ab.

Zusammen mit dem angegebenen successCallback werden alle hinzugefügten Listener für die Medienaktualisierung auch dann aufgerufen, wenn der Status von der Empfängeranwendung empfangen wird. Statt diese Methode zum Abrufen des Medienstatus aufzurufen, sollten Apps immer dann verwendet werden, wenn der Medienupdate-Listener automatisch aufgerufen wird, wenn sich die Medien ändern.

Parameter

Anfragestatus abrufen

chrome.cast.media.GetStatusRequest

Die optionale Anfrage zum Abrufen des Status.

Erfolgsrückruf

function()

Wird aufgerufen, wenn der Status von der Empfängeranwendung empfangen wird

Fehler: Callback

function(non-null chrome.cast.Error)

Wird wegen Fehlers aufgerufen. Mögliche Fehler sind TIMEOUT, API_NOT_INITIALIZED, INVALID_PARAMETER, CHANNEL_ERROR, SESSION_ERROR und EXTENSION_MISSING.

Pausieren

pause(pauseRequest, successCallback, errorCallback)

Pausiert das Medienelement.

Parameter

Pausenanfrage

chrome.cast.media.PauseRequest

Erfolgsrückruf

function()

Wird bei Erfolg aufgerufen.

Fehler: Callback

function(non-null chrome.cast.Error)

Wird wegen Fehlers aufgerufen. Die Anfrage zum Pausieren von Medien. Mögliche Fehler sind TIMEOUT, API_NOT_INITIALIZED, INVALID_PARAMETER, CHANNEL_ERROR, SESSION_ERROR und EXTENSION_MISSING.

Wiedergabe

play(playRequest, successCallback, errorCallback)

Gibt das Medienelement wieder.

Parameter

Play-Anfrage

chrome.cast.media.PlayRequest

Die optionale Medien-Wiedergabeanfrage.

Erfolgsrückruf

function()

Wird bei Erfolg aufgerufen.

Fehler: Callback

function(non-null chrome.cast.Error)

Wird wegen Fehlers aufgerufen. Mögliche Fehler sind TIMEOUT, API_NOT_INITIALIZED, INVALID_PARAMETER, CHANNEL_ERROR, SESSION_ERROR und EXTENSION_MISSING.

Warteschlange Anhängen

QueueAppendItem(item, successCallback, errorCallback)

Hängt ein neues Medienelement an das Ende der Warteschlange an.

Parameter

Artikel

chrome.cast.media.QueueItem

Element, das an das Ende der Warteschlange angehängt werden soll.

Der Wert darf nicht null sein.

Erfolgsrückruf

function()

Wird bei Erfolg aufgerufen.

Fehler: Callback

function(non-null chrome.cast.Error)

Wird wegen Fehlers aufgerufen. Mögliche Fehler sind TIMEOUT, API_NOT_INITIALIZED, INVALID_PARAMETER, CHANNEL_ERROR, SESSION_ERROR und EXTENSION_MISSING.

Warteschlange einfügen

WarteschlangeInsertItems(QueueInsertItemsRequest, successCallback, errorCallback)

Fügt eine Liste neuer Medienelemente in die Warteschlange ein.

Parameter

WarteschlangeInsertItemsRequest

chrome.cast.media.QueueInsertItemsRequest

Anfrage zum Einfügen von Medienelementen in die Medienwarteschlange.

Der Wert darf nicht null sein.

Erfolgsrückruf

function()

Wird bei Erfolg aufgerufen.

Fehler: Callback

function(non-null chrome.cast.Error)

Wird wegen Fehlers aufgerufen. Mögliche Fehler sind TIMEOUT, API_NOT_INITIALIZED, INVALID_PARAMETER, CHANNEL_ERROR, SESSION_ERROR und EXTENSION_MISSING.

WarteschlangeJumpToItem

WarteschlangeJumpToItem(itemId, successCallback, errorCallback)

Spielt das Element mit „itemId“ in der Warteschlange ab.

Wenn „itemId“ nicht in der Warteschlange gefunden wird, weil sie entweder nicht vorhanden war oder von einem anderen Absender entfernt wurde, bevor diese Funktion aufgerufen wird, gibt diese Funktion im Hintergrund zurück, ohne eine Anfrage an den Empfänger zu senden.

Parameter

itemId

Zahl

Die ID des Elements, zu dem gewechselt werden soll.

Erfolgsrückruf

function()

Wird bei Erfolg aufgerufen.

Fehler: Callback

function(non-null chrome.cast.Error)

Wird wegen Fehlers aufgerufen. Mögliche Fehler sind TIMEOUT, API_NOT_INITIALIZED, INVALID_PARAMETER, CHANNEL_ERROR, SESSION_ERROR und EXTENSION_MISSING.

QueueMoveItemToNewIndex

QueueMoveItemToNewIndex(itemId, newIndex, successCallback, errorCallback)

Verschiebt das Element mit „itemId“ an die Position „newIndex“ in der Warteschlange.

Wenn „itemId“ nicht in der Warteschlange gefunden wird, weil sie entweder nicht vorhanden war oder von einem anderen Absender entfernt wurde, bevor diese Funktion aufgerufen wird, gibt diese Funktion im Hintergrund zurück, ohne eine Anfrage an den Empfänger zu senden.

errorCallback wird aufgerufen, wenn newIndex negativ ist. Wenn jedoch „newIndex“ überläuft, entweder weil er falsch angegeben wurde oder die Warteschlange von einem anderen Absender verkleinert wurde, wird das Element an das Ende der Warteschlange verschoben.

Parameter

itemId

Zahl

Die ID des zu verschiebenden Elements.

Neuer Index

Zahl

Der neue Index des Elements.

Erfolgsrückruf

function()

Wird bei Erfolg aufgerufen.

Fehler: Callback

function(non-null chrome.cast.Error)

Wird wegen Fehlers aufgerufen. Mögliche Fehler sind TIMEOUT, API_NOT_INITIALIZED, INVALID_PARAMETER, CHANNEL_ERROR, SESSION_ERROR und EXTENSION_MISSING.

WarteschlangeWeiter

WarteschlangeWeiter(ErfolgCallback, FehlerRückruf)

Springt zum nächsten Element in der Warteschlange.

Parameter

Erfolgsrückruf

function()

Wird bei Erfolg aufgerufen.

Fehler: Callback

function(non-null chrome.cast.Error)

Wird wegen Fehlers aufgerufen. Mögliche Fehler sind TIMEOUT, API_NOT_INITIALIZED, INVALID_PARAMETER, CHANNEL_ERROR, SESSION_ERROR und EXTENSION_MISSING.

Wiedergabeliste Zurück

Warteschlange: Prev(successCallback, errorCallback)

Springt zum vorherigen Element in der Warteschlange.

Parameter

Erfolgsrückruf

function()

Wird bei Erfolg aufgerufen.

Fehler: Callback

function(non-null chrome.cast.Error)

Wird wegen Fehlers aufgerufen. Mögliche Fehler sind TIMEOUT, API_NOT_INITIALIZED, INVALID_PARAMETER, CHANNEL_ERROR, SESSION_ERROR und EXTENSION_MISSING.

Warteschlange entfernen

WarteschlangeRemoveItem(itemId, successCallback, errorCallback)

Entfernt das Element mit itemId aus der Warteschlange.

Wenn „itemId“ nicht in der Warteschlange gefunden wird, weil sie entweder nicht vorhanden war oder von einem anderen Absender entfernt wurde, bevor diese Funktion aufgerufen wird, gibt diese Funktion im Hintergrund zurück, ohne eine Anfrage an den Empfänger zu senden.

Parameter

itemId

Zahl

Die ID des zu entfernenden Elements.

Erfolgsrückruf

function()

Wird bei Erfolg aufgerufen.

Fehler: Callback

function(non-null chrome.cast.Error)

Wird wegen Fehlers aufgerufen. Mögliche Fehler sind TIMEOUT, API_NOT_INITIALIZED, INVALID_PARAMETER, CHANNEL_ERROR, SESSION_ERROR und EXTENSION_MISSING.

QueueReorderItems

WarteschlangeReorderItems(QueueReorderItemsRequest, successCallback, errorCallback)

Ordnen Sie eine Liste der Medienelemente in der Warteschlange neu an.

Parameter

WarteschlangeReorderItemsRequest

chrome.cast.media.QueueReorderItemsRequest

Anfrage zum Neuanordnen von Elementen in der Medienwarteschlange.

Der Wert darf nicht null sein.

Erfolgsrückruf

function()

Wird bei Erfolg aufgerufen.

Fehler: Callback

function(non-null chrome.cast.Error)

Wird wegen Fehlers aufgerufen. Mögliche Fehler sind TIMEOUT, API_NOT_INITIALIZED, INVALID_PARAMETER, CHANNEL_ERROR, SESSION_ERROR und EXTENSION_MISSING.

WarteschlangeSetRepeatMode

WarteschlangeSetRepeatMode(repeatMode, successCallback, errorCallback)

Legt den Wiederholungsmodus der Warteschlange fest.

Parameter

Wiederholungsmodus

chrome.cast.media.RepeatMode

Der Algorithmus für die Auswahl des nächsten Elements, wenn das aktuelle Element beendet ist.

Der Wert darf nicht null sein.

Erfolgsrückruf

function()

Wird bei Erfolg aufgerufen.

Fehler: Callback

function(non-null chrome.cast.Error)

Wird wegen Fehlers aufgerufen. Mögliche Fehler sind TIMEOUT, API_NOT_INITIALIZED, INVALID_PARAMETER, CHANNEL_ERROR, SESSION_ERROR und EXTENSION_MISSING.

WarteschlangeUpdateElemente

WarteschlangeUpdateItems(WarteschlangeUpdateItemsRequest, successCallback, errorCallback)

Aktualisiert die Eigenschaften der Medienwarteschlange, z.B. den Wiederholungsmodus, und die Eigenschaften der vorhandenen Elemente in der Medienwarteschlange.

Parameter

WarteschlangeUpdateItemsRequest

chrome.cast.media.QueueUpdateItemsRequest

Anfrage zum Aktualisieren der Eigenschaften der Medienwarteschlange.

Der Wert darf nicht null sein.

Erfolgsrückruf

function()

Wird bei Erfolg aufgerufen.

Fehler: Callback

function(non-null chrome.cast.Error)

Wird wegen Fehlers aufgerufen. Mögliche Fehler sind TIMEOUT, API_NOT_INITIALIZED, INVALID_PARAMETER, CHANNEL_ERROR, SESSION_ERROR und EXTENSION_MISSING.

removeUpdateListener

removeUpdateListener(Listener)

Entfernt einen zuvor hinzugefügten Listener für diese Medien.

Parameter

Listener

Funktion(boolesch)

Der zu entfernende Listener.

seek

search(seekRequest, successCallback, errorCallback)

Sucht das Medienelement.

Parameter

Suchanfrage

chrome.cast.media.SeekRequest

Die Mediensuchanfrage.

Der Wert darf nicht null sein.

Erfolgsrückruf

function()

Wird bei Erfolg aufgerufen.

Fehler: Callback

function(non-null chrome.cast.Error)

Wird wegen Fehlers aufgerufen. Mögliche Fehler sind TIMEOUT, API_NOT_INITIALIZED, INVALID_PARAMETER, CHANNEL_ERROR, SESSION_ERROR und EXTENSION_MISSING.

setVolume

setVolume(volumeRequest, successCallback, errorCallback)

Legt die Lautstärke des Medienstreams fest. Es muss mindestens eine Property von „volumeRequest.level“ oder „volumeRequest.muted“ festgelegt werden. Das Ändern des Stummschaltungszustands wirkt sich nicht auf die Lautstärke aus und umgekehrt.

Parameter

VolumeRequest

chrome.cast.media.VolumeRequest

Die festgelegte Volume-Anfrage.

Der Wert darf nicht null sein.

Erfolgsrückruf

function()

Wird bei Erfolg aufgerufen.

Fehler: Callback

function(non-null chrome.cast.Error)

Wird wegen Fehlers aufgerufen. Mögliche Fehler sind TIMEOUT, API_NOT_INITIALIZED, INVALID_PARAMETER, CHANNEL_ERROR, SESSION_ERROR und EXTENSION_MISSING.

stoppen

stop(stopRequest, successCallback, errorCallback)

Stoppt den Mediaplayer.

Parameter

stopRequest

chrome.cast.media.StopRequest

Die Anfrage zum Beenden.

Erfolgsrückruf

function()

Wird bei Erfolg aufgerufen.

Fehler: Callback

function(non-null chrome.cast.Error)

Wird wegen Fehlers aufgerufen. Mögliche Fehler sind TIMEOUT, API_NOT_INITIALIZED, INVALID_PARAMETER, CHANNEL_ERROR, SESSION_ERROR und EXTENSION_MISSING.

unterstützt Command

SupportCommand(command) gibt boolesche Werte zurück.

Bestimmt, ob der Mediaplayer den angegebenen Medienbefehl unterstützt.

Parameter

befehl

chrome.cast.media.MediaCommand

Der Befehl, der abgefragt werden soll.

Der Wert darf nicht null sein.

Gibt Folgendes zurück:

boolean Wahr, wenn der Player den Befehl unterstützt.