cast. framework. PlayerManager
Steuert und überwacht die Medienwiedergabe.
- Löst aus
-
non-null Error
Wenn der Konstruktor direkt verwendet wird. AufPlayerManager
sollte nur durch Aufrufen von cast.framework.CastReceiverContext#getPlayerManager zugegriffen werden.
Methoden
addEventListener
addEventListener(eventType, eventListener)
Fügt einen Event-Listener hinzu, der auf Wiedergabeereignisse wartet.
Parameter |
|
---|---|
eventType |
(nicht null cast.framework.events.EventType oder nicht null Array von cast.framework.events.EventType) Ereignistyp oder Array von Ereignistypen |
eventListener |
function(non-null cast.framework.events.Event) |
- Löst aus
-
non-null Error
Wenn die angegebenen Argumente ungültig sind.
addSupportedMediaCommands
addSupportedMediaCommands(supportedMediaCommands, broadcastStatus)
Fügt neue unterstützte Befehle zur vorhandenen Liste der unterstützten Medienbefehle hinzu.
Parameter |
|
---|---|
supportedMediaCommands |
Zahl Eine Bitmaske mit Medienbefehlen, die von der Anwendung unterstützt werden. |
broadcastStatus |
Optional boolean
|
- Weitere Informationen
- cast.framework.messages.Command
broadcastStatus
broadcastStatus(includeMedia, requestId, customData, includeQueueItems)
Sendet eine Medienstatusnachricht an alle Absender (Broadcasting). Anwendungen verwenden diese Funktion, um eine benutzerdefinierte Statusänderung zu senden.
Parameter |
|
---|---|
includeMedia |
Optional boolean
|
requestId |
Optional Zahl Die ID der eingehenden Anfrage, die diese Antwort verursacht hat. |
customData |
Optional Objekt Anwendungsspezifische benutzerdefinierte Daten für Statusmeldungen. Der Wert kann null sein. |
includeQueueItems |
Optional boolean Gibt an, ob Warteschlangenelemente in die Statusmeldung aufgenommen werden sollen. Standardmäßig sind sie nicht enthalten. |
getAbsoluteTimeForMediaTime
getAbsoluteTimeForMediaTime(mediaTime) gibt eine Zahl zurück
Wandelt die Medienzeit in die absolute Zeit der Medien um. Die absolute Zeit gilt nur für Livestreams.
Parameter |
|
---|---|
mediaTime |
Zahl Medienzeit |
- Rückgaben
-
nullable number
Absolute Zeit odernull
, falls nicht verfügbar.
getAudioTracksManager
getAudioTracksManager() gibt cast.framework.AudioTracksManager zurück.
Ruft die AudioTracksManager
-Instanz ab.
- Rückgaben
-
non-null cast.framework.AudioTracksManager
getBreakClipCurrentTimeSec
getBreakClipCurrentTimeSec() gibt eine Zahl zurück
Gibt die aktuelle Zeit des aktuell wiedergegebenen Pausenclips in Sekunden an.
- Rückgaben
-
nullable number
Aktuelle Zeit in Sekunden innerhalb des aktuellen Pausenclips.null
, wennPlayer
den Pausenclip nicht wiedergibt.
getBreakClipDurationSec
getBreakClipDurationSec() gibt eine Zahl zurück
Gibt die Dauer des aktuell wiedergegebenen Pausenclips in Sekunden an.
- Rückgaben
-
nullable number
Die Dauer des aktuellen Pausenclips.null
, wennPlayer
keinen Pausenclip wiedergibt.
getBreakManager
getBreakManager() gibt cast.framework.breaks.BreakManager zurück.
Ruft die BreakManager
-Instanz ab.
- Rückgaben
-
non-null cast.framework.breaks.BreakManager
getBreaks
getBreaks() gibt ein Array von Nicht-Null-Werten cast.framework.messages.Break zurück.
Gibt eine Liste der Unterbrechungen zurück.
- Rückgaben
-
non-null Array of non-null cast.framework.messages.Break
getCurrentSupportedMediaCommands
getCurrentSupportedMediaCommands() gibt eine Zahl zurück
Ruft die vom aktuellen Empfänger unterstützten Medienbefehle ab.
Anders als bei getSupportedMediaCommands()
ändert sich der zurückgegebene Wert dieser Methode dynamisch auf der Grundlage des aktuellen Wiedergabestatus. Beispielsweise wird der Befehl SEEK
während der Anzeigenwiedergabe möglicherweise nicht unterstützt.
Diese Methode sollte nur nach dem Aufruf des Empfängers CastReceiverContext#start
aufgerufen werden. Andernfalls wird 0
zurückgegeben.
- Weitere Informationen
- cast.framework.messages.Command
- Rückgaben
-
number
Eine Bitmaske mit Medienbefehlen, die von der Anwendung unterstützt werden.
getCurrentTimeSec
getCurrentTimeSec() gibt Zahl zurück
Ruft die verstrichene Wiedergabedauer des aktuellen Mediums ab.
- Rückgaben
-
number
Die verstrichene Zeit in Sekunden. Der Wert ist0
, wenn keine Medien wiedergegeben werden.
getDurationSec
getDurationSec() gibt Zahl zurück
Ruft die Dauer der aktuell wiedergegebenen Medien in Sekunden ab.
- Rückgaben
-
number
Mediendauer.NaN
, wenn keine Medien wiedergegeben werden.
getLiveSeekableRange
getLiveSeekableRange() gibt cast.framework.messages.LiveSeekableRange zurück.
Gibt den Live-Suchbereich mit der Start- und Endzeit in Sekunden zurück. Die Werte basieren auf der Medienzeit.
- Rückgaben
getMediaInformation
getMediaInformation() gibt cast.framework.messages.MediaInformation zurück.
Ruft Informationen zu den aktuellen Medien ab.
- Rückgaben
getMediaTimeForAbsoluteTime
getMediaTimeForAbsoluteTime(absoluteTime) gibt eine Zahl zurück
Wandelt die absolute Zeit der Medien in Medienzeit um. Die absolute Zeit gilt nur für Livestreams.
Parameter |
|
---|---|
absoluteTime |
Zahl Die absolute Zeit des Mediums als UNIX-Epochenzeit (Sekunden seit der Unix-Epoche). |
- Rückgaben
-
nullable number
Medienzeit odernull
, falls nicht verfügbar.
getPlaybackConfig
getPlaybackConfig() gibt cast.framework.PlaybackConfig zurück.
Gibt die Wiedergabekonfiguration oder null
zurück, wenn die Standardeinstellungen nicht überschrieben wurden.
- Rückgaben
-
nullable cast.framework.PlaybackConfig
getPlaybackRate
getPlaybackRate() gibt eine Zahl zurück
Gibt die aktuelle Wiedergaberate an.
Gibt 1
zurück, bevor der Empfänger CastReceiverContext#start
aufgerufen wird.
- Rückgaben
-
number
Aktuelle Wiedergabegeschwindigkeit.
getPlayerState
getPlayerState() gibt cast.framework.messages.PlayerState zurück.
Ruft den Status Player
ab.
- Rückgaben
-
non-null cast.framework.messages.PlayerState
: Der Status des aktuellenPlayer
.
getPreferredPlaybackRate
getPreferredPlaybackRate() gibt eine Zahl zurück
Hol dir die bevorzugte Wiedergabegeschwindigkeit. Kann beim Herunterfahren verwendet werden, um die aktuelle bevorzugte Wiedergabegeschwindigkeit im nichtflüchtigen Speicher zu speichern, damit sie in der nächsten Sitzung in den Streamingoptionen verwendet werden kann.
- Rückgaben
-
number
getPreferredTextLanguage
getPreferredTextLanguage() gibt einen String zurück
Ruft die bevorzugte Sprache für den Text-Track ab.
- Rückgaben
-
nullable string
getPreferredTextStyle
getPreferredTextStyle() gibt cast.framework.messages.TextTrackStyle zurück.
Ruft den bevorzugten Texttrack-Stil ab.
- Rückgaben
getQueueManager
getQueueManager() returns (cast.framework.QueueManager or undefined)
Ruft die QueueManager
-Instanz ab.
- Rückgaben
-
(non-null cast.framework.QueueManager or undefined)
getRawCurrentTimeSec
getRawCurrentTimeSec() gibt eine Zahl zurück
Ruft die verstrichene Wiedergabezeit des aktuellen Mediums ab, ohne die Werbeunterbrechungszeit zu subtrahieren.
- Rückgaben
-
number
Die verstrichene Zeit in Sekunden. Der Wert ist0
, wenn keine Medien wiedergegeben werden.
getStartAbsoluteTime
getStartAbsoluteTime() gibt Zahl zurück
Ruft die absolute Medienstartzeit als UNIX-Epochenzeit (Sekunden seit der Unix-Epoche) ab. Die absolute Zeit gilt nur für Livestreams.
- Rückgaben
-
nullable number
getStats
getStats() returns cast.framework.stats.Stats
Gibt Wiedergabestatistiken zurück. Die Statistiken werden gegebenenfalls über die gesamte Wiedergabesitzung zusammengefasst.
- Rückgaben
-
non-null cast.framework.stats.Stats
getSupportedMediaCommands
getSupportedMediaCommands() gibt eine Zahl zurück
Ruft vom Empfänger unterstützte Medienbefehle ab Sollte nur nach dem Aufruf von CastReceiverContext#start()
aufgerufen werden, andernfalls wird 0
zurückgegeben. Der unterstützte Wert für Medienbefehle wird ausschließlich von der Anwendung des Empfängers gesteuert .
Sie wird nicht automatisch auf Grundlage eines MediaStatus
aktualisiert.
- Weitere Informationen
- cast.framework.messages.Command
- Rückgaben
-
number
Eine Bitmaske mit Medienbefehlen, die von der Anwendung unterstützt werden.
getTextTracksManager
getTextTracksManager() gibt cast.framework.TextTracksManager zurück.
Ruft die TextTracksManager
-Instanz ab.
- Rückgaben
-
non-null cast.framework.TextTracksManager
getTimedMetadata
getTimedMetadata() gibt ein Array von Nicht-Null-Werten cast.framework.TimedMetadata zurück.
Gibt zeitgesteuerte Metadaten zurück, die beim Parsen des Manifests aufgetreten sind. Das ist #EXT-X-DATERANGE
in HLS und EventStream
in DASH.
- Rückgaben
-
non-null Array of non-null cast.framework.TimedMetadata
Ladung
Load(loadRequest) gibt Promise zurück, das void enthält
Initiiert eine Anfrage zum Laden von Medien.
Parameter |
|
---|---|
loadRequest |
cast.framework.messages.LoadRequestData Eine Anfrage zum Laden eines Mediums. Der Wert darf nicht null sein. |
- Rückgaben
-
non-null Promise containing void
Promise, das aufgelöst wird, wenn der Vorgang erfolgreich war, oder abgelehnt wird, wenn ein Fehler aufgetreten ist.
Pausieren
Pause()
Pausiert die aktuell wiedergegebenen Medien.
Wiedergabe
Abspielen()
Spielt die aktuell pausierten Medien ab.
removeEventListener
removeEventListener(eventType, eventListener)
Entfernt den Event-Listener, der für ein bestimmtes Wiedergabeereignis hinzugefügt wurde. Wenn kein übereinstimmender Event-Listener vorhanden ist, wird dieser Aufruf ignoriert.
Parameter |
|
---|---|
eventType |
(nicht null cast.framework.events.EventType oder nicht null Array von cast.framework.events.EventType) „eventType“ oder ein Array von Ereignistypen |
eventListener |
function(non-null cast.framework.events.Event) |
removeSupportedMediaCommands
removeSupportedMediaCommands(supportedMediaCommands, broadcastStatus)
Entfernen Sie Befehle aus der Liste der unterstützten Medienbefehle.
Parameter |
|
---|---|
supportedMediaCommands |
Zahl Eine Bitmaske mit Medienbefehlen, die von der Anwendung unterstützt werden. |
broadcastStatus |
Optional boolean
|
- Weitere Informationen
- cast.framework.messages.Command
Community
suchen(Suchzeit)
Sucht in den aktuellen Medien.
Parameter |
|
---|---|
seekTime |
Zahl |
sendCustomState
sendCustomState(state)
Sendet einen benutzerdefinierten Status von einer Anwendungswiedergabelogik an die UI-Logik.
Diese Methode ermöglicht eine Trennung von Wiedergabelogik und Benutzeroberfläche.
Durch die Trennung zwischen Logik und UI kann dieselbe UI-Logik sowohl für die lokale Wiedergabe als auch für die Fernbedienung verwendet werden.
Der von dieser Methode gesendete benutzerdefinierte Status ist über PlayerData
für die UI verfügbar.
Parameter |
|
---|---|
state |
Objekt Objekt für benutzerdefinierten Status. Der Wert darf nicht null sein. |
- Weitere Informationen
- cast.framework.ui.PlayerData#customState
sendError
sendError(senderId, requestId, type, reason, customData)
Sendet einen Fehler an einen bestimmten Absender.
Parameter |
|
---|---|
senderId |
String Die Absender-ID. |
requestId |
Zahl Die ID der eingehenden Anfrage, die diesen Fehler verursacht hat. |
eingeben |
cast.framework.messages.ErrorType Der Fehlertyp. Der Wert darf nicht null sein. |
reason |
Optional cast.framework.messages.ErrorReason Die Ursache des Fehlers. Der Wert kann null sein. |
customData |
Optional Objekt Die Fehlermeldung „Anwendungsspezifische benutzerdefinierte Daten“. Der Wert kann null sein. |
sendLocalMediaRequest
sendLocalMediaRequest(request)
Sendet eine lokale Medienanfrage.
Parameter |
|
---|---|
Request |
cast.framework.messages.RequestData Der Wert darf nicht null sein. |
sendStatus
sendStatus(senderId, requestId, includeMedia, customData, includeQueueItems)
Sendet eine Medienstatusnachricht an einen bestimmten Absender.
Parameter |
|
---|---|
senderId |
String Die Absender-ID. |
requestId |
Zahl Die ID der eingehenden Anfrage, die diese Antwort verursacht hat. |
includeMedia |
Optional boolean
|
customData |
Optional Objekt Anwendungsspezifische benutzerdefinierte Daten für Statusmeldungen. Der Wert kann null sein. |
includeQueueItems |
Optional boolean Gibt an, ob Warteschlangenelemente in die Statusmeldung aufgenommen werden sollen. Standardmäßig sind sie nicht enthalten. |
setIdleReason
setIdleReason(idleReason)
Legt den Grund für den IDLE
-Status des Players fest.
Dadurch können Anwendungen den Status IDLE
erzwingen, um den Grund dafür anzugeben (z. B. ein benutzerdefinierter Fehler).
Der Grund für die Inaktivität wird in der nächsten Statusmeldung gesendet.
Hinweis: Bei den meisten Anwendungen muss dieser Wert nicht festgelegt werden. Es ist nur erforderlich, wenn die Anwendung unter besonderen Umständen den Status Player
in den Status IDLE
ändern muss und der standardmäßige „idleReason“-Parameter nicht das beabsichtigte Verhalten widerspiegelt.
Parameter |
|
---|---|
idleReason |
cast.framework.messages.IdleReason Grund für den Status Der Wert darf nicht null sein. |
setMediaElement
setMediaElement(mediaElement)
Legt die zu verwendende HTMLMediaElement
fest. Wenn ein Promise
von HTMLMediaElement
festgelegt ist, beginnt die Wiedergabe der Medien, nachdem Promise
aufgelöst wurde.
Parameter |
|
---|---|
mediaElement |
(Nicht-Null-HTMLMediaElement oder Nicht-Null-Promise, die Nicht-Null-HTMLMediaElement enthält)
|
setMediaInformation
setMediaInformation(mediaInformation, opt_broadcast)
Legt die Medieninformationen fest.
Parameter |
|
---|---|
mediaInformation |
cast.framework.messages.MediaInformation Der Wert darf nicht null sein. |
opt_broadcast |
Optional boolean |
setMediaPlaybackInfoHandler
setMediaPlaybackInfoHandler(handler)
Legt einen Handler fest, der cast.framework.PlaybackConfig für eine bestimmte Ladeanfrage zurückgibt oder ändert. Die Handler-Parameter sind LoadRequestData
und Standard-PlaybackConfig
für den Empfänger (in CastReceiverOptions
bereitgestellt). Der Handler sollte eine geänderte Wiedergabekonfiguration oder null
zurückgeben, um die Wiedergabe der Medien zu verhindern. Der Rückgabewert kann auch ein Promise
sein, um das Warten auf Daten vom Server zu ermöglichen.
Parameter |
|
---|---|
Handler |
function(non-null cast.framework.messages.LoadRequestData, non-null cast.framework.PlaybackConfig) Eine Funktion zum Bereitstellen einer anfragespezifischen Wiedergabekonfiguration. Der Wert kann null sein. |
setMediaUrlResolver
setMediaUrlResolver(resolver)
Legt einen Handler fest, der für eine LOAD
-Anfrage die Medien-URL zurückgibt.
Mit diesem Handler lässt sich verhindern, dass die URL für Medieninhalte als Teil des Medienstatus veröffentlicht wird. Standardmäßig wird die Medien-contentId
als Inhalts-URL verwendet.
Parameter |
|
---|---|
Resolver |
function(non-null cast.framework.messages.LoadRequestData) Eine Funktion zum Auflösen der Medieninhalts-URL. Der Wert kann null sein. |
setMessageInterceptor
setMessageInterceptor(type, interceptor)
Legt einen Interceptor für eingehende und ausgehende Nachrichten fest.
Der Interceptor kann die Anfragedaten aktualisieren und sollte entweder aktualisierte Daten, einen Promise
mit aktualisierten Daten (wenn Daten nicht sofort zurückgegeben werden können) oder null
zurückgeben, wenn die Anfrage nicht verarbeitet werden soll.
Hinweis: Wenn ein LOAD
-Nachrichten-Interceptor, aber kein separater PRELOAD
-Abfanggerät angegeben ist, wird der LOAD
-Interceptor für PRELOAD
-Nachrichten aufgerufen.
Parameter |
|
---|---|
eingeben |
cast.framework.messages.MessageType Der Wert darf nicht null sein. |
Interceptor |
function(non-null cast.framework.messages.RequestData) Der Wert kann null sein. |
setPlaybackConfig
setPlaybackConfig(playbackConfig)
Legt die Wiedergabekonfiguration für PlayerManager
fest.
Parameter |
|
---|---|
playbackConfig |
Der Wert darf nicht null sein. |
setSupportedMediaCommands
setSupportedMediaCommands(supportedMediaCommands, broadcastStatus)
Legt die vom Empfänger unterstützten Medienbefehle fest.
Parameter |
|
---|---|
supportedMediaCommands |
Zahl Eine Bitmaske mit Medienbefehlen, die von der Anwendung unterstützt werden. |
broadcastStatus |
Optional boolean
|
- Weitere Informationen
- cast.framework.messages.Command
Zwischenstopp
stop()
Stoppt die Wiedergabe der Medien, die gerade abgespielt werden.