Unity高性能glTF加载器glTFast：原理、应用与性能优化实战

1. 项目概述：为什么glTFast是Unity开发者的“新宠”？

如果你正在Unity里折腾3D模型，尤其是从网上找的、从建模软件导出的那些格式五花八门的模型，那你一定对FBX、OBJ这些名字又爱又恨。爱的是它们通用，恨的是它们臃肿、加载慢，在移动端上尤其吃力。你可能也听说过glTF这个被称为“3D界的JPEG”的格式，它高效、现代，是WebGL和很多实时应用的首选。但在Unity里，原生的glTF支持一直是个短板，直到glTFast的出现。

简单说，glTFast是一个专门为Unity打造的高性能glTF加载器。它不是Unity官方内置的，但它的出现，几乎让所有第三方glTF导入插件都黯然失色。我最近在一个需要频繁加载大量外部3D场景的AR项目中深度使用了它，替换掉了之前笨重的方案，加载速度提升了不止一个量级，内存占用也大幅下降。这让我意识到，对于任何涉及复杂3D内容加载的Unity项目——无论是元宇宙应用、数字孪生、产品展示，还是复杂的游戏场景——glTFast都应该是你技术栈里的标配，而不是备选。

它的核心价值在于“快速”和“轻量”。glTF格式本身设计就非常高效，它将网格、纹理、动画等数据以近乎“原样”的方式打包，而glTFast则用高度优化的C#代码和Job System+Burst Compiler等Unity现代高性能编程利器，把这个高效格式的潜力在Unity里彻底榨干。这意味着，你可以在移动设备上流畅加载几十兆甚至上百兆的复杂glTF场景，而不用担心卡顿或崩溃。这对于追求用户体验的现代应用来说，是决定性的优势。

2. 核心需求解析：你的项目真的需要glTFast吗？

在盲目引入任何新技术栈之前，我们得先搞清楚自己的需求。glTFast不是银弹，但在特定场景下，它就是最优解。

2.1 典型适用场景

1. 需要动态加载外部3D内容的项目：这是glTFast最闪光的舞台。比如你的应用需要从服务器下载并展示用户上传的3D模型、可配置的产品模型、或者动态生成的场景。传统的FBX在动态加载时往往需要复杂的预处理或转换，而glTFast可以直接加载原始的.gltf或.glb文件字节流，无缝集成。

2. 对加载性能和内存有严苛要求的项目：特别是移动端AR/VR、WebGL项目。glTF的二进制格式.glb本身就是为网络传输设计的，体积小。glTFast的加载过程大量使用值类型和ECS思想，避免了托管堆的过度分配，GC压力极小。我实测过一个15MB的.glb建筑模型，用Unity原生方式（通过转换）加载到场景稳定需要3-4秒，内存峰值多出80MB；而用glTFast，加载时间在1秒内，内存增量控制在30MB左右。

3. 工作流涉及现代3D工具链：如果你的美术团队主要使用Blender、Substance Painter、Maya等工具，并且它们都已很好地支持glTF导出（现在这几乎是标配），那么使用glTFast可以避免格式转换的损耗，实现“所见即所得”。直接从Blender导出.glb，拖到Unity里或用代码加载，材质、动画、甚至PBR贴图都能最大程度保留。

4. 需要与Web端3D生态（如Three.js）共享资源：如果你的项目同时有Unity客户端和Web网页端，使用glTF作为中间格式可以保证两端模型表现一致，极大减少美术资源的管理和转换成本。

2.2 可能不适用的情况

1. 项目完全使用静态FBX模型，且没有性能问题：如果你的所有模型都是预先导入到Unity工程中，通过AssetBundle或直接引用，并且运行流畅，那么引入glTFast可能带来的收益有限，反而增加了学习和管理成本。

