Documentação

Interatividade (nós de lógica)

A lógica é a forma como a tua experiência reage. No painel Nós, ligas eventos (o que acontece) a ações (o que fazer) – sem escrever código.

Como funciona

Cada nó é um cartão. Ligas a saída de um nó de evento à entrada de um nó de ação ao arrastar uma ligação entre os respetivos pontos. Quando o evento é disparado, as ações ligadas são executadas – e podes encadear várias ações seguidas.

Liga eventos a ações: aqui, tocar num objeto reproduz uma animação.

Clica com o botão direito na área de trabalho (ou usa a paleta) para adicionar um nó. Os nós são identificados por cores – eventos a âmbar, ações a azul-celeste.

Para trabalhares com vários nós ao mesmo tempo, mantém premida a tecla Shift e arrasta numa zona vazia da área de trabalho para selecionar com uma caixa, ou clica com Shift premida (clicar com Ctrl/Cmd premida também funciona) para juntar nós à seleção. Uma seleção move-se em conjunto quando a arrastas e a tecla Delete elimina-a – o botão direito do rato dá a mesma opção.

Eventos

EventoDispara quando…
Ao iniciar a cenaa cena aparece pela primeira vez (o alvo é detetado ou chega-se a ela com Ir para a cena).
Ao tocaro utilizador toca no objeto que escolheres (um objeto 3D ou um elemento de Sobreposição no ecrã).
Ao colidirdois objetos escolhidos se tocam – vê Colisões mais abaixo.
Ao tocar com a mão / Ao deixar de tocaruma mão ou um dedo começa ou deixa de tocar no objeto interativo que escolheres – vê Interação com a mão e física.
Ao agarrar / Ao largaro objeto interativo que escolheres é agarrado ou largado.

Ações

AçãoO que faz
Ir para a cenaMuda para outra cena, com uma transição opcional (desvanecer, efeito pop, deslizar, girar) e uma duração.
Reproduzir somReproduz um recurso de áudio importado, opcionalmente em repetição, no Volume definido pelo controlo deslizante. A saída Ao iniciar é executada de imediato; Depois do som é executada quando o som chega ao fim (nunca em repetição, e de todo se antes vier Parar som, uma nova reprodução do mesmo áudio ou uma mudança de cena).
Parar somPara um som em reprodução – todas as reproduções em curso do recurso de áudio escolhido param e voltam ao início.
Reproduzir vídeoComeça a reproduzir um objeto de vídeo escolhido com um Volume (0 reproduz sem som) e uma Velocidade, em repetição ou não. Ao iniciar é executada de imediato; Depois do vídeo é executada quando o vídeo chega ao fim (nunca em repetição, e de todo se antes vier Parar vídeo, uma nova reprodução no mesmo objeto ou uma mudança de cena). Um navegador que bloqueia o som até um toque reproduz sem som.
Parar vídeoPara um objeto de vídeo escolhido e volta a pô-lo no início.
Reproduzir animaçãoReproduz um clip de animação num objeto (um clip de fotogramas-chave ou a animação incorporada de um modelo). A saída Ao iniciar é executada de imediato. Depois da animação é executada quando o clip chega ao fim: nunca para um clip que se repete, e de todo se antes vier Parar animação, outro Reproduzir animação no mesmo objeto ou uma mudança de cena.
Parar animaçãoPara uma animação em reprodução e deixa-a congelada no ponto em que está.
Mostrar objeto / Ocultar objetoRevela ou oculta um objeto.
DesvanecerFaz um objeto aparecer ou desaparecer gradualmente no número de segundos que definires. Aparecer mostra o objeto e leva-o até à sua própria opacidade (a Opacidade do Inspetor). Desvanecer torna-o invisível e depois oculta-o, para que deixe de poder ser tocado. O que estiver ligado à saída é executado quando o efeito termina. Um Desvanecer mais recente no mesmo objeto continua a partir de onde ele está.
EsperarEspera um número de segundos antes de a ação seguinte da cadeia ser executada.
Definir física / Definir interativoLiga ou desliga a gravidade, ou a possibilidade de tocar e agarrar, num objeto com Colisões.
Definir se pode ser empurradoPermite que uma mão aberta empurre um objeto com Colisões e Física, ou impede-o.
Empurrar objetoDá um empurrão a um objeto com Física.
Repor objetoPõe um objeto de volta onde a cena o colocou ao início, parado.

Nota

