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 sont installés les outils suivants :

  • Android Studio, version 2024.2.1 ("Ladybug") ou ultérieure. Notez que les versions antérieures peuvent ne pas fonctionner correctement avec le SDK Home APIs.

    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 aurez 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.
  • 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 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 Thread Border Router (TBR). Les types d'appareils et traits suivants sont compatibles avec l'application exemple Android :

    • Éclairage avec température de couleur (allumer et éteindre, luminosité)
    • Capteur de contact (état booléen)
    • Lumière à intensité variable (allumée et éteinte, luminosité)
    • Serrure
    • Éclairage couleur étendu (allumer et éteindre, luminosité)
    • Interrupteur générique
    • Routeur de bordure Google
    • Appareil photo Google
    • Google Doorbell
    • Capteur de présence (détection de présence)
    • Lumière On/Off (allumer et éteindre, luminosité)
    • Interrupteur ON/OFF
    • Prise connectée (marche/arrêt)
    • Capteur marche/arrêt

Hubs compatibles

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

Tableau : Google Nest Hub compatibles avec les API Home
Appareil Compatibilité avec le routeur de bordure Thread 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 vous connecter à Google Home Developers.

Connectez-vous maintenant.

Suivant
2. Configurer OAuth