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.
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
| Evento | Dispara quando… |
|---|---|
| Ao iniciar a cena | a cena aparece pela primeira vez (o alvo é encontrado ou você chega a ela por meio de Ir para a cena). |
| Ao tocar | o usuário toca no objeto que você escolheu (um objeto 3D ou um elemento da Sobreposição, fixo na tela). |
| Ao colidir | dois objetos escolhidos se tocam – veja Colisões mais abaixo. |
| Ao tocar com a mão / Ao parar de tocar | uma 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 soltar | o objeto interativo que você escolheu é pego ou solto. |
Ações
| Ação | O que faz |
|---|---|
| Ir para a cena | Muda para outra cena, com uma transição opcional (esmaecer, crescer, subir ou girar) e uma duração. |
| Reproduzir som | Reproduz 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 som | Interrompe um som em reprodução: todas as reproduções do arquivo de áudio escolhido param e voltam ao início. |
| Reproduzir vídeo | Inicia 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ídeo | Interrompe um objeto de vídeo escolhido e o leva de volta ao início. |
| Reproduzir animação | Reproduz 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ção | Interrompe uma animação em reprodução, congelando-a onde está. |
| Mostrar objeto / Ocultar objeto | Mostra ou oculta um objeto. |
| Esmaecer | Faz 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á. |
| Esperar | Espera o número de segundos que você definir antes de executar a próxima ação da sequência. |
| Definir física / Definir interativo | Liga ou desliga a gravidade, ou a possibilidade de tocar e pegar, em um objeto com Colisões. |
| Definir se pode ser empurrado | Permite que uma mão aberta empurre um objeto com Colisões e Física, ou impede isso. |
| Empurrar objeto | Dá um empurrão em um objeto com Física. |
| Redefinir objeto | Coloca um objeto de volta onde a cena o colocou no início, parado. |
Nota
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:
- Adicione um nó Ao tocar e escolha o objeto.
- 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.
| Categoria | Nós |
|---|---|
| Variáveis | Definir variável (coloca um valor em uma variável) e Obter variável (lê o valor atual dela). |
| Operadores | Valor (um valor fixo), Cálculo (somar / subtrair / multiplicar / dividir / resto), Comparar (igual, menor que, maior que… → verdadeiro/falso) e E / Ou / Não. |
| Lógica | Se (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
Colisões: quando dois objetos se tocam
O evento Ao colidir dispara quando dois objetos esbarram um no outro.
- Selecione cada objeto e ative Colisões no Inspetor – os dois objetos precisam estar com a opção ativada.
- Adicione um nó Ao colidir e escolha Objeto A e Objeto B.
- Ligue-o ao que deve acontecer: um som, uma mudança na pontuação, uma troca de cena.
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
Dica