Personnaliser l'interface

Objectif

Rendre le schéma compréhensible pour un opérateur, sans changer les IDs techniques.

Widgets générés automatiquement

Le SDK choisit une suggestion de widget :

Élément	Widget suggéré
Action sans enum	`button`
Action avec au moins un paramètre enum	`dropdown_button`
Variable avec `Min` et `Max`	`slider`
Autre variable	`label`

Ce bloc ui est une indication destinée au contrôleur. Il ne modifie pas le comportement C#.

Ouvrir l'éditeur Pulse

Dans Unity, ouvrez Pulse > Pulse Manager. La fenêtre comporte :

Bindings : inventaire des PulseBehaviour, actions, variables, IDs et bornes ;
UI Setup : libellés, couleurs et icônes associés aux IDs.

Dans Bindings, corrigez tous les IDs vides ou dupliqués. L'outil peut réécrire l'attribut dans le fichier source ; relisez le diff avant de le valider dans Git.

Ajouter un libellé et une couleur

Dans UI Setup :

sélectionnez l'ID à personnaliser ;
saisissez un libellé orienté opérateur, par exemple « Redémarrer l'expérience » ;
choisissez une couleur si elle apporte une signification cohérente ;
cliquez sur Save.

La configuration est enregistrée dans :

Assets/PulseSDK/Resources/pulse-ui-config.json

Versionnez ce fichier avec le projet. Le runtime le charge via Resources et fusionne les valeurs avec le schéma.

En 0.1.3, une entrée qui ne contient qu'une couleur, sans libellé ni icône, n'est pas sauvegardée par l'éditeur. Ajoutez au moins un libellé si vous devez conserver la couleur.

Activer le sélecteur d'icônes

Le sélecteur attend une base Lucide à cet emplacement projet :

Assets/Data/lucide-icons.json

Cette base n'est pas incluse dans le package UPM. Si elle manque, Unity affiche un avertissement et le sélecteur d'icônes reste indisponible ; les libellés et couleurs continuent de fonctionner. Utilisez l'outil TKorp prévu pour générer la base Lucide ou fournissez le fichier attendu avant de configurer les icônes.

Bonnes pratiques éditoriales

Gardez l'ID technique stable ; traduisez seulement le libellé visible.
Commencez le libellé d'une action par un verbe.
Indiquez l'unité d'une variable : « Volume (%) », « Durée (s) ».
Réservez les couleurs fortes aux états réellement importants.
Vérifiez le résultat dans le contrôleur : celui-ci reste responsable du fallback si un widget ou une icône est inconnu.

Ce que vous devez avoir à la fin

La fenêtre Pulse ne signale aucun ID vide ou dupliqué.
pulse-ui-config.json est créé et versionné.
Chaque commande importante possède un libellé compréhensible.
Le contrôleur affiche les widgets attendus et gère les fallbacks.
Si des icônes sont utilisées, lucide-icons.json est disponible.

Étape suivante : maîtriser le cycle de vie et la synchronisation.