L'importateur vous permet d'importer des modèles 3D, des images, des sons et des fichiers vidéo dans Studio. L'importation de modèles 3D prend en charge les maillages avec textures PBR, les maillages avec rigging, skinning et données d'animation, ainsi que les maillages conçus comme des éléments d'avatar.
Importez des modèles 3D personnalisés généraux dans Studio.
Utilisez l'importateur pour importer des actifs avec des composants d'éléments d'avatar.
Pour importer un actif :
- Dans le menu Fichier de Studio, sélectionnez Importer.
- Dans le navigateur de fichiers, sélectionnez le type de fichier supporté que vous souhaitez importer.
- Configurez vos paramètres d'importation et vérifiez les messages d'avertissement ou d'erreur.
- Cliquez sur Importer.
- Après l'importation, vous pouvez clic-droit sur l'actif importé dans l'importateur et effectuer les actions suivantes :
- Copier l'ID d'actif - Copie l'ID de l'actif téléchargé dans votre presse-papiers. Pour les modèles, cela copie l'ID de l'actif du Model.
- Trouver dans l'espace de travail (modèles 3D uniquement) - Positionne automatiquement la caméra à l'emplacement de l'objet importé dans l'espace de travail.
Types de fichiers supportés
Avant d'importer un objet 3D, assurez-vous que le .fbx, .gltf ou .obj répond aux exigences de maillage de Studio pour réduire les erreurs ou les comportements inattendus.
| Type d'actif | Détails |
|---|---|
| Image | Vous pouvez importer des images au format .png, .jpg, .gif, .tga ou .bmp à utiliser comme textures/décals sur des parties, étiquettes d'image, textures de maillage, textures pour matériaux personnalisés, textures pour effets spéciaux, et plus encore. |
| Maillage | Vous pouvez importer des maillages au format .fbx, .obj ou .gltf. Les formats .fbx et .gltf prennent en charge plusieurs objets maillés et hiérarchies, textures de base et textures PBR, objets maillés de cage, rigs, composants d'avatar, données d'animation, et couleurs de vertex. |
| Audio | Vous pouvez importer des actifs audio au format .ogg, .mp3, .flac ou .wav. Consultez Actifs audio pour des détails. |
| Vidéo | Vous pouvez importer des actifs vidéo au format .mp4 ou .mov si toutes les exigences sont respectées. |
File d'attente d'importation
Si vous avez sélectionné plusieurs fichiers avec l'importateur, vous pouvez utiliser la file d'attente d'importation pour gérer en masse vos diverses importations.


La barre supérieure vous permet d'ajouter de nouveaux fichiers, de vider la file d'attente, de rechercher et de filtrer, et d'importer tous les actifs activés.

La file d'attente d'importation liste tous les fichiers ajoutés, avec des menus déroulants pour un accès rapide pour changer le créateur, les préréglages et les chemins de fichier.
Ajouter des fichiers à la file d'attente
Pour ouvrir un navigateur de fichiers et ajouter d'autres fichiers à la file d'attente d'importation, vous pouvez :
- Cliquer sur le bouton Ajouter un fichier dans la barre supérieure de la fenêtre de la file d'attente d'importation.
- Dans le menu Fichier de Studio, sélectionner Importer.
Retirer des fichiers de la file d'attente
Pour retirer tous les fichiers de la file d'attente, cliquez sur le bouton Vider la file d'attente avec l'icône de balai. Pour retirer un fichier individuel de la file d'attente, faites un clic droit sur un élément dans la file d'attente et sélectionnez Supprimer de la file d'attente.
Appliquer les paramètres de préréglage
Utilisez la colonne Préréglage d'importation pour sélectionner une configuration de préréglage à appliquer à votre actif. Pour plus d'informations, consultez Préréglages.
Vous pouvez également appliquer les paramètres d'un élément à tous les éléments en cliquant avec le bouton droit sur un élément avec les paramètres souhaités et en sélectionnant Appliquer les paramètres à tous.
Accéder à l'aperçu individuel et aux paramètres
Si vous importez un modèle 3D, cliquez sur le nom Actif individuel d'un modèle non importé pour accéder à l'aperçu d'importation de cet élément. Utilisez l'aperçu d'importation pour visualiser et vérifier votre modèle, ainsi que définir tous les paramètres d'importation individuels.
Importer des fichiers
Assurez-vous que chaque élément que vous souhaitez importer a une case à cocher activée dans la première colonne. Par défaut, tous les éléments sont sélectionnés s'ils sont importables.
Appuyez sur le bouton Importer pour commencer le processus d'importation.
Aperçu d'importation (Modèles)
La fenêtre d'aperçu d'importation apparaît si vous importez un seul fichier modèle, ou si vous avez sélectionné un actif individuel dans la file d'attente d'importation. Cette fenêtre d'aperçu fournit des contrôles individuels pour les différents objets de votre modèle.
La fenêtre d'aperçu est divisée en plusieurs sections :


