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

    Télécharger Android Studio

  • Débogueur Android (adb).

    Installez adb.

    Pour ce faire, utilisez le gestionnaire de SDK.

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 connectée à 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 .

  • Vous devez disposer d'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. L'application exemple Android est compatible avec les types d'appareils et les traits suivants :

    • Température des couleurs (allumer et éteindre, luminosité)
    • Capteur de contact (état booléen)
    • Lumière à intensité variable (allumée/éteinte, luminosité)
    • Lumière à spectre de couleurs étendu (allumée/éteinte, luminosité)
    • Switch générique
    • Capteur de présence (détection de présence)
    • Allumer/Éteindre la lumière (allumer et éteindre, luminosité)
    • Interrupteur marche/arrêt
    • Module de prise Marche/Arrêt (marche et arrêt)
    • Capteur Marche/Arrêt

Hubs compatibles

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

Table : hubs Google Nest compatibles avec les API Home
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 en local.

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

Connectez-vous dès maintenant !

Suivant
2. Configurer OAuth