Aggiungere le API Home all'app per Android

Per aggiungere le API Home a un'app per Android, devi soddisfare alcuni prerequisiti.

Prerequisiti

Per lo sviluppo, ti servirà un computer su cui sono installati i seguenti strumenti:

  • Android Studio, versione 2024.2.1 ("Ladybug") o successive. Tieni presente che le versioni precedenti potrebbero non funzionare correttamente con l'SDK delle API Home.

    Scarica Android Studio

  • Il debugger Android (adb).

    Installa adb.

    Puoi farlo con SDK Manager.

Per testare le API Home, ti servirà:

  • Un dispositivo Android con Android 10 o versioni successive configurato con un Account Google che intendi utilizzare per lo sviluppo. Assicurati che sia installata una versione aggiornata di Android Studio e che tu abbia eseguito l'accesso con questo account di sviluppo.
  • Una rete Wi-Fi.
  • Per accedere ai dispositivi Matter e controllarli, devi anche avere un hub Google che supporti le API Home. Per maggiori dettagli, consulta Connettività su Android .

  • Almeno un dispositivo supportato in casa. Se questo dispositivo (o qualsiasi altro che vuoi testare) utilizza Thread, l'hub deve essere anche un router di confine Thread. I seguenti tipi di dispositivi e tratti sono supportati dall'app di esempio Android:

    • Luce a temperatura di colore (on/off, luminosità)
    • Sensore di contatto (stato booleano)
    • Luce dimmerabile (on/off, luminosità)
    • Luce a gamma cromatica estesa (on/off, luminosità)
    • Interruttore generico
    • Google Fotocamera
    • Sensore di presenza (rilevamento della presenza)
    • Luce on/off (on/off, luminosità)
    • Interruttore della luce on/off
    • Unità plug-in on/off (on/off)
    • Sensore on/off

Hub supportati

Solo alcuni hub Google Nest supportano le API Home.

Tabella: hub Google Nest con supporto delle API Home
Dispositivo Thread Supporto del router di confine 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

Configura l'SDK

Le API Home in questa beta aperta non fanno ancora parte delle librerie standard fornite da Google per lo sviluppo. Per sviluppare applicazioni con le API Home, devi scaricare e ospitare le librerie localmente.

Per scaricare l'SDK Android delle API Home, devi prima aver eseguito l'accesso a Google Home Developers.

Accedi ora.

Avanti
2. Configurare OAuth