Utilizzare l'app di esempio per Android

L'app di esempio per Android mostra le funzionalità di base di accesso e controllo dei dispositivi utilizzando le API Home per i tipi di dispositivi supportati.

Una volta completata l'autorizzazione dell'account e selezionata una struttura, l'app di esempio carica tutti i dispositivi locali trovati in quella struttura. Se il dispositivo si trova in una stanza, verrà elencato sotto quella stanza. L'app di esempio supporta i seguenti tipi di dispositivi:

  • Luce a temperatura di colore (on/off, luminosità)
  • Sensore di contatto (stato booleano)
  • Luce dimmerabile (on/off, luminosità)
  • Luce colorata estesa (on/off, luminosità)
  • Generic Switch
  • Google Fotocamera
  • Sensore di presenza (rilevamento della presenza)
  • Luce accesa/spenta (accensione e spegnimento, luminosità)
  • Interruttore della luce on/off
  • Unità plug-in on/off (accesa e spenta)
  • Sensore di accensione/spegnimento

Azioni su dispositivi e automazioni esistenti

L'app di esempio è composta da due schede: Dispositivi e Automazioni. Ogni scheda fornisce informazioni sulla struttura e ti consente di eseguire attività.

Scheda Dispositivi

La scheda Dispositivi (Figura 1) mostra le stanze della struttura (Giardino, Mansarda, Viaggi) e i dispositivi per ogni stanza, insieme allo stato di ciascun dispositivo. Per visualizzare o modificare le caratteristiche di un dispositivo, tocca il nome del dispositivo. Viene visualizzata la schermata di controllo del dispositivo (Figura 2).

Per aggiungere un dispositivo alla struttura, tocca Aggiungi dispositivo dalla scheda Dispositivi (Figura 1), quindi segui le istruzioni per aggiungere un dispositivo con o senza utilizzare un codice QR.

Scheda Dispositivi dell'app di esempio delle API Home.
Figura 1: schermata dell'app di esempio: visualizzazione della scheda Dispositivi
Controlli dei dispositivi dell'app di esempio delle API Home.
Figura 2: controlli dei dispositivi dell'app di esempio

Scheda Automazioni

La scheda Automazioni (Figura 3) mostra un elenco di tutte le automazioni per la struttura. Ogni automazione mostra i relativi comandi iniziali e azioni. Sono supportati più comandi iniziali e azioni.

Tocca un'automazione per visualizzarne i dettagli, come mostrato nell'esempio della Figura 4. In questa visualizzazione dettagliata, puoi eliminare l'automazione o eseguirla manualmente senza bisogno di un comando iniziale, a condizione che il pulsante Esegui manualmente sia supportato per questa automazione.

Inoltre, nella visualizzazione dettagliata di un'automazione (Figura 4), puoi attivare/disattivare isActive. Il campo isValid è impostato dall'SDK ed è false se si verifica un problema con il supporto del dispositivo o del tratto o qualche altro problema.

Scheda Automazioni dell'app di esempio delle API Home.
Figura 3: visualizzazione della scheda Automazioni
Visualizzazione dettagliata di un'automazione selezionata.
Figura 4: visualizzazione dettagliata di un'automazione

Crea un'automazione

Per creare una nuova automazione, tocca il pulsante Crea nell'elenco delle automazioni (Figura 3). Viene visualizzata la schermata Nuova automazione (Figura 5).

Utilizza i pulsanti + Aggiungi comando iniziale e + Aggiungi azione (Figura 5) per aggiungere uno o più comandi iniziali e azioni all'automazione. Le figure 6 e 7 mostrano esempi di selezione di un comando iniziale e di un'azione, rispettivamente. Dopo aver effettuato le selezioni e salvato lo starter o l'azione, vengono visualizzati i pulsanti Aggiorna starter e Rimuovi starter per lo starter (e Aggiorna azione e Rimuovi azione per l'azione). In questo modo hai la possibilità di modificare o rimuovere il comando iniziale o l'azione prima di salvare l'automazione.

Una volta aggiunti i comandi iniziali e le azioni, puoi tornare alla schermata Nuova automazione e toccare Crea automazione (Figura 8).

Schermata dell'app di esempio per l'avvio di una nuova automazione.
Figura 5: inizia a creare una nuova automazione
Schermata di esempio dell'app per l'aggiunta di un comando iniziale per un'automazione.
Figura 6: aggiunta di un comando iniziale a un'automazione
Schermata dell'app di esempio per l'aggiunta di un'azione per un'automazione.
Figura 7: aggiunta di un'azione a un'automazione
Schermata dell'app di esempio per la creazione di un'automazione.
Figura 8: creazione dell'automazione

Risoluzione dei problemi

L'app mostra messaggi di dialogo per alcuni eventi comuni che potrebbero verificarsi. Consulta i log adb per informazioni su come risolvere questi eventi.

Se riscontri problemi durante l'utilizzo dell'app di esempio, consulta la sezione Risoluzione dei problemi per Android.