Devi registrare la tua applicazione se utilizzi il Styled Media Receiver o se stai creando un Custom Receiver. Dopo aver registrato l'applicazione, riceverai un ID applicazione, utilizzato dall'applicazione mittente per eseguire chiamate API, ad esempio per avviare un'applicazione di ricezione web.
Se utilizzi il Media Receiver predefinito, non è necessario registrare l'applicazione. Il ricevitore multimediale predefinito non consente di applicare stili all'interfaccia utente del media player e utilizza una costante fornita come ID applicazione.
Inoltre, devi registrare il tuo dispositivo Google Cast in modo che possa accedere alla tua applicazione Web Receiver prima di pubblicarla. Una volta pubblicata, l'applicazione del ricevitore sarà disponibile per tutti i dispositivi Google Cast.
Applicazioni
La registrazione dell'applicazione ti consente di testarla sul tuo dispositivo Cast registrato prima di pubblicarla. La pubblicazione dell'applicazione la rende disponibile su tutti i dispositivi Cast.
Registra la tua applicazione
Devi registrare un Styled Media Receiver o un Custom Receiver per ricevere un ID applicazione utilizzato con le chiamate API dall'applicazione mittente.
Per registrare la tua applicazione di trasmissione:
- Accedi alla Google Cast SDK Developer Console.
- Nella pagina Panoramica o Applicazioni, fai clic su Aggiungi nuova applicazione.
Seleziona il tipo di app Web Receiver che utilizzerai:
Destinatario personalizzato
Seleziona questa opzione se la tua app richiede componenti dell'interfaccia utente o pattern di interazione non forniti dal ricevitore di contenuti multimediali stilizzati. La selezione di Recipient personalizzato può essere necessaria anche se il tipo di contenuti non è elencato tra i tipi di contenuti media supportati di Styled Media Receiver.
Tieni presente che questa opzione richiede la creazione di un'app web completa per l'app Web Receiver.
Per maggiori dettagli, leggi l'articolo Applicazione di ricezione personalizzata.
Styled Media Receiver
Seleziona questa opzione se la tua app riproduce 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'interfaccia utente 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 di vari elementi dell'interfaccia utente del player (ad esempio la schermata iniziale e la barra di avanzamento) semplicemente fornendo un file CSS. Non è necessario creare un'app di ricezione.
Per maggiori dettagli, leggi Ricevitore multimediale in stile.
Inserisci i dettagli dell'app Web Receiver:
Nel campo Nome, inserisci il nome dell'app.
Si tratta del nome dell'applicazione visualizzato durante il caricamento del ricevitore web o in stato di inattività se utilizzi il ricevitore di contenuti multimediali con stile. Se utilizzi un ricevitore personalizzato, il valore di questo campo è il valore predefinito per lo stato dell'applicazione, se non è impostato utilizzando il metodo
setApplicationState.Specifica l'aspetto dell'app Web Receiver:
Per un destinatario 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 Receiver. Durante lo sviluppo, l'URL può utilizzare HTTP, ma quando l'app viene pubblicata deve utilizzare HTTPS. L'URL può riguardare una pagina HTML o un altro tipo di file accessibile da un browser web. È consentito per il ricevitore web avere un indirizzo IP interno (registrato tramite NAT), ma non localhost, poiché raramente si tratta di un dominio di primo livello. Sebbene l'app Web Receiver debba essere pubblicata tramite SSL (HTTPS), i contenuti caricati nell'app possono essere pubblicati tramite HTTP.
Per un Styled Media Receiver, specifica l'URL del foglio di stile nel campo Skin URL.
Fornisci un URL HTTPS che rimandi al file CSS sul tuo sito web. Per utilizzare gli stili predefiniti, lascia vuoto il campo. Puoi sempre modificarli in un secondo momento se vuoi fornire o aggiornare i tuoi stili personalizzati.
Seleziona o deseleziona la casella di controllo Supporta la trasmissione in streaming tramite ripetitore.
La trasmissione tramite ripetitore consente al ricevitore web di supportare la trasmissione da mittenti non connessi alla stessa rete Wi-Fi del ricevitore. Per disattivare la trasmissione tramite ripetitore per il ricevitore, deseleziona questa casella.
Seleziona o deseleziona la casella di controllo Supporta la trasmissione su dispositivi solo audio.
Per consentire alla tua app di rilevare Google Cast per i dispositivi audio, seleziona questa casella. Per disattivare il supporto dei dispositivi solo audio, deseleziona questa casella. Per ulteriori informazioni, consulta Dispositivi audio.
Fai clic su Salva.
Vengono visualizzati i dettagli della registrazione, tra cui ID applicazione, nome, tipo e stato. Prendi nota dell'ID applicazione, poiché lo fornirai nelle chiamate dell'API Cast della tua applicazione.
Fai clic su Fine per tornare alla pagina Applicazioni.
Modificare le informazioni sull'applicazione
Prima di poter pubblicare la tua applicazione, devi fornire alcune informazioni aggiuntive. Puoi anche aggiornare le informazioni che hai fornito sulla tua domanda durante la registrazione.
Per modificare le informazioni sull'applicazione:
- Nella console per gli sviluppatori Google Cast SDK, nella pagina Panoramica o Applicazioni, fai clic sull'ID applicazione o su Modifica per l'applicazione che vuoi modificare.
- Nel campo Nome, aggiorna il nome che hai fornito quando hai registrato l'applicazione.
- Per le applicazioni di ricevitori personalizzati, nel campo URL, aggiorna la posizione dell'applicazione di ricevitore web che hai registrato.
- Per le applicazioni Styled Receiver, nel campo URL skin, aggiorna la posizione del foglio di stile dell'applicazione.
Seleziona o deseleziona la casella di controllo Supporta la trasmissione in streaming tramite ripetitore.
La trasmissione tramite relay consente al ricevitore web di supportare la trasmissione da mittenti non collegati alla stessa rete Wi-Fi del ricevitore. Per disattivare la trasmissione tramite ripetitore per il ricevitore, deseleziona questa casella.
Seleziona o deseleziona la casella di controllo Supporta la trasmissione a dispositivi di solo audio.
Per consentire alla tua app di rilevare Google Cast per i dispositivi audio, seleziona questa casella. Per disattivare il supporto dei dispositivi solo audio, deseleziona questa casella. Per saperne di più, consulta la sezione Dispositivi audio.
Nella sezione Dettagli mittente, fornisci 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 avvio dell'app, utilizzando l'URI utilizzato dall'app Google Home per avviare l'app. Per ulteriori informazioni sul formato URI richiesto, consulta Utilizzare gli schemi URL per comunicare con le app.
Web:
- l'URL del sito web della tua applicazione.
Nella sezione Dettagli della scheda, scegli se mostrare la tua applicazione su proprietà di Google come chromecast.com/apps.
Nel menu a discesa Categoria, seleziona la categoria che meglio descrive la tua applicazione.
Nota:la tua app deve supportare i tipi di contenuti multimediali descritti qui, nonché quelli impliciti in altre impostazioni. Ad esempio, se la tua app supporta Google Cast per l'audio e selezioni TV e film, deve supportare i dispositivi 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 paesi selezionati. Se specifichi i paesi, seleziona le caselle corrispondenti nell'elenco visualizzato.
Nel campo Titolo, fornisci un titolo descrittivo per l'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 Grafica, fai clic sul segno Più per caricare l'immagine dell'icona per la tua applicazione.
L'immagine deve avere una dimensione 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 per quella traduzione.
Dopo aver aggiornato le informazioni sull'applicazione, fai clic su Salva.
Pubblica l'applicazione
La pubblicazione dell'applicazione la rende disponibile su tutti i dispositivi Cast in tutto il mondo. Inoltre, viene creata una scheda per la tua applicazione nelle proprietà di Google, come il sito di schede chromecast.com/apps, dove gli utenti possono trovare e scaricare la tua app. Se hai scelto di mostrare la tua app quando hai modificato le informazioni sull'applicazione nel passaggio 6 qui sopra, la tua app verrà visualizzata in chromecast.com/apps al momento della pubblicazione.
Per pubblicare l'applicazione:
In Google Cast SDK Developer Console, nella pagina Panoramica o Applicazioni, fai clic su Pubblica per l'applicata che vuoi pubblicare.
Se le informazioni sull'applicazione sono complete, viene visualizzata una schermata di anteprima con le informazioni sull'applicazione che hai inserito in Modifica informazioni sull'applicazione. In caso contrario, viene visualizzato un messaggio che indica le informazioni da 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 Google Cast SDK Developer Console monitora il rendimento della tua applicazione. Per ogni applicazione pubblicata nella pagina Applicazioni o Panoramica, puoi visualizzare i dati sul rendimento facendo clic su Visualizza nella colonna Statistiche.
Vengono presentate le seguenti informazioni:
- Numero di ricevitori Cast che hanno avviato l'applicazione
- Numero di sessioni avviate
- Tempo medio di riproduzione dei contenuti multimediali (in minuti) per sessione
Se nelle statistiche viene visualizzata la piattaforma Altro, significa che il mittente non ha indicato la sua piattaforma, ad esempio se un mittente iOS precedente non è stato aggiornato.
Dispositivi
Per impostazione predefinita, i dispositivi Google Cast (ad esempio Chromecast o un dispositivo Android TV) non sono abilitati per lo sviluppo e i test. Per trasformare il tuo dispositivo in un dispositivo di sviluppo e accedere all'app Web Receiver non pubblicata durante sviluppo, devi registrare il dispositivo con la tua app. La registrazione consente inoltre di accedere al ricevitore da una finestra del browser remoto per il debugging (vedi Debugging).
Per registrare il tuo dispositivo Google Cast:
Configura il dispositivo Google Cast e connettilo alla stessa rete Wi-Fi del computer.
Per ulteriori informazioni, consulta le istruzioni per la configurazione del dispositivo di trasmissione.
Sul computer, apri un browser web supportato da Google Cast.
Accedi a Google Cast SDK Developer Console.
Trova il numero di serie del dispositivo che vuoi registrare.
Nella pagina Panoramica o nella pagina Dispositivi, fai clic su Aggiungi nuovo dispositivo.
Inserisci il numero di serie del dispositivo.
Inserisci una descrizione e fai clic su OK.
Si tratta solo di un nome visualizzato per il dispositivo (non deve corrispondere al nome assegnato al dispositivo durante la configurazione dell'utente).
Attendi quindici minuti prima di continuare.
Al termine della 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 volessi trasmettere questa pagina).
Il prompt mostra Scheda Trasmissione e elenca i dispositivi disponibili.
Nel menu a discesa, seleziona il dispositivo di cui vuoi ottenere il numero di serie.
- Per i dispositivi di visualizzazione, il numero di serie viene visualizzato sullo schermo della TV e letto ad alta voce dagli altoparlanti della TV (per distinguere gli zeri dalle O).
- Per i dispositivi audio, il numero di serie viene letto ad alta voce sullo speaker su cui viene eseguito il casting.
Numero di serie del software Android TV
I dispositivi Android TV (ATV) hanno più numeri di serie associati. Il numero di serie del software (Cast) può essere ottenuto trasmettendo la pagina della Console per gli sviluppatori di Google Cast al dispositivo ATV come descritto sopra, o mettendo il dispositivo ATV in modalità sviluppatore e cercando il numero di serie del software nelle impostazioni di Cast.
Per mettere il dispositivo ATV in modalità Sviluppatore, vai a Impostazioni > Sistema > Informazioni > Build del sistema operativo Android TV e fai clic sulla build più volte finché il dispositivo non ti comunica che sei in modalità Sviluppatore. Per trovare il numero di serie in modalità sviluppatore, vai a Impostazioni > Preferenze dispositivo > Chromecast integrato o Impostazioni > Sistema > Trasmissione, a seconda del modello di ATV, e vedrai visualizzato il numero di serie del software.
Tieni presente che quando un dispositivo ATV viene ripristinato ai dati di fabbrica, il numero di serie del software cambia. Dopo un ripristino dei dati di fabbrica, segui i passaggi precedenti per trovare il numero di serie del software e registrare nuovamente il nuovo numero di serie del software del dispositivo con la Console per gli sviluppatori di Google Cast.
Problemi correlati all'account
Vorrei annullare la registrazione a Google Cast Developer Console
La quota di registrazione dell'account sviluppatore di 5 $non è rimborsabile.
Non riesco più ad accedere alla Google Cast Developer Console
Se in precedenza hai ricevuto un'email da Google in cui ti comunicavamo che il tuo account sviluppatore è stato sospeso a causa di ripetute violazioni dei nostri Termini di servizio o delle Norme relative ai contenuti, rispondi all'email se hai bisogno di ulteriori chiarimenti.
La mia app è stata rimossa da Google Cast
Le applicazioni rimosse vengono considerate avvertimenti relativi alla buona reputazione del tuo account sviluppatore. Eventuali 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 godono ancora di buona reputazione in 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é la violazione delle norme non è stata sanata.
Voglio modificare 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
Consulta la pagina di assistenza dell'SDK Cast.