Usar o app de exemplo do Android

O app de amostra 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 é concluída e uma estrutura é selecionada, o app de amostra carrega todos os dispositivos locais encontrados nessa estrutura.

Se um dispositivo estiver em uma sala, ele será listado nessa sala. O app de amostra oferece suporte a estes tipos de dispositivos:

  • Luz de temperatura de cor (ligada e desligada, brilho)
  • Sensor de contato (estado booleano)
  • Iluminação regulável (ligada e desligada, brilho)
  • Luz de cor estendida (ligada e desligada, brilho)
  • Interruptor genérico
  • Câmera do Google
  • Sensor de presença (detecção de ocupação)
  • Luz ligada/desligada (ligada e desligada, brilho)
  • Interruptor de luz ligado/desligado
  • Unidade plug-in ligada/desligada (ligada e desligada)
  • Sensor ligado/desligado

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

O app de amostra consiste em duas guias: Dispositivos e Automações. Cada guia fornece informações sobre a estrutura e permite que você realize tarefas.

Guia "Dispositivos"

A guia Dispositivos (Figura 1) mostra os cômodos da estrutura (quintal, sótão, viagem) e os dispositivos de cada cômodo, além do status de cada dispositivo. Para visualizar ou editar as características de um dispositivo, toque no nome dele. Isso leva você à tela de controle desse 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: tela do app de exemplo: visualização da guia "Dispositivos"
Controles de dispositivos do app de exemplo das APIs Home.
Figura 2: controles do dispositivo do app de exemplo

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. Há suporte para várias ativações e ações.

Toque em uma automação para ver os detalhes dela, conforme mostrado no exemplo da Figura 4. Nessa visualização detalhada, você pode excluir a automação ou executá-la manualmente sem precisar de uma ativação, desde que o botão Executar manualmente seja compatível com essa automação.

Também na visualização detalhada de uma automação (Figura 4), você pode ativar ou desativar isActive. O campo isValid é definido pelo SDK e é false se houver um problema com o dispositivo ou suporte de características 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 nova automação, toque no botão Criar na visualização da lista de automações (Figura 3). A tela Nova automação aparece (Figura 5).

Use os botões +Adicionar ativação e +Adicionar ação (Figura 5) para adicionar uma ou mais ativações e ações à automação. As figuras 6 e 7 mostram exemplos de seleção de uma ativação e uma ação, respectivamente. Depois de fazer as seleções e salvar a ativação ou ação, os botões Atualizar ativação e Remover ativação serão apresentados para a ativação (e Atualizar ação e Remover ação para a ação). Isso oferece a oportunidade de editar ou remover a ativação ou ação antes de salvar a automação.

Quando terminar de adicionar ativaçõ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 uma ativação a uma automação.
Figura 6: adicionar uma ativação a uma automação
Tela do app de exemplo 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 diálogo para alguns eventos comuns que podem ocorrer. Consulte os registros adb para informações sobre como resolver esses eventos.

Se você encontrar problemas ao usar o app de amostra, consulte Solução de problemas do Android.