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.

Reliez les événements aux actions : ici, toucher un objet lance une animation.

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énementDéclenché quand…
Au début de la scènela 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 toucheron touche l’objet que vous avez choisi (un objet 3D ou un élément du Calque écran).
À la collisiondeux objets choisis se touchent – voir Collisions plus bas.
Au contact de la main / À la fin du contactune 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âcherl’objet Interactif que vous avez choisi est saisi, ou lâché.

Actions

ActionCe qu’elle fait
Aller à la scènePasse à une autre scène, avec une transition facultative (fondu, zoom rebond, glissement, rotation) et une durée.
Lire le sonLit 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 sonArrête un son qui joue : chaque lecture de la ressource audio choisie s’arrête et revient au début.
Lire la vidéoLance 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éoArrête un objet vidéo choisi et le remet au début.
Lire l’animationLit 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’animationArrête une animation en cours et la fige sur place.
Afficher l’objet / Masquer l’objetAffiche ou masque un objet.
FonduFait 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.
AttendreAttend 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’objetDonne une poussée à un objet doté de Physique.
Réinitialiser l’objetRemet un objet à l’endroit où la scène l’a placé au départ, immobile.

Remarque

Aucun son ni aucune vidéo ne continue après la fin de sa scène : quand l’expérience passe à une autre scène avec Aller à la scène, tout ce qui est encore en lecture – y compris les sons en boucle – s’arrête automatiquement.

Un exemple détaillé

Pour afficher un objet, lire un son, attendre, puis passer à la scène suivante au toucher :

  1. Ajoutez un nœud Au toucher et choisissez l’objet.
  2. 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.
Les fils de valeur (bleus) transmettent des données aux nœuds ; ici, chaque toucher ajoute 1 au score.
CatégorieNœuds
VariablesDéfinir la variable (placer une valeur dans une variable) et Obtenir la variable (lire sa valeur actuelle).
OpérateursValeur (une valeur fixe), Calcul (additionner / soustraire / multiplier / diviser / reste), Comparer (égal à, inférieur à, supérieur à… → vrai/faux) et Et / Ou / Non.
LogiqueSi (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

Les changements de variables et les décisions des nœuds Si / Tant que / Pour se font immédiatement pendant l’exécution de la logique. Un nœud Attendre ne retarde que les actions qui le suivent – pas la modification d’une variable ni la vérification d’une condition. Les boucles sont en outre plafonnées par sécurité, afin qu’une expérience ne puisse jamais se figer.

Collisions : quand deux objets se touchent

L’événement À la collision se déclenche quand deux objets entrent en contact.

  1. Sélectionnez chaque objet et activez Collisions dans l’Inspecteur : l’option doit être activée sur les deux objets.
  2. Ajoutez un nœud À la collision et choisissez les objets dans les champs Objet A et Objet B.
  3. Reliez-le à ce qui doit se produire : un son, un changement de score, un changement de scène.
Le nœud À la collision se déclenche une seule fois quand les boîtes de deux objets à collisions activées se touchent.

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

Si vous supprimez l’objet ou la scène qu’un nœud désigne, AR Works efface cette référence et affiche un badge d’avertissement sur le nœud : vous voyez tout de suite qu’il faut le reconfigurer, au lieu qu’il ne fasse rien sans vous prévenir.

Astuce

Utilisez Aperçu pour tester votre logique sur-le-champ : touchez les objets directement dans le navigateur.