cast. framework. PlayerManager
Controlla e monitora la riproduzione dei contenuti multimediali.
- Genera
-
non-null Error
Se viene utilizzato direttamente il costruttore.PlayerManager
dovrebbe essere accessibile solo chiamando cast.framework.CastRicevirContext#getPlayerManager.
Metodi
enable
자(eventType, event listener)
Aggiunge un listener di eventi che rimane in ascolto degli eventi di riproduzione.
Parametro |
|
---|---|
Tipo di evento |
(cast.framework.events.EventType o Array non null di cast.framework.events.EventType non null) Un tipo di evento o una matrice di tipi di eventi |
listener di eventi |
function(non-null cast.framework.events.Event) |
- Genera
-
non-null Error
Se gli argomenti specificati non sono validi.
addCommandMediaCommands
addSupportedMediaCommands(supportedMediaCommands, broadcastStatus)
Aggiunge nuovi comandi supportati all'elenco esistente dei comandi multimediali supportati.
Parametro |
|
---|---|
CommandMediaCommands supportato |
number Una maschera di bit di comandi multimediali supportati dall'applicazione. |
stato trasmissione |
Facoltativo boolean
|
- Vedi anche
- cast.framework.messages.Command
stato trasmissione
broadcastStatus(includeMedia, requestId, customData, includeQueueItem)
Invia un messaggio di stato multimediale a tutti i mittenti (trasmissione). Le applicazioni lo utilizzano per inviare una modifica di stato personalizzata.
Parametro |
|
---|---|
includi Media |
Facoltativo boolean
|
ID richiesta |
Facoltativo number L'ID della richiesta in entrata che ha causato la risposta. |
datipersonalizzati |
Facoltativo Oggetto I dati personalizzati specifici dell'applicazione del messaggio di stato. Il valore può essere nullo. |
includeQueueItem |
Facoltativo boolean Indica se includere elementi di coda nel messaggio di stato. Per impostazione predefinita, non sono inclusi. |
getTimeTimePerMediaTime
getAbsoluteTimeForMediaTime(mediaTime) restituisce il numero
Converte il tempo dei contenuti multimediali in tempo assoluto dei media. Il tempo assoluto è applicabile solo per i live streaming.
Parametro |
|
---|---|
MediaTime |
number Tempo sui contenuti multimediali. |
- Valori restituiti
-
nullable number
Ora assoluta onull
se non disponibili.
getAudioTracksManager
getAudioTracksManager() restituisce cast.framework.AudioTracksManager
Recupera l'istanza AudioTracksManager
.
- Valori restituiti
-
non-null cast.framework.AudioTracksManager
getBreakClipCurrentTimeSec
getBreakClipCurrentTimeSec() restituisce numero
Restituisce la durata corrente del clip di interruzione attualmente in riproduzione, in secondi.
- Valori restituiti
-
nullable number
Ora corrente in secondi all'interno del clip di interruzione corrente.null
quandoPlayer
non sta riproducendo il clip di interruzione.
getBreakClipDurationSec
getBreakClipDurationSec() restituisce numero
Restituisce la durata del clip dell'interruzione attualmente in riproduzione in secondi.
- Valori restituiti
-
nullable number
Durata del clip di interruzione corrente.null
quandoPlayer
non sta riproducendo un clip di interruzione.
getBreakManager
getBreakManager() restituisce cast.framework.breaks.BreakManager
Recupera l'istanza BreakManager
.
- Valori restituiti
-
non-null cast.framework.breaks.BreakManager
Fai una pausa
getBreaks() restituisce array di valori cast.framework.messages.Break non null
Restituisce un elenco di interruzioni.
- Valori restituiti
-
non-null Array of non-null cast.framework.messages.Break
getCurrentSupportedMediaCommands
getCurrentSupportedMediaCommands() restituisce numero
Visualizza i comandi multimediali supportati dal ricevitore corrente.
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 deve essere chiamato solo dopo aver chiamato il destinatario
CastReceiverContext#start
, altrimenti restituirà 0
.
- Vedi anche
- cast.framework.messages.Command
- Valori restituiti
-
number
Una maschera di comandi multimediali supportati dall'applicazione.
getCurrentTimeSec
getCurrentTimeSec() restituisce il numero
Visualizza il tempo di riproduzione trascorso del contenuto multimediale corrente.
- Valori restituiti
-
number
Il tempo trascorso, in secondi. Il valore sarà0
se nessun contenuto multimediale è in riproduzione.
getDurataSec
getDurationSec() restituisce numero
Restituisce la durata dei contenuti multimediali attualmente in riproduzione, in secondi.
- Valori restituiti
-
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 in tempo reale con ora di inizio e ora di fine in secondi. I valori si basano sul tempo multimediale.
- Valori restituiti
getMediaInformation
getMediaInformation() restituisce cast.framework.messages.MediaInformation
Visualizza le informazioni sui contenuti multimediali correnti.
- Valori restituiti
getMediaTimeForAbsoluteTime
getMediaTimeForAbsoluteTime(astime) restituisce numero
Converte il tempo multimediale assoluto in tempo multimediale. Il tempo assoluto è applicabile solo per i live streaming.
Parametro |
|
---|---|
AbsoluteTime |
number L'ora assoluta dei media, come il tempo UNIX epoca (secondi dall'epoca Unix). |
- Valori restituiti
-
nullable number
Tempo dei contenuti multimediali onull
se non disponibile.
getConfigConfig
getRiproduzioneConfig() restituisce cast.framework.RiproduzioneConfig
Restituisce la configurazione di riproduzione.
- Valori restituiti
-
nullable cast.framework.PlaybackConfig
tasso di riproduzione
getRiproduzioneRate() restituisce il numero
Restituisce la velocità di riproduzione attuale.
Restituisce 1
prima che il destinatario CastRecevierContext#start
venga richiamato.
- Valori restituiti
-
number
Velocità di riproduzione attuale.
getPlayerState
getPlayerState() restituisce cast.framework.messages.PlayerState
Visualizza lo stato Player
.
- Valori restituiti
-
non-null cast.framework.messages.PlayerState
Lo stato dell'Player
attuale.
Frequenza di riproduzione preferita
getpreferredRiproduzioneRate() restituisce il numero
Seleziona la velocità di riproduzione che preferisci. Può essere utilizzato all'evento di spegnimento per salvare l'ultima frequenza di riproduzione preferita nello spazio di archiviazione permanente, in modo da poterlo utilizzare nella sessione successiva nelle opzioni di trasmissione.
- Valori restituiti
-
number
getPreferredTextLingua
getPreferredText Language() restituisce la stringa
Visualizza la lingua preferita per la traccia di testo.
- Valori restituiti
-
nullable string
ottieniStileStilePreferito
getPreferredTextStyle() restituisce cast.framework.messages.TextTrackStyle
Visualizza lo stile di traccia di testo che preferisci.
- Valori restituiti
getManagerManager
getQueueManager() restituisce (cast.framework.QueueManager o undefined)
Recupera l'istanza QueueManager
.
- Valori restituiti
-
(non-null cast.framework.QueueManager or undefined)
getRawCurrentTimeSec
getRawCurrentTimeSec() restituisce il numero
Visualizza il tempo di riproduzione trascorso del contenuto multimediale corrente, senza sottrarre il tempo di interruzione pubblicitaria.
- Valori restituiti
-
number
Il tempo trascorso, in secondi. Il valore sarà0
se nessun contenuto multimediale è in riproduzione.
getStartTimeTime
getStartAbsoluteTime() restituisce il numero
Visualizza l'ora di inizio del contenuto multimediale assoluto, come il tempo UNIX (in secondi dall'epoca Unix). Il tempo assoluto è applicabile solo per i live streaming.
- Valori restituiti
-
nullable number
getStats
getStats() restituisce cast.framework.Stats
Restituisce le statistiche di riproduzione. Ove opportuno, le statistiche vengono aggregate durante l'intera sessione di riproduzione.
- Valori restituiti
-
non-null cast.framework.Stats
getCommandMediaCommands
getSupportedMediaCommands() restituisce il numero
Riceve i comandi multimediali supportati dal ricevitore. 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 MediaStatus
.
- Vedi anche
- cast.framework.messages.Command
- Valori restituiti
-
number
Una maschera di comandi multimediali supportati dall'applicazione.
getTextTracksManager
getTextTracksManager() restituisce cast.framework.TextTracksManager
Recupera l'istanza TextTracksManager
.
- Valori restituiti
-
non-null cast.framework.TextTracksManager
MetadatiGetTimed
getTimedMetadata() restituisce array di valori cast.framework.TimedMetadata diversi da null
Restituisce i metadati a tempo incontrati durante l'analisi del manifest. Sono #EXT-X-DATERANGE
in HLS e EventStream
in DASH.
- Valori restituiti
-
non-null Array of non-null cast.framework.TimedMetadata
carico
load(loadRequest) restituisce la promessa contenente null
Avvia una richiesta per caricare i contenuti multimediali.
Parametro |
|
---|---|
LoadRequest |
cast.framework.messages.LoadRequestData Una richiesta per caricare un contenuto multimediale. Il valore non deve essere null. |
- Valori restituiti
-
non-null Promise containing void
Promessa risolta quando l'operazione è riuscita o rifiutata se non riuscita.
metti in pausa
in pausa()
Consente di mettere in pausa i contenuti multimediali attualmente in riproduzione.
riproduci
play()
Riproduce i contenuti multimediali attualmente in pausa.
removeEvent listener
removeEvent listener(eventType, event listener)
Rimuove il listener di eventi aggiunto per un determinato evento di riproduzione. Se non esiste alcun listener di eventi corrispondente, questa chiamata viene ignorata.
Parametro |
|
---|---|
Tipo di evento |
(cast.framework.events.EventType o Array non null di cast.framework.events.EventType non null) Un eventType o una matrice di tipi di eventi |
listener di eventi |
function(non-null cast.framework.events.Event) |
removeSupportMediaCommands
removeSupportedMediaCommands(supportedMediaCommands, broadcastStatus)
Rimuovi comandi dall'elenco dei comandi multimediali supportati.
Parametro |
|
---|---|
CommandMediaCommands supportato |
number Una maschera di bit di comandi multimediali supportati dall'applicazione. |
stato trasmissione |
Facoltativo boolean
|
- Vedi anche
- cast.framework.messages.Command
cerca
ricerca(seekTime)
Cerca i contenuti multimediali correnti.
Parametro |
|
---|---|
tempo di ricerca |
number |
sendCustomState
sendCustomState(state)
Invia uno stato personalizzato da una logica di riproduzione dell'applicazione alla logica dell'interfaccia utente.
Questo metodo contribuisce a separare la logica di riproduzione dall'interfaccia utente.
Mantenendo la separazione tra la logica e l'UI ti 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 dello stato personalizzato. Il valore non deve essere null. |
- Vedi anche
- cast.framework.ui.PlayerData#customState
sendError
sendError(senderId, requestId, type, reason, customData)
Invia un errore a un mittente specifico.
Parametro |
|
---|---|
ID mittente |
string L'ID del mittente. |
ID richiesta |
number 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 null. |
motivo |
Facoltativo cast.framework.messages.ErrorMotivo Il motivo dell'errore. Il valore può essere nullo. |
datipersonalizzati |
Facoltativo Oggetto I dati personalizzati specifici dell'applicazione del messaggio di errore. Il valore può essere nullo. |
sendMediaMediaRequest
sendLocalMediaRequest(request)
Invia una richiesta di contenuti multimediali locali.
Parametro |
|
---|---|
richiesta |
cast.framework.messages.RequestData Il valore non deve essere null. |
sendStatus
sendStatus(senderId, requestId, includeMedia, customData, includeQueueItem)
Invia un messaggio di stato multimediale a un mittente specifico.
Parametro |
|
---|---|
ID mittente |
string L'ID del mittente. |
ID richiesta |
number L'ID della richiesta in entrata che ha causato la risposta. |
includi Media |
Facoltativo boolean
|
datipersonalizzati |
Facoltativo Oggetto I dati personalizzati specifici dell'applicazione del messaggio di stato. Il valore può essere nullo. |
includeQueueItem |
Facoltativo boolean Indica se includere elementi di coda nel messaggio di stato. Per impostazione predefinita, non sono inclusi. |
setIdleMotivo
setIdleMotivo(idleMotivo)
Imposta il motivo per cui il player è in stato IDLE
.
Consente alle applicazioni che vogliono forzare lo stato IDLE
a indicare il motivo di questa operazione (ad esempio, un errore personalizzato).
Il motivo dell'inattività viene inviato nel messaggio di stato successivo.
Nota: non è necessario impostare questo valore per la maggior parte delle applicazioni. È necessario
solo se l'app deve impostare Player
per lo stato IDLE
in circostanze speciali
e il valore predefinito idleMotivo non riflette il comportamento previsto.
Parametro |
|
---|---|
Motivo inattività |
cast.framework.messages.IdleMotivo Il motivo per essere
nello stato Il valore non deve essere null. |
setMediaElement
setMediaElement(mediaElement)
Imposta il HTMLMediaElement
da utilizzare. Se è impostato un Promise
di HTMLMediaElement
, la riproduzione dei contenuti multimediali inizia dopo che Promise
è stato risolto.
Parametro |
|
---|---|
elemento multimediale |
(HTMLMediaElement non null o Promise non null contenente HTMLMediaElement non null)
|
impostaMediaMedia
setMediaInformation(mediaInformation, opt_broadcast)
Imposta le informazioni dei contenuti multimediali.
Parametro |
|
---|---|
Informazioni Media |
cast.framework.messages.MediaInformation Il valore non deve essere null. |
trasmissione_opt. |
Facoltativo boolean |
setMediaRiproduzioneInfoHandler
setMediaRiproduzioneInfoHandler(handler)
Imposta un gestore per restituire o modificare cast.framework.RiproduzioneConfig,
per una richiesta di carico specifica. I parametri del gestore sono gli attributi LoadRequestData
e PlaybackConfig
predefiniti per il ricevitore (forniti nel file CastReceiverOptions
). Il gestore deve restituire una configurazione di riproduzione modificata oppure null
per impedire la riproduzione del file multimediale. Il valore restituito può anche essere Promise
per consentire l'attesa dei dati dal server.
Parametro |
|
---|---|
handler |
function(non-null cast.framework.messages.LoadRequestData, non null cast.framework.RiproduzioneConfig) Una funzione per fornire una configurazione di riproduzione specifica per la richiesta. Il valore può essere nullo. |
setMediaUrlSolver
setMediaUrlSolver(risolutore)
Imposta un gestore che restituisca l'URL dei contenuti multimediali di una richiesta LOAD
.
Questo gestore può essere utilizzato per evitare che l'URL dei contenuti multimediali venga pubblicato come parte dello stato dei contenuti multimediali. Per impostazione predefinita, contentId
è utilizzato come URL di contenuti.
Parametro |
|
---|---|
resolver |
function(non-null cast.framework.messages.LoadRequestData) Una funzione per risolvere l'URL dei contenuti multimediali. Il valore può essere nullo. |
setMessageInterceptor
setMessageInterceptor(tipo, intercettore)
Imposta un intercettore dei messaggi in entrata e in uscita.
L'intercettatore può aggiornare i dati della richiesta e dovrebbe restituire i dati aggiornati, un Promise
con dati aggiornati (se i dati non possono essere restituiti immediatamente) o null
se la richiesta non deve essere gestita.
Nota: se viene fornito un intercettatore di messaggi LOAD
, ma non viene fornito un intercettatore PRELOAD
separato, l'intercettatore LOAD
verrà richiamato per i messaggi PRELOAD
.
Parametro |
|
---|---|
digita |
cast.framework.messages.MessageType Il valore non deve essere null. |
intercettore |
function(non-null cast.framework.messages.RequestData) Il valore può essere nullo. |
impostaRiproduzioneRiproduzione
setmentConfig(playbackConfig)
Imposta la configurazione di riproduzione su PlayerManager
.
Parametro |
|
---|---|
Configurazione riproduzione |
cast.framework.RiproduzioneConfig Il valore non deve essere null. |
setMediaMediaCommands
setSupportedMediaCommands(supportedMediaCommands, broadcastStatus)
Consente di impostare i comandi multimediali supportati dal ricevitore.
Parametro |
|
---|---|
CommandMediaCommands supportato |
number Una maschera di bit di comandi multimediali supportati dall'applicazione. |
stato trasmissione |
Facoltativo boolean
|
- Vedi anche
- cast.framework.messages.Command
arresto
stop()
Interrompe il contenuto multimediale attualmente in riproduzione.