cast. framework. PlayerManager
Controlla e monitora la riproduzione di contenuti multimediali.
- Tiri
-
non-null ErrorSe il costruttore viene utilizzato direttamente.PlayerManagerdeve essere accessibile solo chiamando cast.framework.CastReceiverContext#getPlayerManager.
Metodi
addEventListener
addEventListener(eventType, eventListener)
Aggiunge un listener di eventi che rimane in ascolto degli eventi di riproduzione.
Parametro |
|
|---|---|
|
eventType |
(cast.framework.events.EventType non nullo o Array non nullo cast.framework.events.EventType non nullo) Un tipo di evento o un array di tipi di evento |
|
eventListener |
function(non-null cast.framework.events.Event) |
- Tiri
-
non-null ErrorSe gli argomenti specificati non sono validi.
addSupportedMediaCommands
addSupportedMediaCommands(supportedMediaCommands, broadcastStatus)
Aggiunge nuovi comandi supportati all'elenco esistente di comandi multimediali supportati.
Parametro |
|
|---|---|
|
supportedMediaCommands |
numero Maschera di bit dei comandi multimediali supportati dall'applicazione. |
|
broadcastStatus |
Facoltativo boolean
|
- Vedi anche
- cast.framework.messages.Command
broadcastStatus
broadcastStatus(includeMedia, requestId, customData, includeQueueItems)
Invia un messaggio di stato multimediale a tutti i mittenti (trasmissione). Le applicazioni utilizzano questa opzione per inviare una modifica dello stato personalizzata.
Parametro |
|
|---|---|
|
includeMedia |
Facoltativo boolean
|
|
requestId |
Facoltativo numero L'ID della richiesta in entrata che ha causato questa risposta. |
|
customData |
Facoltativo Oggetto I dati personalizzati specifici dell'applicazione del messaggio di stato. Il valore può essere nullo. |
|
includeQueueItems |
Facoltativo boolean Indica se includere gli elementi della coda nel messaggio di stato. Non sono inclusi per impostazione predefinita. |
getAbsoluteTimeForMediaTime
getTotalTimeForMediaTime(mediaTime) restituisce un numero
Converte il tempo dei media in tempo assoluto dei media. Il tempo assoluto è applicabile solo ai live streaming.
Parametro |
|
|---|---|
|
mediaTime |
numero Tempo multimediale. |
- Ritorni
-
nullable numberTempo assoluto onullse non disponibile.
getAudioTracksManager
getAudioTracksManager() restituisce cast.framework.AudioTracksManager
Recupera l'istanza AudioTracksManager.
- Ritorni
-
non-null cast.framework.AudioTracksManager
getBreakClipCurrentTimeSec
getBreakClipCurrentTimeSec() restituisce numero
Restituisce l'ora in secondi corrente dell'interruzione di clip attualmente in riproduzione.
- Ritorni
-
nullable numberTempo attuale in secondi all'interno del clip di interruzione corrente.nullquandoPlayernon è in riproduzione nel clip di interruzione.
getBreakClipDurationSec
getBreakClipDurationSec() restituisce numero
Restituisce la durata in secondi del clip di interruzione attualmente in riproduzione.
- Ritorni
-
nullable numberDurata del clip di interruzione corrente.nullquandoPlayernon riproduce un clip di interruzione.
getBreakManager
getBreakManager() restituisce cast.framework.breaks.BreakManager
Recupera l'istanza BreakManager.
- Ritorni
-
non-null cast.framework.breaks.BreakManager
getBreaks
getBreaks() restituisce Array di cast.framework.messages.Break con valori diversi da null
Restituisce un elenco di interruzioni.
- Ritorni
-
non-null Array of non-null cast.framework.messages.Break
getCurrentSupportedMediaCommands
getCurrentSupportMediaCommands() restituisce numero
Restituisce i comandi multimediali supportati dal ricevitore attuale.
A differenza di getSupportedMediaCommands(), il valore restituito di questo metodo cambia in modo dinamico in base allo stato di riproduzione attuale. Ad esempio,
durante la riproduzione degli annunci, il comando SEEK potrebbe non essere supportato.
Questo metodo dovrebbe essere chiamato solo dopo aver chiamato il destinatario CastReceiverContext#start, altrimenti restituirà 0.
- Vedi anche
- cast.framework.messages.Command
- Ritorni
-
numberUna maschera di bit dei comandi multimediali supportati dall'applicazione.
getCurrentTimeSec
getCurrentTimeSec() restituisce number
Consente di acquisire il tempo di riproduzione trascorso del contenuto multimediale corrente.
- Ritorni
-
numberIl tempo trascorso, in secondi. Il valore sarà0se non sono in riproduzione contenuti multimediali.
getDurationSec
getDurationSec() restituisce numero
Restituisce la durata in secondi dei contenuti multimediali attualmente in riproduzione.
- Ritorni
-
numberDurata dei contenuti multimediali.NaNse non ci sono contenuti multimediali in riproduzione.
getLiveSeekableRange
getLiveSeekableRange() restituisce cast.framework.messages.LiveSeekableRange
Restituisce l'intervallo disponibile per la ricerca in tempo reale con l'ora di inizio e l'ora di fine in secondi. I valori si basano sulla durata dei media.
- Ritorni
getMediaInformation
getMediaInformation() restituisce cast.framework.messages.MediaInformation
Consente di ottenere informazioni sui contenuti multimediali correnti.
- Ritorni
getMediaTimeForAbsoluteTime
getMediaTimeForabsoluteTime(absoluteTime) restituisce numero
Converte il tempo assoluto multimediale in tempo multimediale. Il tempo assoluto è applicabile solo ai live streaming.
Parametro |
|
|---|---|
|
absoluteTime |
numero Il tempo assoluto dei contenuti multimediali, come tempo dell'epoca UNIX (secondi dall'epoca di Unix). |
- Ritorni
-
nullable numberMedia tempo onullse non disponibile.
getPlaybackConfig
getPlaybackConfig() restituisce cast.framework.PlaybackConfig
Restituisce la configurazione di riproduzione o null se i valori predefiniti non sono stati sostituiti.
- Ritorni
-
nullable cast.framework.PlaybackConfig
getPlaybackRate
getPlaybackRate() restituisce numero
Restituisce la velocità di riproduzione corrente.
Restituisce 1 prima che il destinatario CastReceiverContext#start venga chiamato.
- Ritorni
-
numberVelocità di riproduzione attuale.
getPlayerState
getPlayerState() restituisce cast.framework.messages.PlayerState
Ottieni lo stato Player.
- Ritorni
-
non-null cast.framework.messages.PlayerStateLo stato attuale dell'appPlayer.
getPreferredPlaybackRate
getPreferredPlaybackRate() restituisce numero
Ottieni la velocità di riproduzione preferita. Può essere utilizzato all'evento di arresto per salvare l'ultima velocità di riproduzione preferita in un'archiviazione permanente, in modo da poterla utilizzare nella sessione successiva nelle opzioni di trasmissione.
- Ritorni
-
number
getPreferredTextLanguage
getPreferredTextLanguage() restituisce stringa
Consente di acquisire la lingua preferita per la traccia di testo.
- Ritorni
-
nullable string
getPreferredTextStyle
getPreferredTextStyle() restituisce cast.framework.messages.TextTrackStyle
Consente di acquisire lo stile preferito per la traccia di testo.
- Ritorni
getQueueManager
getQueueManager() returns (cast.framework.QueueManager or undefined)
Recupera l'istanza QueueManager.
- Ritorni
-
(non-null cast.framework.QueueManager or undefined)
getRawCurrentTimeSec
getRawCurrentTimeSec() restituisce numero
Restituisce il tempo di riproduzione trascorso del contenuto multimediale corrente, senza sottrarre il tempo di interruzione pubblicitaria.
- Ritorni
-
numberIl tempo trascorso, in secondi. Il valore sarà0se non sono in riproduzione contenuti multimediali.
getStartAbsoluteTime
getStartAmountTime() restituisce number
Restituisce l'ora di inizio assoluta dei contenuti multimediali, espressa come ora UNIX Epoch (secondi dall'epoca di Unix). Il tempo assoluto è applicabile solo ai live streaming.
- Ritorni
-
nullable number
getStats
getStats() returns cast.framework.stats.Stats
Restituisce le statistiche di riproduzione. Le statistiche vengono aggregate per tutta la durata della sessione di riproduzione, ove appropriato.
- Ritorni
-
non-null cast.framework.stats.Stats
getSupportedMediaCommands
getSupportedMediaCommands() restituisce numero
Restituisce i comandi multimediali supportati dal destinatario. Deve essere chiamato solo dopo aver chiamato
CastReceiverContext#start(), altrimenti restituisce 0. Il valore dei comandi multimediali supportati è controllato esclusivamente dall'applicazione del destinatario .
Non viene aggiornato automaticamente in base a un MediaStatus.
- Vedi anche
- cast.framework.messages.Command
- Ritorni
-
numberUna maschera di bit dei comandi multimediali supportati dall'applicazione.
getTextTracksManager
getTextTracksManager() restituisce cast.framework.TextTracksManager
Recupera l'istanza TextTracksManager.
- Ritorni
-
non-null cast.framework.TextTracksManager
getTimedMetadata
getTimedMetadata() restituisce Array di cast.framework.TimedMetadata non null
Restituisce i metadati a tempo riscontrati durante l'analisi del file manifest. Questo è
#EXT-X-DATERANGE in HLS e EventStream in DASH.
- Ritorni
-
non-null Array of non-null cast.framework.TimedMetadata
carico
Load(loadRequest) restituisce Promise contenente void
Avvia una richiesta per caricare contenuti multimediali.
Parametro |
|
|---|---|
|
loadRequest |
cast.framework.messages.LoadRequestData Una richiesta per caricare un contenuto multimediale. Il valore non deve essere nullo. |
- Ritorni
-
non-null Promise containing voidPrometti che verrà risolto quando l'operazione è riuscita o che verrà rifiutata se l'operazione non va a buon fine.
in pausa
pausa()
Mette in pausa i contenuti multimediali attualmente in riproduzione.
riproduci
play()
Riproduce i contenuti multimediali attualmente in pausa.
removeEventListener
removeEventListener(eventType, eventListener)
Rimuove il listener di eventi aggiunto per un determinato evento di riproduzione. Se non esiste un listener di eventi corrispondente, questa chiamata viene ignorata.
Parametro |
|
|---|---|
|
eventType |
(cast.framework.events.EventType non nullo o Array non nullo cast.framework.events.EventType non nullo) Un eventType o un array di tipi di eventi |
|
eventListener |
function(non-null cast.framework.events.Event) |
removeSupportedMediaCommands
removeSupportedMediaCommands(supportedMediaCommands, broadcastStatus)
Rimuovi i comandi dall'elenco dei comandi multimediali supportati.
Parametro |
|
|---|---|
|
supportedMediaCommands |
numero Maschera di bit dei comandi multimediali supportati dall'applicazione. |
|
broadcastStatus |
Facoltativo boolean
|
- Vedi anche
- cast.framework.messages.Command
cerca
search(seekTime)
Cerca nei contenuti multimediali correnti.
Parametro |
|
|---|---|
|
seekTime |
numero |
sendCustomState
sendCustomState(state)
Invia uno stato personalizzato dalla logica di riproduzione di un'applicazione alla logica dell'interfaccia utente.
Questo metodo consente di separare la logica di riproduzione dall'interfaccia utente.
Il mantenimento della separazione tra logica e UI consente di utilizzare la stessa logica dell'interfaccia utente sia per la riproduzione locale sia per il controllo remoto.
Lo stato personalizzato inviato con questo metodo è disponibile per l'interfaccia utente tramite PlayerData.
Parametro |
|
|---|---|
|
state |
Oggetto Oggetto stato personalizzato. Il valore non deve essere nullo. |
- Vedi anche
- cast.framework.ui.PlayerData#customState
sendError
sendError(senderId, requestId, type, reason, customData)
Invia un errore a un mittente specifico.
Parametro |
|
|---|---|
|
senderId |
stringa L'ID mittente. |
|
requestId |
numero L'ID della richiesta in entrata che ha causato questo errore. |
|
digita |
cast.framework.messages.ErrorType Il tipo di errore. Il valore non deve essere nullo. |
|
motivo |
Facoltativo cast.framework.messages.ErrorReason Il motivo dell'errore. Il valore può essere nullo. |
|
customData |
Facoltativo Oggetto Il messaggio di errore relativo ai dati personalizzati specifici dell'applicazione. Il valore può essere nullo. |
sendLocalMediaRequest
sendLocalMediaRequest(request)
Invia una richiesta a media locali.
Parametro |
|
|---|---|
|
richiesta |
cast.framework.messages.RequestData Il valore non deve essere nullo. |
sendStatus
sendStatus(senderId, requestId, includeMedia, customData, includeQueueItems)
Invia un messaggio di stato dei contenuti multimediali a un mittente specifico.
Parametro |
|
|---|---|
|
senderId |
stringa L'ID mittente. |
|
requestId |
numero L'ID della richiesta in entrata che ha causato questa risposta. |
|
includeMedia |
Facoltativo boolean
|
|
customData |
Facoltativo Oggetto I dati personalizzati specifici dell'applicazione del messaggio di stato. Il valore può essere nullo. |
|
includeQueueItems |
Facoltativo boolean Indica se includere gli elementi della coda nel messaggio di stato. Non sono inclusi per impostazione predefinita. |
setIdleReason
setIdleReason(idleReason)
Consente di impostare il motivo per cui il player si trova nello stato IDLE.
Ciò consente alle applicazioni che vogliono forzare lo stato IDLE di indicarne il motivo (ad esempio, un errore personalizzato).
Il motivo dell'inattività viene inviato nel messaggio di stato successivo.
Nota: per la maggior parte delle applicazioni non è necessario impostare questo valore. È necessario solo se l'app deve portare Player allo stato IDLE in circostanze speciali e il valore predefinito idleReason non riflette il comportamento previsto.
Parametro |
|
|---|---|
|
idleReason |
cast.framework.messages.IdleReason Il motivo dello stato
Il valore non deve essere nullo. |
setMediaElement
setMediaElement(mediaElement)
Imposta l'HTMLMediaElement da utilizzare. Se è impostato un Promise di
HTMLMediaElement, la riproduzione dei contenuti multimediali inizia dopo la risoluzione del
Promise.
Parametro |
|
|---|---|
|
mediaElement |
(HTMLMediaElement non null o Promise non null contenente HTMLMediaElement non null)
|
setMediaInformation
setMediaInformation(mediaInformation, opt_broadcast)
Imposta le informazioni multimediali.
Parametro |
|
|---|---|
|
mediaInformation |
cast.framework.messages.MediaInformation Il valore non deve essere nullo. |
|
opt_broadcast |
Facoltativo boolean |
setMediaPlaybackInfoHandler
setMediaPlaybackInfoHandler(handler)
Imposta un gestore per restituire o modificare cast.framework.PlaybackConfig,
per una richiesta di caricamento specifica. I parametri del gestore sono
LoadRequestData e PlaybackConfig predefiniti per il destinatario (fornito
in CastReceiverOptions). Il gestore deve restituire una configurazione di riproduzione modificata oppure null per impedire la riproduzione dei contenuti multimediali. Il valore restituito
può anche essere un Promise per consentire l'attesa dei dati dal server.
Parametro |
|
|---|---|
|
handler |
function(non-null cast.framework.messages.LoadRequestData, non-null cast.framework.PlaybackConfig) Una funzione per fornire una configurazione di riproduzione specifica di una richiesta. Il valore può essere nullo. |
setMediaUrlResolver
setMediaUrlResolver(resolver)
Imposta un gestore per restituire l'URL di contenuti multimediali per una richiesta LOAD.
Questo gestore può essere utilizzato per evitare che l'URL dei contenuti multimediali venga pubblicato
nello stato dei contenuti multimediali. Per impostazione predefinita, l'elemento multimediale contentId viene
utilizzato come URL dei contenuti.
Parametro |
|
|---|---|
|
resolver |
function(non-null cast.framework.messages.LoadRequestData) Una funzione per risolvere l'URL di contenuti multimediali. Il valore può essere nullo. |
setMessageInterceptor
setMessageInterceptor(type, interceptor)
Imposta un intercettatore dei messaggi in entrata e in uscita.
L'intercettatore può aggiornare i dati della richiesta e deve restituire dati aggiornati, un valore Promise con i dati aggiornati (se i dati non possono essere restituiti immediatamente) oppure null se la richiesta non deve essere gestita.
Nota: se viene fornito un intercettore di messaggi LOAD, ma non viene fornito un intercettore PRELOAD separato, verrà chiamato l'intercettatore LOAD per i messaggi PRELOAD.
Parametro |
|
|---|---|
|
digita |
cast.framework.messages.MessageType Il valore non deve essere nullo. |
|
intercettore |
function(non-null cast.framework.messages.RequestData) Il valore può essere nullo. |
setPlaybackConfig
setPlaybackConfig(playbackConfig)
Imposta la configurazione di riproduzione su PlayerManager.
Parametro |
|
|---|---|
|
playbackConfig |
Il valore non deve essere nullo. |
setSupportedMediaCommands
setSupportedMediaCommands(supportedMediaCommands, broadcastStatus)
Imposta i comandi multimediali supportati dal ricevitore.
Parametro |
|
|---|---|
|
supportedMediaCommands |
numero Maschera di bit dei comandi multimediali supportati dall'applicazione. |
|
broadcastStatus |
Facoltativo boolean
|
- Vedi anche
- cast.framework.messages.Command
Scalo
stop()
Interrompe il contenuto multimediale attualmente in riproduzione.