Usar o app de exemplo do Android

O app de exemplo do Android mostra os recursos básicos de acesso e controle de dispositivos usando as APIs Home para os tipos de dispositivos compatíveis.

Depois que a autorização da conta for concluída e uma estrutura for selecionada, o app de exemplo vai carregar todos os dispositivos locais encontrados nessa estrutura. Se o dispositivo estiver em um ambiente, ele vai aparecer listado abaixo dele. O app de exemplo é compatível com estes tipos de dispositivos:

  • Luz de temperatura da cor (ligar e desligar, brilho)
  • Sensor de contato (estado booleano)
  • Luz regulável (ligar e desligar, brilho)
  • Luz colorida estendida (ligada e desligada, brilho)
  • Switch genérico
  • Câmera do Google
  • Sensor de ocupação (detecção de ocupação)
  • Luz de ativação/desativação (ativação e desativação, brilho)
  • Interruptor de luz liga/desliga
  • Unidade de plug-in liga/desliga (ligada e desligada)
  • Sensor de ativação/desativação

Ações em dispositivos e automações atuais

O app de exemplo consiste em duas guias: Dispositivos e Automações. Cada guia fornece informações sobre a estrutura e permite realizar tarefas.

Guia "Dispositivos"

A guia Dispositivos (Figura 1) mostra os ambientes na estrutura (Quintal, Sótão, Viagem) e os dispositivos de cada ambiente, além do status de cada um. Para ver ou editar os traços de um dispositivo, toque no nome dele. Isso leva você à tela de controle do dispositivo (Figura 2).

Para adicionar um dispositivo à estrutura, toque em Adicionar dispositivo na guia Dispositivos (Figura 1) e siga as instruções para adicionar um dispositivo com ou sem usar um QR code.

Guia "Dispositivos" do app de exemplo das APIs Home.
Figura 1: exemplo de tela do app: visualização da guia "Dispositivos"
Controles de dispositivos do app de exemplo das APIs Home.
Figura 2: exemplo de controles de dispositivo do app

Guia "Automações"

A guia Automações (Figura 3) mostra uma lista de todas as automações da estrutura. Cada automação mostra as ativações e ações. Várias ativações e ações são aceitas.

Toque em uma automação para ver os detalhes dela, como mostrado no exemplo da Figura 4. Nessa visualização detalhada, é possível excluir ou executar manualmente a automação sem precisar de um iniciador, desde que o botão Executar manualmente seja compatível com ela.

Também na visualização detalhada de uma automação (Figura 4), é possível ativar ou desativar isActive. O campo isValid é definido pelo SDK e é false se houver um problema com o suporte a dispositivos ou traços ou algum outro problema.

Guia "Automações" do app de exemplo das APIs Home.
Figura 3: visualização da guia "Automações"
Visualização detalhada de uma automação selecionada.
Figura 4: visualização detalhada de uma automação

Criar uma automação

Para criar uma automação, toque no botão Criar na lista de automações (Figura 3). A tela Nova automação aparece (Figura 5).

Use os botões +Adicionar inicializador e +Adicionar ação (Figura 5) para adicionar um ou mais inicializadores e ações à sua automação. As figuras 6 e 7 mostram exemplos de como selecionar um inicializador e uma ação, respectivamente. Depois de fazer as seleções e salvar o gatilho ou a ação, os botões Atualizar gatilho e Remover gatilho vão aparecer para o gatilho (e Atualizar ação e Remover ação para a ação). Assim, você pode editar, remover ou salvar a automação.

Quando terminar de adicionar inicializações e ações, volte para a tela Nova automação e toque em Criar automação (Figura 8).

Tela do app de exemplo para iniciar uma nova automação.
Figura 5: começar a criar uma nova automação
Tela de exemplo do app para adicionar um gatilho a uma automação.
Figura 6: adicionar um gatilho a uma automação
Exemplo de tela do app para adicionar uma ação a uma automação.
Figura 7: adicionar uma ação a uma automação
Tela de exemplo do app para criar uma automação.
Figura 8: criar a automação

Solução de problemas

O app mostra mensagens de caixa de diálogo para alguns eventos comuns que podem ocorrer. Consulte os registros do adb para saber como resolver esses eventos.

Se você tiver problemas ao usar o app de exemplo, consulte Solução de problemas para Android.