Usar o app de exemplo do iOS

O app de exemplo 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 desse ambiente. O app de amostra é compatível com estes tipos de dispositivos:

  • Luz de temperatura de cor
  • Luz dimerizável
  • Trava da porta
  • Luz colorida estendida
  • Ventilador
  • Câmera do Google
  • Sensor de presença
  • Luz de ligar/desligar
  • Unidade de plug-in liga/desliga
  • Sensor de temperatura
  • Termostato
  • Cortina

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 cômodos da estrutura (Banheiro, Sala de estar, Escritório) e os dispositivos de cada um, além do status de cada dispositivo. Também é possível desconectar o dispositivo ou atualizar as permissões clicando no ícone more_horiz no canto superior direito da tela (Figura 2).

Guia "Dispositivos" do app de exemplo das APIs Home iOS.
Figura 1: visualização da guia "Dispositivos"
Controles de dispositivos do app de exemplo das APIs Home iOS.
Figura 2: desconectar ou atualizar permissões

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, você encontra a descrição detalhada das ativações, condições e ações.

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

Criar uma automação

Para criar uma automação, toque no botão +Adicionar na lista de automações (Figura 3). A próxima tela vai mostrar uma lista de automações sugeridas. Selecione a automação desejada (Figura 5). Se nada for preenchido automaticamente, a estrutura não terá os dispositivos necessários para a automação. Por exemplo, se você quiser ligar o ventilador e a luz, a estrutura precisa conter os dois dispositivos. Caso contrário, as automações não vão aparecer.

Depois de selecionar a automação, você vai ver os Ativadores, condições e ações (Figura 6). Clique em Salvar para adicionar sua automação (Figura 7).

Tela do app de exemplo para automações sugeridas
Figura 5: sugestões de automação
Exemplo de tela do app de automação.
Figura 6: salvar automação
Tela de exemplo do app de automação criada.
Figura 7: automação criada

Editar uma automação

Para editar o nome e a descrição da automação, na visualização detalhada (Figura 4), clique no ícone Configurações e em Editar nome (Figura 8). Como mostrado na Figura 9, edite o nome e a descrição e volte depois de concluir (Figura 8). Para salvar, clique no ícone Configurações e em Salvar.

Tela do app de exemplo para selecionar o botão "Editar nome".
Figura 8: editar o nome da automação
Tela de exemplo do app para editar o nome e a descrição da automação.
Figura 9: editor de nome e descrição

Excluir uma automação

Para excluir uma automação, acesse a visão geral dela (Figura 7). Deslize para a esquerda na automação que você quer excluir e clique no ícone excluir (Figura 10).

Exemplo de tela do app para excluir uma automação.
Figura 10: excluir uma automação

Editor de automação genérica

Com o editor genérico, é possível selecionar qualquer dispositivo na estrutura para usar em ativações e ações, com traços de suporte como condições, ao criar scripts de automação.

Para adicionar uma automação genérica, toque em Automação genérica na tela "Sugestões de automação" (Figura 5).

Na próxima tela, é possível editar o nome e a descrição da automação.

Adicionar candidato inicial

Para adicionar uma opção de ativação, toque em Adicionar ativação e condição (Figura 11). A tela de candidatos iniciais mostra os iniciadores disponíveis na estrutura (Figura 12). Selecione um dos candidatos iniciais para continuar (Figura 13).

Adicione uma ativação.
Figura 11: tela genérica do Editor
Lista de candidatos iniciantes.
Figura 12: lista de candidatos a inicialização
Selecione um inicializador.
Figura 13: selecione uma inicialização

Selecione Liga ou desliga ou Muda o brilho (Figuras 14 e 15) e ative ou desative ou mude o brilho. Quando terminar a configuração, toque em Concluído para voltar à tela do editor genérico. O modelo inicial selecionado vai aparecer na tela do editor genérico (Figura 16).

Acender ou apagar luzes.
Figura 14: ligar ou desligar a luz
Mudar brilho
Figura 15: mudar o brilho
Lista de iniciadores.
Figura 16: inicializador adicionado

Adicionar candidato de ação

Para adicionar uma ação sugerida, toque em Adicionar ação (Figura 17). A tela Candidatos a ação mostra as opções disponíveis (Figura 18). Selecione uma das opções de ação para continuar (Figura 19).

Adicionar ação
Figura 17: adicionar ação
Lista de candidatos a ações
Figura 18: lista de ações candidatas
Selecione uma ação.
Figura 19: selecionar uma ação
Acender ou apagar luzes
Figura 20: LevelControlTrait não é compatível com ações

Selecione Liga ou desliga e escolha se o dispositivo vai ligar ou desligar. Toque em Concluído para voltar à tela do editor genérico (Figura 21). Toque em Salvar para criar a automação (Figura 22). Sua automação vai aparecer na guia "Automação" (Figura 23).

Acender ou apagar luzes
Figura 21: acender ou apagar a luz
Ativação e ação adicionadas.
Figura 22: ação e inicializador adicionados
Automação genérica criada
Figura 23: automação genérica criada