Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Con il rilascio di Android 5.0 arriva Android TV, che supporta Google Cast.
Questo documento descrive cosa devi fare per configurare e testare Android TV
durante lo sviluppo di applicazioni Cast. L'applicazione Cast esistente viene eseguita su
Android TV senza alcuno sforzo in più. Se stai sviluppando un'applicazione Cast
per la prima volta, rileggi la documentazione relativa a Google Cast.
e sviluppare l'applicazione Cast in modo da eseguirla su un dispositivo Chromecast.
sviluppo e test con Android TV.
Configurazione per lo sviluppo
Configurare il dispositivo Android TV:
Collega il dispositivo Android TV alla rete locale.
Accedi al tuo Account Google.
In Impostazioni, nella riga Dispositivo, seleziona Informazioni.
Scorri verso il basso e fai clic diverse volte su Crea finché non viene visualizzata una finestra di dialogo.
con il messaggio "Ora sei uno sviluppatore".
Se il debug USB:
Installa il cavo USB, ma non collegare l'estremità master del cavo USB
al computer.
Nella riga Preferenze, seleziona Opzioni sviluppatore e seleziona
Debug USB e seleziona On.
Torna alla schermata Home. Devi eseguire questa operazione per applicare le impostazioni
appena selezionato. Le impostazioni continueranno a esistere se non ripristini i dati di fabbrica.
Rendere l'applicazione Cast compatibile con Android TV richiede pochissimo
lavoro aggiuntivo. Ecco alcuni consigli e insidie comuni da evitare
Per assicurarti che la tua applicazione sia compatibile con Android TV:
Tieni presente che la stringa dello user agent contiene sia "Android" e "CHighlight";
alcuni siti potrebbero reindirizzare a un sito solo per dispositivi mobili perché rilevano il
"Android" dell'etichetta. Non dare per scontato che "Android" nella stringa user agent
indica un utente di dispositivi mobili.
Lo stack multimediale di Android potrebbe utilizzare GZIP trasparente per recuperare i dati. Assicurati che
i tuoi dati multimediali possono rispondere a Accept-Encoding: gzip.
Gli eventi multimediali HTML5 di Android TV potrebbero essere attivati in tempi diversi rispetto a
Chromecast, questa operazione potrebbe rivelare problemi nascosti su Chromecast.
Quando aggiorni i contenuti multimediali, usa gli eventi relativi ai contenuti multimediali attivati da <audio>/<video>
come timeupdate, pause e waiting.
Evita di usare eventi relativi al networking come progress, suspend e
stalled, poiché tendono a dipendere dalla piattaforma.
Quando configuri i certificati HTTPS del tuo sito Web ricevitore, assicurati di
Includono certificati CA intermedi. Consulta le
Pagina di test SSL Qualsys per
verifica se il percorso di certificazione certificato per il tuo sito include un'autorità di certificazione
certificato con l'etichetta "download aggiuntivo", potrebbe non caricarsi
piattaforme di terze parti.
Mentre Chromecast mostra la pagina Ricevitore web su un piano grafico da 720p,
altre piattaforme Cast, tra cui Android TV, potrebbero visualizzare la pagina con risoluzione fino a 1080p.
Assicurati che la pagina WebRicevitore venga scalata agevolmente a diverse risoluzioni.
Utilizzo di Android Debug Bridge
La piattaforma Android TV è presente in molti tipi di elettronica di consumo
Dispositivi: televisori, decoder, console per videogiochi e così via.
Ognuno può essere configurato in modo diverso. Se hai difficoltà ad accedere al
Risorse di sistema di Android TV tramite l'interfaccia utente del dispositivo, puoi:
utilizza Android Debug Bridge (ADB) per conoscere il numero di serie del dispositivo
registrazione ed eseguire il debug dell'applicazione. Vedi Android
Debug Bridge per saperne di più
informazioni.
Utilizzo di ADB tramite Wi-Fi
Per connetterti al tuo dispositivo tramite ADB con una connessione Wi-Fi:
Sul dispositivo Android TV, attiva le opzioni sviluppatore come descritto nella sezione
Preparati per lo sviluppo.
Assicurati che il computer sia collegato alla stessa rete di Android.
TV.
Apri un terminale e inserisci quanto segue:
adb connect Android TV device IP address:4321
Sul computer, apri un terminale e inserisci i comandi ADB. Puoi verificare
connessione sia stata stabilita e il dispositivo Android TV sta comunicando
attraverso la rete con il seguente comando:
adb logcat
Utilizzo di ADB con un cavo USB
Per connetterti al dispositivo tramite ADB con una connessione via cavo USB:
Configura il dispositivo Android TV per lo sviluppo, come descritto nella sezione
Preparati per lo sviluppo.
Collega l'estremità master del cavo USB al computer.
Nella finestra di dialogo Consentire il debug USB?, seleziona Consenti sempre da
questo computer e seleziona OK.
Sul computer, apri un terminale e inserisci i comandi ADB. Puoi verificare
connessione sia stata stabilita e il dispositivo Android TV sta comunicando
attraverso la rete con il seguente comando:
adb logcat
Utilizzo di ADB tramite TCP/IP
ADB funziona senza cavo USB, tramite TCP/IP, ma è necessario prima installare
Indirizzo IP del dispositivo TV. I dispositivi interessati da questo problema restano in ascolto delle connessioni delle porte ADB
automaticamente e possono essere connessi senza inizializzare la porta. Standard
i dispositivi Android TV retail non ascoltano automaticamente le connessioni ADB. della
questi dispositivi, devi prima connetterti ad ADB con un cavo USB e inizializzare
dalla porta.
Configura il dispositivo Android TV per lo sviluppo, come descritto nella sezione
Preparati per lo sviluppo.
Su Android TV, nella riga Dispositivo, seleziona Rete > Wi-Fi
e seleziona la rete connessa.
Seleziona Informazioni di stato e prendi nota dell'indirizzo IP.
Se il tuo dispositivo è un dispositivo Android TV standard per la vendita al dettaglio, procedi nel seguente modo:
Assicurati che il computer sia collegato alla stessa rete del dispositivo Android.
TV.
Sul computer, in un terminale, inizializza la porta per TCP/IP tramite
inserendo quanto segue:
adb tcpip 5555
Rimuovi il cavo USB e inserisci quanto segue nel terminale:
adb connect Android TV device IP address:5555
Se il tuo dispositivo è un problema con Android TV sviluppato da uno sviluppatore, procedi nel seguente modo:
Assicurati che il computer sia collegato alla stessa rete di Android.
TV.
Apri un terminale e inserisci quanto segue:
adb connect Android TV device IP address:4321
Su Android TV, nella finestra di dialogo Consentire il debug USB?, seleziona Sempre.
Consenti da questo computer e seleziona OK. Puoi verificare la connessione
e che il dispositivo Android TV comunichi tramite
con il seguente comando:
[null,null,["Ultimo aggiornamento 2025-07-25 UTC."],[[["\u003cp\u003eExisting Google Cast applications are compatible with Android TV without requiring modifications.\u003c/p\u003e\n"],["\u003cp\u003eBefore developing for Android TV, create a Cast application for Chromecast as a prerequisite.\u003c/p\u003e\n"],["\u003cp\u003eTo debug a Web Receiver on Android TV, connect through ADB and use Chrome DevTools (chrome://inspect).\u003c/p\u003e\n"],["\u003cp\u003eEnsure your Web Receiver handles various resolutions and potential user-agent string issues for compatibility.\u003c/p\u003e\n"],["\u003cp\u003eAndroid TV supports ADB debugging via USB, Wi-Fi, or TCP/IP for easier development and troubleshooting.\u003c/p\u003e\n"]]],[],null,["# Android TV with Google Cast\n\nWith the release of Android 5.0 comes Android TV, which supports Google Cast.\nThis document describes what you need to do to set up and test on Android TV\nwhen developing Cast applications. Your existing Cast application runs on\nAndroid TV with no additional effort. If you are developing a Cast application\nfor the first time, review the [Google Cast documentation](/cast/docs/developers)\nand develop your Cast application to run on a Chromecast device first before\ndeveloping and testing with Android TV.\n| **Note:** This document assumes that you have already developed an application that runs on a Chromecast device, as that is a mandatory first step toward having your Cast application running on Android TV.\n\nSetting up for development\n--------------------------\n\n1. Set up your Android TV device:\n 1. Connect the Android TV device to the local network.\n 2. Sign into your Google account.\n2. From the **Settings** , in the **Device** row, select **About**.\n3. Scroll down to and click on **Build** several times until a dialog appears with the message, \"You are now a developer.\"\n4. If USB debugging:\n 1. Install the USB cable, but don't connect the master end of the USB cable to your computer just yet.\n 2. In the **Preferences** row, select **Developer options** , select **USB debugging** , and select **On**.\n5. Navigate back to the home screen. You must do this to apply the settings you just selected. The settings will persist unless you perform a factory reset.\n6. Register your Android TV device on the [Google Cast SDK Developer Console](https://cast.google.com/publish), as described in [Device Registration](/cast/docs/registration#RegisterDevice).\n\nDebugging\n---------\n\nTo test and debug your Web Receiver application on your Android TV device, do the\nfollowing:\n\n1. Register your Android TV device and your application on the [Google Cast SDK Developer Console](https://cast.google.com/publish). See [Registration](/cast/docs/registration) for more information about registering devices and applications.\n2. Start your sender application and cast to the Android TV device.\n3. Connect to your Android TV device via ADB, as described in [Using Android Debug Bridge](#using_android_debug_bridge).\n4. On your development machine, open a Chrome browser window and navigate to **chrome://inspect** . **Note:** This is different than the [debugging option for a Chromecast device](/cast/docs/debugging#chrome_remote_debugger), where you navigate to your Web Receiver's IP address on port 9222.\n5. Click the **inspect** link to bring the Web Receiver into the debugger.\n6. In the Chrome Remote Debugger console, enable debug logging by entering the\n following:\n\n cast.receiver.logger.setLevelValue(cast.receiver.LoggerLevel.DEBUG);\n\nSee [Debugging](/cast/docs/debugging) for more information.\n\nGuidelines for Android TV compatibility\n---------------------------------------\n\nMaking your Cast application compatible with Android TV requires very little\nadditional work. Here are some recommendations and common pitfalls to avoid in\norder to ensure your application is compatible with Android TV:\n\n- Be aware that the user-agent string contains both \"Android\" and \"CrKey\"; some sites may redirect to a mobile-only site because they detect the \"Android\" label. Don't assume that \"Android\" in the user-agent string always indicates a mobile user.\n- Android's media stack may use transparent GZIP for fetching data. Make sure your media data can respond to `Accept-Encoding: gzip`.\n- Android TV HTML5 media events may be triggered in different timings than Chromecast, this may reveal issues that were hidden on Chromecast.\n- When updating the media, use media related events fired by `\u003caudio\u003e/\u003cvideo\u003e` elements, like `timeupdate`, `pause` and `waiting`. Avoid using networking related events like `progress`, `suspend` and `stalled`, as these tend to be platform dependent.\n- When configuring your Web Receiver site's HTTPS certificates, be sure to include intermediate CA certificates. See the [Qualsys SSL test page](https://www.ssllabs.com/ssltest/analyze.html) to verify: if the trusted certification path for your site includes a CA certificate labelled \"extra download\", then it may not load on Android-based platforms.\n- While Chromecast displays the Web Receiver page on a 720p graphics plane, other Cast platforms including Android TV may display the page up to 1080p. Ensure your Web Receiver page scales gracefully at different resolutions.\n\nUsing Android Debug Bridge\n--------------------------\n\nThe Android TV platform is featured on many kinds of consumer electronics\ndevices: televisions, set-top boxes, gaming consoles and so forth.\nEach may be configured differently. If you are having difficulty accessing the\nAndroid TV system resources through the device's user interface, you may\nuse the Android Debug Bridge (ADB) to obtain your device's serial number for\nregistration, as well as to debug your application. See [Android\nDebug Bridge](http://developer.android.com/tools/help/adb.html) for more\ninformation.\n\n### Using ADB over Wi-Fi\n\nTo connect to your device via ADB with a Wi-Fi connection:\n\n1. On your Android TV device, enabled developer options as described in [Setting up for development](#setting_up_for_development).\n2. Be sure your computer is connected to the same network as your Android TV device.\n3. Open a terminal and enter the following:\n\n ```\n adb connect Android TV device IP address:4321\n ```\n4. On your computer, open a terminal and enter ADB commands. You can verify the\n connection is established and that the Android TV device is communicating\n across the network with the following command:\n\n ```\n adb logcat\n ```\n\n### Using ADB with a USB cable\n\nTo connect to your device via ADB with a USB cable connection:\n\n1. Set up your Android TV device for development, as described in [Setting up for development](#setting_up_for_development).\n2. Connect the master end of the USB cable to your computer.\n3. In the **Allow USB debugging?** dialog, select **Always** allow from this computer, and select **OK**.\n4. On your computer, open a terminal and enter ADB commands. You can verify the\n connection is established and that the Android TV device is communicating\n across the network with the following command:\n\n ```\n adb logcat\n ```\n\n### Using ADB over TCP/IP\n\nADB works without a USB cable, over TCP/IP, but you must first get the Android\nTV device's IP address. Developer-issue devices listen for ADB port connections\nautomatically and can be connected without initializing the port. Standard\nretail Android TV devices do not listen for ADB connections automatically; for\nthese devices, you must first connect to ADB with a USB cable and initialize\nthe port.\n\n1. Set up your Android TV device for development, as described in [Setting up for development](#setting_up_for_development).\n2. On the Android TV, in the **Device** row, select **Network** \\\u003e **Wi-Fi**, and select the connected network.\n3. Select **Status info** and note the **IP address**.\n4. If your device is a standard, retail Android TV device, do the following:\n\n 1. Follow the steps under [Using ADB with a USB cable](#using_adb_with_a_usb_cable).\n 2. Be sure your computer is connected to the same network as the Android TV device.\n 3. On your computer, in a terminal, initialize the port for TCP/IP by\n entering the following:\n\n ```\n adb tcpip 5555\n ```\n 4. Remove the USB cable, and enter the following in the terminal:\n\n ```\n adb connect Android TV device IP address:5555\n ```\n5. If your device is a developer-issue Android TV, do the following:\n\n 1. Be sure your computer is connected to the same network as your Android TV device.\n 2. Open a terminal and enter the following:\n\n ```\n adb connect Android TV device IP address:4321\n ```\n6. On the Android TV, in the **Allow USB debugging?** dialog, select **Always\n allow from this computer** , and select **OK**. You can verify the connection\n is established and that the Android TV device is communicating across the\n network with the following command:\n\n ```\n adb logcat\n ```"]]
