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 successiva. Tieni presente che le versioni precedenti potrebbero non funzionare correttamente con l'SDK delle API Home.

    Scaricare Android Studio

  • Il debugger Android (adb).

    Installa adb.

    Questa operazione può essere eseguita con SDK Manager.

Per testare le API Home, ti serviranno:

  • 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 di aver eseguito l'accesso con questo account di sviluppo.
  • Una rete Wi-Fi.
  • Un hub Google che supporta le API Home.
  • 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. L'app di esempio per Android supporta i seguenti tipi di dispositivi e trait:

    • Luce temperatura colore (accesa e spenta, luminosità)
    • Sensore di contatto (stato booleano)
    • Luce dimmerabile (on e off, luminosità)
    • Luce a colori estesa (on e off, luminosità)
    • Switch generico
    • Sensore di presenza (rilevamento della presenza)
    • Luce On/Off (accesa e spenta, luminosità)
    • Interruttore della luce on/off
    • Unità plug-in On/Off (on e off)
    • Sensore On/Off

Hub supportati

Solo alcuni hub Google Nest supportano le API Home.

Tabella: Google Nest Hub con supporto delle API Home
Dispositivo Sistema operativo Thread Supporto del router di confine Google Store
Google Home Cast
Google Nest Audio Cast
Google Nest Hub Cast
Google Nest Hub (2nd gen) Fuchsia
Google Nest Hub Max Fuchsia
Google Nest Mini Cast
Google TV Streamer (4k) Android

Configura l'SDK

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

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

Accedi ora.