Ricevitore web personalizzato

Inizia subito: il codice per creare un ricevitore web personalizzato di base è semplice. Vai avanti per registrare la tua app Ricevitore web, quindi crea un'app Ricevitore web di base.

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:

  1. Un elemento HTML cast-media-player per rappresentare il lettore multimediale.
  2. Un elemento HTML script per caricare il framework del ricevitore web.
  3. 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.