Crie uma domótica avançada com o editor de scripts

Com a app Google Home, pode automatizar a sua casa com rotinas. Para criar rotinas dos residentes avançadas, o editor de scripts permite-lhe programar automatizações com script com iniciadores, condições, ações e lógica avançada adicionais.

O editor de scripts está atualmente disponível em Pré-visualização pública. Pode aceder ao editor de scripts com o Google Home para a Web ou na app Google Home para dispositivos móveis depois de aderir à Pré-visualização pública.

Saiba como escrever automatizações com script:

• Escreva automatizações com script com o editor de scripts
• Lista completa de iniciadores, condições e ações compatíveis
• Lista de dispositivos compatíveis
• Visite o nosso codelab para ver um exemplo orientado de como criar o seu primeiro script.
• Pratique a escrita de uma automatização com script e scripts de exemplo adicionais

Visite o codelab

Começar

O editor de scripts permite-lhe escrever e editar as suas próprias rotinas dos residentes com o Google Home para a Web ou na app Google Home.

Para criar automatizações com script, tem de:

• Compreender as noções básicas do YAML, uma linguagem de script legível que lhe permite introduzir instruções linha a linha para criar domótica.
• Compreender como funcionam as rotinas, incluindo terminologia como iniciadores e ações.
• Saber como usar o editor de scripts para escrever automatizações com script.

Para informações mais detalhadas sobre como escrever um script, siga o artigo Escreva automatizações com script com o editor de scripts.

Nota: num iPhone ou iPad, pode ver, editar, desativar e executar automatizações na app Google Home, mas, atualmente, não pode criar novas automatizações com script. Se tiver um iPhone ou um iPad, recomendamos que use o Google Home para a Web para criar novas automatizações.

Noções básicas do editor de scripts

O editor de scripts usa o YAML, uma linguagem de script que lhe permite introduzir instruções linha a linha para criar domótica. Saiba mais no artigo Escreva automatizações com script com o editor de scripts.

Guia de referência rápida do YAML

Conceitos do YAML	Exemplo
Pares de chave-valor O YAML é escrito como uma coleção de pares de chave-valor separados por : e um espaço. Cada par de chave-valor começa numa nova linha. Uma chave é uma palavra-chave literal. O valor associado a uma chave pode ser tão simples como uma string, um número ou uma data, ou tão complexo como outra coleção de pares de chave-valor. Neste exemplo, a chave = name e o valor = TV on lights off.	name: TV on lights off
Avanço e pares de chave-valor aninhados Pode "aninhar" vários pares de chave-valor numa única chave principal. O YAML usa o avanço (2 espaços) para indicar a estrutura e a hierarquia, e para definir elementos aninhados. Cada nível de aninhamento tem um avanço com o mesmo número de espaços. No exemplo, a chave principal = metadata. O valor para metadados é dois pares de chave-valor aninhados: Par 1: chave = name; valor = TV on lights off Par 2: chave = description; valor = Turn off lights when TV turns on Cada par tem um avanço de 2 espaços para mostrar que é um elemento secundário da chave metadata.	metadata: name: TV on lights off description: Turn off lights when TV turns on
Vários valores Para incluir vários valores com uma única chave, crie uma lista. Use um hífen antes de cada item de lista. No exemplo, a chave = weekday e o valor é uma lista que inclui Monday e Thursday.	weekday: - MONDAY - THURSDAY
Comentários As linhas que começam por # são comentários e são ignoradas pelo motor de automatização.	# This is a comment. It will be ignored.

Iniciadores, condições e ações compatíveis

Vai definir os comportamentos de automatização através de chaves denominadas iniciadores, condições e ações:

• Os iniciadores indicam à automatização quando deve começar. Os iniciadores podem incluir horas ou estados do dispositivo específicos. Uma automatização pode incluir mais do que um iniciador.
• As condições são restrições relativas ao momento em que a automatização deve ser executada. As condições são verificadas sempre que uma automatização é iniciada. Por exemplo, pode especificar que a sua automatização só é executada se estiver ausente ou se for após o pôr do sol.
• As ações são o que a automatização vai fazer, como ajustar o volume do altifalante ou ligar ou desligar uma luz.

Para ver uma lista completa de iniciadores, condições e ações, visite o Centro para programadores do Google Home. Cada um destes componentes tem o seu próprio conjunto de instruções e formatação. Clique numa entrada na tabela de iniciadores, condições e ações compatíveis para encontrar instruções específicas, como formatar e um código de exemplo. Também pode verificar quais dos seus dispositivos são compatíveis e que ações e comandos podem usar.

Crie, edite e elimine automatizações com script

Use o editor de scripts no Google Home para a Web ou na app Google Home para escrever e editar automatizações com script personalizadas.

Importante: todos os membros do agregado familiar podem ver quando estas automatizações são iniciadas. As automatizações devem ser usadas apenas como comodidade e não em situações nas quais a segurança é fundamental. Não crie automatizações que possam resultar em ferimentos ou danos caso não sejam iniciadas ou paradas. As automatizações podem depender de a ligação à Internet e Wi-Fi funcionarem, bem como da disponibilidade do serviço da Google e de terceiros que fabricam os dispositivos incluídos nas automatizações. As automatizações podem nem sempre funcionar e a Google não é responsável por quaisquer danos ou perdas incorridos devido a automatizações falhadas.

Crie uma automatização com script

