Spatial Visualizer

Prototype d'application de visualisation 3D des objets d'un flux audio spatialisé.

Le projet est conçu pour fonctionner avec Generic Spatial Renderer Daemon (gsrd), qui fournit le moteur temps réel, l’état OSC et les contrôles audio utilisés par le visualizer. Le visualizer seul ne produit pas de rendu audio: il sert d’interface de supervision et de pilotage pour gsrd.

Principe

• Le serveur écoute des messages OSC en UDP (port dynamique par défaut pour éviter les conflits avec gsrd sur 9000).
• Au démarrage, le viewer envoie /gsrd/register [listen_port] vers <host>:9000 (port configurable via --osc-rx-port) pour s’enregistrer auprès de gsrd.
• Tant qu’il est actif, le viewer envoie /gsrd/heartbeat [listen_port] toutes les 5 secondes vers la même destination pour maintenir l’inscription côté gsrd.
• Les positions reçues sont diffusées en WebSocket au front web.
• Le front affiche chaque source comme une sphère dans un volume 3D normalisé [-1, 1].
• Le menu Layout permet de choisir la configuration d’enceintes chargée depuis layouts/*.json et affichée dans la scène.

Formats OSC supportés

Le serveur accepte le format historique du prototype et des variantes de type bridge (id embarqué dans l'adresse, coordonnées sphériques).

1) Position cartésienne (format historique)

/source/position id x y z

2) Position cartésienne (id dans l'adresse)

/source/<id>/position x y z
/object/<id>/position x y z
/channel/<id>/position x y z

3) Position sphérique (azimut, élévation, distance)

/source/<id>/aed azimuth elevation distance

Le serveur convertit aed vers x y z, puis clamp dans [-1,1].

4) Suppression d'une source

/source/remove id
/source/<id>/remove

Options CLI

node server.js --host 127.0.0.1 --osc-port 0 --osc-rx-port 9000 --http-port 3000

• --osc-port : port UDP local d'écoute OSC (utilisé aussi comme listen_port dans /gsrd/register). Défaut 0 (= port dynamique attribué par l'OS).
• --host / --osc-host : hôte gsrd cible pour l'enregistrement.
• --osc-rx-port : port UDP côté gsrd recevant /gsrd/register (défaut 9000).
• --http-port : port HTTP du viewer.

Lancer le projet

npm install
npm start

Puis ouvrir: http://localhost:3000

Vérification rapide

node --test

Messages envoyés par le viewer vers gsrd

Message OSC	Fréquence	Args
/gsrd/register	une fois au démarrage	[int listen_port]
/gsrd/heartbeat	toutes les 5 s	[int listen_port]

Heartbeat gsrd (réponses attendues)

Le viewer envoie /gsrd/heartbeat [listen_port] toutes les 5 secondes.

• /gsrd/heartbeat/ack : rien à faire, la session est valide.
• /gsrd/heartbeat/unknown : le viewer se ré-enregistre automatiquement avec /gsrd/register.
• timeout d'ACK (> ~10 s) : le viewer tente périodiquement un /gsrd/register jusqu'au retour des réponses.