Bien démarrer avec le SDK Unity

Le guide complet pour rendre une application Unity XR pilotable depuis Pulse Control.

Le Pulse SDK pour Unity permet à une application XR d'exposer ses commandes et ses réglages à Pulse Control. Vous décrivez le contrat avec des attributs C# ; le package découvre les composants actifs, génère leur schéma et traite les commandes reçues du MDM.

Vous n'avez pas à implémenter le WebSocket ni le protocole de contrôle dans votre application.

Choisir votre point d’entrée

Parcours de démarrage

Installez le package, créez une première intégration et connectez-la au MDM.

Guides pratiques

Exposez des actions, des variables et personnalisez l’interface générée.

Concepts

Comprenez le cycle de vie, la synchronisation et les responsabilités des composants.

Référence

Consultez l’API publique, les compatibilités et les limites connues.

Ce que vous allez construire

Au terme du parcours, votre application saura :

se connecter au broker Pulse local et se reconnecter automatiquement ;
exposer des méthodes avec [PulseAction] ;
exposer des champs ou propriétés avec [PulseVariable] ;
décrire des paramètres numériques, booléens, textuels et des enums ;
personnaliser les libellés, couleurs et icônes proposés à Pulse Control ;
survivre aux changements de scène et aux builds avec stripping ;
diagnostiquer une installation, un schéma ou une commande qui ne fonctionne pas.

Parcours recommandé

Cette documentation décrit la version 0.1.3 du package et Unity 6000.3 ou supérieur. Le registre UPM est public : aucun compte ni token n'est nécessaire.

Modèle mental

PulseBehaviour enregistre un composant actif dans PulseRegistry. PulseMDMClient transforme ce registre en SCHEMA et exécute les messages CMD ou SET. PulseManager porte la connexion WebSocket et garantit que ses événements reviennent sur le thread principal Unity.

Les identifiants comme experience.play ou lighting.intensity sont le contrat durable entre votre application et ses contrôleurs. Traitez-les comme une API publique : uniques, stables et indépendants des noms de classes.

Dans la version 0.1.3, une valeur modifiée localement dans Unity n'émet pas automatiquement de DELTA. Les valeurs initiales sont incluses dans le SCHEMA, et les SET distants sont appliqués, mais le suivi temps réel des changements locaux n'est pas encore fourni par le package.