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 des textures PBR, les maillages avec rigging, skinning et données d'animation, ainsi que les maillages conçus comme é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 pris en charge 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 de l'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 pris en charge
Avant d'importer un objet 3D, assurez-vous que le .fbx, .gltf ou .obj respecte les 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 pour les utiliser comme textures/décals sur des pièces, é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 de maillage et hiérarchies, des textures de base et PBR, des objets de maillage de cage, des rigs, des composants d'avatar, des données d'animation et des couleurs de vertex. |
| Audio | Vous pouvez importer des actifs audio au format .ogg, .mp3, .flac ou .wav. Voir Actifs audio pour plus de 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'importation
Si vous avez sélectionné plusieurs fichiers avec l'importateur, vous pouvez utiliser la file d'importation pour gérer en masse vos différents imports.


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

La file d'importation liste tous les fichiers ajoutés, avec des menus déroulants d'accès rapide pour changer de créateur, de préréglages et de chemins de fichiers.
Ajouter des fichiers à la file
Pour ouvrir un navigateur de fichiers et ajouter des fichiers supplémentaires à la file d'importation, vous pouvez :
- Cliquer sur le bouton Ajouter un fichier dans la barre supérieure de la fenêtre de la file d'importation.
- Dans le menu Fichier de Studio, sélectionner Importer.
Supprimer des fichiers de la file
Pour supprimer tous les fichiers de la file, cliquez sur le bouton Vider la file avec l'icône de balai. Pour supprimer un fichier individuel de la file, faites un clic droit sur un élément de la file et sélectionnez Supprimer de la file.
Appliquer des 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, voir Préréglages.
Vous pouvez également appliquer les paramètres d'un élément à tous les éléments en faisant un clic 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 et aux paramètres individuels
Si vous importez un modèle 3D, cliquez sur le nom de l'Actif d'un modèle non importé pour accéder à l'aperçu d'importation pour cet élément. Utilisez l'aperçu d'importation pour visualiser et vérifier votre modèle, ainsi que pour 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 de modèle, ou si vous avez sélectionné un actif individuel dans la file 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 de 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 et vues de caméra.

La hiérarchie des objets de l'objet importé. Comprend des objets de maillage et d'autres composants pris en charge.

Les paramètres d'importation pour votre importation. Pour une liste complète des paramètres, voir Paramètres d'importation.
Paramètres d'importation
En fonction de l'objet sélectionné dans le panneau de hiérarchie, le panneau d'inspection affiche les groupes de paramètres suivants :
- Général du fichier : Affecte l'ensemble du fichier importé.
- Général du rig : Affecte l'objet de maillage sélectionné si des données de rigging sont présentes.
- Transformation du fichier : Affecte les propriétés de transformation du fichier importé.
- Géométrie du fichier : Affecte les propriétés de géométrie du fichier importé.
- Général de l'objet : Affecte l'objet enfant sélectionné.
- Géométrie de l'objet : Affecte la géométrie de l'objet enfant sélectionné.
Général du fichier
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 en tant que modèle | Si activé, l'importateur importe le modèle en tant qu'actif unique même si le modèle contient plusieurs enfants. Par défaut, cela 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 inventaire Boîte à outils et Gestionnaire d'actifs en tant que nouvel actif. Par défaut, cela est activé. Si désactivé, l'importateur n'ajoute pas le modèle à votre inventaire pour une utilisation ultérieure. Cela est idéal lorsque vous souhaitez tester et itérer sur la conception d'un modèle sans créer plusieurs copies dans la Boîte à outils et le Gestionnaire d'actifs. |
| Importer en tant que package | Ajoute votre actif à l'espace de travail en tant que package, un format évolutif, partageable et auto-mis à jour recommandé pour les actifs qui sont réutilisés ou couramment redistribués. Par défaut, cela est désactivé. |
| Créateur | Définit le créateur, ou le groupe de créateurs, pour l'actif. |
| Ajouter à l'espace de travail | Si activé, l'importateur insère le modèle dans le Workspace. Si vous importez depuis un jeu enregistré ou publié, ce paramètre accorde également la permission au jeu d'utiliser l'actif restreint. Par défaut, cela est activé. Si désactivé, ce paramètre n'ajoute que le modèle à votre inventaire et ne donne pas la permission au jeu 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, cela est désactivé. |
| Conserver les os à influence nulle | Si activé, l'importateur conserve les os qui n'influencent pas le maillage. Par défaut, cela 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, cela est activé. |
| Ancré | Si activé, l'importateur définit la propriété Anchored sur true pour tous les MeshParts importés. Cela est désactivé pour les maillages avec des données de rig / avatars. Par défaut, cela est désactivé. |
| Utilise la 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. |
Général du rig
L'importateur fournit les paramètres suivants pour les maillages avec des données de rigging, généralement des corps de personnages ou des accessoires vestimentaires :
| Paramètre | Description |
|---|---|
| Type de rig | Définit le type de rig auquel 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 rapidement à tester et à télécharger 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 du monde | Définit l'axe de face avant de l'objet. Par défaut, cela est défini sur Avant. |
| Haut du monde | Définit l'axe de face supérieure 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é d'échelle | Définit les unités dans lesquelles le fichier a été modélisé afin qu'il soit dimensionné correctement 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, cela est désactivé. |
| Inverser les faces négatives | Inverse l'orientation des faces négatives dans le maillage. Par défaut, cela est désactivé. |
Général de l'objet
Lorsque vous sélectionnez un objet enfant spécifique de votre maillage, l'importateur remplit les paramètres généraux de l'objet. 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 intensif en performances. Par défaut, cela 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, cela 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'importation.
Par défaut, vous pouvez choisir entre deux préréglages :
- Par défaut de Studio : Le comportement d'importation par défaut.
- Dernier importé : Utilise les paramètres appliqués à l'importation la plus récente.
Vous pouvez utiliser le menu ⋯ à côté du menu déroulant des préréglages pour des options supplémentaires :
- Réinitialiser tout : Supprime toutes les modifications apportées à la configuration actuelle, remettant les paramètres dans l'état par défaut pour le préréglage actuel.
- Enregistrer la sélection : Vous permet d'enregistrer les nouvelles modifications des paramètres d'importation 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 comme par défaut : Définit le préréglage actuel comme le par défaut pour tous les imports à 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'à atteindre 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.

