Classe: CastRicevirContext

cast.framework.CastReceiverContext

class   static

Gestisce il caricamento delle librerie sottostanti e inizializza l'SDK del ricevitore Cast sottostante.

Genera

non-null Error Se MediaElement non viene creato nel corpo del documento. Se vengono creati più elementi multimediali, lo sviluppatore deve impostare la classe "castMediaElement" su uno di questi, che verrà utilizzato dal ricevitore CAF.

Metodi

getInstance

static

getInstance() restituisce cast.framework.CastReceiverContext

Restituisce l'istanza singleton CastReceiverContext.

Resi

non-null cast.framework.CastReceiverContext 

addCustomMessageListener

addCustomMessageListener(namespace, listener)

Configura un listener di messaggi per un canale di messaggi personalizzato. È consentito più di un listener per uno spazio dei nomi.

Parametro

spazio dei nomi

stringa

Lo spazio dei nomi. Tieni presente che uno spazio dei nomi valido deve essere preceduto dalla stringa "urn:x-cast:".

listener

function(non-null cast.framework.system.Message)
Genera

Error Se il sistema non è pronto o lo spazio dei nomi non è supportato da questa applicazione.

addEventListener

addEventListener(type, handler)

Aggiungi un listener agli eventi di sistema di trasmissione.

Parametro

tipo

cast.framework.system.EventType

Il valore non deve essere null.

handler

function(non-null cast.framework.system.Event)

canDisplayType

canDisplayType(mimeType, codecs, width, height, framerate) restituisce booleano

Controlla se i parametri multimediali specificati degli stream video o audio sono supportati dalla piattaforma.

Parametro

mimeType

stringa

Tipo MIME del media. È costituito da un tipo e un sottotipo separati da una '/'. Può trattarsi di tipi MIME video o audio.

codec

Facoltativo

stringa

La stringa tra virgolette contiene un elenco separato da virgole di formati, in cui ogni formato specifica un tipo di campione multimediale presente nello stream.

larghezza

Facoltativo

numero

Descrive la risoluzione orizzontale dello stream in pixel.

altezza

Facoltativo

numero

Descrive la risoluzione verticale dello stream in pixel.

framerate

Facoltativo

numero

Descrive la frequenza fotogrammi dello stream.
Resi

boolean Se lo stream può essere riprodotto su Chromecast.

getApplicationData

getApplicationData() restituisce cast.framework.system.ApplicationData

Fornisce le informazioni sull'applicazione una volta che il sistema è pronto, altrimenti il valore sarà null.

Resi

nullable cast.framework.system.ApplicationData Le informazioni sull'applicazione o null se il sistema non è pronto.

getDeviceCapabilities

getDeviceCapabilities() restituisce cast.receiver.CastReceiverManager.DeviceCapabilitiesObj

Fornisce informazioni sulle funzionalità del dispositivo una volta che il sistema è pronto, altrimenti sarà null. Se viene restituito un oggetto vuoto, il dispositivo non espone alcuna informazione sulle funzionalità.

Resi

nullable cast.receiver.CastReceiverManager.DeviceCapabilitiesObj Le informazioni sulle funzionalità del dispositivo (coppie chiave/valore). Sarà nullo se il sistema non è ancora pronto. Potrebbe essere un oggetto vuoto se la piattaforma non espone informazioni sulle funzionalità del dispositivo.

getDeviceInformation

getDeviceInformation() restituisce cast.receiver.CastReceiverManager.DeviceInformationObj

Fornisce informazioni identificative del dispositivo non correlate alle funzionalità una volta che il sistema è pronto, altrimenti sarà "null". Se viene restituito un oggetto vuoto, il dispositivo non espone queste informazioni.

Resi

nullable cast.receiver.CastReceiverManager.DeviceInformationObj Le informazioni sul dispositivo (coppie chiave/valore). Sarà nullo se il sistema non è ancora pronto. Potrebbe essere un oggetto vuoto se la piattaforma non espone queste informazioni.

getPlayerManager

getPlayerManager() restituisce cast.framework.PlayerManager

Ottieni l'istanza del player che può controllare e monitorare la riproduzione dei contenuti multimediali.

Resi

non-null cast.framework.PlayerManager 

getSender

getSender(senderId) restituisce cast.framework.system.Sender

Ottieni un mittente in base all'ID mittente

Parametro

senderId

stringa

L'ID del mittente da restituire.
Resi

nullable cast.framework.system.Sender 

getSenders

getSenders() returns Array of non-null cast.framework.system.Sender

Recupera un elenco dei mittenti attualmente connessi.

Resi

non-null Array of non-null cast.framework.system.Sender 

getStandbyState

getStandbyState() restituisce cast.framework.system.StandbyState

Indica se l'ingresso HDMI dell'applicazione di trasmissione è in standby.

Resi

non-null cast.framework.system.StandbyState Indica se l'ingresso HDMI dell'applicazione è in standby o meno. Se non è possibile determinarlo perché la TV non supporta i comandi CEC, ad esempio, il valore restituito è UNKNOWN.

getSystemState

getSystemState() restituisce cast.framework.system.SystemState