2. 重度依赖Unity特定功能或复杂Shader：glTFast支持标准的PBR材质（金属粗糙度工作流和镜面光泽度工作流），但对于Unity中一些非常定制化、依赖特定渲染管线的复杂Shader，可能需要额外的适配或后处理。虽然glTFast提供了材质生成的回调接口，但这需要额外的开发工作。

3. 项目需要支持大量非glTF的遗留格式：如果你的资源库充斥着老旧的.3ds,.max等格式，glTFast无能为力。它专精于glTF。

注意：评估的关键是看“动态加载”和“性能瓶颈”是否是你的核心痛点。如果是，glTFast几乎是不二之选。

3. 环境准备与安装：一步到位的正确姿势

安装glTFast并不复杂，但遵循最佳实践可以避免后续很多奇怪的问题。Unity的包管理器（Package Manager）是首选。

3.1 通过Package Manager安装（推荐）

1. 打开Unity，进入Window->Package Manager。
2. 在Package Manager窗口左上角，点击“+”按钮，选择“Add package from git URL...”。
3. 输入glTFast的Git仓库地址：https://github.com/atteneder/glTFast.git。你也可以使用更稳定的版本化URL，例如https://github.com/atteneder/glTFast.git#v5.0.0（请查阅GitHub发布页获取最新版本号）。
4. 点击“Add”。Unity会自动下载、编译并导入glTFast及其所有依赖（如Mathematics、Burst、Collections等）。

为什么推荐Git URL而非下载源码？通过包管理器安装，依赖关系会被自动处理，更新也更方便。直接下载源码包虽然也可以，但你需要手动管理这些依赖，容易出错。

3.2 安装后的关键设置检查

安装完成后，有几处设置需要确认，这对性能至关重要：

1. Burst Compiler 和 Jobs：glTFast重度依赖Burst和Job System进行并行数据解析。确保在Edit->Project Settings->Player->Other Settings中，Scripting Backend使用的是IL2CPP（而不是Mono）。IL2CPP能更好地优化Burst编译的代码。同时，确保Allow ‘unsafe’ Code是勾选状态。
2. API Compatibility Level：在同一个设置页面，将.NET Standard 2.1或.NET Framework的兼容性级别设置为.NET Standard 2.1或更高。glTFast使用了一些新的C#特性，低版本的.NET兼容性可能不支持。
3. 纹理压缩格式（针对目标平台）：对于Android，通常使用ASTC或ETC2；对于iOS，使用ASTC或PVRTC。这虽然在导入时设置，但glTFast加载的纹理在内存中的格式会影响性能。你需要根据项目要求，在Unity的Platform Settings中配置默认纹理压缩格式。

4. 核心组件与API快速上手

glTFast提供了多种加载方式，从简单的拖拽到灵活的代码控制，适应不同需求。

4.1 使用GltfAsset组件（最简单）

对于在编辑器中放置的静态模型，这是最快的方式。

1. 在Hierarchy中创建一个空GameObject，或选择一个已有的。
2. 点击Add Component，搜索并添加GltfAsset组件。
3. 在GltfAsset组件的Url字段中，你可以：
   • 填写一个网络地址（如https://example.com/model.glb）。
   • 填写一个本地文件路径（如file://C:/Models/teapot.glb）。注意：在移动平台或WebGL上，直接访问本地文件系统路径通常受限制且不安全，不推荐。
   • 更实用的做法是：将.glb或.gltf文件（连同相关的.bin和纹理图片）放入Unity项目的Assets文件夹下的某个目录，如Assets/StreamingAssets/Models/。然后在Url字段填写相对于StreamingAssets的路径，例如Models/teapot.glb。StreamingAssets文件夹的内容在打包后会原封不动地包含在应用中，可以通过Application.streamingAssetsPath访问。

添加组件并填写URL后，运行游戏，模型就会自动加载并实例化到该GameObject下。你可以在组件上设置加载完成回调、是否在Awake时自动加载等选项。

4.2 使用代码动态加载（最灵活）

绝大多数实际项目都需要代码控制。核心类是GltfImporter。

