Ressources
Une ressource est tout ce que vous importez ou créez une fois pour l'utiliser à plusieurs endroits : modèles, images, sons, scripts, et plus encore. Voici comment fonctionnent les dossiers et les chemins, et comment les objets utilisent les ressources.
| Ressource | Sert à |
|---|---|
| modèle | un objet 3D |
| image | une texture, ou une image dans une carte d'interface |
| vidéo | une surface vidéo, ou une carte |
| audio | une source sonore, ou des sons ponctuels joués par un script |
| police | du texte |
| matériau | un matériau que vous réutilisez sur plusieurs objets |
| géométrie | une forme que vous réutilisez sur plusieurs objets |
| prefab | un groupe d'objets enregistré que vous pouvez ajouter à nouveau |
| splat | une capture en Gaussian splats |
| carte | une mise en page d'interface |
| patch | un graphe visuel que vous pouvez réutiliser et appeler |
| script | un comportement écrit en TypeScript |
Dossiers et chemins
Les ressources sont rangées dans des dossiers, comme les fichiers sur votre ordinateur. Un chemin, ce sont les noms des dossiers puis le nom de la ressource, séparés par des barres obliques :
Models/Trees/oak.glb
Les noms sont uniques à l'intérieur d'un dossier : un chemin désigne donc toujours une seule ressource.
Les scripts s'importent les uns les autres par leur chemin. Quand vous renommez ou déplacez une ressource, tous les scripts qui l'importent sont mis à jour pour vous. Vous n'avez pas à corriger les imports à la main.
Quand un modèle arrive avec ses propres textures, elles sont rangées sous le modèle. Déplacez ou supprimez le modèle, et ses textures suivent. Vous n'avez jamais à les gérer une par une.
Les objets renvoient aux ressources
Un objet ne contient pas de copie d'une ressource. Il contient une référence vers elle :
- Un objet modèle pointe vers un modèle.
- La texture de couleur d'un matériau pointe vers une image.
- Un objet texte pointe vers une police.
Quand vous modifiez une ressource, tout ce qui l'utilise se met donc à jour d'un coup. Modifiez un matériau, et tous les panneaux de votre scène qui l'utilisent changent.
Cela explique aussi un symptôme. Si une ressource manque, l'objet existe toujours, mais il n'est pas dessiné. Vous ne recevez aucun message d'erreur.
Les ressources se chargent pendant que la scène tourne
Les ressources qui ne sont pas préchargées arrivent après l'ouverture de la scène. Vous pouvez le remarquer :
- un modèle apparaît un instant après le démarrage de la scène ;
- un matériau semble terminé, mais sa texture manque pendant un instant ;
- un texte apparaît avec un léger retard.
Certaines choses doivent être à l'écran dès la toute première image, comme un carton de titre ou un logo. Ne les faites pas dépendre d'un gros téléchargement. Vous pouvez aussi les précharger, ou garder la scène masquée jusqu'à l'arrivée du contenu.
Suivant : Caméras — ce à travers quoi votre visiteur regarde.