Fornisce informazioni sull'applicazione relative allo stato del sistema.

Resi

non-null cast.framework.system.SystemState Lo stato del sistema.

getVisibilityState

getVisibilityState() restituisce cast.framework.system.VisibilityState

Indica se l'applicazione di trasmissione è l'ingresso HDMI attivo.

Resi

non-null cast.framework.system.VisibilityState Indica se l'applicazione è l'ingresso HDMI attivo. Se non è possibile determinarlo perché la TV non supporta i comandi CEC, ad esempio, il valore restituito è UNKNOWN.

isSystemReady

isSystemReady() restituisce booleano

Quando iniziano le chiamate dell'applicazione, il sistema invia l'evento ready per indicare che le informazioni dell'applicazione sono pronte e che l'applicazione può inviare messaggi non appena viene connesso un mittente.

Resi

boolean Indica se il sistema è pronto per elaborare i messaggi.

loadPlayerLibraries

loadPlayerLibraries(useLegacyDashSupport)

Avvia il caricamento di player.js. Può essere utilizzato per iniziare a caricare il codice js dei player nella fase iniziale di avvio del ricevitore prima di chiamare start. Questa funzione non esegue alcuna operazione se i giocatori sono già stati caricati (è stato chiamato start).

Parametro

useLegacyDashSupport

Facoltativo

booleano

Indica che MPL deve essere utilizzato per i contenuti DASH.

removeCustomMessageListener

removeCustomMessageListener(namespace, listener)

Rimuove un listener di messaggi precedentemente registrato con CastReceiverContext#addCustomMessageListener.

Parametro

spazio dei nomi

stringa

Lo spazio dei nomi. Tieni presente che uno spazio dei nomi valido deve essere preceduto dalla stringa "urn:x-cast:".

listener

function(non-null cast.framework.system.Message)

La funzione del listener di messaggi da annullare la registrazione.
Genera

Error Se il sistema non è pronto o lo spazio dei nomi non è supportato da questa applicazione.

removeEventListener

removeEventListener(type, handler)

Rimuovi il listener per trasmettere gli eventi di sistema.

Parametro

tipo

cast.framework.system.EventType

Il valore non deve essere null.

handler

function(non-null cast.framework.system.Event)

sendCustomMessage

sendCustomMessage(namespace, senderId, data)

Invia un messaggio a un mittente specifico.

Parametro

spazio dei nomi

stringa

Lo spazio dei nomi. Tieni presente che uno spazio dei nomi valido deve essere preceduto dalla stringa "urn:x-cast:".

senderId

(stringa o non definito)

senderId o undefined per la trasmissione a tutti i mittenti.

dati

qualsiasi tipo

Il payload del messaggio.

Il valore non deve essere null.
Genera

Error Se si è verificato un errore durante la preparazione del messaggio.

sendFeedbackMessage

sendFeedbackMessage(feedbackMessage)

Questa funzione deve essere chiamata in risposta all'evento feedbackstarted se l'applicazione aggiunge informazioni sullo stato di debug al log nel report sul feedback. Accetta un parametro "message", ovvero una stringa che rappresenta le informazioni di debug che l'applicazione vuole registrare.

Parametro

feedbackMessage

stringa
Deprecato
Utilizza cast.framework.CastReceiverContext#setFeedbackHandler

setApplicationState

setApplicationState(statusText)

Imposta lo stato dell'applicazione. L'applicazione deve chiamare questo metodo quando il suo stato cambia. Se non è definito o è impostato su una stringa vuota, per lo stato dell'applicazione viene utilizzato per impostazione predefinita il valore di Application Name stabilito durante la registrazione dell'applicazione.

Parametro

statusText

stringa

Il testo dello stato.

setFeedbackHandler

setFeedbackHandler(feedbackHandler)

Imposta un gestore per fornire dati aggiuntivi a un report di feedback. Il gestore verrà chiamato quando viene creato un feedback segnalato e deve restituire dati aggiuntivi come stringa o promessa di stringa. La promessa di restituzione deve essere risolta entro 5 secondi per essere inclusa nel report.

Parametro

feedbackHandler

function()

Il valore può essere null.

setInactivityTimeout

setInactivityTimeout(maxInactivity)

Imposta il timeout per inattività del ricevitore. Ti consigliamo di impostare il valore massimo di inattività quando chiami Start e di non modificarlo. Questa API viene fornita solo a scopo di sviluppo/debug.

Parametro

maxInactivity

numero

Intervallo in secondi prima di chiudere una connessione che non risponde.

setLoggerLevel

setLoggerLevel(level)

Imposta il livello di verbosità del log.

Parametro

livello

cast.framework.LoggerLevel

Il livello di logging.

Il valore non deve essere null.

start

start(options) restituisce cast.framework.CastReceiverContext

Inizializza System Manager e Media Manager, in modo che l'app ricevitore possa ricevere richieste dai mittenti.

Parametro

opzioni

(cast.framework.CastReceiverOptions non null o oggetto non null facoltativo)
Resi

non-null cast.framework.CastReceiverContext 

interrompi

stop()

Chiudi l'applicazione ricevitore.