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.
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
| Evento | Dispara quando… |
|---|---|
| Ao iniciar a cena | a cena aparece pela primeira vez (o alvo é detetado ou chega-se a ela com Ir para a cena). |
| Ao tocar | o utilizador toca no objeto que escolheres (um objeto 3D ou um elemento de Sobreposição no ecrã). |
| Ao colidir | dois objetos escolhidos se tocam – vê Colisões mais abaixo. |
| Ao tocar com a mão / Ao deixar de tocar | uma 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 largar | o objeto interativo que escolheres é agarrado ou largado. |
Ações
| Ação | O que faz |
|---|---|
| Ir para a cena | Muda para outra cena, com uma transição opcional (desvanecer, efeito pop, deslizar, girar) e uma duração. |
| Reproduzir som | Reproduz 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 som | Para um som em reprodução – todas as reproduções em curso do recurso de áudio escolhido param e voltam ao início. |
| Reproduzir vídeo | Começ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ídeo | Para um objeto de vídeo escolhido e volta a pô-lo no início. |
| Reproduzir animação | Reproduz 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ção | Para uma animação em reprodução e deixa-a congelada no ponto em que está. |
| Mostrar objeto / Ocultar objeto | Revela ou oculta um objeto. |
| Desvanecer | Faz 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á. |
| Esperar | Espera um número de segundos antes de a ação seguinte da cadeia ser executada. |
| Definir física / Definir interativo | Liga ou desliga a gravidade, ou a possibilidade de tocar e agarrar, num 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-o. |
| Empurrar objeto | Dá um empurrão a um objeto com Física. |
| Repor objeto | Põe um objeto de volta onde a cena o colocou ao início, parado. |
Nota
Um exemplo prático
Para fazer aparecer um objeto, reproduzir um som, esperar e depois passar à cena seguinte quando alguém toca no objeto:
- Adiciona um nó Ao tocar e escolhe o objeto.
- 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.
| Categoria | Nós |
|---|---|
| Variáveis | Definir variável (coloca um valor numa variável) e Obter variável (lê o seu valor atual). |
| 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 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
Colisões: quando dois objetos se tocam
O evento Ao colidir é disparado quando dois objetos chocam um com o outro.
- Seleciona cada objeto e ativa Colisões no Inspetor – ambos os objetos precisam de ter essa opção ativada.
- Adiciona um nó Ao colidir e escolhe o Objeto A e o Objeto B.
- Liga-o ao que deve acontecer – um som, uma mudança de pontuação, uma troca de cena.
É 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
Dica