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 dele. 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
  • Sensor de presença
  • Luz de ativação/desativação
  • 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. Você também pode 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 para iOS.
Figura 1: visualização da guia "Dispositivos"
Controles de dispositivo 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 do app de exemplo da 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, você pode 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: selecionar 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 ações sugeridas para continuar (Figura 19).

Adicionar ação
Figura 17: adicionar ação
Lista de candidatos a ações
Figura 18: lista de ações sugeridas
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
Adicionamos uma ativação e uma ação.
Figura 22: acionador e ação adicionados
Automação genérica criada
Figura 23: automação genérica criada