cast. framework. PlayerManager
Controlla e monitora la riproduzione di contenuti multimediali.
- Tiri
-
non-null Error
Se il costruttore viene utilizzato direttamente.PlayerManager
deve 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 Error
Se 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 number
Tempo assoluto onull
se 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 number
Tempo attuale in secondi all'interno del clip di interruzione corrente.null
quandoPlayer
non è in riproduzione nel clip di interruzione.
getBreakClipDurationSec
getBreakClipDurationSec() restituisce numero
Restituisce la durata in secondi del clip di interruzione attualmente in riproduzione.
- Ritorni
-
nullable number
Durata del clip di interruzione corrente.null
quandoPlayer
non 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
-
number
Una 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
-
number
Il tempo trascorso, in secondi. Il valore sarà0
se non sono in riproduzione contenuti multimediali.
getDurationSec
getDurationSec() restituisce numero
Restituisce la durata in secondi dei contenuti multimediali attualmente in riproduzione.
- Ritorni
-
number
Durata dei contenuti multimediali.NaN
se 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 number
Media tempo onull
se 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
-
number
Velocità di riproduzione attuale.
getPlayerState
getPlayerState() restituisce cast.framework.messages.PlayerState
Ottieni lo stato Player
.
- Ritorni
-
non-null cast.framework.messages.PlayerState
Lo 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
-
number
Il tempo trascorso, in secondi. Il valore sarà0
se 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
-
number
Una 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 void
Prometti 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.