Classe: PlayerManager

cast.framework.PlayerManager

class   statico

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

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

nullable cast.framework.messages.LiveSeekableRange 

getMediaInformation

getMediaInformation() restituisce cast.framework.messages.MediaInformation

Visualizza le informazioni sui contenuti multimediali correnti.

Valori restituiti

nullable cast.framework.messages.MediaInformation 

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

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

nullable cast.framework.messages.TextTrackStyle 

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

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

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

Vedi anche

cast.framework.messages.Command

arresto

interrompi()

Consente di interrompere la riproduzione dei contenuti multimediali attualmente in riproduzione.