EarMotion — Guide complet

Cartographies sonores interactives : placez des sources sonores sur une carte, déplacez un auditeur et écoutez l'espace en temps réel — au casque (binaural), sur haut-parleurs (multicanal), ou dehors au GPS avec les cartes « Monde Réel ».

1. Démarrage

L'accueil

À l'ouverture, EarMotion affiche la liste des cartes. Sans compte, vous pouvez déjà écouter les cartes en libre accès : touchez ▶ Play sur l'une d'elles. Avec un compte (bouton 👤 Compte), vous créez et enregistrez vos propres cartes.

Play et Édition

Dans une carte ouverte, la barre du haut propose deux modes :

Autres boutons de la barre du haut : ⬡ 3D (bascule 2D / 3D), 🔊 ▶ (démarrer / mettre en pause le moteur audio) avec le curseur de volume général, Enregistrer (sauvegarde de la carte sur le serveur), ? (aide) et le Setup (roue dentée) qui ouvre la fenêtre de configuration.

Le son ne peut démarrer qu'après un premier geste (règle des navigateurs) : cliquez , ou touchez n'importe quelle touche / l'écran — l'audio s'arme automatiquement.

La colonne de menus, et les modules

En mode Édition, la colonne de gauche est une suite d'accordéons : la Librairie et le Gestionnaire de sources (la matière et les objets posés), puis Réglages carte, Visualisation, Apparence (la carte elle-même), Sortie Audio et Visuel (par où ça sort), Interactions et Séquenceur (comment on y joue), Partage et Analyses (la diffusion) — et, tout en bas, la Bibliothèque de modules.

Toutes ces entrées ne sont pas toujours là. Beaucoup d'entre elles appartiennent à un module et n'apparaissent que s'il est activé pour cette carte : Timing & anneau, le sous-menu Caméra d'Interactions, Partage, Analyses, Séquenceur de trajectoire, Adaptive Wave, Visuel… D'autres suivent le contenu : Sources streaming n'apparaît que si la carte porte au moins une radio, Monde Réel que si la carte est géoréférencée.

Une carte neuve démarre sans aucun module actif — c'est voulu : on part de la base et on ajoute ce dont on a besoin. Le point d'entrée de tout est donc la Bibliothèque de modules (dernière entrée de la colonne) › Gérer les modules…, qui est le seul endroit où l'on active ou désactive un module. Retenez la règle : « il me manque un menu » veut dire « son module n'est pas activé ». La Bibliothèque de modules, elle, n'est jamais masquée : c'est le chemin de retour.

Le gestionnaire liste chaque module avec son groupe, son état (livré, partiel, à venir), son coût de téléchargement et les permissions qu'il demande. Un module peut en exiger un autre (il reste inerte tant que son socle est éteint) ; éteindre un module ne supprime jamais ce que la carte contient déjà — il retire l'outil, pas le contenu.

Le déroulé type

  1. Créer une carte, ouvrir l'éditeur (mode Édition).
  2. Ouvrir la Librairie, importer des sons, les glisser sur la carte → des sources sont créées.
  3. Régler chaque source dans l'inspecteur (zone, volume, fondu, courbe…).
  4. Passer en Play, démarrer l'audio et déplacer l'auditeur pour écouter.
  5. Au besoin, activer les modules voulus (Bibliothèque de modulesGérer les modules…) : Partage, Analyses, Monde Réel, Visuel…
  6. Enregistrer, puis partager (lien, QR, mot de passe, collaborateurs).

2. Cartes & comptes

Comptes et rôles

Adresse publique (vitrine)

Dans Setup › Mon compte, choisissez votre adresse publique (champ ?u=, jamais votre e-mail). Les cartes que vous marquez publiques (cadenas 🌐 sur leur fiche) deviennent accessibles à tous sur cette adresse.

Fiche d'une carte (accueil)

Chaque carte de la liste propose : ▶ Play, et si vous en êtes propriétaire Éditer, 👥 (collaborateurs), 🔑 (partage libre ou par mot de passe), 🌐/🔒 (publique / privée) et Supprimer. Voir § 13 Partage.

Sauvegarde, export, historique

Carte locale (cet appareil)

