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, avrai bisogno di un computer con i seguenti strumenti installati:

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

    Scarica Android Studio

  • Il debugger Android (adb).

    Installa adb.

    Questa operazione può essere eseguita con SDK Manager.

Per testare le API Home, devi avere:

  • 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 sviluppatore.
  • Una rete Wi-Fi.
  • Per accedere ai dispositivi Matter e controllarli, devi anche avere un hub Google che supporti le API Home. Per informazioni dettagliate, 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 Thread Border Router (TBR). I seguenti tipi di dispositivi e tratti sono supportati dall'app di esempio per Android:

    • Luce con temperatura di colore (accensione e spegnimento, luminosità)
    • Sensore di contatto (stato booleano)
    • Luce dimmerabile (accensione e spegnimento, luminosità)
    • Serratura per porte
    • Luce a gamma cromatica estesa (accensione e spegnimento, luminosità)
    • Switch generico
    • Router di confine Google
    • Google Fotocamera
    • Google Doorbell
    • Sensore di presenza (rilevamento di presenza)
    • Luce On/Off (accensione e spegnimento, 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 Supporto del router di confine 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

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 Home, devi scaricare e ospitare le librerie localmente.

Per scaricare l'SDK Android di Home APIs, devi prima accedere a Google Home Developers.

Accedi ora.

Avanti
2. Configurare OAuth