Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Android 5.0 est accompagné d'Android TV, compatible avec Google Cast.
Ce document décrit la procédure de configuration et de test sur Android TV.
lors du développement d'applications Cast. Votre application Cast existante s'exécute sur
Android TV sans effort supplémentaire Si vous développez une application Cast
pour la première fois, consultez la documentation Google Cast
et développer votre application Cast pour qu'elle s'exécute d'abord sur un appareil Chromecast
développer et tester avec Android TV.
Dans Paramètres, sur la ligne Appareil, sélectionnez À propos.
Faites défiler la page jusqu'à Build (Compiler) et cliquez dessus plusieurs fois jusqu'à ce qu'une boîte de dialogue
avec le message "Vous êtes désormais un développeur".
En cas de débogage USB:
<ph type="x-smartling-placeholder"></ph>
Installez le câble USB, mais ne connectez pas l'extrémité maître.
sur votre ordinateur.
Sur la ligne Préférences, sélectionnez Options pour les développeurs, puis
Débogage USB, puis sélectionnez Activé.
Revenez à l'écran d'accueil. Cette opération est obligatoire pour appliquer les paramètres
que vous venez de sélectionner. Les paramètres seront conservés tant que vous ne rétablissez pas la configuration d'usine.
Pour tester et déboguer votre application Web Receiver sur votre appareil Android TV, procédez comme suit :
suivantes:
Enregistrez votre appareil Android TV et votre application sur le
Console développeur du SDK Google Cast
Consultez la page Inscription pour en savoir plus sur
l'enregistrement d'appareils et d'applications.
Lancez l'application émettrice et castez du contenu sur l'appareil Android TV.
Pour en savoir plus, consultez la section Débogage.
Consignes relatives à la compatibilité avec Android TV
Pour rendre votre application Cast compatible avec Android TV, vous n'avez besoin
travail supplémentaire. Voici quelques recommandations et pièges courants à éviter dans
pour vous assurer que votre application est compatible avec Android TV:
Notez que la chaîne user-agent contient à la fois "Android" et "Créférence";
certains sites peuvent être redirigés vers un site réservé aux mobiles, car ils détectent le
"Android" libellé. Ne partez pas du principe que "Android" toujours dans la chaîne du user-agent.
indique un utilisateur mobile.
La pile multimédia d'Android peut utiliser un fichier GZIP transparent pour récupérer les données. Assurez-vous que
vos données multimédias peuvent répondre à Accept-Encoding: gzip.
Les événements multimédias HTML5 d'Android TV peuvent être déclenchés à des moments différents de ceux
Chromecast, cela peut révéler des problèmes qui étaient masqués sur Chromecast.
Lors de la mise à jour du contenu multimédia, utiliser les événements liés aux contenus multimédias déclenchés par <audio>/<video>
tels que timeupdate, pause et waiting.
Évitez d'utiliser des événements liés à la mise en réseau tels que progress, suspend et
stalled, car elles dépendent généralement de la plate-forme.
Lorsque vous configurez les certificats HTTPS de votre site Web Receiver, veillez à
inclure des certificats CA intermédiaires. Consultez le
Page de test SSL Qualsys pour
valider: si le parcours de certification Trusted pour votre site inclut une autorité de certification
avec la mention "Téléchargement supplémentaire", cela signifie qu'il risque de ne pas se charger
plates-formes.
Pendant que Chromecast affiche la page Web Receiver sur un plan graphique 720p,
d'autres plates-formes Cast, y compris Android TV, peuvent afficher une page avec une résolution maximale de 1080p.
Vérifiez que votre page Web Receiver s'adapte correctement à différentes résolutions.
Utiliser Android Debug Bridge
La plate-forme Android TV est utilisée sur de nombreux types de produits électroniques grand public.
tels que les téléviseurs, les boîtiers décodeurs, les consoles de jeu, etc.
Chacun d'eux peut être configuré différemment. Si vous rencontrez des difficultés pour accéder au
ressources système Android TV via l'interface utilisateur de l'appareil, vous pouvez :
utilisez Android Debug Bridge (ADB) pour obtenir le numéro de série de votre appareil pour
l'inscription et le débogage de votre application. Voir Android
Debug Bridge pour en savoir plus
des informations.
Utiliser ADB via le Wi-Fi
Pour vous connecter à votre appareil via ADB avec une connexion Wi-Fi:
Sur votre appareil Android TV, vous avez activé les options pour les développeurs comme décrit dans la section
Configurer pour le développement
Assurez-vous que votre ordinateur est connecté au même réseau que votre appareil Android.
téléviseur.
Ouvrez un terminal et saisissez la commande suivante:
adb connect Android TV device IP address:4321
Sur votre ordinateur, ouvrez un terminal et saisissez les commandes ADB. Vous pouvez vérifier
est établie et que l'appareil Android TV communique.
à l'aide de la commande suivante:
adb logcat
Utiliser ADB avec un câble USB
Pour vous connecter à votre appareil via ADB à l'aide d'une connexion par câble USB:
Connectez l'extrémité maître du câble USB à votre ordinateur.
Dans la boîte de dialogue Autoriser le débogage USB ?, sélectionnez Toujours autoriser depuis
cet ordinateur, puis sélectionnez OK.
Sur votre ordinateur, ouvrez un terminal et saisissez les commandes ADB. Vous pouvez vérifier
est établie et que l'appareil Android TV communique.
à l'aide de la commande suivante:
adb logcat
Utiliser ADB sur TCP/IP
ADB fonctionne sans câble USB, via TCP/IP, mais vous devez d'abord vous procurer Android
Adresse IP du téléviseur. Les appareils qui posent problème aux développeurs écoutent les connexions du port ADB
automatiquement et peuvent être
connectés sans initialiser le port. Normal
Les appareils Android TV pour la vente au détail n'écoutent pas automatiquement les connexions ADB. pour
vous devez d'abord vous connecter à ADB à l'aide d'un câble USB et initialiser
le port.
Assurez-vous que votre ordinateur est connecté au même réseau qu'Android
téléviseur.
Sur votre ordinateur, dans un terminal, initialisez le port pour TCP/IP en
en saisissant ce qui suit:
adb tcpip 5555
Retirez le câble USB et saisissez les informations suivantes dans le terminal:
adb connect Android TV device IP address:5555
Si votre appareil est un problème de développeur Android TV, procédez comme suit:
Assurez-vous que votre ordinateur est connecté au même réseau que votre appareil Android.
téléviseur.
Ouvrez un terminal et saisissez la commande suivante:
adb connect Android TV device IP address:4321
Sur l'Android TV, dans la boîte de dialogue Autoriser le débogage USB ?, sélectionnez Toujours.
autoriser sur cet ordinateur, puis sélectionnez OK. Vous pouvez vérifier la connexion
est établie et que l'appareil Android TV communique
à l'aide de la commande suivante:
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/25 (UTC).
[null,null,["Dernière mise à jour le 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 ```"]]
