Documentação

Interatividade (nós de lógica)

A lógica é o que faz sua experiência reagir. No painel Nós, você liga eventos (o que acontece) a ações (o que fazer) – sem precisar programar.

Como funciona

Cada nó é um cartão. Você liga a saída de um nó de evento à entrada de um nó de ação arrastando um fio entre os pontos dos dois. Quando o evento dispara, as ações ligadas são executadas – e você pode encadear várias ações em sequência.

Ligue eventos a ações: aqui, tocar em um objeto reproduz uma animação.

Clique com o botão direito do mouse na área de edição (ou use a paleta) para adicionar um nó. Os nós têm cores diferentes: eventos em âmbar e ações em azul-celeste.

Para trabalhar com vários nós ao mesmo tempo, segure Shift e arraste em uma parte vazia da área de edição para selecionar com uma caixa, ou clique segurando Shift (Ctrl/Cmd+clique também funciona) para adicionar nós à seleção. Uma seleção se move em conjunto quando é arrastada, e a tecla Delete exclui tudo; o menu do botão direito do mouse tem a mesma opção.

Eventos

EventoDispara quando…
Ao iniciar a cenaa cena aparece pela primeira vez (o alvo é encontrado ou você chega a ela por meio de Ir para a cena).
Ao tocaro usuário toca no objeto que você escolheu (um objeto 3D ou um elemento da Sobreposição, fixo na tela).
Ao colidirdois objetos escolhidos se tocam – veja Colisões mais abaixo.
Ao tocar com a mão / Ao parar de tocaruma mão ou um dedo começa ou para de tocar no objeto interativo que você escolheu – veja Interação com a mão e física.
Ao pegar / Ao soltaro objeto interativo que você escolheu é pego ou solto.

Ações

AçãoO que faz
Ir para a cenaMuda para outra cena, com uma transição opcional (esmaecer, crescer, subir ou girar) e uma duração.
Reproduzir somReproduz um arquivo de áudio importado, em repetição se você quiser, no Volume definido pelo controle deslizante. A saída Ao iniciar é executada na hora; Depois do som é executada quando o som chega ao fim (nunca em repetição, e nem chega a rodar se antes vier Parar som, uma nova reprodução do mesmo áudio ou uma troca de cena).
Parar somInterrompe um som em reprodução: todas as reproduções do arquivo de áudio escolhido param e voltam ao início.
Reproduzir vídeoInicia a reprodução de 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 na hora; Depois do vídeo é executada quando o vídeo chega ao fim (nunca em repetição, e nem chega a rodar se antes vier Parar vídeo, uma nova reprodução no mesmo objeto ou uma troca de cena). Um navegador que bloqueia o som até um toque reproduz sem som.
Parar vídeoInterrompe um objeto de vídeo escolhido e o leva de volta ao início.
Reproduzir animaçãoReproduz um clipe de animação em um objeto (um clipe de quadros-chave ou a animação embutida de um modelo). A saída Ao iniciar é executada na hora. Depois da animação é executada quando o clipe chega ao fim: nunca para um clipe que se repete, e nem chega a rodar se antes vier Parar animação, outro Reproduzir animação no mesmo objeto ou uma troca de cena.
Parar animaçãoInterrompe uma animação em reprodução, congelando-a onde está.
Mostrar objeto / Ocultar objetoMostra ou oculta um objeto.
EsmaecerFaz um objeto aparecer ou sumir aos poucos no número de segundos que você definir. Aparecer mostra o objeto e o leva até a opacidade dele (a Opacidade do Inspetor). Esmaecer o deixa invisível e depois o oculta, para que não possa mais ser tocado. O que estiver ligado à saída é executado quando o efeito termina. Um Esmaecer mais novo no mesmo objeto continua de onde ele está.
EsperarEspera o número de segundos que você definir antes de executar a próxima ação da sequência.
Definir física / Definir interativoLiga ou desliga a gravidade, ou a possibilidade de tocar e pegar, em um 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 isso.
Empurrar objetoDá um empurrão em um objeto com Física.
Redefinir objetoColoca um objeto de volta onde a cena o colocou no início, parado.

Nota

Sons e vídeos nunca continuam depois que a cena termina: quando a experiência passa para outra cena com Ir para a cena, tudo o que ainda estiver tocando – inclusive sons em repetição – é interrompido automaticamente.

Um exemplo prático

Para fazer um objeto aparecer, reproduzir um som, esperar e depois ir para a próxima cena quando ele for tocado:

  1. Adicione um nó Ao tocar e escolha o objeto.
  2. Ligue-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: manter uma pontuação, fazer uma conta ou tomar uma decisão. A paleta agrupa essas categorias sob títulos recolhíveis, que você pode fechar quando não estiver usando.

Uma variável é um valor com nome que sua experiência pode memorizar e alterar enquanto está em execução: uma pontuação, um contador ou um estado de ligado/desligado. Crie 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 da cena (é redefinida sempre que a cena começa) ou global (compartilhada entre as cenas durante toda a sessão).

Essas categorias trabalham com dois tipos de fio:

  • Os fios de Fluxo (como antes) decidem o que é executado em seguida.
  • Os fios de Valor levam um número, um texto ou um valor verdadeiro/falso da saída de um nó para a entrada de outro – aparecem em azul abaixo.
Os fios de valor (azuis) levam dados aos nós; aqui, cada toque soma 1 à pontuação.
CategoriaNós
VariáveisDefinir variável (coloca um valor em uma variável) e Obter variável (lê o valor atual dela).
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 for verdadeira) e Para (conta de um valor inicial até um valor final).

Para mostrar uma variável na tela, adicione um elemento Texto na Sobreposição e ative a opção Mostrar variável (ao vivo). O texto passa a exibir o valor e se atualiza no instante em que ele muda, perfeito para uma pontuação ao vivo.

Nota

As mudanças nas variáveis e as decisões de Se / Enquanto / Para acontecem na hora, conforme a lógica é executada. Um nó Esperar só segura as ações que vêm depois dele, e não a definição de uma variável nem a verificação de uma condição. As repetições também têm um limite de segurança, para que uma experiência nunca trave.

Colisões: quando dois objetos se tocam

O evento Ao colidir dispara quando dois objetos esbarram um no outro.

  1. Selecione cada objeto e ative Colisões no Inspetor – os dois objetos precisam estar com a opção ativada.
  2. Adicione um nó Ao colidir e escolha Objeto A e Objeto B.
  3. Ligue-o ao que deve acontecer: um som, uma mudança na pontuação, uma troca de cena.
O evento Ao colidir dispara uma vez quando as caixas de dois objetos com colisão se tocam.

Ele dispara uma vez quando as caixas dos objetos se sobrepõem pela primeira vez e só dispara de novo depois que eles ficam separados por pelo menos um quarto de segundo e se tocam outra vez. Então mantê-los juntos, ou um objeto que quica ou balança por um instante contra o outro, não o aciona de novo. A ordem de A e B não importa. As colisões valem para objetos 3D da cena, não para elementos da Sobreposição na tela.

A caixa de cada objeto segue os Limites dele depois que você os altera (para qualquer tipo, menos Malha) e, se não, o objeto como ele é desenhado. Um Plano com Chão ativado sempre conta como sólido, então um nó Ao colidir também pode indicá-lo.

Nota

Se você excluir um objeto ou uma cena para os quais um nó aponta, o AR Works remove essa referência e mostra um selo de aviso no nó. Assim fica claro que o nó precisa ser apontado de novo, em vez de simplesmente não fazer nada.

Dica

Use Visualizar para testar sua lógica na hora: toque nos objetos direto no navegador.