匯入器允許您將 3D 模型、圖像、聲音和視頻文件匯入到 Studio 中。3D 模型匯入支持帶有 PBR 紋理的網格、帶有綁定、蒙皮和動畫數據的網格，以及設計為虛擬角色物品的網格。
將一般 3D 自訂模型匯入到 Studio 中。
使用匯入器匯入帶有虛擬角色物品組件的資產。
要匯入資產：
- 從 Studio 的 檔案 菜單中，選擇 匯入。
- 在檔案瀏覽器中，選擇您打算匯入的 支援的檔案類型。
- 配置您的匯入設置並驗證任何 警告或錯誤消息。
- 點擊 匯入。
- 匯入後，您可以 右鍵單擊 匯入器中的資產並執行以下操作：
- 複製資產 ID - 將上傳的資產 ID 複製到您的剪貼板。對於模型，這會複製 Model 的資產 ID。
- 在工作區中查找（僅限 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 格式的視頻資產。 |
glTF 匯入層次結構
.gltf 和 .glb 文件的匯入層次結構與 .fbx 文件不同。以下表格比較在匯入相同的網格時，每種格式中籠網格的顯示情況。
| .fbx | .gltf / .glb | |
|---|---|---|
| 顶层 | 一個 Model。 | 一個 Model。 |
| 網格 | 一個直接位於頂層 Model 內的 MeshPart。 | 一個位於頂層 Model 內的 Model，包含每個 glTF 網格的 MeshPart。 |
| 籠網格 | 一個位於 MeshPart 內的 WrapLayer。 | 一個位於 MeshPart 內的 WrapLayer，以及每個原始內部和外部籠節點的額外 Model。您可以在匯入後刪除這些額外的模型。 |
在 glTF 匯入中，如果一個節點及其網格具有相同的名稱，例如 Cover，則匯入器會在其中一個名稱後添加 _Node 後綴，例如 Cover_Node。
匯入佇列
如果您使用匯入器選擇了多個文件，您可以使用匯入佇列來批量管理您的各種匯入。
頂部欄 允許您添加新文件、清除佇列、搜索和篩選，以及匯入所有啟用的資產。
匯入佇列 列出所有添加的文件，並提供快速訪問下拉菜單以更改創建者、預設和檔案路徑。
將文件添加到佇列
要打開檔案瀏覽器並將其他文件添加到匯入佇列，您可以：
- 點擊匯入佇列窗口頂部欄中的 添加文件 按鈕。
- 從 Studio 的 檔案 菜單中，選擇 匯入。
從佇列中刪除文件
要從佇列中刪除所有文件，請點擊帶有掃帚圖標的 清除佇列 按鈕。要從佇列中刪除單個文件，請右鍵單擊佇列中的項目並選擇 從佇列中刪除。
應用預設設置
使用 匯入預設 列來選擇要應用於您的資產的預設配置。欲了解更多信息，請參見 預設。
您還可以通過右鍵單擊具有所需設置的項目並選擇 將設置應用於所有 來將一個項目的設置應用於所有項目。
訪問單個預覽和設置
如果您正在匯入 3D 模型，請單擊未匯入模型的單個 資產 名稱以訪問該項目的 匯入預覽。使用匯入預覽查看和檢查您的模型，以及設置任何單獨的 匯入設置。
匯入文件
確保您要匯入的每個項目在第一列中都有啟用的復選框。默認情況下，如果它們可以匯入，則所有項目都會被選中。
按下 匯入 按鈕以開始匯入過程。
匯入預覽（模型）
如果您正在匯入單個模型文件，或者如果您從匯入佇列中選擇了單個資產，則會顯示匯入預覽窗口。此預覽窗口為模型中的各種物件提供單獨的控制。
預覽窗口分為多個部分：
您的模型文件的 檔案路徑。點擊 瀏覽 以編輯。
應用於您的匯入的 預設。使用下拉菜單選擇多個預設，或使用漢堡菜單設置新預設。
您模型的 3D 預覽。使用鼠標按鈕和右上角的圖標進行各種相機選項和視圖。
匯入物件的 物件層次結構。包括網格物件和其他支援的組件。
您匯入的 匯入設置。有關設置的完整列表，請參見 匯入設置。
匯入設置
根據層次面板中選擇的物件，檢查器面板顯示以下設置組：
- 檔案一般：影響整個匯入的檔案。
- 綁定一般：如果存在綁定數據，則影響所選的網格物件。
- 檔案變換：影響匯入檔案的變換屬性。
- 檔案幾何：影響匯入檔案的幾何屬性。
- 物件一般：影響所選的子物件。
- 物件幾何：影響所選子物件的幾何。
檔案一般
匯入器為所有網格提供以下設置：
| 設置 | 描述 |
|---|---|
| 名稱 | 設置匯入資產的名稱，顯示在您的項目中。 |
| 僅作為模型匯入 | 如果啟用，匯入器將模型作為單個資產匯入，即使模型包含多個子項目。默認情況下，這是 啟用 的。 如果禁用，匯入器將模型及所有子項目（例如多個網格）作為單獨的資產匯入。 |
| 上傳到 Roblox | 如果啟用，匯入器將模型添加到您的 工具箱 和 資產管理器 庫中，作為新資產。默認情況下，這是 啟用 的。 如果禁用，匯入器不會將模型添加到您的庫中以供以後使用。這在您想要測試和迭代模型設計而不在工具箱和資產管理器中創建多個副本時是理想的。 |
| 作為包裝匯入 | 將您的資產添加到工作區作為 包裝，這是一種自動更新、可擴展和可共享的格式，建議用於重複使用或常見重新分發的資產。默認情況下，這是 禁用 的。 |
| 創建者 | 設置資產的創建者或創建者組。 |
| 添加到工作區 | 如果啟用，匯入器將模型插入到 Workspace 中。如果從已保存或已發佈的遊戲匯入，則此設置還授予遊戲使用受限資產的權限。默認情況下，這是 啟用 的。 如果禁用，則此設置僅將模型添加到您的庫中，並且不會授予遊戲使用該資產的權限。 |
| 使用場景位置插入 | 如果啟用，匯入器在將模型插入工作區時使用當前場景位置。默認情況下，這是 禁用 的。 |
| 保留零影響骨骼 | 如果啟用，匯入器保留不影響網格的骨骼。默認情況下，這是 禁用 的。 如果禁用，匯入器將刪除零影響骨骼。 |
| 將樞紐設置為場景原點 | 如果啟用，匯入器將整個模型的樞紐點設置為場景原點。默認情況下，這是 啟用 的。 |
| 固定 | 如果啟用，匯入器將 Anchored 屬性設置為 true，適用於所有匯入的 MeshParts。對於具有綁定數據/虛擬角色的網格，這是禁用的。默認情況下，這是 禁用 的。 |
| 使用籠 | 如果啟用，匯入器會在模型中查找籠網格並將其轉換為 WrapInstance 物件，例如 WrapLayer 或 WrapTarget。如果禁用，匯入器將其視為常規網格。如果匯入器最初在模型中檢測到籠網格，則默認情況下這是 啟用 的。 |
綁定一般
匯入器為具有綁定數據的網格提供以下設置，通常是角色身體或服裝配件：
| 設置 | 描述 |
|---|---|
| 綁定類型 | 設置網格應該與之關聯的綁定類型。選項為： - R15 - 自訂 - 無綁定 默認情況下，匯入器會根據檢測到的網格的綁定和蒙皮數據嘗試選擇最合適的設置。 |
| 驗證 UGC 身體 | 匯入後，Studio 會在 虛擬角色設置 工具中打開資產，讓您快速開始測試和上傳虛擬角色資產到市場。 |
| 綁定比例 | 如果綁定類型設置為 R15，則匯入器提供額外選項以指定 身體類型縮放。選項為： - 默認 - Rthro - Rthro 窄 |
檔案變換
匯入器為所有網格提供以下設置：
| 設置 | 描述 |
|---|---|
| 世界前方 | 設置物件的前方面向軸。默認情況下，這設置為 前方。 |
| 世界向上 | 設置物件的向上面向軸。默認情況下，這設置為 上方。 |
檔案幾何
檔案幾何包括有關整個模型的檔案尺寸和多邊形數的信息。您可以編輯所有網格的以下設置：
| 設置 | 描述 |
|---|---|
| 縮放單位 | 設置檔案建模所使用的單位，以便在匯入時適當調整大小。默認情況下，這設置為 Studs。 |
| 合併網格 | 如果啟用，將模型中的所有 MeshParts 合併為單個 MeshPart，並創建一個 MeshPart 而不是模型。默認情況下，這是 禁用 的。 |
| 反轉負面面 | 反轉網格中負面面的方向。默認情況下，這是 禁用 的。 |
物件一般
當選擇網格的特定子物件時，匯入器會填充物件一般設置。您可以編輯所選子物件的以下設置：
| 設置 | 描述 |
|---|---|
| 名稱 | 設置模型中所選子物件的名稱。 |
| 固定 | 如果啟用，將所選子物件的 Anchored 屬性設置為 true。默認情況下，這是 禁用 的。 |
| 使用匯入的樞紐 | 如果啟用，使用子物件中設置的樞紐點匯入物件。默認情況下，這是 啟用 的。 |
物件幾何
物件幾何包括有關所選子物件的尺寸和多邊形數的信息。您可以編輯所選子物件的以下設置：
| 設置 | 描述 |
|---|---|
| 設置為雙面 | 如果禁用，將頂點設置為單面。單面頂點意味著您可以從一側看透它們。 如果啟用，將頂點設置為雙面。雙面頂點在兩側都可視渲染。雙面渲染對性能的影響更大。 默認情況下，這是 禁用 的。 |
| 忽略頂點顏色 | 如果啟用，忽略子物件中的頂點顏色數據。默認情況下，這是 禁用 的。 |
預設
您可以保存各種匯入設置的預設，以便稍後在 匯入預覽 或 匯入佇列 中快速應用。
默認情況下，您可以在兩個預設之間進行選擇：
- Studio 默認：默認的匯入行為。
- 最後匯入：使用應用於最近匯入的設置。
您可以使用預設下拉菜單旁邊的 ⋯ 菜單來獲取其他選項：
- 重置所有：移除當前配置的任何更改，將設置恢復到當前預設的默認狀態。
- 保存選擇：允許您將任何新更改保存到當前選定的預設中。
- 另存為新：將當前設置設置為新預設。顯示對話框以允許您設置名稱。
- 設置為默認：將當前預設設置為所有未來匯入的默認值。
- 重命名：重命名當前預設。
- 刪除：刪除當前預設。重置為 Studio Default 預設。
警告和錯誤
如果 Studio 檢測到您的模型存在任何問題，則在層次面板或設置面板中會顯示小指示器。
如果您在層次中看到警告圖標，請展開層次，直到到達特定子物件，以查看有關問題的更多信息。警告和錯誤消息會在設置面板中顯示或作為工具提示顯示。
