投入使用前

GLB 压缩与查看器兼容性

文件扩展名为 GLB，并不意味着所有应用都能加载其内容。请检查输出使用的扩展，并在目标应用中测试。

让设置匹配你的加载器

这些要求可能同时存在。结果面板会显示输出的兼容性信息。本工具预览已配置解码器，预览成功并不代表你的应用也已配置它们。

预设默认使用几何量化。关闭后可消除几何量化的加载要求，但 Meshopt 压缩或转换后的纹理仍需要对应的加载器。请以实际结果报告的扩展为准。

使用 Three.js

加载 Meshopt 压缩的几何时，通过 GLTFLoader.setMeshoptDecoder() 注册解码器。使用 KTX2 纹理时，配置 KTX2Loader、检测渲染器支持情况，再通过 setKTX2Loader() 关联加载器。应用中还需提供匹配的转码器文件，并参照所用 Three.js 版本的文档。

GLTFLoader 文档 · KTX2Loader 文档

例一：原文件能打开，“更小文件”结果打不开

保留原纹理，将同一源文件分别用“保守优化”和“更小文件”导出。如果只有第二份在应用中失败，先对照结果扩展和加载器报错，不要急着修改减面参数。这样能缩小排查范围，但不能据此认定所有失败都是缺少解码器。

如果结果使用 EXT_meshopt_compression，Three.js 需要在加载前注册 MeshoptDecoder，再重试同一个输出文件。如果无法修改目标应用，可以关闭压缩重新导出，但下载体积可能增加。

例二：原纹理正常，换 KTX2 后在线上加载失败

固定几何设置，比较原纹理与 KTX2 两份输出。在 Three.js 应用中，确认已挂载 KTX2Loader 并调用 detectSupport，再查看 basis_transcoder.js 和 basis_transcoder.wasm 的请求。地址返回 404，或返回应用首页 HTML 时，应检查资源部署路径，而不是调整纹理质量。

修好加载器或资源路径后，重新加载同一份 KTX2 输出，并在目标手机上检查。本站预览正常，只能说明文件能在本站查看器中打开，生产应用仍要完成自己的加载配置。

名称、extras 与场景行为

三个保留选项默认开启。如果应用按名称查找对象或材质，或读取 extras，请保持开启。这些选项不保证节点索引、层级、动画采样或自定义属性完全不变；优化可能合并或重组数据，并改变精度。

请在实际应用中测试选择操作、材质切换、动画播放、变形目标及对象变换。“保留 extras”不能用于保留任意自定义扩展。

输入限制

本服务拒绝 Draco 压缩输入、外部资源及不支持的必需扩展。未知的可选扩展可能被丢弃。必要时，请从源应用导出未压缩、资源内嵌的 GLB。

引擎支持的扩展及优化行为，请参阅 gltfpack 上游文档。本网站还实施额外的校验和资源限制。

在 Three.js 中加载 gltfpack 模型 →