Le chemin du fichier de votre fichier modèle. Cliquez sur Parcourir pour modifier.

Le préréglage appliqué à votre importation. Utilisez le menu déroulant pour sélectionner plusieurs préréglages, ou le menu hamburger pour définir un nouveau préréglage.

L'aperçu 3D de votre modèle. Utilisez les boutons de la souris et les icônes en haut à droite pour diverses options de caméra et de vues.

L'hiérarchie d'objet de l'objet importé. Inclut les objets maillés et d'autres composants pris en charge.

Les paramètres d'importation pour votre importation. Pour une liste complète des paramètres, consultez Paramètres d'importation.
Paramètres d'importation
Selon l'objet sélectionné dans le panneau de hiérarchie, le panneau d'inspection affiche les groupes de paramètres suivants :
- Fichier général : Cela affecte l'ensemble du fichier importé.
- Rig général : Cela affecte l'objet maillé sélectionné si des données de rigging sont présentes.
- Transformation du fichier : Cela affecte les propriétés de transformation du fichier importé.
- Géométrie du fichier : Cela affecte les propriétés de géométrie du fichier importé.
- Objet général : Cela affecte l'objet enfant sélectionné.
- Géométrie de l'objet : Cela affecte la géométrie de l'objet enfant sélectionné.
Fichier général
L'importateur fournit les paramètres suivants pour tous les maillages :
| Paramètre | Description |
|---|---|
| Nom | Définit le nom de l'actif importé tel qu'il apparaîtra dans votre projet. |
| Importer uniquement comme modèle | Si activé, l'importateur importe le modèle comme un seul actif même si le modèle contient plusieurs enfants. Par défaut, c'est activé. Si désactivé, l'importateur importe le modèle et tous les descendants, tels que les multiples maillages, en tant qu'actifs individuels. |
| Télécharger sur Roblox | Si activé, l'importateur ajoute le modèle à votre Boîte à outils et à l'inventaire de Gestionnaire d'actifs comme un nouvel actif. Par défaut, c'est activé. Si désactivé, l'actif est gardé local à votre espace de travail et n'est pas assigné d'ID d'actif. C'est idéal pour tester et itérer sur un modèle avant de l'intégrer dans votre projet. |
| Importer en tant que paquet | Ajoute votre actif à l'espace de travail en tant que paquet, un format auto-mise à jour, évolutif et partageable recommandé pour les actifs qui sont réutilisés ou souvent redistribués. Par défaut, c'est désactivé. |
| Créateur | Définit le créateur, ou le groupe de créateurs, de l'actif. |
| Ajouter à l'espace de travail | Si activé, l'importateur insère le modèle dans le Workspace. Si l'importation provient d'une expérience sauvegardée ou publiée, ce paramètre accorde également la permission à l'expérience d'utiliser l'actif restreint. Par défaut, c'est activé. Si désactivé, ce paramètre ajoute uniquement le modèle à votre inventaire et ne donne pas la permission à l'expérience d'utiliser l'actif. |
| Insérer en utilisant la position de la scène | Si activé, l'importateur utilise la position actuelle de la scène lors de l'insertion du modèle dans l'espace de travail. Par défaut, c'est désactivé. |
| Conserver les os à influence nulle | Si activé, l'importateur conserve les os qui n'influencent pas le maillage. Par défaut, c'est désactivé. Si désactivé, l'importateur supprime les os à influence nulle. |
| Définir le pivot à l'origine de la scène | Si activé, l'importateur définit le point de pivot de l'ensemble du modèle à l'origine de la scène. Par défaut, c'est activé. |
| Ancré | Si activé, l'importateur définit la propriété Anchored sur true pour tous les MeshParts importés. Ceci est désactivé pour les maillages avec des données de rig / avatars. Par défaut, c'est désactivé. |
| Utilise une cage | Si activé, l'importateur trouve les maillages de cage dans le modèle et les convertit en objets WrapInstance, tels que WrapLayer ou WrapTarget. Si désactivé, l'importateur les traite comme des maillages ordinaires. Si l'importateur détecte initialement des maillages de cage dans le modèle, cela est activé par défaut. |
Rig général
L'importateur fournit les paramètres suivants pour les maillages avec des données de rigging, typiquement des corps de personnage ou des accessoires vestimentaires :
| Paramètre | Description |
|---|---|
| Type de rig | Définit le type de rig avec lequel le maillage doit être associé. Les options sont : - R15 - Personnalisé - Pas de rig Par défaut, l'importateur tente de sélectionner le paramètre le plus approprié en fonction des données de rigging et de skinning détectées du maillage. |
| Valider le corps UGC | Après l'importation, Studio ouvre les actifs dans l'outil Configuration de l'Avatar, vous permettant de commencer à tester et à télécharger rapidement des actifs d'avatar sur le Marketplace. |
| Échelle du rig | Si le type de rig est défini sur R15, l'importateur fournit des options supplémentaires pour spécifier l'échelle du type de corps. Les options sont : - Par défaut - Rthro - Rthro étroit |
Transformation du fichier
L'importateur fournit les paramètres suivants pour tous les maillages :
| Paramètre | Description |
|---|---|
| Avant le monde | Définit l'axe avant de l'objet. Par défaut, cela est défini sur Avant. |
| Haut du monde | Définit l'axe vers le haut de l'objet. Par défaut, cela est défini sur Haut. |
Géométrie du fichier
La géométrie du fichier inclut des informations sur les dimensions du fichier et le nombre de polygones de l'ensemble du modèle. Vous pouvez modifier les paramètres suivants pour tous les maillages :
| Paramètre | Description |
|---|---|
| Unité de mesure | Définit les unités dans lesquelles le fichier a été modélisé afin qu'il soit correctement dimensionné lors de l'importation. Par défaut, cela est défini sur Studs. |
| Fusionner les maillages | Si activé, fusionne tous les MeshParts dans le modèle en un seul MeshPart et crée un MeshPart plutôt qu'un Modèle. Par défaut, ceci est désactivé. |
| Inverser les faces négatives | Inverse l'orientation des faces négatives dans le maillage. Par défaut, ceci est désactivé. |
Objet général
Lors de la sélection d'un objet enfant spécifique de votre maillage, l'importateur remplit les paramètres d'objet général. Vous pouvez modifier les paramètres suivants pour les objets enfants sélectionnés :
| Paramètre | Description |
|---|---|
| Nom | Définit le nom de l'objet enfant sélectionné dans le modèle. |
| Ancré | Si activé, définit la propriété Anchored sur true pour l'objet enfant sélectionné. Par défaut, cela est désactivé. |
| Utiliser le pivot importé | Si activé, importe l'objet en utilisant le point de pivot défini dans l'objet enfant. Par défaut, cela est activé. |
Géométrie de l'objet
La géométrie de l'objet inclut des informations sur les dimensions et le nombre de polygones de l'objet enfant sélectionné du modèle. Vous pouvez modifier les paramètres suivants pour les objets enfants sélectionnés :
| Paramètre | Description |
|---|---|
| Rendre double face | Si désactivé, définit les sommets comme unidirectionnels. Les sommets unidirectionnels signifient que vous pouvez voir à travers eux d'un côté. Si activé, définit les sommets comme double face. Les sommets double face se rendent visuellement des deux côtés. Le double face est plus exigeant en performance. Par défaut, ceci est désactivé. |
| Ignorer les couleurs de vertex | Si activé, ignore les données de couleur de vertex dans l'objet enfant. Par défaut, ceci est désactivé. |
Préréglages
Vous pouvez enregistrer des préréglages de divers paramètres d'importation pour les appliquer rapidement plus tard dans l'aperçu d'importation ou la file d'attente d'importation.
Par défaut, vous pouvez sélectionner entre deux préréglages :
- Par défaut de Studio : Le comportement d'importation par défaut.
- Dernière importation : Utilise les paramètres appliqués à la dernière importation.
Vous pouvez utiliser le menu ⋯ à côté du menu déroulant Préréglages pour des options supplémentaires :
- Réinitialiser tout : Supprime tout changement à la configuration actuelle, remettant les paramètres à l'état par défaut pour le préréglage actuel.
- Enregistrer la sélection : Vous permet d'enregistrer tout changement nouveau aux paramètres de l'importateur dans le préréglage actuellement sélectionné.
- Enregistrer sous nouveau : Définit les paramètres actuels comme un nouveau préréglage. Une boîte de dialogue s'affiche vous permettant de définir un nom.
- Définir par défaut : Définit le préréglage actuel comme le défaut pour tous les importations à venir.
- Renommer : Renomme le préréglage actuel.
- Supprimer : Supprime le préréglage actuel. Réinitialise au préréglage Par défaut de Studio.
Avertissements et erreurs
Si Studio détecte des problèmes avec votre modèle, un petit indicateur s'affiche dans le panneau de hiérarchie ou le panneau de paramètres.
Si vous voyez une icône d'avertissement dans la hiérarchie, développez la hiérarchie jusqu'à ce que vous atteigniez l'objet enfant spécifique pour voir plus d'informations sur le problème. Les messages d'avertissement et d'erreur s'affichent dans le panneau de paramètres ou sous forme d'info-bulle.

