Workflow de dossier XML dans Unity

Dans le workflow des dossiers XML, une ressource Harmony Importer unique peut être créée par un développeur pour référencer un dossier XML exporté depuis Harmony. Cet importateur peut ensuite être utilisé pour générer une ressource Harmony Project et un nouveau Prefab du moteur de rendu Harmony Renderer.

Pour chaque fichier XML réexporté, les développeurs doivent définir manuellement les chemins d’importation et d’exportation et effectuer le processus d’importation à partir de la ressource Harmony Importer.

Ce workflow offre une certaine souplesse quant à l’emplacement des données XML. Par exemple, il peut résider à l’intérieur ou à l’extérieur du projet Unity. Toutefois, l’inconvénient de ce workflow est que davantage d’erreurs peuvent être commises, car les étapes sont plus nombreuses. Par exemple, le chemin d’accès aux fichiers de l’importateur TBG devra être mis à jour manuellement lors du déplacement des fichiers.

Le Prefab Harmony Renderer qui en résulte permet un rendu performant des personnages en générant un maillage au sein d’un plugin C++. Ceci est préférable pour les foules de personnages qui ne nécessitent pas de fonctionnalités de rendu personnalisées compliquées.

  1. Dans Harmony, recherchez le bouton Exporter vers la feuille de sprite dans la barre d’outils Jeux.

  2. Sélectionnez Enregistrer et exporter. Assurez-vous que l’option Exporter en tant que TBG n’est pas cochée dans la boîte de dialogue Exporter vers une feuille de sprite.

  3. Enregistrez le code XML dans un dossier à l’intérieur du dossier Ressources de votre projet Unity.

  4. Dans Unity, créez un nouvelle ressource Harmony Importer en effectuant l’une des fonctions suivantes :

    • Dans la liste déroulante Ressources dans le menu supérieur, sélectionnezCréer > Importer un projet Harmony.

    • Cliquez avec le bouton droit sur le dossier Ressources dans la vue Projet et sélectionnez Créer > Importer un projet Harmony.

  5. Nommez l’Harmony Importer avec un suffixe « Importer » pour éviter toute confusion future.

  6. Copiez le chemin d’accès relatif du dossier exporté, collez-le dans le nouvel Harmony Importer.

  7. Copiez le chemin d’accès relatif de la ressource Harmony Importer, collez-le dans Harmony Importer, remplacez « Importer » par « Project » dans le chemin d’accès.

  8. Cliquez sur Import.

    Une nouvelle ressource HarmonyProject sera créée ainsi qu’un nouveau Prefab avec Harmony Renderer qui fait référence à HarmonyProject.

    9. La ressource Prefab peut être glissée à partir de la vue Projet vers la Hierarchy View et la Scene View pour afficher votre personnage dans votre jeu

Importation d’ancres

Dans Harmony, les ancres fournissent un moyen d’indiquer quelles chevilles et dessins sont des positions d’intérêt pour les scripts de jeu dans Unity. Un ancrage peut être assigné à tout dessin ou cheville.

  1. Sélectionnez un calque dans la Timeline View ou un nœud dans la Node View et sélectionnez le bouton Basculer l’ancre dans la barre d’outils Jeux.

  2. Importez le personnage dans Unity. Voir Comment importer un dossier XML dans Unity

La prochaine fois que le processus d’importation XML est effectué, la nouvelle ancre apparaîtra dans Unity sous le Prefab importé du personnage en tant que nouvelle HarmonyAnchor.

Ce nouveau GameObject suivra la position, la rotation et l’échelle de l’animation courante sur le personnage. Cela vous permet d’attacher dynamiquement des objets de jeu en tant qu’enfants aux ancres pour les transporter, les équiper et les utiliser.

REMARQUE Le déplacement des positions d’ancrage n’affectera pas les visuels du moteur de rendu Harmony Renderer. Pour afficher et affecter l’ensemble de la structure du personnage dans Unity et pas seulement les ancres, vous pouvez envisager d’utiliser le workflow TBG

Ajout de sources audio

Lorsque vous créez des fichiers de plan dans Harmony avec audio, l’audio est exporté dans le dossier du projet. Harmony Importer créera automatiquement une AudioSource et l’ajoutera au Prefab généré. Harmony Renderer peut ensuite déclencher la lecture des fichiers AudioClip à certains moments de la lecture de l’animation, comme cela a été fait dans Harmony.