Com a app Google Home

1. Abra a app Google Home .
2. Toque em Automatizações .
3. Toque em Adicionar Residentes Mais opções Editor de scripts.
4. Crie o rascunho da nova automatização com script. Consulte o artigo Escreva automatizações com script com o editor de scripts para ter ajuda na estruturação do seu script.
5. Toque em Validar para verificar se o script é executado. Não pode ativar uma automatização com erros.
6. Toque em Guardar para adicionar a automatização à sua casa ou guardar o trabalho em curso. Se o seu script for válido quando o guardar, a automatização é ativada automaticamente. Se ainda não quiser que seja executada, desative a opção Ativar.

Com o Google Home para a Web

1. Abra home.google.com/automations e inicie sessão na sua conta.
2. Clique em Adicionar novo.
3. Crie o rascunho da nova automatização com script. Consulte o artigo Escreva automatizações com script com o editor de scripts para ter ajuda na estruturação do seu script.
4. Clique em Validar para confirmar se o script pode ser executado. Não pode ativar uma automatização com erros.
5. Clique em Guardar para adicionar a automatização à sua casa ou guardar o trabalho em curso. Se o seu script for válido quando o guardar, a automatização é ativada automaticamente. Se ainda não quiser que seja executada, desative a opção Ativar.

Edite uma automatização com script

Pode ver e editar a maioria das automatizações que criou com o editor de scripts. Não é possível editar automatizações sem script e automatizações que estejam a ser executadas ativamente no editor de scripts. Depois de parar uma automatização, pode editá-la.

Com a app Google Home

1. Abra a app Google Home .
2. Toque em Automatizações  o nome da automatização com script Editar.
3. Edite a automatização com script.
4. Toque em Validar para confirmar se o script pode ser executado. Não pode ativar uma automatização com erros.
5. Toque em Guardar. Se o seu script for válido quando o guardar, a automatização é ativada automaticamente. Se ainda não quiser que seja executada, desative a opção Ativar.

Para um acesso rápido e fácil, afixe os seus dispositivos, divisões, automatizações e ações mais usados aos Favoritos na app Google Home. Saiba como criar e personalizar os Favoritos.

Com o Google Home para a Web

1. Abra home.google.com/automations e inicie sessão na sua conta.
2. Selecione a automatização com script.
3. Edite o script.
4. Clique em Validar para confirmar se o script pode ser executado. Não pode ativar uma automatização com erros.
5. Clique em Guardar para adicionar a automatização à sua casa ou guardar o trabalho em curso. Se o seu script for válido quando o guardar, a automatização é ativada automaticamente. Se ainda não quiser que seja executada, desative a opção Ativar.

Elimine uma automatização com script

Importante: a eliminação de uma rotina ou automatização é permanente. Para parar temporariamente uma rotina ou uma automatização, pause-a.

Com a app Google Home

1. Abra a app Google Home .
2. Toque em Automatizações .
3. Selecione a rotina que quer eliminar.
4. Toque em Eliminar Eliminar rotina.

Com o Google Home para a Web

1. Abra home.google.com/automations e inicie sessão na sua conta.
2. Clique na automatização com script .
3. Clique em Eliminar Eliminar.

Ajuda para automatizações com script

• Encontre ajuda para scripts e saiba em que as outras pessoas estão a trabalhar na Comunidade de domótica do Google Home.
• Para que as automatizações funcionem, os scripts têm de usar código válido. Se existir um erro, é apresentada uma mensagem. Saiba mais acerca dos erros e avisos de validação.
• Para validar o código, clique ou toque em Validar no editor de scripts. Seguem-se alguns erros comuns a ter em atenção:
  • Certifique-se de que usa o nome do dispositivo correto no formato Nome do dispositivo – Nome da divisão. Se não tiver a certeza, verifique o nome do dispositivo na app Google Home.
  • Certifique-se de que o dispositivo é compatível com a função que quer que execute. Também pode usar o preenchimento automático para encontrar as opções disponíveis.
  • Certifique-se de que inclui uma ação. São necessárias ações para que uma automatização seja executada.
• Se o script for guardado, mas a automatização não se comportar conforme o esperado ou deixar de funcionar, confirme manualmente se cada componente do script funciona. Por exemplo, se escreveu um script para ligar a luz e alterar o brilho ao pôr do sol, experimente concluir estas tarefas com um comando do Assistente para confirmar que cada função individual funciona. Também pode verificar se:
  • O dispositivo está adicionado ou associado na app Google Home.
  • O dispositivo está ligado e online.
  • O nome, os iniciadores, as condições e as ações do dispositivo estão escritos corretamente.  Nota: os fabricantes podem alterar as caraterísticas do dispositivo quando fazem atualizações, o que pode fazer com que os scripts deixem de funcionar. Pode usar o preenchimento automático para ajudar a atualizar os scripts afetados.
  • O script tem avanço e formatação adequados.
• Com o Google Home para a Web, pode aceder aos registos de automatizações abaixo do script para ver o histórico da automatização e identificar potenciais problemas. Learn more about the types of messages you see in the Automation logs.
• Try using the script editor’s experimental generative AI feature to describe the automation you want and it will draft a script for you to review and edit.
• Saiba mais sobre as noções básicas das rotinas e como resolver problemas relacionados com as mesmas.
• Consulte o artigo Pratique a escrita de um primeiro script.