Ajouter les API Home à votre application Android

Pour ajouter les API Home à une application Android, vous devez remplir quelques conditions préalables.

Prérequis

Pour le développement, vous avez besoin d'un ordinateur sur lequel les outils suivants sont installés:

  • Android Studio, version 2024.2.1 ("Ladybug") ou ultérieure Notez que les versions antérieures à cette version risquent de ne pas fonctionner correctement avec le SDK des API Home.

    Télécharger Android Studio

  • Le débogueur Android (adb).

    Installez adb.

    Pour ce faire, utilisez le SDK Manager.

Pour tester les API Home, vous avez besoin des éléments suivants:

  • Un appareil Android équipé d'Android 10 ou version ultérieure configuré avec un compte Google que vous prévoyez d'utiliser pour le développement. Assurez-vous qu'une version à jour de Android Studio est installée et que vous êtes connecté avec ce compte de développement.
  • Un réseau Wi-Fi
  • Un hub Google compatible avec les API Home.
  • Au moins un appareil compatible dans la maison Si cet appareil (ou tout autre que vous souhaitez tester) utilise Thread, le hub doit également être un routeur de bordure Thread. Les types et caractéristiques d'appareils suivants sont compatibles avec l'application exemple Android:

    • Voyant de température des couleurs (allumé et éteint, luminosité)
    • Capteur de contact (état booléen)
    • Lumière réglable (allumage et extinction, luminosité)
    • Lumière de couleur étendue (marche/arrêt, luminosité)
    • Commutateur générique
    • Capteur de présence (détection de présence)
    • Lumière Marche/Arrêt (allumer et éteindre, luminosité)
    • Interrupteur marche/arrêt
    • Unité de plug-in Marche/Arrêt (marche et arrêt)
    • Capteur Marche/Arrêt

Hubs compatibles

Seuls certains hubs Google Nest sont compatibles avec les API Home.

Tableau: Hubs Google Nest compatibles avec les API Home
Appareil OS Thread Compatibilité avec le routeur de bordure Google Store
Google Home Cast
Google Nest Audio Cast
Google Nest Hub Cast
Google Nest Hub (2nd gen) Fuchsia
Google Nest Hub Max Fuchsia
Google Nest Mini Cast
Google TV Streamer (4k) Android

Configurez le SDK

Les API Home de cette version bêta ouverte ne font pas encore partie des bibliothèques standards fournies par Google pour le développement. Pour développer des applications avec les API Home, vous devez télécharger et héberger les bibliothèques en local.

Pour télécharger le SDK Android des API Home, vous devez d'abord être connecté à Google Home Developers.

Connectez-vous dès maintenant.