导入器 | 文档 - Roblox 创作者中心

导入器允许您将 3D 模型、图像、声音和视频文件导入到 Studio 中。3D 模型导入支持带有 PBR 纹理的网格、带有绑定、蒙皮和动画数据的网格，以及设计为头像物品的网格。

将一般 3D 自定义模型导入到 Studio 中。

使用导入器导入带有头像物品组件的资产。

要导入资产：

从 Studio 的文件菜单中选择导入。
在文件浏览器中，选择您打算导入的支持的文件类型。
配置您的导入设置并验证任何警告或错误消息。
点击导入。
导入后，您可以右键单击导入器中的导入资产并执行以下操作：
1. 复制资产 ID - 将上传的资产 ID 复制到您的剪贴板。对于模型，这将复制 Model 的资产 ID。
2. 在工作区中查找（仅限 3D 模型） - 自动将相机定位到工作区中导入对象的位置。

要使用 HTTP 请求直接导入资产，请参阅 Open Cloud 资产使用指南。

支持的文件类型

在导入 3D 对象之前，请确保 .fbx、.gltf 或 .obj 符合 Studio 的网格要求，以减少错误或意外行为。

资产类型	详细信息
图像	您可以导入 .png、.jpg、.gif、.tga 或 .bmp 格式的图像，用作零件上的纹理/贴花、图像标签、网格纹理、自定义材料的纹理、特效的纹理等。
网格	您可以导入 .fbx、.obj 或 .gltf 格式的网格。 .fbx 和 .gltf 格式支持多个网格对象和层次结构、基本和 PBR 纹理、笼网格对象、绑定、头像组件、动画数据和顶点颜色。
音频	您可以导入 .ogg、.mp3、.flac 或 .wav 格式的音频资产。有关详细信息，请参阅音频资产。
视频	如果满足所有要求，您可以导入 .mp4 或 .mov 格式的视频资产。

导入队列

如果您使用导入器选择了多个文件，您可以使用导入队列批量管理您的各种导入。

导入器界面，左上角显示网格的预览，左下角显示 3D 对象的列表，右侧显示可切换的属性列表。

顶部栏允许您添加新文件、清除队列、搜索和过滤，以及导入所有启用的资产。

导入队列列出所有添加的文件，并提供快速访问下拉菜单以更改创建者、预设和文件路径。

将文件添加到队列

要打开文件浏览器并将其他文件添加到导入队列，您可以：

点击导入队列窗口顶部栏中的添加文件按钮。
从 Studio 的文件菜单中选择导入。

从队列中移除文件

要从队列中移除所有文件，请点击带有扫帚图标的清除队列按钮。要从队列中移除单个文件，请右键单击队列中的项目并选择从队列中删除。

应用预设设置

使用导入预设列选择要应用于您的资产的预设配置。有关更多信息，请参阅预设。

您还可以通过右键单击具有所需设置的项目并选择将设置应用于所有来将一个项目的设置应用于所有项目。

访问单个预览和设置

如果您正在导入 3D 模型，请单击未导入模型的单个资产名称以访问该项目的导入预览。使用导入预览查看和检查您的模型，并设置任何单独的导入设置。

导入文件

确保您要导入的每个项目在第一列中启用了复选框。默认情况下，如果可以导入，则所有项目均被选中。

按导入按钮开始导入过程。

导入预览（模型）

如果您正在导入单个模型文件，或者如果您从导入队列中选择了单个资产，则会出现导入预览窗口。此预览窗口为模型中的各种对象提供单独的控制。

预览窗口分为多个部分：

您的模型文件的文件路径。点击浏览进行编辑。

应用于您的导入的预设。使用下拉菜单选择多个预设，或使用汉堡菜单设置新预设。

您模型的 3D 预览。使用鼠标按钮和右上角图标进行各种相机选项和视图。

导入对象的对象层次结构。包括网格对象和其他支持的组件。

您导入的导入设置。有关设置的完整列表，请参阅导入设置。

导入设置

根据层次面板中选择的对象，检查器面板显示以下设置组：

文件常规：影响整个导入文件。
绑定常规：如果存在绑定数据，则影响所选网格对象。
文件变换：影响导入文件的变换属性。
文件几何：影响导入文件的几何属性。
对象常规：影响所选子对象。
对象几何：影响所选子对象的几何。

文件常规

导入器为所有网格提供以下设置：