Panneau gauche › Réglages carte › case Carte locale (cet appareil) : la carte vit dans ce navigateur, sur cet appareil. Elle n'apparaît ni en ligne ni sur vos autres appareils — en échange, elle ne demande aucun compte. La case déplace la carte, elle ne la copie pas : décocher la remet en ligne sur le serveur (partage, collaboration, historique, accès depuis vos appareils). Une carte jamais enregistrée peut être enregistrée en local d'un simple clic sur la case.

Sons hors connexion

Juste sous cette case, sur une carte locale, apparaît Sons hors connexion : Rendre disponible télécharge sur cet appareil les sons que la carte utilise, avec une progression en pourcentage et en méga-octets ; relancé, le téléchargement reprend où il s'était arrêté. L'état est dit en clair — « Disponible hors connexion », « Partiellement téléchargée », « Non disponible hors connexion » — et Retirer libère la place (la carte reste locale, mais elle aura de nouveau besoin du réseau pour sonner).

L'application elle-même reste disponible hors connexion après une première visite. La règle est « réseau d'abord » : tant que vous êtes en ligne, vous avez toujours la dernière version ; hors réseau, la copie en cache prend le relais. À ne pas confondre avec le pack hors-ligne du Monde Réel (voir § 9), qui embarque en plus les fonds de carte d'un itinéraire.

Poids des cartes — versions allégées

Setup › Version audio : une variante allégée (ambisonic 4 voies, triphonie, stéréo, mono) réduit fortement le poids téléchargé et la charge des cartes à nombreux canaux — Auto — selon l'appareil par défaut, rouvrir la carte pour appliquer. 📊 Estimation & compatibilité appareils… estime le poids et la compatibilité.

3. Sources & zones

La Librairie

Librairie (panneau gauche) : les fichiers audio, en deux onglets qui sont deux portées différentes.

