Panoramica

L'SDK Cast consente a un utente di selezionare contenuti audiovisivi in streaming tramite un mittente e di riprodurli (o trasmetterli a) un altro dispositivo noto come Ricevitore, mentre controlla la riproduzione utilizzando il mittente.

Il termine mittente si riferisce a un'app che svolge il ruolo di controller per la sessione di trasmissione. Un mittente avvia la sessione di trasmissione e gestisce l'interazione dell'utente con i contenuti.

Esistono molti tipi di mittenti, tra cui le app per dispositivi mobili e le app web Google Chrome, nonché piattaforme di controllo virtuali sui dispositivi Google Home compatibili con il tocco. I controlli multimediali nel browser web Chrome funzionano come un mittente, così come l'Assistente Google stesso.

Il termine Ricevitore fa riferimento a un'app eseguita su un dispositivo compatibile con Google Cast che risponde ai comandi del mittente e trasmette contenuti in streaming da un servizio di streaming online al dispositivo compatibile con Google Cast. Alcuni esempi di dispositivi ricevitori compatibili con Google Cast sono Chromecast, smart TV, smart TV e smart speaker.

L'SDK Cast supporta inoltre più mittenti che si connettono a una sessione di trasmissione. Ad esempio, un Mittente potrebbe avviare una sessione su un Destinatario e un altro Mittente potrebbe partecipare alla stessa sessione per controllare la riproduzione, caricare nuovi contenuti o mettere in coda più contenuti per un secondo momento.

Componenti e architettura dell'app

Google Cast supporta lo sviluppo di app di Sender per Android, iOS e piattaforme web supportate da Google Cast, come Google Chrome.

Un'app Ricevitore viene eseguita su un dispositivo compatibile con Google Cast, tra cui:

  • Un Chromecast collegato a un televisore o a un sistema audio ad alta definizione.
  • Un televisore compatibile con Google Cast.
  • Uno smartscreen compatibile con Google Cast.
  • Un dispositivo Android compatibile con Google Cast, ad esempio Android TV.

Architettura di trasmissione generale

Un mittente controlla la riproduzione di contenuti multimediali su un ricevitore utilizzando i messaggi di riproduzione multimediali definiti dall'SDK. Se un caso d'uso di app richiede l'invio di dati non formalmente definiti nei messaggi di riproduzione multimediale standard, puoi utilizzare il campo customData fornito da diversi tipi di messaggi per passare dati accessori.

Esistono due scenari di base per lo sviluppo di app Google Cast:

  1. Una soluzione end-to-end basata su Cast. In questo scenario, lo sviluppatore deve creare sia l'app Sender sia due app del ricevitore: un ricevitore Android TV e un ricevitore web (di seguito sono riportate ulteriori informazioni in merito).
  2. Un'app Sender compatibile con Google Cast in grado di trasmettere contenuti (uno schermo o uno stream multimediale) al ricevitore di trasmissione predefinito di Google, chiamato ricevitore multimediale predefinito. In questo scenario, lo sviluppatore deve creare una sola app, il mittente. Il ricevitore multimediale predefinito è utile per l'apprendimento e per scenari di riproduzione molto limitati. Non è pratico per i destinatari che richiedono logica di business, credenziali, gestione dei diritti o analisi personalizzate.

SDK Google Cast

L'SDK Google Cast è composto da diverse librerie dell'API Cast. Oltre alle API, esistono due tipi di documentazione:

  • Guide alle API che ti aiuteranno a usare le API con un codice campione che dimostra le funzionalità di Google Cast.
  • Tutorial sul codelab che illustrano la procedura di sviluppo di tipi specifici di app di trasmissione.

Le API Cast sono suddivise in base alla piattaforma e al tipo di app Google Cast. La tabella 1 contiene link alle guide delle diverse API Cast.

Tabella 1: guide all'SDK Cast
Piattaforma Mittente Ricevitore
Android App Android Sender Panoramica dei ricevitori Android TV
Web App Web Sender Panoramica del ricevitore web
iOS App Sender iOS n/d

Tipi di app mittente