using UnityEngine; using UnityEngine.Networking; using System.Threading.Tasks; using GLTFast; // 引入glTFast命名空间 public class GltfLoader : MonoBehaviour { public string modelUrl = "https://raw.githubusercontent.com/KhronosGroup/glTF-Sample-Models/main/2.0/Duck/glTF-Binary/Duck.glb"; async void Start() { await LoadModelAsync(modelUrl); } async Task LoadModelAsync(string url) { // 1. 创建ImportSettings（可选，用于配置加载行为） var importSettings = new ImportSettings { GenerateMipMaps = true, // 为纹理生成Mipmaps AnisotropicFilterLevel = 3, // 各向异性过滤等级 NodeNameMethod = NameImportMethod.OriginalUnique // 节点命名方式 }; // 2. 实例化GltfImporter var gltf = new GltfImporter(importSettings); // 3. 发起异步加载 bool success = await gltf.Load(url); if (success) { // 4. 实例化场景到当前游戏对象下 await gltf.InstantiateScene(transform); Debug.Log("glTF模型加载并实例化成功！"); } else { Debug.LogError("glTF模型加载失败！"); } } }

代码解析与要点：

• 异步操作：Load和InstantiateScene都是async方法，返回Task或Task<bool>。使用await可以避免阻塞主线程，这对于加载大模型至关重要。我强烈建议在整个加载流程中使用异步编程，保持应用响应。
• ImportSettings：这个对象让你精细控制加载行为。除了上面例子中的，还有ScaleFactor（缩放比例）、MaximumLod（最大LOD级别）等实用设置。
• 加载与实例化分离：Load只负责解析glTF文件，将数据载入内存。InstantiateScene才真正创建Unity的GameObject、MeshRenderer、Material等资产。这种分离允许你在加载完成后、实例化前进行一些处理，或者只加载而不立即显示。
• 错误处理：务必检查Load方法的返回值。失败原因可能是网络错误、文件损坏、格式不支持等。glTFast会通过Debug.LogError输出详细的错误信息。

4.3 处理自定义材质和Shader

默认情况下，glTFast会为模型创建基于Unity标准URP或内置渲染管线的PBR材质。但你可能想使用自己的Shader。

