L'SDK Web Ricevitore utilizza un media player integrato per offrire un'esperienza di riproduzione facile e immediata. Fornisce assistenza fin da subito per l'Assistente Google e per funzionalità specifiche di Google Cast supportate automaticamente su tutti i mittenti e i dispositivi abilitati al tocco. Le nuove funzionalità rilasciate continueranno a essere supportate senza ulteriori modifiche del mittente.
Il Ricevitore web personalizzato è un'app HTML5 personalizzata che deve essere ospitata per mostrare i tuoi contenuti sui dispositivi compatibili con Google Cast. Potresti dover creare un ricevitore web personalizzato in base alle tue esigenze aziendali. Per informazioni su quale tipo di ricevitore utilizzare, consulta la guida alla scelta di un ricevitore web.
SDK Google Web Ricevitore
L'app Ricevitore web accede all'API Web ricezione con il seguente riferimento:
<script src="//www.gstatic.com/cast/sdk/libs/caf_receiver/v3/cast_receiver_framework.js"></script>
Best practice per i protocolli URL: tieni presente che l'URL sopra indicato non specifica un protocollo ""http:" o "https:". L'omissione di questi protocolli durante l'origine della risorsa
cast_receiver_framework.js
consente di recuperare questa risorsa utilizzando
lo stesso protocollo del server che ospita l'app web ricezione. Ciò significa che
il passaggio da HTTP per sviluppo a HTTPS per la produzione è trasparente
e non richiederà una modifica del codice. Le app ricevitore web pubblicate devono essere ospitate
su server compatibili con TLS.
Anteprima SDK
È inoltre disponibile una versione pre-release dell'SDK Ricevitore web per il test nelle applicazioni non di produzione. Puoi trovare ulteriori informazioni sull'URL di anteprima dell'SDK all'URL di anteprima dell'SDK Google Cast per il ricevitore web.
Ciclo di vita delle applicazioni
Il ciclo di vita dell'app del ricevitore web inizia dal momento in cui il ricevitore web viene caricato sul dispositivo di trasmissione e procede fino al punto in cui l'applicazione viene demolita e il dispositivo torna allo stato predefinito.
Durante il ciclo di vita di un'app ricevitore web, i messaggi vengono scambiati tra il ricevitore web e le eventuali applicazioni di mittenti connessi. Un'applicazione del mittente invia un messaggio iniziale a un dispositivo Google Cast che richiede la creazione di una sessione utilizzando un ID app specifico. Viene avviato il ciclo di vita del Ricevitore web, in quanto il dispositivo Google Cast tenterà di caricare l'app Ricevitore web. Se non sono presenti problemi di rete, l'app Ricevitore web verrà scaricata dalla rete utilizzando l'URL risolto associato all'ID app. Al termine del caricamento, l'app Ricevitore web eseguirà le operazioni di configurazione e indicherà che è pronta per elaborare i messaggi da qualsiasi applicazione di mittenti connessi.
Un'app Ricevitore web potrebbe smettere di funzionare (terminare il ciclo di vita corrente e chiudere l'applicazione) nelle seguenti condizioni:
- L'app Ricevitore web riceve un messaggio esplicito dall'ultimo mittente connesso per terminare la sessione di applicazione.
- L'app Ricevitore web è rimasta inattiva per un periodo di tempo definito senza alcun mittente connesso e decide di terminare la sessione dell'applicazione.
- È stata avviata una sessione di trasmissione diversa.
- Il Ricevitore web riscontra un errore irreversibile durante il suo normale ciclo di vita.
L'SDK Ricevitore web gestisce tutti i casi comuni in conformità con le nostre linee guida per l'esperienza utente.
Classi principali
Il framework dell'SDK Ricevitore web ha due classi principali:
cast.framework.CastReceiverContext
: gestisce tutto il framework e carica le librerie necessarie. Con questo oggetto puoi:- Impostare le opzioni di configurazione delle applicazioni
- Gestire gli eventi di sistema (ad esempio, il mittente è collegato o è disconnesso)
- Creare canali personalizzati
- Avvia la comunicazione di trasmissione
cast.framework.PlayerManager
: gestisce la riproduzione dei contenuti multimediali. Gestisce il player e l'elemento multimediale sottostanti in base alla richiesta del mittente. Con questo oggetto puoi:- Gestire le operazioni di riproduzione
- Gestire le richieste relative alla riproduzione dal mittente
- Gestire gli eventi relativi alla riproduzione
Registra l'app Ricevitore web
Prima di sviluppare un'app Ricevitore web, devi registrare la tua app Ricevitore web nella Console per gli sviluppatori relativa all'SDK Google Cast. Per ulteriori informazioni, consulta la pagina Registrazione. Tutte le app di ricezione web richiedono alle applicazioni del mittente di fornire un ID app con i messaggi di comando che inviano al ricevitore web tramite l'API del mittente. Quando registri la tua applicazione Ricevitore web, ricevi l'ID app da includere nelle chiamate API del mittente.
Creare un'app di ricezione web di base
Di seguito è riportata la struttura principale di un'app ricevente web di base senza personalizzazione:
- Un elemento HTML
cast-media-player
per rappresentare il lettore multimediale. - Un elemento HTML script per caricare il framework del ricevitore web.
- Chiama
start()
per avviare l'app Ricevitore web senza opzioni.
Di seguito è riportato il codice minimo per un'app ricevitore web che utilizza il framework dell'applicazione di trasmissione senza alcuna personalizzazione. Puoi copiare e incollare questo script così com'è nella tua app per creare la tua app Ricevitore web.
<html>
<head>
<script type="text/javascript"
src="//www.gstatic.com/cast/sdk/libs/caf_receiver/v3/cast_receiver_framework.js">
</script>
</head>
<body>
<cast-media-player></cast-media-player>
<script>
cast.framework.CastReceiverContext.getInstance().start();
</script>
</body>
</html>
A questo punto, un utente può aprire la propria app mittente, connettersi al suo dispositivo di trasmissione, andare ai contenuti multimediali e premere Play, che comunica al ricevitore web di trasmettere in streaming i contenuti multimediali alla TV da guardare.
Confronta questo Ricevitore web di base con un'app ricevitore personalizzata.
Media e player
Il framework Cast fornisce un media player integrato, rappresentato dall'elemento HTML cast-media-player
. Questo lettore multimediale supporta la riproduzione per protocolli di streaming quali MPEG-DASH, HLS e Fluid Streaming.
Un set di codec e container multimediali supportati è riportato nella pagina
Contenuti multimediali supportati. Tramite il messaggio Cast, gli sviluppatori possono supportare un elenco di operazioni avviate dal mittente, come caricamento, riproduzione, pausa e ricerca, in cui l'SDK Google Cast gestisce le interazioni con i contenuti multimediali. Per un elenco delle
operazioni supportate, consulta il riferimento API mittente per la piattaforma della tua applicazione:
RemoteMediaClient
in Android Sender,
GCKMediaControlChannel
in iOS Sender
e
Media
in Web Sender.
Condivisione delle risorse tra origini
Google Cast supporta pienamente la condivisione delle risorse multiorigine (CORS). A differenza dei protocolli basati su file, i protocolli di streaming accedono ai contenuti in modo asincrono utilizzando XMLHttpRequest
. In un mondo CORS, queste richieste sono protette da
accesso inappropriato dall'intestazione CORS dal server da cui ha origine
la risorsa. Ciò significa che il server dei tuoi contenuti ha un'opinione su dove possono essere inclusi. La maggior parte dei browser moderni supporta completamente CORS. I dispositivi iOS e Android accedono ai contenuti a un livello inferiore e non guardano queste intestazioni. Questo è spesso il primo problema che si verifica quando uno sviluppatore vuole utilizzare i contenuti in streaming. Per ulteriori dettagli, consulta Condivisione delle risorse multiorigine.