chrome. cast. media. Medien
Ein Medienelement, das in die Empfängeranwendung geladen wurde.
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 |
|
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 |
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 |
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 |
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 |
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 |
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.