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 aurez 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 peuvent ne pas fonctionner correctement avec le SDK des API Home.

    Télécharger Android Studio

  • Le débogueur Android (adb).

    Installez adb.

    Vous pouvez le faire avec le SDK Manager.

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

  • Un appareil Android équipé d'Android 10 ou version ultérieure, configuré avec un compte Google que vous comptez utiliser pour le développement. Assurez-vous qu'une version à jour du Android Studio est installée et que vous êtes connecté avec ce compte de développement.
  • Un réseau Wi-Fi.
  • Pour accéder aux appareils Matter et les contrôler, vous avez également besoin d'un hub Google compatible avec les API Home. Pour en savoir plus, consultez la section Connectivité sur Android .

  • Au moins un appareil compatible dans la maison. Si cet appareil (ou tout autre appareil que vous souhaitez tester) utilise Thread, le hub doit également être un routeur de bordure Thread. Les types d'appareils et les caractéristiques suivants sont compatibles avec l'application exemple Android :

    • Lumière à température de couleur (marche/arrêt, luminosité)
    • Capteur de contact (état booléen)
    • Lumière à intensité variable (marche/arrêt, luminosité)
    • Lumière à couleur étendue (marche/arrêt, luminosité)
    • Interrupteur générique
    • Appareil photo Google
    • Capteur de présence (détection de présence)
    • Lumière marche/arrêt (marche/arrêt, luminosité)
    • Interrupteur marche/arrêt
    • Prise marche/arrêt (marche/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 support
Appareil Thread Compatibilité avec le routeur de bordure Google Store
Google Home
Google Nest Audio
Google Nest Hub
Google Nest Hub (2nd gen)
Google Nest Hub Max
Google Nest Mini
Google TV Streamer (4k)
Nest WiFi Pro

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 localement.

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

Se connecter

Suivant
2. Configurer OAuth