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.
Configurer pour le développement
- Configurez votre appareil Android TV:
<ph type="x-smartling-placeholder">
- </ph>
- Connectez l'appareil Android TV au réseau local.
- Connectez-vous à votre compte Google.
- 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.
- Enregistrez votre appareil Android TV sur le Console développeur du SDK Google Cast, en tant que décrites dans la section Enregistrement de l'appareil.
Débogage
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.
- Connectez-vous à votre appareil Android TV via ADB, comme décrit dans la section Utiliser Android Debug Bridge
- Sur votre ordinateur de développement, ouvrez une fenêtre de navigateur Chrome et accédez à chrome://inspect.
- Cliquez sur le lien Inspecter pour afficher le récepteur Web dans le débogueur.
Dans la console du débogueur à distance de Chrome, activez la journalisation des données de débogage en saisissant la suivantes:
cast.receiver.logger.setLevelValue(cast.receiver.LoggerLevel.DEBUG);
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 quetimeupdate
,pause
etwaiting
. Évitez d'utiliser des événements liés à la mise en réseau tels queprogress
,suspend
etstalled
, 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:
- Configurez votre appareil Android TV pour le développement, comme décrit dans Configurer pour le développement
- 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.
- Configurez votre appareil Android TV pour le développement, comme décrit dans Configurer pour le développement
- Sur la ligne Appareil d'Android TV, sélectionnez Réseau > Wi-Fi, et sélectionnez le réseau connecté.
- Sélectionnez Informations d'état et notez l'adresse IP.
S'il s'agit d'un appareil Android TV standard commercialisé, procédez comme suit:
- Suivez les étapes de la section Utilisez ADB avec un câble USB.
- 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:
adb logcat