Home APIs zu Ihrer Android-App hinzufügen

Wenn du die Home APIs einer Android-App hinzufügen möchtest, müssen einige Voraussetzungen erfüllt sein.

Vorbereitung

Für die Entwicklung benötigst du einen Computer, auf dem die folgenden Tools installiert sind:

  • Android Studio, Version 2024.2.1 („Ladybug“) oder höher. Beachte, dass frühere Versionen möglicherweise nicht ordnungsgemäß mit dem Home APIs SDK funktionieren.

    Android Studio herunterladen

  • Den Android-Debugger (adb).

    Install adb.

    Dies kann mit dem SDK Manager erfolgen.

Zum Testen der Home APIs benötigst du außerdem Folgendes:

  • Ein Android-Gerät mit Android 10 oder höher, das mit einem Google-Konto eingerichtet ist, das du für die Entwicklung verwenden möchtest. Achte darauf, dass eine aktuelle Version von Android Studio installiert ist und du mit diesem Entwicklungskonto angemeldet bist.
  • Ein WLAN.
  • Wenn du Matter Geräte aufrufen und steuern möchtest, benötigst du außerdem einen Google-Hub, der die Home APIs unterstützt. Weitere Informationen findest du unter Konnektivität auf Android .

  • Mindestens ein unterstütztes Gerät im Zuhause. Wenn dieses Gerät (oder ein anderes, das du testen möchtest) Thread verwendet, muss der Hub auch ein Thread-Border-Router sein. Die folgenden Gerätetypen und Merkmale werden von der Android-Beispiel-App unterstützt:

    • Farbtemperatur-Licht (ein und aus, Helligkeit)
    • Kontaktsensor (boolescher Status)
    • Dimmbares Licht (ein und aus, Helligkeit)
    • Licht mit erweitertem Farbspektrum (ein und aus, Helligkeit)
    • Allgemeiner Schalter
    • Google Kamera
    • Anwesenheitssensor (Anwesenheit im Zuhause)
    • Ein/Aus-Licht (ein und aus, Helligkeit)
    • Ein/Aus-Lichtschalter
    • Ein/Aus-Steckdose (ein und aus)
    • Ein/Aus-Sensor

Unterstützte Hubs

Nur bestimmte Google Nest-Hubs unterstützen die Home APIs.

Tabelle: Google Nest-Hubs mit Unterstützung für Home APIs
Gerät Thread Unterstützung für Border-Router 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

SDK einrichten

Die Home APIs in dieser offenen Beta sind noch nicht Teil der Standardbibliotheken, die von Google für die Entwicklung bereitgestellt werden. Wenn du Anwendungen mit den Home APIs entwickeln möchtest, musst du die Bibliotheken lokal herunterladen und hosten.

Wenn du das Home APIs Android SDK herunterladen möchtest, musst du zuerst bei Google Home-Entwickler angemeldet sein.

Jetzt anmelden

Weiter
2. OAuth einrichten