Documentation
Interactivité (nœuds de logique)
La logique, c’est ce qui fait réagir votre expérience. Dans le panneau Nœuds, vous reliez des événements (ce qui se passe) à des actions (ce qu’il faut faire) – sans écrire une ligne de code.
Comment ça marche
Chaque nœud est une carte. Pour relier la sortie d’un nœud d’événement à l’entrée d’un nœud d’action, faites glisser un fil entre leurs points. Quand l’événement se déclenche, les actions reliées s’exécutent – et vous pouvez en enchaîner plusieurs à la suite.
Faites un clic droit sur le canevas (ou utilisez la palette) pour ajouter un nœud. Les nœuds sont repérés par une couleur : ambre pour les événements, bleu ciel pour les actions.
Pour travailler sur plusieurs nœuds à la fois, maintenez Maj enfoncée et faites glisser sur une zone vide du canevas pour tracer un cadre de sélection, ou cliquez en maintenant Maj (Ctrl/Cmd+clic fonctionne aussi) pour ajouter des nœuds à la sélection. Une sélection se déplace d’un bloc quand vous la faites glisser, et la touche Suppr l’efface – un clic droit propose la même option.
Événements
| Événement | Déclenché quand… |
|---|---|
| Au début de la scène | la scène apparaît pour la première fois (la cible est détectée, ou l’on y arrive avec Aller à la scène). |
| Au toucher | on touche l’objet que vous avez choisi (un objet 3D ou un élément du Calque écran). |
| À la collision | deux objets choisis se touchent – voir Collisions plus bas. |
| Au contact de la main / À la fin du contact | une main ou un doigt commence ou cesse de toucher l’objet Interactif que vous avez choisi – voir Interaction par la main et physique. |
| À la saisie / Au lâcher | l’objet Interactif que vous avez choisi est saisi, ou lâché. |
Actions
| Action | Ce qu’elle fait |
|---|---|
| Aller à la scène | Passe à une autre scène, avec une transition facultative (fondu, zoom rebond, glissement, rotation) et une durée. |
| Lire le son | Lit une ressource audio importée, en boucle si vous le souhaitez, au Volume réglé par son curseur. Sa sortie Au début s’exécute tout de suite ; Après le son s’exécute une fois le son arrivé à sa fin (jamais en boucle, et pas du tout si Arrêter le son, une autre lecture du même son ou un changement de scène arrive avant). |
| Arrêter le son | Arrête un son qui joue : chaque lecture de la ressource audio choisie s’arrête et revient au début. |
| Lire la vidéo | Lance la lecture d’un objet vidéo choisi à un Volume (0 la lit sans le son) et une Vitesse, en boucle ou non. Au début s’exécute tout de suite ; Après la vidéo s’exécute une fois la vidéo arrivée à sa fin (jamais en boucle, et pas du tout si Arrêter la vidéo, une autre lecture de vidéo sur le même objet ou un changement de scène arrive avant). Un navigateur qui bloque le son jusqu’à un appui la lit sans le son. |
| Arrêter la vidéo | Arrête un objet vidéo choisi et le remet au début. |
| Lire l’animation | Lit un clip d’animation sur un objet (un clip à images clés ou l’animation intégrée d’un modèle). Sa sortie Au début s’exécute tout de suite. Après l’animation s’exécute une fois le clip arrivé à sa fin : jamais pour un clip qui boucle, et pas du tout si Arrêter l’animation, une autre Lire l’animation sur le même objet ou un changement de scène arrive avant. |
| Arrêter l’animation | Arrête une animation en cours et la fige sur place. |
| Afficher l’objet / Masquer l’objet | Affiche ou masque un objet. |
| Fondu | Fait apparaître ou disparaître un objet en fondu sur le nombre de secondes choisi. Fondu entrant l’affiche et l’amène à sa propre opacité (l’Opacité de l’Inspecteur). Fondu sortant le rend invisible, puis le masque pour qu’on ne puisse plus le toucher. Ce qui est relié à sa sortie s’exécute une fois le fondu terminé. Un fondu plus récent sur le même objet reprend là où il en est. |
| Attendre | Attend un certain nombre de secondes avant d’exécuter l’action suivante de la chaîne. |
| Définir la physique / Définir l’interactivité | Active ou désactive la gravité, ou le toucher et la saisie, pour un objet doté de Collisions. |
| Définir s’il peut être poussé | Permet à une main ouverte de pousser un objet doté de Collisions et de Physique, ou l’en empêche. |
| Pousser l’objet | Donne une poussée à un objet doté de Physique. |
| Réinitialiser l’objet | Remet un objet à l’endroit où la scène l’a placé au départ, immobile. |
Remarque
Un exemple détaillé
Pour afficher un objet, lire un son, attendre, puis passer à la scène suivante au toucher :
- Ajoutez un nœud Au toucher et choisissez l’objet.
- Reliez-le à Afficher l’objet → Lire le son → Attendre (2 s) → Aller à la scène.
Variables, calculs et logique
Trois autres catégories de nœuds permettent de créer des comportements plus élaborés : tenir un score, faire un calcul ou prendre une décision. La palette les regroupe sous des titres repliables que vous pouvez fermer quand vous ne vous en servez pas.
Une variable est une valeur nommée que votre expérience peut mémoriser et modifier pendant son exécution : un score, un compteur ou un état activé/désactivé. Créez vos variables dans le panneau Variables à gauche : donnez à chacune un nom, un type (Nombre, Texte ou Vrai / Faux) et une valeur de départ. Une variable peut être locale à la scène (réinitialisée à chaque début de la scène) ou globale (partagée entre les scènes pendant toute la session).
Ces catégories utilisent deux types de fils :
- Les fils Flux (comme avant) décident de ce qui s’exécute ensuite.
- Les fils Valeur transportent un nombre, un texte ou une valeur vrai/faux de la sortie d’un nœud vers l’entrée d’un autre – ils sont affichés en bleu ci-dessous.
| Catégorie | Nœuds |
|---|---|
| Variables | Définir la variable (placer une valeur dans une variable) et Obtenir la variable (lire sa valeur actuelle). |
| Opérateurs | Valeur (une valeur fixe), Calcul (additionner / soustraire / multiplier / diviser / reste), Comparer (égal à, inférieur à, supérieur à… → vrai/faux) et Et / Ou / Non. |
| Logique | Si (exécuter la branche Vrai ou Faux), Tant que (répéter tant qu’une condition est vraie) et Pour (compter d’une valeur de départ à une valeur de fin). |
Pour afficher une variable à l’écran, ajoutez un élément Texte dans le Calque écran et choisissez la variable dans son option Afficher une variable (en direct) : le texte affiche alors la valeur et se met à jour à l’instant où elle change, idéal pour un score en direct.
Remarque
Collisions : quand deux objets se touchent
L’événement À la collision se déclenche quand deux objets entrent en contact.
- Sélectionnez chaque objet et activez Collisions dans l’Inspecteur : l’option doit être activée sur les deux objets.
- Ajoutez un nœud À la collision et choisissez les objets dans les champs Objet A et Objet B.
- Reliez-le à ce qui doit se produire : un son, un changement de score, un changement de scène.
Il se déclenche une seule fois quand les boîtes englobantes des objets se chevauchent pour la première fois, puis seulement après qu’ils sont restés séparés au moins un quart de seconde et se touchent à nouveau : les maintenir l’un contre l’autre, ou un objet qui rebondit ou tremble un instant contre l’autre, ne le redéclenche donc pas. L’ordre de A et B n’a pas d’importance. Les collisions concernent les objets 3D de la scène, pas les éléments du Calque écran.
La boîte englobante de chaque objet suit ses Limites dès que vous les avez modifiées (vers tout type sauf Maillage), et sinon l’objet tel qu’il est dessiné. Un Plan dont l’option Sol est activée compte toujours comme solide : un nœud À la collision peut donc aussi le désigner.
Remarque
Astuce