导入器 | 文档 - 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	如果启用，导入器将模型添加到您的工具箱和资产管理器库中，作为新资产。默认情况下，此设置为启用。如果禁用，资产将保留在您的工作区本地，并且不会分配资产 ID。这对于在将模型集成到您的项目之前进行测试和迭代是理想的。
作为包导入	将资产添加到工作区作为包，这种自动更新、可扩展和可共享的格式建议用于重复使用或常见重新分发的资产。默认情况下，此设置为禁用。
创建者	设置资产的创建者或创建者组。
添加到工作区	如果启用，导入器将模型插入到 Workspace 中。如果从已保存或发布的体验导入，此设置还授予体验使用受限资产的权限。默认情况下，此设置为启用。如果禁用，此设置仅将模型添加到您的库，而不授予体验使用该资产的权限。
使用场景位置插入	如果启用，导入器将在将模型插入工作区时使用当前场景位置。默认情况下，此设置为禁用。
保留零影响骨骼	如果启用，导入器将保留对网格没有影响的骨骼。默认情况下，此设置为禁用。如果禁用，导入器将移除零影响骨骼。
将支点设置为场景原点	如果启用，导入器将整个模型的支点设置为场景原点。默认情况下，此设置为启用。
固定	如果启用，导入器将在所有导入的 MeshParts 上将 Anchored 属性设置为 true。对于具有绑定数据/头像的网格，此设置为禁用。默认情况下，此设置为禁用。
使用笼子	如果启用，导入器将在模型中查找笼子网格并将其转换为 WrapInstance 对象，例如 WrapLayer 或 WrapTarget。如果禁用，导入器将其视为常规网格。如果导入器最初在模型中检测到笼子网格，此设置默认为启用。

绑定通用

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

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

文件变换

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

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

文件几何

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

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

对象通用

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

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

对象几何

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

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

预设

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

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

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

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

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

警告和错误

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

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

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

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