Les deux onglets ont une barre Rechercher un son… (insensible à la casse et aux accents) et un filtre Tous les dossiers. Dans « Cette carte », les colonnes du tableau — Fichier, Util. (combien de sources l'utilisent), BPM, Groupe, Dossierse trient d'un clic sur leur en-tête. Les dossiers sont le rangement de votre compte, commun à toutes vos cartes ; les groupes sont une couleur, enregistrée avec la carte.

🛠 Gérer les fichiers ouvre le gestionnaire serveur : écouter, retailler (trim), remplacer le contenu (le nom est conservé → les sources restent valides) ou supprimer — la suppression dit quelles cartes du compte utilisent le son avant d'agir.

Un son importé est rattaché à la carte : il lui appartient dès l'import, et il survit au rechargement même s'il n'est posé nulle part — vous pouvez importer d'abord, choisir ensuite. À l'import, les sons sont convertis en MP3 et découpés par canal.

L'inspecteur (panneau droit)

Sélectionnez une source (mode Édition) pour régler :

Sources multicanal — éditeur de canaux

Recadrer presets et design des canaux ouvre l'éditeur de canaux : disposition des sous-sources (canaux) d'une source multicanal, presets de disposition (enregistrables), verrou 🔒 des canaux et ↺ Réinitialiser les positions (anneau par défaut).

Tableau comparatif des sources

Sources (panneau gauche) : vue comparative de toutes les sources — volume, fondu, zone, courbe — éditable directement dans le tableau ; cliquer une ligne la sélectionne dans l'inspecteur.

Entrée carte son (live)

+ Entrée carte son crée une source alimentée par une entrée physique de votre interface audio (choix du périphérique et des canaux dans l'inspecteur, bouton 🔄 Détecter).

Sources « action » : lien, musique, vidéo, flux radio

Quatre types de sources spéciales se déclenchent à l'entrée de l'auditeur dans leur zone : Lien web (carte avec bouton, ou ouverture automatique), Musique (Spotify / Apple Music / Deezer — sur téléphone, le lien ouvre l'app), vidéo détectable (YouTube / Vimeo / Dailymotion : lecture embarquée directe, fermée en sortie de zone) et Flux (webradio Icecast/SHOUTcast, spatialisée comme une source normale). Pour les flux : un menu de presets vérifiés (FIP, SomaFM, Radio Paradise, TSF Jazz…) et un 🔍 moteur de recherche international par nom, pays, région ou thème (annuaire libre radio-browser.info). Un flux est stéréo : ses deux canaux L·R sont visibles et écartables sur la carte, comme une source multicanale.

Dès qu'une carte contient au moins un flux, une entrée Sources streaming apparaît dans le menu de gauche. Elle réunit le mode de connexion et la modulation :

Un chien de garde reconnecte automatiquement un flux tombé (avec temporisation progressive pour ne jamais insister auprès d'une radio qui refuse).

Carte d'identité, estimation écologique & statistiques

En tête de la colonne de droite (édition) : le nom de la carte (cliquer pour renommer), l'historique des éditions, une synthèse (sources, fichiers, diffusion, modules actifs) et une estimation écologique : débit requis pour charger la carte en 1 minute (avec compatibilité de connexion), données streamées par heure d'écoute, g CO₂e et Wh estimés (modèle réseau fixe Ademe/IEA — comptez ×5-10 en 4G). La même estimation apparaît sur chaque carte de Mes cartes, dont les vignettes sont désormais une réduction complète du rendu réel (textes, formes, zones, réverb, badges ▣ ≋ ◉). Dans Réglages carte › Réglages avancés : ▤ Statistiques d'usage (chargements, sessions, temps d'écoute, données consommées, empreinte estimée — visibles par le propriétaire) et la ▚ Console, qui affiche les ressources en temps réel : latences audio, mémoire des sons décodés, flux connectés avec leur tampon, capteurs (GPS, curseur), images/s et réseau.

Zones de réverbération (convolution)

+ Zone réverb (Sources › Réverb) pose une zone de réverbération sur la carte. Dans son inspecteur 🌀 Zone de réverb : déclencheur (auditeur dans la zone ou source dans la zone), cible (toutes les sources ou un calque), preset d'IR, Longueur (decay), Niveau (wet), forme de zone (radiale ou polygone), rayon et gradient. Importer une IR (.wav) permet d'utiliser votre propre réponse impulsionnelle (sinon preset algorithmique).

4. Écoute & spatialisation

L'auditeur (curseur)

En mode Play, déplacez l'auditeur à la souris ou au doigt : le mix évolue selon votre position et votre orientation par rapport aux zones des sources. Setup › Curseur de navigation règle sa couleur, sa taille, le lissage anti-jitter, l'orientation automatique (le curseur regarde dans le sens du déplacement), la sensibilité et l'inertie. Sur tablette, le triangle de direction s'affiche au-dessus du doigt.

Modes de sortie audio

Mode (Setup › Sortie audio)Usage
Casque — mixdown stéréo (panoramique)Simple panoramique gauche / droite, très léger.
Casque — binaural HRTF (spatialisé 3D)Son 3D au casque — idéal mobile / app.
Multicanal direct (Haut-parleurs physiques)Chaque HP physique sur une sortie dédiée (installation, jusqu'à 8 canaux).
Installation multicanal (MBAP — spatialisé sur tous les HP)Panning MBAP diffus sur l'ensemble du dispositif ; option Rotation au cap (le champ tourne avec l'orientation de l'auditeur).

La case Laisser le lecteur choisir la sortie audio (mode Play) délègue ce choix à l'auditeur.

Une même carte ne s'entend pas pareil d'une sortie à l'autre, et dans un cas — le multicanal direct — les zones que vous avez dessinées ne sont pas utilisées du tout. → Les sorties audio, et ce qu'il faut adapter (stéréo, binaural, 5.1, Atmos).

Binaural par dôme de HP virtuels

En binaural, les sources sont panotées sur un anneau de HP virtuels et l'encodage HRTF (coûteux) n'est calculé que sur ces points fixes → coût CPU borné quel que soit le nombre de sources. Réglages : HP virtuels 16 (CPU léger) / 24 (équilibré) / 32 (précis) et Panoramique VBAP (net) / MBAP (diffus). Le moteur binaural peut aussi être Ambisonique HOA — JSAmbisonics (web seulement) : encodage ambisonique puis un seul décodage binaural HRTF.

Table des haut-parleurs

Table des HP (Setup › Sortie audio) : positions et canaux de chaque HP, presets de disposition (Stéréo, Quad, Octo, Atmos 7.1.4, Double Octo, Dôme 12, Dôme 24, Grille 64…), presets personnels enregistrables, échelle carte (unités par mètre), Adapter carte (recentre et met le dispositif à l'échelle de la carte), hauteur d'écoute, export / import JSON. Le VU multicanal flottant affiche les niveaux par canal.

Performance

Beat-sync (expérimental)

Panneau gauche › Timing & anneauTiming — calage de tempo (cet appareil) — cette entrée n'apparaît que si l'un de ses trois occupants est actif (anneau d'échantillons, calage de tempo, DJ-XR), au gestionnaire de modules (voir § 1). Elle aligne les boucles musicales sur un tempo commun (BPM) et quantise les déclenchements (mixage type DJ). Moteurs : Varispeed (le pitch suit le tempo) ou Timestretch (pitch préservé) (étirement hors-ligne, qualité expérimentale). Les fichiers doivent être des boucles propres, avec leur BPM renseigné dans la Librairie ; l'inspecteur permet d'activer / désactiver la synchro par source.

5. Outils d'édition & objets

En mode Édition, deux barres flottantes (déplaçables par leur en-tête, orientation horizontale / verticale au petit bouton ⇆) surplombent la carte :

Barre « Outils »

Barre « Affichage »

Ce qui est dessiné sur la carte — jamais le son : zones Voronoï, haut-parleurs, sources, noms (sources et HP), sous-sources multicanal, grille, surbrillance (halo) des sources audibles. Ces réglages existent aussi en cases à cocher dans Panneau gauche › Visualisation — entrée de premier niveau, juste au-dessus d'Apparence (elle s'appelait « Affichage & visualisation » et vivait à l'intérieur de celle-ci) — et sont conservés avec la carte.

Cette barre ne porte plus l'exposition du Séquenceur ni de l'enregistrement au lecteur : ce sont des modules (voir § 1), ils s'activent au gestionnaire, groupe « Play client ».

6. Vue 3D

Le bouton ⬡ 3D bascule la carte en vue 3D WebGL. Boutons dédiés (visibles en 3D) :

Édition en 3D

Modèles 3D et décor

Importer un modèle 3D (Design › Décor 3D) accepte les fichiers .glb / .gltf. L'éditeur 🧊 Modèle 3D règle l'échelle, la rotation, la hauteur (Z), ou supprime le modèle.

Cartes Monde Réel en 3D

Le fond OSM est drapé au sol avec un patch de détail dont la résolution suit le zoom caméra (LOD), le tracé de l'itinéraire est posé au sol, et l'option Relief 3D (élévation réelle) incline la vue et drape la carte sur le relief (voir § 7).

7. Monde Réel (GPS)

Activer le mode

Dans Réglages carte (panneau gauche), le sélecteur Mode de carte propose : Smartphone, Tablette, Grand écran, Installation et Cartographie réelle — « parcours géolocalisé utilisant le GPS et l'orientation ». Ce dernier révèle le panneau Monde Réel et son fond de carte OpenStreetMap (bouton ℹ En savoir plus sur les modes pour le détail).

Géoréférencement — « Définir la zone réelle »

Le sous-panneau Géoréférencement affiche Lat / Lon du centre, Rotation (cap vs nord vrai) et Échelle (unités de carte par mètre réel). Le bouton 🗺️ Définir la zone réelle… ouvre la carte OSM plein écran :

Le sous-panneau Fond de carte affiche / masque le fond OSM, règle son opacité et indique la superficie de la zone (avec ses dimensions). Le sous-panneau Relief & 3D active le Relief 3D (élévation réelle) avec inclinaison de la vue (0–75°) et exagération du relief (0–4×).

Itinéraire — planificateur de programme d'écoute

Simulation

Le sous-panneau Simulation rejoue l'itinéraire sans sortir de chez soi :

GPS réel sur le terrain

Densité & secteurs — la machine à 3 anneaux

Pour les longs parcours, l'itinéraire peut être découpé en secteurs de contenus :

Journal

Le sous-panneau Journal trace les événements du parcours (changements de secteur, nœuds de scénario) — utile pour vérifier un scénario en simulation accélérée.

8. Scénario non linéaire — l'éditeur dédié

L'entrée Scénario non linéaire du panneau de gauche pilote une narration à embranchements. Le bandeau indique l'état du graphe (« graphe valide », avertissements, erreurs — nœuds orphelins ou sans issue signalés).

Depuis le 2 août, un récit n'a plus besoin du mode Monde Réel. Il vivait à l'intérieur, et n'existait donc que sur une carte géoréférencée — alors qu'il n'a rien de géographique : ses conditions d'entrée de zone travaillent sur les zones des sources, en coordonnées de carte. Une installation en salle, une pièce sonore, une carte abstraite peuvent porter un scénario.

Ce que le Monde Réel apporte quand il est actif, et qui manque sans lui : la condition route_progress (distance parcourue sur l'itinéraire) et la position réelle dans le journal. Les autres conditions — zone, variable, temps écoulé, déclencheur manuel — fonctionnent partout.

L'éditeur graphique

Éditer le graphe ouvre l'éditeur dédié, qui occupe tout l'écran — ce n'est plus une fenêtre posée sur la carte. On en sort par ← Carte ou Échap.

Trois zones, les mêmes que dans l'éditeur de radio adaptative :

Double-clic = nouveau nœud, glisser la pastille d'un nœud = nouvelle arête, Suppr = supprimer la sélection.

Le niveau d'interface

En haut à droite : Simple · Standard · Avancé. Il règle ce qui est proposé à la création, et rien d'autre.

Ce que la carte contient déjà reste toujours visible et modifiable, quel que soit le niveau : un choix posé, une variable, un sous-nœud ◇ apparaissent — et leur groupe s'ouvre de lui-même. On ne cache jamais ce qui est utilisé, sinon le nœud deviendrait incompréhensible et l'édition destructrice. Le niveau est un réglage de votre machine, pas de la carte : il vous suit d'une carte à l'autre.

Pour chaque nœud, l'inspecteur règle :

Pour chaque arête : une condition de progression s ≥ (m). L'évaluation est déterministe (priorités), déclenchée pendant la simulation ou le GPS réel. Un mode JSON avancé (Valider & appliquer) permet d'éditer le scénario à la main, avec validation.

Séquenceur unifié : sous-nœuds condition & temps absolu

Ce qu'une action peut faire

Le scénario et le contrôle distant (OSC, tablette, modules) partagent le même vocabulaire depuis le 2 août. Une action de nœud — ou de jalon minuté — peut donc :

Les cinq premières familles étaient réservées au pilotage à distance : le scénario ne savait manipuler que des calques et des variables. Symétriquement, OSC a gagné l'écran noir, les variables et la fin de récit. La liste complète est dans docs/API_OSC.md.

Adaptive Wave : résonance & génération par IA

L'entrée Adaptive Wave du panneau de gauche ouvre son éditeur dédié, en trois sections : Fragments (le contenu balisé), Circonstances (les seuils du trajet) et Règles. La case Résonance active la lecture continue 3 canaux — la voix lit le récit dans l'ordre (retenue aux moments choisis), musique et bruitage s'adaptent aux circonstances selon les règles.

Les règles s'éditent enfin. Une règle se lit « quand ces circonstances → alors ceci » : on coche les circonstances (ou leur négation), puis ce que ça fait à chaque canal — retenir la voix, demander telle balise à la musique ou au bruitage, doser. Priorité, temps d'attente, portée et traitement fin (panoramique, passe-bas, vitesse) apparaissent au niveau Avancé, et toujours si la règle en porte. Une règle modifiée prend effet sans couper le son : on peut la régler en écoutant.

La radio adaptative joue désormais sur n'importe quelle carte, pas seulement en Monde Réel : elle suit l'auditeur, quel que soit ce qui le déplace — souris, doigt, séquenceur ou GPS. Elle se met en route quand la carte joue et s'arrête avec elle.

Le bouton Générer par IA — pas à pas ouvre un assistant en 3 étapes : décris ton récit → copie le prompt-dramaturge préparé et colle-le dans l'IA de ton choix (Claude, ChatGPT…) → recolle sa réponse JSON. La carte se joue aussitôt : les voix sans fichier audio sont lues par la synthèse vocale de l'appareil (aucune clé, aucun coût). Démo à écouter : la carte publique « Adaptive Wave — Radio résonante ».

9. Pack hors-ligne

Pour écouter sur le terrain sans réseau, le sous-panneau Hors-ligne du Monde Réel prépare un pack :

Ce pack est celui du Monde Réel : il embarque en plus les fonds de carte de l'itinéraire. Pour une carte ordinaire, c'est Sons hors connexion qu'il faut (carte locale, voir § 2) — deux mécanismes distincts.

10. Calques

Le panneau 🗂️ Calques (bouton Calques de la barre Outils) regroupe sources et annotations :

Sur les cartes Monde Réel, trois calques sont créés d'office : Itinéraire (tracé) (affiche / masque le tracé en 2D et en 3D), Fond de carte (affiche / masque le fond OSM) et Infos (pour vos annotations). Les calques cibles de l'éditeur de branches (voir § 8) s'appuient sur ce même système.

11. Séquenceur & enregistreur

Séquenceur de trajectoires

Panneau gauche › Séquenceur de trajectoire : trajectoire automatique de l'auditeur.

Enregistreur de la sortie

Panneau gauche › Sortie AudioEnregistreur : ⏺ Enregistrer l'audio capte la sortie sonore de l'application (votre écoute telle quelle), ■ Arrêter produit le fichier. Si le moteur audio n'est pas démarré, le démarre — inutile de cliquer d'abord.

L'enregistreur a déménagé de Partage vers Sortie Audio : enregistrer ce qu'on entend appartient à la sortie audio, pas à l'export du projet. Il est gouverné par son propre module, « Enregistreur de la sortie » (groupe Sorties audio) : sur une carte neuve, activez-le au gestionnaire pour faire apparaître la section. À ne pas confondre avec « Enregistrement audio (côté lecteur) », qui met la capture à la disposition de l'auditeur en mode Play et demande le module Partage.

12. Sessions & analyses

Sessions d'étude

Panneau gauche › Analyses (Session & enregistrement des traces). Cette entrée appartient au module « Analyses et traces » : sur une carte neuve, activez-le au gestionnaire pour la faire apparaître (voir § 1).

Tableau de bord d'analyse

📊 Analyse des sessions (lien « Analyses » de l'accueil ou du Setup) : liste des sessions par carte, téléchargement ZIP, et un lecteur de parcours qui rejoue la trajectoire de l'auditeur synchronisée à l'audio enregistré (couleur du tracé au choix : intensité sonore, vitesse ou temps ; ◇ début, ✕ fin). Accès réservé à l'administrateur.

13. Partage & collaboration

Partager une carte (façon « réunion »)

Sur la fiche d'une carte (accueil), le bouton 🔑 ouvre le partage :

L'entrée Partage de la colonne de menus et la section Ouvrir sur un appareil (iPad / iPhone / web) du Setup appartiennent au module « Export du projet » : sur une carte neuve, elles n'apparaissent qu'une fois ce module activé au gestionnaire (voir § 1). Le partage depuis la fiche de la carte, sur l'accueil (boutons 🔑 et 👥), n'en dépend pas : il suit vos droits sur la carte, et n'existe pas pour une carte locale.

Collaborateurs

Le bouton 👥 invite par e-mail avec un rôle : Lecture (voir et ouvrir la carte) ou Édition (la modifier aussi). Le collaborateur doit avoir un compte avec la même adresse e-mail pour retrouver la carte dans « Mes cartes ». L'historique des versions permet de revenir en arrière si une édition à plusieurs a mal tourné.

Adresse publique

Vos cartes marquées publiques (🌐) sont visibles sur votre adresse ?u=votre-nom (Setup › Mon compte › Mon adresse publique).

Multi-utilisateur

Setup › Multi-utilisateur : plusieurs auditeurs simultanés sur la même carte. Diffusion par le leader : un seul système sonore (le vôtre) — chaque participant rejoint via le Contrôle distant (QR) et déplace son propre auditeur, mixé dans votre sortie. Le mode « Diffuseurs en parallèle » (chacun joue le son sur son appareil) est en développement. Nombre maximal de participants réglable.

14. Contrôle distant, caméras & OSC

Contrôle distant (iPad / tablette)

Setup › Contrôle distant (pilotage lecture) — QR… : Créer une session (QR) affiche un QR code à scanner avec la tablette — la connexion est en WebRTC pair-à-pair sur le réseau local, sans serveur intermédiaire (un blob à copier / coller sert de secours). Chaque contrôleur connecté devient un auditeur supplémentaire sur la carte et déplace sa position depuis sa mini-carte. Plusieurs contrôleurs peuvent se connecter (liste « Contrôleurs connectés »).

Caméras & détection de mouvement

Capturez le fond quand l'espace est vide. La détection compare l'image à un modèle de fond. Si ce fond est capturé alors que des gens sont déjà là, chacun produit deux détections : là où il est, et le trou qu'il a laissé dans le fond. D'où le bouton ↺ Recapturer le fond.

Le suivi des personnes. Chaque personne détectée reçoit un numéro qu'elle conserve d'une image à l'autre, y compris si elle passe d'une caméra à l'autre ou disparaît brièvement derrière quelqu'un. Ce n'est pas qu'une affaire d'affichage : les déclenchements se souviennent de qui est déjà entré dans une zone, donc une identité qui change relance le son. Le curseur Stabilité du suivi (Interactions › Détection de mouvement) règle le lissage : plus il est haut, moins la position tremble, mais plus elle est molle. Le lissage s'adapte au mouvement — il calme l'immobilité sans freiner les déplacements.

L'aperçu affiche par défaut l'image avec la détection par-dessus. Les autres modes (masque seul, fond moyenné, niveaux de gris) servent au réglage fin. S'il n'y a pas d'image, l'aperçu l'écrit — il ne reste jamais noir sans explication.

Le sous-menu Caméra d'Interactions, le bouton Contrôle distant — QR… et Simuler un public appartiennent chacun à un module (« Caméra », « Tablette distante », « Simulateur de public ») : sur une carte neuve, activez-les au gestionnaire pour les faire apparaître (voir § 1).

OSC (pilotage externe)

Voir la page dédiée : Piloter EarMotion en OSC — depuis le 11/08, les adresses couvrent tout le vocabulaire d'actions (/emt/<action>), et la version web se pilote elle aussi, par un petit pont à lancer sur la machine.

Avec l'app desktop, un pont OSC/UDP (port 9130) accepte notamment : /transport/play, /transport/stop, /master <float>, /listener/xy <x> <y>, /map/leave. Via WebRTC (JSON), s'ajoutent le déplacement des auditeurs multiples et le pilotage des calques (layerEnable, layerVolume, layerOpacity). Référence développeur : docs/API_OSC.md.

15. 🎬 Mode Visuel & multi-écrans

Principe

Le mode Visuel projette une couche visuelle sur le player : un fichier vidéo (mp4/webm, muet — l'audio vient de la carte), un objet 3D (glb · gltf · dae · obj) en orbite lente, ou un shader génératif. Activez-le en Édition : entrée VISUALISATION🎬 VisuelActiver sur le player. Le bouton 👁 Aperçu dans l'éditeur montre le résultat sans quitter l'édition, et le scénario peut l'allumer/l'éteindre (action « Visuel : ON/OFF » du séquenceur).

Objet 3D

Caméra : clés d'animation

0 clé = orbite automatique (vitesse, distance et hauteur de caméra réglables dans le panneau — hauteur négative = contre-plongée) · 1 clé = plan fixe · ≥ 2 clés = trajectoire lissée (boucle en option). Une clé = un instant t + une position de caméra + un point de visée.

Le principe de l'éditeur, pendant l'aperçu : cliquer une clé ◆ fige l'aperçu sur elle — ce que vous voyez est exactement ce que la caméra donnera à cet instant. Glisser alors le losange (position) ou le carré (visée) dans la minimap modifie la vue en direct ; la barre sous la minimap règle les hauteurs (caméra et visée) de la clé sélectionnée. Dans le séquenceur en bas : ▶/⏸ rejoue ou fige la trajectoire, cliquer/glisser sur la frise déplace la tête de lecture (scrub), glisser un losange change son instant, ◇+ insère une clé à la tête de lecture (capture la vue actuelle, exactement), × supprime la clé sélectionnée. Le transport est local à l'aperçu : les écrans externes continuent de suivre l'horloge commune.

Éditeur nodal (effets)

🎛 Éditeur nodal compose les effets façon TouchDesigner : sources (Scène 3D, Vidéo, Génératif) → effets (Couleur, Mélange A/B, Kaléidoscope, Feedback, Bloom, Réactif audio, Shader perso en GLSL) → Sortie. Clic droit ou touche n : ajout avec autocomplétion. Tous les shaders reçoivent uAudio (niveau sonore réel), uCursor (position de l'auditeur) et uProx (proximité de la zone la plus proche) — contrat complet dans docs/VISUAL_SHADERS.md.

Multi-écrans (installation)

16. Raccourcis clavier

Touche / gesteContexteAction
Vue 3D, « Vue curseur » activeAvancer / reculer le long du cap ; tourner le cap de l'auditeur.
Suppr / Vue 3D, mode ÉditionSupprimer l'élément sélectionné (annotation, modèle 3D, source, HP).
Suppr / Éditeur de branches (Monde Réel)Supprimer le nœud ou l'arête sélectionné(e).
ÉchapÉditeur 2DVider la sélection multiple (annule le rectangle élastique).
ÉchapModales / popups / visite guidéeFermer ou annuler.
EntréeChamps de saisie des modalesValider (renommage, mot de passe, collaborateur, recherche d'adresse…).
Visite guidée (aide « ? »)Étape précédente / suivante.
N'importe quelle touchePremière interactionDémarre le moteur audio (contournement de l'autoplay navigateur).
Maj+clicÉditeur (carte ou liste des sources)Ajouter / retirer de la sélection multiple ; sélection de plage dans la liste.
Ctrl/Cmd+clicListe des sourcesBasculer une ligne dans la sélection.
Ctrl/Cmd+glisserMode PlayDéplacer la vue (pan) au lieu de l'auditeur.
Maj+glisser verticalVue 3D, objet sélectionnéRégler l'élévation (Z) de l'objet.
Alt+glisser verticalVue 3D, source sélectionnéeRégler le rayon de la zone.
Pincement 2 doigtsVue 3D (tactile)Zoom caméra — ou redimensionnement de la sélection si l'outil Échelle est actif.
Double-clicÉditeur de branches / tracé Monde RéelCréer un nœud / supprimer un point du tracé.

Il n'existe pas (encore) de raccourcis Ctrl+S (utilisez le bouton Enregistrer), Ctrl+Z ni copier / coller au clavier.

17. FAQ & dépannage

Je n'entends rien

Il me manque un menu (Partage, Analyses, Timing & anneau, Caméra…)

C'est presque toujours que son module n'est pas activé pour cette carte — et une carte neuve démarre sans aucun module actif. Ouvrez la Bibliothèque de modules, dernière entrée de la colonne de gauche, puis Gérer les modules… : c'est le seul endroit où l'on active un module (voir § 1). Deux autres cas : Sources streaming n'apparaît que si la carte porte au moins une radio, et Monde Réel que si la carte est géoréférencée.

Un son a changé sur le serveur mais pas dans la carte

Rien à faire : remplacer un fichier côté serveur invalide les caches tout seul (ils sont datés et dimensionnés). Rouvrez la carte, la nouvelle version est chargée. Si la carte est une carte locale dont les sons ont été rendus disponibles hors connexion (voir § 2), refaites Rendre disponible pour rafraîchir la copie embarquée.

La carte est lourde / ça rame

Monde Réel : le GPS décroche

C'est le mode tunnel : le bandeau « Signal GPS perdu » s'affiche quand les fixes manquent trop longtemps ; la lecture reprend automatiquement au prochain fix accepté. Choisissez le bon profil de mobilité (piéton, vélo, voiture…) pour un filtrage adapté.

Monde Réel : puis-je écouter sans réseau ?

Oui — préparez le pack hors-ligne (voir § 9) jusqu'au badge « Pack complet — jouable hors ligne ». En « Hors ligne complet », le fond de carte en ligne est coupé volontairement : tout vient du pack.

Le rendu se fige après une très longue session

Après un usage très intensif (WebGL + carte), certains navigateurs dégradent le rendu GPU (carte noire). Ce n'est pas une perte de données : rechargez l'onglet ou relancez le navigateur.

Mon collaborateur ne voit pas la carte

Il doit avoir un compte avec exactement l'adresse e-mail invitée (bouton 👥) ; la carte apparaît alors dans « Mes cartes ». Pour un accès sans compte, utilisez plutôt le partage par lien / mot de passe (🔑).

Où retrouver la visite guidée ?

Le bouton ? (accueil et barre du haut de l'éditeur) propose la visite guidée (spotlight pas à pas, adaptée à l'écran où vous êtes) et ce guide complet. Échap quitte la visite à tout moment ; votre mode Play / Édition est restauré.