Os sons e os vídeos terminam sempre com a sua cena: quando a experiência passa para outra cena com Ir para a cena, tudo o que ainda estiver a ser reproduzido – incluindo sons em repetição – é interrompido automaticamente.

Um exemplo prático

Para fazer aparecer um objeto, reproduzir um som, esperar e depois passar à cena seguinte quando alguém toca no objeto:

  1. Adiciona um nó Ao tocar e escolhe o objeto.
  2. Liga-o a Mostrar objeto → Reproduzir som → Esperar (2 s) → Ir para a cena.

Variáveis, cálculos e lógica

Mais três categorias de nós permitem criar comportamentos mais elaborados – guardar uma pontuação, fazer uma conta ou tomar uma decisão. A paleta agrupa-as em títulos recolhíveis, que podes fechar quando não os estiveres a usar.

Uma variável é um valor com nome que a tua experiência pode memorizar e alterar enquanto é executada – uma pontuação, um contador ou um estado ligado/desligado. Cria variáveis no painel Variáveis, à esquerda: dá a cada uma um nome, um tipo (Número, Texto ou Verdadeiro / Falso) e um valor inicial. Uma variável pode ser local à cena (volta ao início sempre que a cena começa) ou global (partilhada entre cenas durante toda a sessão).

Estas categorias funcionam com dois tipos de ligação:

  • Fluxo: as ligações (como antes) decidem o que é executado a seguir.
  • Valor: as ligações transportam um número, um texto ou um valor verdadeiro/falso da saída de um nó para a entrada de outro – mostradas a azul abaixo.
As ligações de valor (azuis) levam dados aos nós; aqui, cada toque soma 1 à pontuação.
CategoriaNós
VariáveisDefinir variável (coloca um valor numa variável) e Obter variável (lê o seu valor atual).
OperadoresValor (um valor fixo), Cálculo (somar / subtrair / multiplicar / dividir / resto), Comparar (igual, menor que, maior que… → verdadeiro/falso) e E / Ou / Não.
LógicaSe (executa o ramo Verdadeiro ou Falso), Enquanto (repete enquanto uma condição se mantiver) e Para (conta de um valor inicial até um valor final).

Para mostrar uma variável no ecrã, adiciona um elemento Texto à Sobreposição e ativa a opção Mostrar variável (ao vivo) – o texto passa a mostrar o valor e atualiza-se no instante em que este muda, ideal para uma pontuação ao vivo.

Nota

As alterações às variáveis e as decisões dos nós Se / Enquanto / Para acontecem de imediato à medida que a lógica é executada. Um nó Esperar só atrasa as ações que vêm a seguir – não a definição de uma variável nem a verificação de uma condição. Os ciclos também têm um limite de segurança, para que uma experiência nunca bloqueie.

Colisões: quando dois objetos se tocam

O evento Ao colidir é disparado quando dois objetos chocam um com o outro.

  1. Seleciona cada objeto e ativa Colisões no Inspetor – ambos os objetos precisam de ter essa opção ativada.
  2. Adiciona um nó Ao colidir e escolhe o Objeto A e o Objeto B.
  3. Liga-o ao que deve acontecer – um som, uma mudança de pontuação, uma troca de cena.
O evento Ao colidir é acionado uma vez quando as caixas de dois objetos com colisões ativadas se tocam.

É disparado uma vez quando as caixas delimitadoras dos objetos se sobrepõem pela primeira vez, e só volta a disparar depois de os objetos estarem separados durante pelo menos um quarto de segundo e se tocarem de novo. Por isso, mantê-los juntos, ou um objeto que ressalta ou treme por um instante contra o outro, não o dispara outra vez. A ordem de A e B não importa. As colisões servem para objetos 3D da cena, não para elementos de Sobreposição no ecrã.

A caixa de cada objeto segue os seus Limites depois de os alterares (para qualquer tipo exceto Malha) e, caso contrário, o objeto tal como é desenhado. Um Plano com Chão ativado conta sempre como sólido, por isso um nó Ao colidir também o pode indicar.

Nota

Se eliminares um objeto ou uma cena para os quais um nó aponta, o AR Works limpa essa referência e mostra um sinal de aviso no nó, para ficar claro que é preciso voltar a apontá-lo, em vez de o nó não fazer nada em silêncio.

Dica

Usa o botão Pré-visualizar para testar a tua lógica de imediato – toca nos objetos diretamente no navegador.