Classe: PlayerManager

cast.framework.PlayerManager

class   statica

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 true indica che i mittenti devono ricevere una notifica relativa alla modifica (se non specificata, i mittenti riceveranno una notifica).

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 true indica che il messaggio deve includere informazioni sui contenuti multimediali.
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 o null 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 quando Player 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 quando Player 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

nullable cast.framework.messages.LiveSeekableRange 

getMediaInformation

getMediaInformation() restituisce cast.framework.messages.MediaInformation

Consente di ottenere informazioni sui contenuti multimediali correnti.

Ritorni

nullable cast.framework.messages.MediaInformation 

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 o null 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'app Player.

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

nullable cast.framework.messages.TextTrackStyle 

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 true indica che i mittenti devono ricevere una notifica relativa alla modifica (se non specificata, i mittenti riceveranno una notifica).

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 true indica che il messaggio deve includere un'istanza MediaInformation.
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 IDLE. 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) MediaElement che verrà utilizzato da Player.

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	cast.framework.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 true indica che i mittenti devono ricevere una notifica relativa alla modifica (se non specificata, i mittenti riceveranno una notifica).

Vedi anche

cast.framework.messages.Command

Scalo

stop()

Interrompe il contenuto multimediale attualmente in riproduzione.