允许您在运行时和编辑器中导入和导出 glTF 文件。 glTF 是一种新的开源 3D 模型传输格式，它支持 Unity 格式所需的一切。在此处阅读有关 glTF 的更多信息

GLTFUtility 专注于简单性和易用性，旨在成为一种导入后忘记的解决方案，与内置功能保持一致。

重要通知

系统

• 编辑器导入
• 编辑器导出
• 运行时导入 API
• 运行时导出 API
• GLTF 格式
• GLB 格式
• 多线程
• URP #75
• HDRP #73
• LWRP

规范

• 静态网格体（带子网格体）
• UV（最多 8 个通道）
• 法线
• 切线
• 顶点颜色
• 材质（金属/镜面反射、不透明/遮罩/混合）
• 纹理（嵌入/外部）
• 远程纹理（仅在异步期间）
• 钻机
• 头像/面具 #70
• 动画（多个）
• 变形目标（带有实验名称）
• 相机

扩展

• KHR_texture_transform（部分支持）
• KHR_materials_pbrSpecularGlossiness
• KHR_lights_punctual #25
• KHR_draco_mesh_compression #27 警告：据说会导致 WebGL 出现问题。
• KHR_mesh_quantization

• ArgumentNullException: Value cannot be null在构建中，但不在编辑器中。
  • 这很可能是由于着色器从构建中剥离。要解决此问题，请将 GLTFUtility 着色器添加到 图形设置（Graphic Settings） 中的 始终包含的着色器（Always Included Shaders） 列表中。
• Draco 压缩不适用于 iOS 和 UWP
  • 有关 #133 的更多信息

// Single thread
using Siccity.GLTFUtility;

void ImportGLTF(string filepath) {
   GameObject result = Importer.LoadFromFile(filepath);
}

// Multithreaded
using Siccity.GLTFUtility;

void ImportGLTFAsync(string filepath) {
   Importer.ImportGLTFAsync(filepath, new ImportSettings(), OnFinishAsync);
}

void OnFinishAsync(GameObject result, AnimationClip[] animations) {
   Debug.Log("Finished importing " + result.name);
}

若要确保 Unity 在构建中包含 GLTFUtility 着色器，必须将这些着色器添加到“始终包含的着色器”列表中。

1. 打开 编辑（Edit） -> 项目设置（Project Settings）
2. 打开图形
3. 滚动到始终包含的着色器
4. 在“大小”下，将值增加 4 并按 Enter。
5. 在 项目（Project） 面板中，导航到 包（Packages）/GLTFUtility/材质（Materials）/内置（Built-in）。
6. 此目录中有 4 个 .shader 文件。
7. 将 4 个文件中的每一个拖放到 Always Included Shaders 中新创建的 4 行之一。