cast. framework. PlayerManager
Consente di controllare e monitorare la riproduzione dei contenuti multimediali.
- Genera
-
non-null Error
Se viene utilizzato direttamente il costruttore.PlayerManager
è accessibile solo chiamando cast.framework.CastRicevirContext#getPlayerManager.
Metodi
💬
AdsBot(eventType, event listener)
Aggiunge un listener di eventi che rimane in ascolto degli eventi di riproduzione.
Parametro |
|
---|---|
tipo evento |
(cast.framework.events.EventType non null o un array non null di cast.framework.events.EventType non null) Un tipo di evento o un array 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.
AggiungiComandoMediaMedias
addSupportMediaCommands(supportedMediaCommands, broadcastStatus)
Aggiunge nuovi comandi supportati all'elenco esistente dei comandi multimediali supportati.
Parametro |
|
---|---|
CommandMediaCommands |
numero Una maschera di bit dei comandi multimediali supportati dall'applicazione. |
broadcastStatus |
Facoltativo boolean
|
- Vedi anche
- cast.framework.messages.Command
broadcastStatus
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 |
|
---|---|
includiMedia |
Facoltativo boolean
|
ID richiesta |
Facoltativo numero L'ID della richiesta in entrata che ha causato questa risposta. |
datipersonalizzati |
Facoltativo Oggetto I dati personalizzati specifici dell'applicazione dei messaggi di stato. Il valore può essere null. |
includeQueueItem |
Facoltativo boolean Indica se includere elementi della coda nel messaggio di stato. Per impostazione predefinita, non sono inclusi. |
getAbsoluteTimeForMediaTime
getAbsoluteTimeForMediaTime(mediaTime) restituisce numero
Converte il tempo dei media in tempo assoluto dei contenuti multimediali. Il tempo assoluto è applicabile solo per i live streaming.
Parametro |
|
---|---|
MediaTime |
numero Tempo dei contenuti multimediali. |
- Valori restituiti
-
nullable number
Tempo assoluto onull
se non disponibile.
getManagerTracksManager
getAudioTracksManager() restituisce cast.framework.AudioTracksManager
Visualizza l'istanza di AudioTracksManager
.
- Valori restituiti
-
non-null cast.framework.AudioTracksManager
getBreakClipCurrentTimeSec
getBreakClipCurrentTimeSec() restituisce numero
Restituisce l'ora attuale 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 un clip di interruzione.
getBreakClipDurationSec
getBreakClipDurationSec() restituisce numero
Restituisce la durata del clip di 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
Visualizza l'istanza di BreakManager
.
- Valori restituiti
-
non-null cast.framework.breaks.BreakManager
getBreak
getBreaks() restituisce un array di cast.framework.messages.Break non null.
Restituisce un elenco di interruzioni.
- Valori restituiti
-
non-null Array of non-null cast.framework.messages.Break
getCurrentSupportMediaCommands
getCurrentSupportatoMediaCommands() restituisce numero
Visualizza i comandi multimediali attualmente supportati dal ricevitore.
A differenza di getSupportedMediaCommands()
, il valore restituito di questo metodo cambia in modo dinamico in base allo stato di riproduzione corrente. 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 comando multimediale supportata dall'applicazione.
getCurrentTimeSec
getCurrentTimeSec() restituisce numero
Visualizza il tempo di riproduzione trascorso del contenuto multimediale corrente.
- Valori restituiti
-
number
Il tempo trascorso, in secondi. Questa sarà0
se nessun contenuto multimediale è in riproduzione.
getDurationSec
getDurationSec() restituisce numero
Visualizza 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 dei media.
- Valori restituiti
getMediaInformation
getMediaInformation() restituisce cast.framework.messages.MediaInformation
Visualizza le informazioni sui contenuti multimediali correnti.
- Valori restituiti
getMediaTimeForAbsoluteTime
getMediaTimeForAbsoluteTime(absoluteTime) restituisce numero
Converte il tempo assoluto dei contenuti multimediali in quello dei contenuti multimediali. Il tempo assoluto è applicabile solo per i live streaming.
Parametro |
|
---|---|
AbsoluteTime |
numero Il tempo assoluto del supporto, espresso come tempo UNIX (in secondi dall'epoca Unix). |
- Valori restituiti
-
nullable number
Tempo di utilizzo dei contenuti multimediali onull
se non è disponibile.
getPlayConfig
getRiproduzioneConfig() restituisce cast.framework.RiproduzioneConfig
Restituisce la configurazione di riproduzione.
- Valori restituiti
-
nullable cast.framework.PlaybackConfig
Velocità di riproduzione
getPlayRate() restituisce numero
Restituisce la velocità di riproduzione attuale.
Restituisce 1
prima che il destinatario CastReceiverContext#start
sia chiamato.
- 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 attuale diPlayer
.
Frequenza di riproduzione preferita
getPreferredRiproduzioneRate() restituisce numero
Ottieni la velocità di riproduzione che preferisci. Può essere utilizzato all'evento di arresto per salvare l'ultima velocità di riproduzione preferita in uno spazio di archiviazione permanente, in modo da poter essere utilizzata nella sessione successiva nelle opzioni di trasmissione.
- Valori restituiti
-
number
getlaTextTextLingua
getPreferredTextlanguage() restituisce stringa
Visualizza la lingua preferita della traccia di testo.
- Valori restituiti
-
nullable string
stileRiceviStilePreferito
getPreferredTextStyle() restituisce cast.framework.messages.TextTrackStyle
Consente di acquisire lo stile di traccia di testo preferito.
- Valori restituiti
getQueueManager
getQueueManager() returns (cast.framework.QueueManager o non definito)
Visualizza l'istanza di QueueManager
.
- Valori restituiti
-
(non-null cast.framework.QueueManager or undefined)
getRawCurrentTimeSec
getRawCurrentTimeSec() restituisce 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. Questa sarà0
se nessun contenuto multimediale è in riproduzione.
getStartAbsoluteTime
getStartAbsoluteTime() restituisce numero
Consente di acquisire l'ora di inizio del contenuto multimediale assoluto, espressa nel formato UNIX Epoch (in secondi dall'epoca Unix). Il tempo assoluto è applicabile solo per i live streaming.
- Valori restituiti
-
nullable number
getStats
getStats() restituisce cast.framework.stats.Stats
Restituisce le statistiche di riproduzione. Ove opportuno, le statistiche vengono aggregate per l'intera sessione di riproduzione.
- Valori restituiti
-
non-null cast.framework.stats.Stats
getSupportMediaCommands
getSupportMediaCommands() restituisce numero
Ottieni 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 ricevente .
Non viene aggiornato automaticamente in base al MediaStatus
.
- Vedi anche
- cast.framework.messages.Command
- Valori restituiti
-
number
Una maschera di comando multimediale supportata dall'applicazione.
getTextTracksManager
getTextTracksManager() restituisce cast.framework.TextTracksManager
Visualizza l'istanza di TextTracksManager
.
- Valori restituiti
-
non-null cast.framework.TextTracksManager
metadatiGetTimed
getTimedMetadata() restituisce un array di valori cast.framework.TimedMetadata non null
Restituisce i metadati a tempo riscontrati durante l'analisi del manifest. Questo è
#EXT-X-DATERANGE
in HLS e EventStream
in DASH.
- Valori restituiti
-
non-null Array of non-null cast.framework.TimedMetadata
carico
load(loadRequest) restituisce Promise contiene void
Avvia una richiesta per caricare i contenuti multimediali.
Parametro |
|
---|---|
richiesta di caricamento |
cast.framework.messages.LoadRequestData Una richiesta per il caricamento di un contenuto multimediale. Il valore non deve essere null. |
- Valori restituiti
-
non-null Promise containing void
Promessa che viene risolta al termine dell'operazione o rifiutata in caso di esito negativo.
in pausa
pausa()
Mette 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 corrispondenti, la chiamata viene ignorata.
Parametro |
|
---|---|
tipo evento |
(cast.framework.events.EventType non null o un array non null di cast.framework.events.EventType non null) Un eventType o un array di tipi di eventi |
listener di eventi |
function(non-null cast.framework.events.Event) |
removeSupportMediaCommands
removeSupportMediaCommands(supportedMediaCommands, broadcastStatus)
Rimuovi i comandi dall'elenco dei comandi multimediali supportati.
Parametro |
|
---|---|
CommandMediaCommands |
numero Una 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 |
|
---|---|
cercatempo |
numero |
sendCustomState
sendCustomState(state)
Invia uno stato personalizzato da una logica di riproduzione delle applicazioni alla logica di UI.
Questo metodo consente di separare la logica di riproduzione e l'UI.
Mantenendo la separazione tra logica e UI, puoi utilizzare la stessa logica di UI sia per la riproduzione locale che per il controllo remoto.
Lo stato personalizzato inviato da questo metodo è disponibile per la UI tramite PlayerData
.
Parametro |
|
---|---|
finale |
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 |
|
---|---|
mittente ID |
stringa L'ID mittente. |
ID richiesta |
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 null. |
motivo |
Facoltativo cast.framework.messages.ErrorReason Il motivo dell'errore. Il valore può essere null. |
datipersonalizzati |
Facoltativo Oggetto I dati personalizzati specifici dell'applicazione dei messaggi di errore. Il valore può essere null. |
inviaRichiesta MediaMedia
sendLocalMediaRequest(request)
Invia una richiesta di contenuti multimediali locali.
Parametro |
|
---|---|
richiesta |
cast.framework.messages.RequestData Il valore non deve essere null. |
stato di invio
sendStatus(senderId, requestId, includeMedia, customData, includeQueueItem)
Invia un messaggio di stato sui contenuti multimediali a un mittente specifico.
Parametro |
|
---|---|
mittente ID |
stringa L'ID mittente. |
ID richiesta |
numero L'ID della richiesta in entrata che ha causato questa risposta. |
includiMedia |
Facoltativo boolean
|
datipersonalizzati |
Facoltativo Oggetto I dati personalizzati specifici dell'applicazione dei messaggi di stato. Il valore può essere null. |
includeQueueItem |
Facoltativo boolean Indica se includere elementi della coda nel messaggio di stato. Per impostazione predefinita, non sono inclusi. |
setIdleReason
setIdleReason(idleReason)
Imposta il motivo per cui il player è in stato IDLE
.
Ciò consente alle applicazioni che vogliono forzare lo stato di IDLE
a indicare il motivo per questa operazione (ad esempio, un errore personalizzato).
Il motivo dell'inattività viene inviato nel messaggio di stato successivo.
Nota: la maggior parte delle applicazioni non deve necessariamente impostare questo valore. È necessario solo se l'app deve passare allo stato Player
allo stato IDLE
in circostanze speciali e l'impostazione inattiva predefinita Motivo non riflette il comportamento previsto.
Parametro |
|
---|---|
motivo per inattività |
cast.framework.messages.IdleReason Il motivo per essere
nello stato Il valore non deve essere null. |
Imposta MediaElement
setMediaElement(mediaElement)
Imposta il HTMLMediaElement
da utilizzare. Se è impostato un valore Promise
di
HTMLMediaElement
, la riproduzione dei contenuti multimediali inizia dopo la risoluzione di
Promise
.
Parametro |
|
---|---|
elemento multimediale |
(HTMLMediaElement non null o promessa non null contenente HTMLHTMLElement non null)
|
impostaMediaMedia
setMediaInformation(mediaInformation, opt_broadcast)
Imposta le informazioni multimediali.
Parametro |
|
---|---|
Informazioni Media |
cast.framework.messages.MediaInformation Il valore non deve essere null. |
trasmissione_ottimale |
Facoltativo boolean |
setMediaRiproduzioneInfoHandler
setMediaRiproduzioneInfoHandler(hander)
Imposta un gestore per restituire o modificare cast.framework.RiproduzioneConfig,
per una richiesta di caricamento specifica. I parametri del gestore sono il LoadRequestData
e il PlaybackConfig
predefinito per il ricevitore (fornito nel CastReceiverOptions
). Il gestore deve restituire una configurazione di riproduzione modificata oppure null
per impedire la riproduzione del contenuto multimediale. Il valore
restituito può anche essere un Promise
per consentire di attendere i dati dal server.
Parametro |
|
---|---|
handler |
function(non-null cast.framework.messages.LoadRequestData, non-null cast.framework.playConfig) Una funzione per fornire una configurazione di riproduzione specifica per la richiesta. Il valore può essere null. |
setMediaUrlSolver
setMediaUrlSolver(risolutore)
Imposta un gestore per restituire l'URL di contenuti multimediali per una richiesta LOAD
.
Questo gestore può essere utilizzato per evitare la pubblicazione dell'URL dei contenuti multimediali
come parte dello stato dei contenuti multimediali. Per impostazione predefinita, l'elemento multimediale contentId
viene 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 null. |
setMessageInterceptor
setMessageInterceptor(tipo, intercettazione)
Imposta un intercettore di messaggi in entrata e in uscita.
L'intercettatore può aggiornare i dati della richiesta e deve 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 intercettore di messaggi LOAD
, ma non viene fornito un'intercettazione separata di PRELOAD
, l'intercettatrice LOAD
verrà chiamata 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 null. |
impostaRiproduzioneConfig
setRiproduzioneConfig(playbackConfig)
Consente di impostare la configurazione della riproduzione su PlayerManager
.
Parametro |
|
---|---|
riproduzioniconfigurazione |
cast.framework.RiproduzioneConfig Il valore non deve essere null. |
setSupportMediaCommands
setSupportMediaCommands(supportedMediaCommands, broadcastStatus)
Consente di impostare i comandi multimediali supportati dal ricevitore.
Parametro |
|
---|---|
CommandMediaCommands |
numero Una maschera di bit dei comandi multimediali supportati dall'applicazione. |
broadcastStatus |
Facoltativo boolean
|
- Vedi anche
- cast.framework.messages.Command
arresto
interrompi()
Consente di interrompere la riproduzione dei contenuti multimediali attualmente in riproduzione.