Le app Sender possono essere eseguite su tre piattaforme:

  • Web
  • Android
  • iOS

Sebbene la scelta del tipo di mittente sia probabilmente determinata principalmente dalle piattaforme di mittenti che intendi supportare, è importante conoscere le funzionalità e le limitazioni di ciascun tipo di mittente (consulta la Tabella 3).

Tabella 3: confronto tra mittenti
Capacità Mittente Android Mittente iOS Mittente web
Interruzioni pubblicitarie e annunci companion all'interno di uno stream multimediale
Tracce di testo con stili applicati
Raggruppa, applica uno stile e attiva le tracce multimediali
Riproduzione automatica e coda (modifica, riordinamento, aggiornamento)
Criteri personalizzati
Azioni personalizzate
UI completa di Google Cast, inclusi controller e minicontroller
Intenzione di partecipare

Tipi di app del ricevitore

Le app del ricevitore gestiscono le comunicazioni tra l'app Sender e il dispositivo di trasmissione. Esistono due tipi principali di ricevitori: il web ricevitore e il ricevitore Android TV. Devi fornire almeno un ricevitore web e ti invitiamo a fornire un ricevitore Android TV per massimizzare l'esperienza dell'utente con la tua applicazione.

Esistono tre tipi di ricevitori web, ciascuno con un insieme distinto di qualità e funzionalità:

  • Il Destinatario personalizzato, che consente logica personalizzata, branding e modifica dei controlli.
  • Il ricevitore multimediale con stile, che consente un branding personalizzato.
  • Il Ricevitore predefinito, che è il tipo più semplice. Questo non consente alcuna personalizzazione e non è adatto per le app di produzione.

Oltre alle funzionalità fornite dal ricevitore personalizzato, il ricevitore Android TV offre Cast Connect, un insieme di funzionalità che offrono un'esperienza nativa agli utenti, combinando perfettamente Cast con Android TV.

La Tabella 2 evidenzia le funzionalità dei diversi tipi di ricevitori.

Tabella 2: confronto dei ricevitori
Ricevitore Android TV Ricevitore personalizzato Ricevitore multimediale con stile (SMR) Ricevitore multimediale predefinito
Piattaforma
Basati su Android (Java/Kotlin)
Basato sul web (HTML5)
Requisiti
Deve essere registrato
Funzionalità
Riproduzione di contenuti multimediali HLS e DASH
Supporto per i controlli touch
Consente di gestire i comandi vocali dei dispositivi con l'assistente integrato
Stile visivo e branding personalizzabili
Gestisce i messaggi personalizzati
Trasmetti Connect

La scelta tra le tre opzioni di ricevitore web dipende dai tipi di contenuti multimediali che l'app deve supportare, dal grado di personalizzazione dell'interfaccia utente richiesta e da eventuali requisiti di logica personalizzata.

Determina il tipo di ricevitore web da creare

Se la tua app può integrarsi con Cast, usa i seguenti prompt per determinare quale tipo di ricevitore web dovresti creare:

Crea un ricevitore personalizzato se:
L'app richiede una o più delle seguenti funzionalità speciali:

  • Stile non fornito dal ricevitore multimediale con stile
  • Modifiche ai controlli touch
  • Autorizzazione o autenticazione
  • Analisi del destinatario
  • Licenza DRM fornita separatamente dal file manifest
  • Prima, mid o post-pubblicità
  • Qualsiasi altra funzionalità di ricezione personalizzata o logica JavaScript personalizzata
OPPURE
  • L'app richiede stili personalizzati
E
  • Le funzionalità di stile del ricevitore multimediale con stile non sono sufficienti
Crea un ricevitore multimediale con stile se:
  • L'app richiede stili personalizzati
E
  • Le funzionalità di stile del ricevitore multimediale con stile sono sufficienti
E
  • L'app non richiede nessuna delle funzionalità speciali elencate sopra
Usa il ricevitore multimediale predefinito se:
  • Il formato multimediale è supportato
E
  • L'app non richiede stili personalizzati
E
  • L'app non richiede nessuna delle funzionalità speciali elencate sopra