Autorizzazione account su Android

Prima di procedere con l'autorizzazione dell'account, assicurati di avere:

  1. L'Google Home app (GHA) installata sul dispositivo mobile Android.
  2. Almeno uno di questi tipi di dispositivi supportati per l'app di esempio nella casa:
    • Luce a temperatura di colore (on/off, luminosità)
    • Sensore di contatto (stato booleano)
    • Luce dimmerabile (on/off, luminosità)
    • Serratura per porte
    • Luce a gamma cromatica estesa (on/off, luminosità)
    • Interruttore generico
    • Router di confine Google
    • Google Fotocamera
    • Google Campanello
    • 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
  3. Due dispositivi per testare l'automazione di esempio.

Prima di utilizzare i dispositivi tramite le API Home, è necessario che siano controllabili da GHA.

Esegui l'app di esempio per Android

Prima di autorizzare un account, verifica che l'app di esempio sia configurata con l'ambito OAuth appropriato per il tuo progetto. Per impostazione predefinita, il codice sorgente dell'app di esempio utilizza l'ambito https://www.googleapis.com/auth/home.platform.v2. Molte funzionalità dell'app di esempio sono limitate dall'ambito home.platform.v2 e richiedono l'approvazione del partner per l'accesso. Per autorizzare e utilizzare l'app di esempio con l'ambito standard https://www.googleapis.com/auth/home.platform.selected.devices, imposta manualmente homePlatformScope su HOME_PLATFORM_SCOPE_VERSION_1 in HomeModule.kt come descritto in Creare l'app.

Esegui l'app di esempio per Android. La prima volta che la esegui, ti verrà chiesto di consentire l'accesso a una casa sul tuo Account Google. In questo modo, l'app di esempio potrà accedere e controllare le strutture e i dispositivi della casa.

Se non hai una struttura, l'utente può crearne una durante il flusso di autorizzazione senza dover utilizzare GHA.

Il comportamento di autorizzazione predefinito dell'app varia a seconda che l'app sia stata registrata o meno nella Google Home Developer Console.

Se un'app non è registrata nella Developer Console, sarà in stato non verificato. Questo stato è consigliato per testare l'utilizzo delle API Home:

Se un'app è registrata nella Developer Console e è stata approvata per l'accesso a uno o più tipi di dispositivi e la verifica del brand è stata completata per OAuth, sarà in stato verificato. Questo stato è necessario per il lancio di un'app in produzione:

  • I limiti degli utenti di test non si applicano più. Qualsiasi utente può concedere l'autorizzazione all'app.
  • L'utente può concedere l'autorizzazione solo ai tipi di dispositivi approvati in the Developer Console.

Tocca Consenti l'accesso a una casa scelta:

  • Se al tuo account sono collegate delle case, scegli una casa a cui concedere l'autorizzazione. Se non vengono trovati dispositivi nella casa scelta, puoi:
    1. Tocca Consenti l'accesso a un'altra casa per selezionare un'altra casa.
    2. Configura un dispositivo a tua scelta nella casa utilizzando l'app Google HomeGoogle Home app (GHA). Ricorda che solo questi tipi di dispositivi sono supportati per il controllo in questa app di esempio:
      • Luce a temperatura di colore (on/off, luminosità)
      • Sensore di contatto (stato booleano)
      • Luce dimmerabile (on/off, luminosità)
      • Serratura per porte
      • Luce a gamma cromatica estesa (on/off, luminosità)
      • Interruttore generico
      • Router di confine Google
      • Google Fotocamera
      • Google Campanello
      • 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
  • Se non sono collegate case al tuo account, vedrai una schermata con il messaggio Non sono presenti strutture per l'account selezionato.
    1. Scorri indietro per tornare alla visualizzazione principale dell'app di esempio.
    2. Per configurare una casa, utilizza l'app Google HomeGHA. Quindi prova di nuovo a concedere l'autorizzazione all'app di esempio.

Il flusso di autorizzazioni può essere rivisto in qualsiasi momento selezionando l'icona del profilo in alto a destra in qualsiasi schermata dell'app di esempio.

Selezionando una struttura in cui eseguire l'app di esempio.
Figura 1: seleziona una struttura
La struttura selezionata, che mostra i dispositivi disponibili.
Figura 2: struttura e dispositivi
Controllare le impostazioni di un dispositivo.
Figura 3: controlli dei dispositivi
La struttura selezionata, che mostra le automazioni disponibili.
Figura 4: struttura e automazioni

Una volta concessa l'autorizzazione a una casa con dispositivi, verrà visualizzata la visualizzazione dei dispositivi. Puoi controllare i dispositivi e osservare le modifiche dello stato tramite l'app di esempio.