Devi registrare la tua applicazione se utilizzi il ricevitore multimediale con stile o se crei un ricevitore personalizzato. Dopo aver registrato la tua applicazione, riceverai un ID applicazione, che viene utilizzato dall'applicazione mittente per eseguire chiamate API, ad esempio per avviare un'applicazione ricevitore web.
Se utilizzi il Ricevitore multimediale predefinito, non è necessario registrare l'applicazione. Il ricevitore multimediale predefinito non consente di assegnare alcuno stile all'interfaccia utente del lettore multimediale e utilizza una costante fornita come ID applicazione.
Inoltre, devi registrare il dispositivo Google Cast in modo che possa accedere all'applicazione Web ricevitore prima di pubblicarlo. Dopo la pubblicazione, l'applicazione del ricevitore sarà disponibile per tutti i dispositivi Google Cast.
Applicazioni
La registrazione della tua applicazione ti consente di testarla sul tuo dispositivo di trasmissione registrato prima di pubblicarla. Quando pubblichi, l'applicazione viene resa disponibile per tutti i dispositivi di trasmissione.
Registra la tua applicazione
Devi registrare un ricevitore multimediale con stile o un ricevitore personalizzato per ricevere un ID applicazione che viene utilizzato con le chiamate API dall'applicazione mittente.
Per registrare l'app Google Cast, procedi nel seguente modo:
- Accedi alla Console per gli sviluppatori dell'SDK Google Cast.
- Dalla pagina Panoramica o dalla pagina Applicazioni, fai clic su Aggiungi nuova applicazione.
Seleziona il tipo di app ricevitore web che utilizzerai:
Ricevitore personalizzato
Seleziona questa opzione se l'app richiede componenti dell'interfaccia utente o pattern di interazione non forniti dal ricevitore multimediale con stile. Potrebbe essere necessario selezionare Ricevitore personalizzato anche se il tipo di contenuto non è elencato tra i tipi di contenuti multimediali supportati dal ricevitore con stile.
Tieni presente che questa opzione richiede la creazione di un'app web completa per l'app ricevitore web.
Per maggiori dettagli, vedi Applicazione personalizzata ricevitore.
Ricevitore multimediale con stile
Seleziona questa opzione se la tua app trasmette in streaming contenuti video o audio utilizzando uno dei tipi di contenuti multimediali supportati e vuoi fornire un'interfaccia utente sulla TV che utilizzi l'UI predefinita del media player o un insieme di stili personalizzati sopra l'interfaccia utente predefinita del media player.
Gli stili personalizzati che puoi fornire ti consentono di definire l'aspetto dei vari elementi dell'interfaccia utente del player (come la schermata iniziale e la barra di avanzamento) semplicemente fornendo un file CSS. Non è necessario creare un'app ricevitore.
Per maggiori dettagli, consulta Ricevitore multimediale con stile.
Inserisci i dettagli relativi alla tua app Web Ricevir:
Nel campo Nome, inserisci il nome dell'app.
Si tratta del nome dell'applicazione che viene visualizzato quando il web ricevitore è in fase di caricamento o è in stato di inattività se utilizzi il ricevitore multimediale con stile. Se utilizzi un ricevitore personalizzato, il valore di questo campo è il valore predefinito per lo stato dell'applicazione, se non viene impostato utilizzando il metodo
setApplicationState.Specifica l'aspetto dell'app ricevitore web:
Per un Ricevitore personalizzato, specifica l'URL dell'app nel campo URL.
Inserisci un URL che il dispositivo Google Cast deve richiedere durante il caricamento dell'app web ricevitore. Durante lo sviluppo, l'URL può utilizzare HTTP, ma quando l'app viene pubblicata deve utilizzare HTTPS. L'URL potrebbe riguardare una pagina HTML o un altro tipo di file accessibile da un browser web. Il tuo ricevitore web può essere collegato a un indirizzo IP interno (registrato a NAT), ma non a localhost, poiché raramente si tratta di un dominio di primo livello. Anche se l'app ricevitore web deve essere pubblicata tramite SSL (HTTPS) al momento della pubblicazione, i contenuti caricati nell'app potrebbero essere pubblicati tramite HTTP.
Per un Ricevitore multimediale con stile, specifica l'URL del foglio di stile nel campo URL skin.
Fornisci un URL HTTPS che indirizza al file CSS che si trova sul tuo sito web. Per utilizzare gli stili predefiniti, lascia vuoto il campo. Puoi sempre modificarlo in un secondo momento se vuoi fornire o aggiornare gli stili personalizzati.
Seleziona o lascia deselezionata la casella di controllo Supporta la trasmissione tramite inoltro.
La trasmissione tramite inoltro consente al ricevitore web di supportare la trasmissione da mittenti non connessi alla stessa rete Wi-Fi del ricevitore. Per disabilitare la trasmissione in differita per il ricevitore, deseleziona questa casella.
Seleziona o lascia deselezionata la casella di controllo Supporta la trasmissione a dispositivi di solo audio.
Seleziona questa casella per consentire all'app di rilevare i dispositivi audio Google Cast. Deseleziona questa casella per disattivare il supporto dei dispositivi solo audio. Per ulteriori informazioni, vedi Dispositivi audio.
Fai clic su Salva.
Vengono visualizzati i dettagli della registrazione, inclusi l'ID, il nome, il tipo e lo stato dell'applicazione. Prendi nota dell'ID applicazione, che dovrai fornire insieme alle chiamate all'API Cast della tua applicazione.
Fai clic su Fine per tornare alla pagina Applicazioni.
Modifica informazioni applicazione
Prima di poter pubblicare la tua applicazione, devi fornire alcune informazioni aggiuntive. Puoi anche aggiornare le informazioni fornite sulla richiesta durante la registrazione.
Per modificare le informazioni dell'applicazione:
- Nella Console per gli sviluppatori dell'SDK Google Cast, dalla pagina Panoramica o dalla pagina Applicazioni, fai clic sull'ID applicazione o su Modifica per l'applicazione che vuoi modificare.
- Nel campo Nome, aggiorna il nome che hai fornito al momento della registrazione della richiesta.
- Per le applicazioni Ricevitore personalizzato, nel campo URL, aggiorna la posizione dell'applicazione Ricevitore web che hai registrato.
- Per le applicazioni Ricevitore con stile, aggiorna la posizione del foglio di stile dell'applicazione nel campo URL skin.
Seleziona o lascia deselezionata la casella di controllo Supporta la trasmissione tramite inoltro.
La trasmissione tramite inoltro consente al ricevitore web di supportare la trasmissione da mittenti non connessi alla stessa rete Wi-Fi del ricevitore. Deseleziona questa casella per disattivare la trasmissione per il ricevitore.
Seleziona o lascia deselezionata la casella di controllo Supporta la trasmissione a dispositivi di solo audio.
Seleziona questa casella per consentire alla tua app di rilevare i dispositivi Google Cast per audio. Deseleziona questa casella per disattivare il supporto dei dispositivi solo audio. Per ulteriori informazioni, vedi Dispositivi audio.
Nella sezione Dettagli mittente, specifica quanto segue per ogni piattaforma supportata dalla tua app:
Android:
- il nome completo del pacchetto dell'applicazione.
iOS:
- l'ID iTunes e l'ID bundle richiesti da Apple.
- L'URI di lancio dell'app, che utilizza l'URI utilizzato dall'app Google Home per avviare l'app. Per ulteriori informazioni sul formato URI richiesto, consulta la sezione Utilizzare gli schemi URL per comunicare con le app.
Web:
- l'URL del sito web della tua applicazione.
Nella sezione Dettagli scheda, scegli se elencare la tua applicazione nelle proprietà di Google, ad esempio chromecast.com/apps..
Nel menu a discesa Categoria, seleziona la categoria che descrive meglio la tua applicazione.
Nota: la tua app deve supportare i tipi di contenuti multimediali descritti qui oltre a quelli impliciti in altre impostazioni. Ad esempio, se la tua app supporta Google Cast per l'audio e qui selezioni TV e film, l'app deve supportare i dispositivi di solo audio come descritto nella sezione Dispositivi audio, nonché le disposizioni per la riproduzione di video.
Per descrivere i paesi in cui è disponibile la tua app, seleziona il pulsante di opzione Tutti i paesi o Solo in alcuni paesi; se specifichi i paesi, seleziona le caselle corrispondenti ai paesi nell'elenco visualizzato.
Nel campo Titolo, inserisci un titolo descrittivo per la tua applicazione.
Utilizza al massimo 50 caratteri. Ad esempio, "YouTube".
Nel campo Descrizione, inserisci una descrizione per l'applicazione.
Utilizza al massimo 80 caratteri. Ad esempio, "Goditi i tuoi canali YouTube preferiti sullo schermo migliore di casa".
Nella sezione Elementi grafici, fai clic sul segno più per caricare l'immagine dell'icona per la tua applicazione.
L'immagine deve essere di 512 x 512 pixel e può avere uno sfondo trasparente.
In Aggiungi le tue traduzioni, se vuoi fornire traduzioni per i campi Titolo e Descrizione, seleziona la lingua dal menu a discesa, fai clic su Aggiungi e inserisci il testo tradotto nella finestra di dialogo visualizzata. Puoi anche caricare un'immagine per l'icona specifica della traduzione.
Al termine dell'aggiornamento delle informazioni della richiesta, fai clic su Salva.
Pubblica l'applicazione
Quando pubblichi l'applicazione, la tua applicazione diventa disponibile per tutti i dispositivi di trasmissione in tutto il mondo. Viene inoltre creata una scheda per la tua applicazione nelle proprietà di Google, come il sito chromecast.com/apps, da cui gli utenti possono trovare e scaricare la tua app. Se hai scelto di inserire la tua app quando hai modificato le informazioni dell'applicazione nel precedente passaggio 6, l'app verrà visualizzata in chromecast.com/apps dopo la pubblicazione.
Per pubblicare la tua applicazione:
Nella Console per gli sviluppatori dell'SDK Google Cast, dalla pagina Panoramica o dalla pagina Applicazioni, fai clic su Pubblica relativa all'applicazione da pubblicare.
Se le informazioni sull'applicazione sono complete, viene visualizzata una schermata di anteprima con le informazioni immesse nella sezione Modifica informazioni applicazione. In caso contrario, viene visualizzato un messaggio con le informazioni che devi fornire.
Puoi fare clic su Modifica per tornare indietro e aggiornare le informazioni.
Se tutto è pronto per pubblicare l'applicazione, fai clic su Pubblica.
Statistiche
La Console per gli sviluppatori dell'SDK Google Cast tiene traccia delle prestazioni della tua applicazione. Per ogni applicazione pubblicata nelle pagine Applicazioni o Panoramica, puoi visualizzare i dati sul rendimento facendo clic su Visualizza nella colonna Statistiche.
Vengono presentate le seguenti informazioni:
- Numero di ricevitori di trasmissione che hanno avviato l'applicazione
- Numero di sessioni avviate
- Tempo medio di riproduzione di contenuti multimediali (in minuti) per sessione
Se nelle statistiche viene visualizzata la piattaforma Altro, significa che il mittente non ha indicato la piattaforma corrispondente; ad esempio, se un mittente iOS precedente non è stato aggiornato.
Dispositivi
Per impostazione predefinita, i dispositivi Google Cast (ad esempio Chromecast o Android TV) non sono attivi per lo sviluppo e i test. Per trasformare il dispositivo in un dispositivo di sviluppo e ottenere l'accesso alla tua app ricevitore web non pubblicata durante lo sviluppo, devi registrare il dispositivo nell'app. La registrazione consente anche di accedere al ricevitore da una finestra del browser remoto per il debug (vedi Debug).
Per registrare il tuo dispositivo Google Cast, procedi nel seguente modo:
Configura il dispositivo Google Cast e collegalo alla stessa rete Wi-Fi a cui è collegato il computer.
Per ulteriori informazioni, leggi le istruzioni per la configurazione del dispositivo di trasmissione.
Sul computer, apri un browser web supportato da Google Cast.
Accedi alla Console per gli sviluppatori dell'SDK Google Cast.
Trova il numero di serie del dispositivo che vuoi registrare.
Dalla pagina Panoramica o dalla pagina Dispositivi, fai clic su Aggiungi nuovo dispositivo.
Inserisci il numero di serie del dispositivo.
Inserisci una descrizione e fai clic su OK.
Questo è solo un nome intuitivo per il tuo dispositivo (non deve necessariamente corrispondere al nome che hai assegnato al dispositivo durante la configurazione dell'utente).
Attendi quindici minuti prima di continuare.
Una volta completata la registrazione, lo stato del dispositivo sarà "Pronto per il test".
Riavvia il dispositivo di trasmissione: scollega il cavo di alimentazione o USB dal dispositivo, quindi ricollegalo.
Trovare il numero di serie del dispositivo
Per trovare il numero di serie di qualsiasi dispositivo, puoi trasmettere la pagina della Console per gli sviluppatori di Google Cast al dispositivo:
Fai clic sul pulsante Trasmetti (come se stessi trasmettendo questa pagina).
Il prompt mostra la scheda Trasmetti e l'elenco dei dispositivi disponibili.
Dal menu a discesa, seleziona il dispositivo per cui vuoi ottenere il numero di serie.
- Per i dispositivi di visualizzazione, il numero di serie viene visualizzato sullo schermo della TV e viene letto ad alta voce sugli altoparlanti della TV (per distinguere gli 0 e gli O).
- Per i dispositivi audio, il numero di serie viene letto ad alta voce sull'altoparlante trasmesso.
Numero di serie del software Android TV
I dispositivi Android TV (ATV) sono associati a più numeri di serie. Puoi ottenere il numero di serie del software (Cast) trasmettendo la pagina della console per gli sviluppatori di Google Cast al dispositivo ATV come spiegato in precedenza oppure impostando il dispositivo ATV in modalità sviluppatore e cercando il numero di serie del software nelle impostazioni di trasmissione.
Per attivare la modalità sviluppatore sul dispositivo ATV, vai a Impostazioni > Sistema > Informazioni > Build sistema operativo Android TV e fai clic sulla build diverse volte finché il dispositivo non ti comunica che sei in modalità sviluppatore. Per trovare il numero di serie in modalità sviluppatore, seleziona Impostazioni > Preferenze del dispositivo > Chromecast integrato o Impostazioni > Sistema > Trasmetti, a seconda del modello dell'ATV, per visualizzare il numero di serie del software.
Tieni presente che, quando vengono ripristinati i dati di fabbrica di un dispositivo ATV, il numero di serie del software cambia. Dopo il ripristino dei dati di fabbrica, svolgi i passaggi precedenti per trovare il numero di serie del software e registrare di nuovo il nuovo numero di serie del dispositivo in Cast Developer Console.
Problemi correlati all'account
Vorrei annullare la mia registrazione alla Console per gli sviluppatori di Google Cast
La quota di registrazione dell'account sviluppatore di 5 $non è rimborsabile.
Non riesco più ad accedere alla Console per gli sviluppatori di Google Cast
Se in precedenza ti abbiamo inviato un'email in cui ti veniva comunicato che il tuo account sviluppatore è stato sospeso a causa di ripetute violazioni dei nostri Termini di servizio o delle norme relative ai contenuti, rispondi a questa email per richiedere ulteriori chiarimenti.
La mia app è stata rimossa da Google Cast
Le applicazioni rimosse vengono considerate avvertimenti relativi alla buona reputazione del tuo account sviluppatore. Violazioni gravi o ripetute delle norme potrebbero comportare la chiusura del tuo account sviluppatore.
Una rimozione significa che gli utenti non potranno visualizzare o accedere all'applicazione rimossa. Se le tue credenziali di sviluppatore sono ancora in regola con Google Cast e la natura della tua applicazione lo consente, puoi apportare correzioni e pubblicare una nuova istanza conforme dell'applicazione.
Non ripubblicare un'applicazione rimossa finché non avrai risolto la violazione delle norme.
Voglio cambiare l'indirizzo email associato al mio account
Non puoi modificare l'indirizzo email associato al tuo account sviluppatore Google Cast. Se lavori per un'organizzazione, ti consigliamo di utilizzare un indirizzo email del team per evitare problemi di accesso in futuro.
Ho un altro problema
Visita la pagina di assistenza per l'SDK Cast.