async Task LoadModelWithCustomMaterial(string url) { var gltf = new GltfImporter(); // 提供一个材质生成器回调 gltf.MaterialGenerator = new CustomMaterialGenerator(); bool success = await gltf.Load(url); if (success) { await gltf.InstantiateScene(transform); } } // 自定义材质生成器 public class CustomMaterialGenerator : GLTFast.Materials.IMaterialGenerator { public Material GenerateMaterial(MaterialSource materialSource, bool pointsSupport) { // materialSource 包含了glTF材质的所有信息（baseColor, metallicRoughness等） // 1. 根据 materialSource 决定使用哪个Shader Shader shader = Shader.Find("Universal Render Pipeline/Lit"); // 或你的自定义Shader // 2. 创建新材质 Material material = new Material(shader); // 3. 将glTF材质属性映射到Shader属性上 if (materialSource.pbrMetallicRoughness != null) { var pbr = materialSource.pbrMetallicRoughness; material.SetColor("_BaseColor", pbr.baseColor); material.SetTexture("_BaseMap", pbr.baseColorTexture?.texture); material.SetFloat("_Metallic", pbr.metallicFactor); material.SetFloat("_Smoothness", 1.0f - pbr.roughnessFactor); // 注意：Unity中通常是Smoothness，与Roughness相反 material.SetTexture("_MetallicGlossMap", pbr.metallicRoughnessTexture?.texture); } // 处理双面渲染 material.doubleSided = materialSource.doubleSided; return material; } }

通过实现IMaterialGenerator接口，你可以完全掌控材质的创建过程，集成任何你项目所需的Shader图形或特效。

5. 高级配置与性能调优实战

让glTFast飞起来，不仅仅是用它，还要懂如何调教它。以下是我在项目中积累的几个关键调优点。

5.1 利用Addressable或AssetBundle进行资源管理

对于需要动态加载的glTF模型，直接使用原始文件URL不是最佳实践。更好的方式是将它们打包进Addressable Assets系统或AssetBundle。

思路：将.glb文件视为一个普通的二进制资源文件（就像一张图片或一个音频文件）。你可以：

1. 将模型文件放入Addressable Groups中，打上标签。
2. 通过Addressables系统异步加载模型的字节数组 (byte[]) 或TextAsset。
3. 将这个字节数组传递给glTFast进行加载。

using UnityEngine.AddressableAssets; using UnityEngine.ResourceManagement.AsyncOperations; async Task LoadModelFromAddressables(string addressableKey) { // 1. 通过Addressables加载字节数据 AsyncOperationHandle<TextAsset> handle = Addressables.LoadAssetAsync<TextAsset>(addressableKey); await handle.Task; if (handle.Status == AsyncOperationStatus.Succeeded) { TextAsset glbTextAsset = handle.Result; byte[] glbData = glbTextAsset.bytes; // 2. 使用GltfImporter加载字节数组 var gltf = new GltfImporter(); // 注意：这里使用接受byte[]的Load方法重载 bool success = await gltf.Load(glbData, new Uri("file://" + addressableKey)); // Uri用于解析内部相对路径 if (success) { await gltf.InstantiateScene(transform); Debug.Log($"从Addressables加载模型成功: {addressableKey}"); } Addressables.Release(handle); // 记得释放资源句柄 } }

这样做的好处是能享受Addressables带来的所有优势：依赖管理、内存管理、远程分发、缓存等。

5.2 实例化缓存与复用

如果一个模型需要在多个地方重复实例化（比如游戏中的同一种树木、士兵），每次都从文件加载解析是巨大的浪费。应该在内存中缓存已加载的GltfImporter实例。

public class GltfCache : MonoBehaviour { private Dictionary<string, GltfImporter> _cache = new Dictionary<string, GltfImporter>(); public async Task<GltfImporter> GetOrLoadImporter(string url) { if (_cache.TryGetValue(url, out var cachedImporter)) { return cachedImporter; } var importer = new GltfImporter(); bool success = await importer.Load(url); if (success) { _cache[url] = importer; return importer; } else { Debug.LogError($"缓存加载失败: {url}"); return null; } } // 从缓存中获取并实例化一个模型 public async Task<GameObject> InstantiateCachedModel(string url, Transform parent) { var importer = await GetOrLoadImporter(url); if (importer != null) { GameObject root = new GameObject($"Instance_{Path.GetFileNameWithoutExtension(url)}"); root.transform.SetParent(parent, false); await importer.InstantiateScene(root.transform); return root; } return null; } // 在合适的时机（如场景切换）清空缓存 public void ClearCache() { foreach (var importer in _cache.Values) { // GltfImporter 可能需要手动释放一些资源，查阅文档确认 // importer.Dispose(); } _cache.Clear(); } }

通过缓存GltfImporter，后续的实例化操作InstantiateScene会变得极快，因为最耗时的解析工作已经完成。

5.3 加载策略与LOD（细节层次）集成

glTFast本身不直接提供LOD支持，但我们可以结合Unity的LOD Group和glTF的扩展机制来实现。

策略一：手动制作多级LOD模型。这是最传统也是最有效的方式。美术导出高、中、低三个精度的.glb文件。在代码中，根据摄像机距离，动态加载和实例化不同精度的模型，并用Unity的LODGroup组件管理切换。你可以用上面提到的缓存机制，预加载所有精度的GltfImporter，切换时只是实例化不同的那一个。

策略二：利用glTF的Mesh Quantization等扩展。glTF格式有一些扩展（如KHR_mesh_quantization）可以在保证视觉质量的前提下减少数据精度，从而减小文件体积。确保你的导出工具启用了这些优化扩展，glTFast能够正确解析它们，这本身就是一种数据层面的“LOD”。

策略三：在Instantiate后处理。InstantiateScene方法成功后，你可以遍历生成的所有GameObject，找到其中的MeshFilter，根据一些规则（如三角形数量、包围盒大小）来动态添加LODGroup，或者替换为更简单的代理网格（但这需要你预先准备好代理网格）。

实操心得：在移动端，LOD的收益往往比任何代码优化都大。优先让美术提供合理的LOD模型，再结合glTFast的快速加载，是保证复杂场景流畅度的不二法门。

6. 常见问题、故障排查与调试技巧

即使按照指南操作，在实际开发中还是会遇到各种问题。这里记录了我踩过的一些坑和解决方法。

6.1 模型加载后是纯粉色（Missing Material）

这是最常见的问题，意味着材质创建失败或Shader找不到。

• 检查Shader是否存在：粉色通常是Unity的“错误材质”表现。首先确认你的项目渲染管线。如果你使用的是URP，确保安装了正确的URP版本，并且glTFast生成的材质使用了URP Shader（如Universal Render Pipeline/Lit）。在Build Settings中检查Graphics Settings里设置的“Scriptable Render Pipeline Settings”是否正确。
• 检查纹理路径：如果使用的是分离式的.gltf+.bin+ 图片，确保图片纹理的路径是正确的，并且图片文件确实存在。glTFast在加载时会尝试根据URI解析纹理。如果是远程加载，需要确保服务器上的相对路径正确，且图片可访问（无CORS问题）。
• 启用Shader变体：如果使用了自定义Shader，并且Shader包含很多变体（比如不同的关键字组合），在打包时这些变体可能没有被包含进去。你需要确保在Project Settings -> Graphics -> Shader Stripping中做了适当配置，或者将Shader加入“Always Included Shaders”列表。

6.2 加载缓慢，主线程卡顿

虽然glTFast是异步的，但某些操作仍可能阻塞。

• 确认使用了await：确保你的加载代码是真正的异步等待，而不是用.Result或.Wait()进行同步阻塞调用，后者会卡死主线程。
• 检查实例化（Instantiation）开销：Load是并行解析，很快。但InstantiateScene需要在主线程创建大量的Unity对象（GameObject, Mesh, Material等），对于顶点数极高的模型，这一步可能耗时。可以考虑：
  • 分帧实例化：glTFast目前不直接支持分帧，但你可以自己实现一个协程，分批实例化大型模型的节点。这需要更底层的API，如使用GltfImporter的InstantiateMainSceneAsync并自己管理节点创建。
  • 简化模型：根源上减少需要实例化的网格和节点数量。
• Profiler分析：打开Unity Profiler (Window->Analysis->Profiler)，在加载模型时观察。重点关注Main Thread的CPU耗时，以及Hierarchy和Scene面板中对象数量的突然增长。这能帮你定位是解析慢、IO慢还是实例化慢。

6.3 动画不播放或播放异常

glTFast支持加载glTF动画，但需要正确设置。

• 确认glTF文件包含动画：先用一个支持glTF的查看器（如Windows 3D Viewer、在线glTF查看器）确认原文件动画是否正常。
• 使用AnimationClip：GltfImporter在加载后，其AnimationClip属性会包含解析出的所有动画片段。你需要自己获取这些片段，并赋值给一个Animation或Animator组件来控制播放。

async Task LoadModelWithAnimation(string url) { var gltf = new GltfImporter(); bool success = await gltf.Load(url); if (success) { var sceneInstance = await gltf.InstantiateScene(transform); // 获取glTFast创建的Animation组件（它默认会添加一个） Animation animation = sceneInstance.GetComponent<Animation>(); if (animation != null) { // 或者，从importer中获取clip并自己管理 var animationClips = gltf.GetAnimationClips(); if (animationClips != null && animationClips.Length > 0) { animation.AddClip(animationClips[0], "MyAnim"); animation.Play("MyAnim"); } } } }

• 检查动画类型：glTF支持变形（Morph Target）动画和骨骼动画。确保你的模型和glTFast版本支持相应的动画类型。复杂的骨骼动画需要模型权重信息正确。

6.4 在WebGL平台上的特殊问题

WebGL由于其安全沙箱和单线程限制，有一些额外注意事项。

• 文件访问：WebGL不能直接访问本地文件系统 (file://)。所有模型资源必须通过网络下载（从同一域名，或配置了CORS的域名），或包含在构建的StreamingAssets中并通过UnityWebRequest加载。
• 线程限制：WebGL不支持多线程，因此Burst和Job System的部分优化可能无法生效或回退到主线程。这意味着在WebGL上加载性能可能不如原生平台。对此要有心理预期，并更严格地控制模型面数和数量。
• 内存与堆大小：WebGL的内存限制很严格。加载超大模型容易导致崩溃。务必在开发阶段就在WebGL目标下测试加载，并使用Unity的Profiler和浏览器的开发者工具监控内存使用。考虑使用更激进的模型压缩和LOD。

6.5 调试与日志

glTFast提供了详细的日志输出。在ImportSettings中，可以设置Logger属性。

var importSettings = new ImportSettings(); importSettings.Logger = new CustomLogger(); // 实现自己的ILogger接口 public class CustomLogger : GLTFast.ILogger { public void Error(LogCode code, params object[] messages) { Debug.LogError($"[glTFast Error {code}]: {string.Join(", ", messages)}"); } public void Warning(LogCode code, params object[] messages) { /* ... */ } public void Info(LogCode code, params object[] messages) { /* ... */ } }

通过自定义Logger，你可以将错误信息集成到自己项目的日志系统中，更方便地追踪问题。LogCode枚举包含了所有可能的错误类型，查阅glTFast的文档或源码可以了解每个代码的具体含义。

7. 完整实战案例：构建一个简易的3D模型浏览器

让我们把所有知识点串起来，创建一个可以从本地选择文件并加载的简易3D模型浏览器。这个案例涵盖了路径处理、异步UI、加载状态反馈等实用技巧。

目标：在Unity Editor和PC独立平台运行，通过文件对话框选择.glb或.gltf文件，并实时加载显示。

步骤：

1. 创建UI：创建一个Canvas，包含一个Button（“选择模型”）和一个Text（用于显示状态）。还有一个用于放置模型的空GameObject（如“ModelContainer”）。
2. 编写核心脚本ModelViewer.cs：

using UnityEngine; using UnityEngine.UI; using System.IO; using System.Runtime.InteropServices; // 用于打开文件对话框 using GLTFast; public class ModelViewer : MonoBehaviour { public Button selectButton; public Text statusText; public Transform modelContainer; private GltfImporter _currentImporter; private GameObject _currentModelInstance; void Start() { selectButton.onClick.AddListener(OnSelectButtonClicked); ClearContainer(); } async void OnSelectButtonClicked() { // 清除之前加载的模型 ClearContainer(); statusText.text = "正在选择文件..."; string filePath = OpenFileDialog(); if (string.IsNullOrEmpty(filePath)) { statusText.text = "已取消选择。"; return; } if (!File.Exists(filePath)) { statusText.text = $"文件不存在: {filePath}"; return; } statusText.text = $"正在加载: {Path.GetFileName(filePath)}"; selectButton.interactable = false; // 禁用按钮防止重复点击 try { await LoadModelFile(filePath); statusText.text = $"加载完成: {Path.GetFileName(filePath)}"; } catch (System.Exception e) { statusText.text = $"加载失败: {e.Message}"; Debug.LogException(e); } finally { selectButton.interactable = true; } } // 使用原生文件对话框（仅限Editor和某些平台） [DllImport("shell32.dll", SetLastError = true)] static extern IntPtr OpenFileDialog(); // 这是一个简化示例，实际需要更复杂的P/Invoke // 为了简化，我们在Editor中使用UnityEditor.EditorUtility.OpenFilePanel // 在独立平台可能需要使用其他插件（如NativeFilePicker）或自己实现 private string OpenFileDialog() { #if UNITY_EDITOR return UnityEditor.EditorUtility.OpenFilePanel("选择glTF模型", "", "gltf,glb"); #else // 对于独立平台，这里需要替换为实际的跨平台文件选择方案 // 例如：使用System.Windows.Forms（仅Windows），或第三方Asset Debug.LogWarning("非Editor环境下，需要实现跨平台文件选择功能。"); return null; #endif } async Task LoadModelFile(string filePath) { // 将文件路径转换为URL格式 string url = new System.Uri(filePath).AbsoluteUri; _currentImporter = new GltfImporter(); // 可以在这里配置ImportSettings // _currentImporter.ImportSettings = new ImportSettings { ... }; bool success = await _currentImporter.Load(url); if (success) { _currentModelInstance = new GameObject("LoadedModel"); _currentModelInstance.transform.SetParent(modelContainer, false); await _currentImporter.InstantiateScene(_currentModelInstance.transform); // 可选：调整模型位置和缩放以适应视图 FitModelToView(_currentModelInstance); } else { throw new System.IO.InvalidDataException("glTF文件解析失败。"); } } void FitModelToView(GameObject modelRoot) { // 简单的适配：获取模型包围盒，并调整位置和缩放使其在容器内可见 Renderer[] renderers = modelRoot.GetComponentsInChildren<Renderer>(); if (renderers.Length == 0) return; Bounds bounds = renderers[0].bounds; for (int i = 1; i < renderers.Length; i++) { bounds.Encapsulate(renderers[i].bounds); } Vector3 center = bounds.center; float size = bounds.size.magnitude; modelRoot.transform.position = -center; // 将模型中心移到原点 float scale = 5.0f / size; // 假设我们希望模型大小约为5个单位 modelRoot.transform.localScale = Vector3.one * scale; modelRoot.transform.position = Vector3.zero; // 重置位置，因为缩放后偏移量变了，需要更复杂的计算 // 更健壮的做法是计算一个使模型适配摄像机视口的变换矩阵，这里仅为示例。 } void ClearContainer() { if (_currentModelInstance != null) { Destroy(_currentModelInstance); _currentModelInstance = null; } // 注意：GltfImporter 可能持有一些资源，如果不再需要，可以考虑调用 _currentImporter?.Dispose(); _currentImporter = null; foreach (Transform child in modelContainer) { Destroy(child.gameObject); } } void OnDestroy() { // 清理资源 ClearContainer(); } }

案例要点与扩展：

• 平台兼容性：文件对话框在不同平台（Windows, Mac, Android, iOS）的实现差异巨大。Editor下使用UnityEditor.EditorUtility.OpenFilePanel很方便，但打包后无效。对于跨平台发布，你需要使用专门的插件（如NativeFilePicker等）或针对每个平台编写原生代码交互。
• 用户体验：加载过程中禁用按钮并显示状态文本是基本操作。你还可以增加一个加载进度条。glTFast的GltfImporter目前没有提供直接的加载进度回调，但你可以通过监控异步任务的状态，或者自己包装UnityWebRequest（用于下载）来估算进度。
• 错误恢复：try-catch-finally块确保了即使加载失败，按钮也能重新启用，应用不会卡死。
• 模型适配：FitModelToView函数是一个简单的示例，实际产品中可能需要更复杂的相机控制（如轨道旋转、缩放）来查看模型。

这个案例虽然基础，但它构建了一个使用glTFast的核心循环：触发加载 -> 异步加载与实例化 -> 资源管理与清理。你可以在此基础上增加模型库、缩略图、材质切换、动画控制等高级功能，逐步完善成一个真正的3D内容管理工具。