设置	描述
名称	设置导入资产的名称，以便在您的项目中显示。
仅作为模型导入	如果启用，导入器将模型作为单个资产导入，即使模型包含多个子项。默认情况下，此选项为启用。如果禁用，导入器将模型及其所有后代（例如多个网格）作为单独的资产导入。
上传到 Roblox	如果启用，导入器将模型添加到您的工具箱和资产管理器库中，作为新资产。默认情况下，此选项为启用。如果禁用，导入器不会将模型添加到您的库中以供后续使用。这在您想要测试和迭代模型设计而不在工具箱和资产管理器中创建多个副本时是理想的。
作为包导入	将您的资产添加到工作区作为包，这是一种自动更新、可扩展和可共享的格式，推荐用于重复使用或常见重新分发的资产。默认情况下，此选项为禁用。
创建者	设置资产的创建者或创建者组。
添加到工作区	如果启用，导入器将模型插入到 Workspace 中。如果从保存或发布的游戏导入，此设置还授予游戏使用受限资产的权限。默认情况下，此选项为启用。如果禁用，此设置仅将模型添加到您的库中，并且不授予游戏使用该资产的权限。
使用场景位置插入	如果启用，导入器在将模型插入工作区时使用当前场景位置。默认情况下，此选项为禁用。
保留零影响骨骼	如果启用，导入器保留不影响网格的骨骼。默认情况下，此选项为禁用。如果禁用，导入器将移除零影响骨骼。
将枢轴设置为场景原点	如果启用，导入器将整个模型的枢轴点设置为场景原点。默认情况下，此选项为启用。
固定	如果启用，导入器将所有导入的 MeshParts 的 Anchored 属性设置为 true。对于具有绑定数据/头像的网格，此选项为禁用。默认情况下，此选项为禁用。
使用笼	如果启用，导入器在模型中查找笼网格并将其转换为 WrapInstance 对象，例如 WrapLayer 或 WrapTarget。如果禁用，导入器将其视为常规网格。如果导入器最初在模型中检测到笼网格，则默认情况下此选项为启用。

绑定常规

导入器为具有绑定数据的网格提供以下设置，通常是角色身体或服装配件：

设置	描述
绑定类型	设置网格应关联的绑定类型。选项包括： - R15 - 自定义 - 无绑定默认情况下，导入器会根据检测到的网格的绑定和蒙皮数据尝试选择最合适的设置。
验证 UGC 身体	导入后，Studio 会在头像设置工具中打开资产，允许您快速开始测试和上传头像资产到市场。
绑定比例	如果绑定类型设置为 R15，导入器提供额外选项以指定身体类型缩放。选项包括： - 默认 - Rthro - Rthro 窄

文件变换

导入器为所有网格提供以下设置：

设置	描述
世界前方	设置对象的前方轴。默认情况下，此选项设置为前。
世界向上	设置对象的向上轴。默认情况下，此选项设置为上。

文件几何

文件几何包括有关整个模型的文件尺寸和多边形计数的信息。您可以编辑所有网格的以下设置：

设置	描述
缩放单位	设置文件建模时使用的单位，以便在导入时适当调整大小。默认情况下，此选项设置为 Studs。
合并网格	如果启用，将模型中的所有 MeshParts 合并为一个 MeshPart，并创建一个 MeshPart 而不是一个模型。默认情况下，此选项为禁用。
反转负面面	反转网格中负面面的方向。默认情况下，此选项为禁用。

对象常规

当选择网格的特定子对象时，导入器填充对象常规设置。您可以编辑所选子对象的以下设置：

设置	描述
名称	设置模型中所选子对象的名称。
固定	如果启用，将所选子对象的 Anchored 属性设置为 true。默认情况下，此选项为禁用。
使用导入的枢轴	如果启用，使用子对象中设置的枢轴点导入对象。默认情况下，此选项为启用。

对象几何

对象几何包括有关所选子对象的尺寸和多边形计数的信息。您可以编辑所选子对象的以下设置：

设置	描述
双面	如果禁用，将顶点设置为单面。单面顶点意味着您可以从一侧看透它们。如果启用，将顶点设置为双面。双面顶点在两个面上都可视化渲染。双面渲染对性能的要求更高。默认情况下，此选项为禁用。
忽略顶点颜色	如果启用，忽略子对象中的顶点颜色数据。默认情况下，此选项为禁用。

预设

您可以保存各种导入设置的预设，以便在导入预览或导入队列中快速应用。

默认情况下，您可以在两个预设之间进行选择：

Studio 默认：默认导入行为。
最后导入：使用应用于最近一次导入的设置。

您可以使用预设下拉菜单旁边的 ⋯ 菜单获取其他选项：

重置所有：移除当前配置的任何更改，将设置恢复为当前预设的默认状态。
保存选择：允许您将任何新更改保存到当前选定的预设中。
另存为新：将当前设置设置为新预设。会显示一个对话框，允许您设置名称。
设为默认：将当前预设设置为今后所有导入的默认值。
重命名：重命名当前预设。
删除：删除当前预设。重置为 Studio 默认预设。

警告和错误

如果 Studio 检测到模型的任何问题，层次面板或设置面板中会显示一个小指示器。

如果您在层次中看到警告图标，请展开层次，直到您到达特定子对象，以查看有关该问题的更多信息。警告和错误消息会在设置面板中显示或作为工具提示显示。

一个橙色的警告消息，说明有关笼不匹配的错误。 — 警告和错误消息在检查器面板的适当部分显示。

一个红色的错误消息，弹出消息关于缺失的纹理。 — 一些错误在悬停在错误图标上时显示工具提示。