格式	材质	纹理	动画	文件大小	最佳用途
OBJ	✓ 基础	✓ 外链	❌ 不支持	中等	兼容性广
PLY	✓ 顶点色	❌ 不支持	❌ 不支持	小	点云/扫描
glTF	✓ 完整	✓ 完整	✓ 完整	中等	多文件保真
GLB	✓ 完整	✓ 完整	✓ 完整	优化	Web 发布

导出选择指南

选择 OBJ 适用于：

通用兼容 - 几乎所有 3D 软件都支持
基础材质 - 通过 MTL 保留部分材质信息
编辑交换 - 便于跨软件修改

保持为（优化）GLB 适用于：

Web 发布 - 使用 Draco 等优化
体积优化 - 纹理与几何同时优化
完整保真 - 保留材质/纹理/动画

选择 glTF 适用于：

多文件管线 - JSON + BIN 分离管理
引擎/平台对接 - 与部分平台的标准化流程更顺畅
资源复用 - 适合 CI/CD 与版本管理

如何导出 GLB（到其他格式）

桌面导出工作流

进入全屏模式

点击全屏按钮或按下 F11 进入全屏查看模式，获得完整工具栏。

访问导出工具

在全屏工具栏点击导出（下载图标）或使用快捷键 Ctrl+E。

选择导出格式

根据工作流选择：

OBJ - 兼容旧软件（带 MTL）
PLY - 点云/扫描等应用
优化 GLB - Web 发布
glTF - 多文件交换（JSON + BIN）

导出文件

点击导出开始处理。完成后浏览器会自动下载导出文件。

📱 移动端导出

在移动设备上访问导出

在全屏模式下，点击更多（⋮）→ 导出。

选择格式并下载

选择 OBJ / glTF / 优化 GLB 等格式并导出，文件会保存到“下载”。

移动端提示：

OBJ 兼容性更好（保留基础材质）
含大纹理的 GLB 建议使用 Wi-Fi
导出后到“下载”中查找文件

按工作流的导出建议

CAD/工程交换（GLB → OBJ）

软件集成

转换为：OBJ

保留几何，并通过 MTL 保留部分材质
被 DCC 与部分 CAD 工具广泛支持

游戏引擎导入

保持为：优化 GLB

Unity/Unreal 等引擎支持 GLB
保留材质与动画，体积优化后加载更快

CAD 软件导入

转换为：OBJ

设计需要材质引用时优先 OBJ
请确认目标 CAD 的首选格式

导出故障排除

🚫 导出按钮变灰

快速修复：等待 GLB 模型（含纹理）完全加载

排查步骤：

确保 GLB 文件与纹理已全部加载
检查是否仍在加载动画/资源
验证浏览器 WebGL 2.0 支持
尝试 Chrome/Edge 获得最佳性能

⚠️ 导出失败或耗时过长

立即解决：

关闭其他标签页与应用，释放内存
选择更简单的格式（OBJ/PLY 速度较快）
检查模型复杂度（大量纹理会更慢）

高级排查：

对大 GLB 文件，优先尝试导出为 OBJ 或优化 GLB
若持续失败，清除浏览器缓存后重试
禁用可能干扰下载的扩展

📁 导出文件未下载

下载问题：

检查“下载”文件夹
确认浏览器下载权限
尝试不同导出格式
关闭下载管理器/拦截器

🔧 导出质量问题

常见问题：

OBJ 纹理缺失：纹理为外链，请确保纹理文件与 MTL 一并保留
动画未导出：仅 GLB/glTF 保留动画
尺度不正确：检查目标软件单位设置

导出说明：系统基于当前加载的 GLB 模型进行转换。材质与纹理仅在支持的格式中保留（OBJ 为部分保留）。若需完整保真，请选择优化 GLB 或 glTF。

导出质量与兼容性

格式功能对比

功能	GLB	glTF	OBJ	PLY
几何	✓ 完整	✓ 完整	✓ 完整	✓ 完整
PBR 材质	✓ 完整	✓ 完整	✓ 基础	❌ 不支持
纹理	✓ 内嵌	✓ 外链	✓ 外链	❌ 不支持
动画	✓ 支持	✓ 支持	❌ 不支持	❌ 不支持
顶点色	✓ 支持	✓ 支持	✓ 限制	✓ 支持
文件大小	✓ 优化	◆ 中等	◆ 中等	✓ 小

软件兼容性矩阵

软件类型	GLB	glTF	OBJ	PLY
游戏引擎	✓ 原生	✓ 原生	✓ 良好	❌ 较差
3D 编辑器	✓ 极佳	✓ 极佳	✓ 通用	✓ 良好
CAD 软件	◆ 需插件	◆ 需插件	✓ 良好	✓ 良好
3D 打印	❌ 不适用	❌ 不适用	◆ 部分	◆ 有限
Web 查看	✓ 原生	✓ 原生	◆ 有限	❌ 较差
AR/VR 平台	✓ 原生	✓ 原生	◆ 需转换	❌ 不适用

工作流集成建议

工作流	推荐格式	理由
Web 发布	优化 GLB	Draco 压缩，加载快
游戏开发	GLB	保留材质/动画
CAD/工程	OBJ	通用网格交换，材质部分保留
归档/备份	原始 GLB	完整保留全部数据
跨平台	OBJ + MTL	兼容性最佳

导出前的优化与校验

准备 GLB 模型

检查纹理：确保纹理已优化并正确引用/内嵌
验证材质：确认 PBR 材质显示正确
测试动画：如有动画，请播放检查
体积优化：如导出 GLB，建议使用 Draco 压缩

选择合适格式

完整保真：优化 GLB
通用兼容：OBJ（含 MTL）
多文件管线：glTF（JSON + BIN）
点云/扫描：PLY（顶点色）

验证导出质量

在目标软件中导入测试
检查功能保留（材质/纹理/动画）
验证几何完整，无丢失/穿帮
确认单位/尺度 是否正确

高级导出技术详情

导出实现

多格式导出的 ExportDialog 组件

导出由 ExportDialog 组件（src/components/glb-viewer/fullscreen/ExportDialog.tsx）实现，支持多种格式：

// 多格式导出
const handleExport = useCallback(async () => {
  if (!online3DViewerAPI?.exportModel) return;
  await online3DViewerAPI.exportModel(
    formatConfig.fileFormat,   // 'Binary' | 'Text'
    formatConfig.extension     // 'obj' | 'ply' | 'off' | 'gltf' | 'glb' | '3dm' | 'bim'
  );
}, [formatConfig, online3DViewerAPI]);

转换与优化

几何保真：保持网格拓扑正确
材质处理：在不支持材质的格式中进行“降级”保留
纹理管理：根据目标格式选择内嵌或外链
性能优化：在 GLB 导出时应用压缩与尺寸优化

下一步

学习测量工具进行精确分析
探索渲染与性能优化查看体验
查看故障排除获取导出/格式相关解答
浏览移动设备指南了解移动端能力

本指南介绍了 GLB File Viewer 全屏模式下的专业导出功能，面向数字内容创作、游戏与 Web 可视化工作流。

GLB导出指南 - 专业3D格式转换

快速开始 - 两步完成导出

点击导出按钮

在全屏模式下，点击工具栏中的导出（📥 下载图标）或按下 Ctrl+E。

选择目标格式并下载

选择需要的目标格式并点击导出，文件会自动下载。

常见转换：

GLB → OBJ（带 MTL，兼容性广）
GLB → glTF（多文件：JSON + BIN）
GLB → 优化 GLB（适合 Web 部署，支持压缩）

格式选择提示：OBJ 适合通用兼容，glTF 适合多文件交换，优化 GLB 适合 Web 发布（保留全部特性并可压缩）。

GLB 导出能力

多格式转换

将 GLB 导出为 OBJ、PLY、glTF、优化 GLB 等格式

材质保留

在支持的格式中尽可能保留材质与纹理（OBJ 部分保留）

优化选项

导出时可应用压缩与优化，获得更小的文件

工作流集成

面向 CAD/游戏/Web/数字内容等多种工作流

🎯 导出格式对比

格式	材质	纹理	动画	文件大小	最佳用途
OBJ	✓ 基础	✓ 外链	❌ 不支持	中等	兼容性广
PLY	✓ 顶点色	❌ 不支持	❌ 不支持	小	点云/扫描
glTF	✓ 完整	✓ 完整	✓ 完整	中等	多文件保真
GLB	✓ 完整	✓ 完整	✓ 完整	优化	Web 发布

导出选择指南

选择 OBJ 适用于：

通用兼容 - 几乎所有 3D 软件都支持
基础材质 - 通过 MTL 保留部分材质信息
编辑交换 - 便于跨软件修改

保持为（优化）GLB 适用于：

Web 发布 - 使用 Draco 等优化
体积优化 - 纹理与几何同时优化
完整保真 - 保留材质/纹理/动画

选择 glTF 适用于：

多文件管线 - JSON + BIN 分离管理
引擎/平台对接 - 与部分平台的标准化流程更顺畅
资源复用 - 适合 CI/CD 与版本管理

如何导出 GLB（到其他格式）

桌面导出工作流

进入全屏模式

点击全屏按钮或按下 F11 进入全屏查看模式，获得完整工具栏。

访问导出工具

在全屏工具栏点击导出（下载图标）或使用快捷键 Ctrl+E。

选择导出格式

根据工作流选择：

OBJ - 兼容旧软件（带 MTL）
PLY - 点云/扫描等应用
优化 GLB - Web 发布
glTF - 多文件交换（JSON + BIN）

导出文件

点击导出开始处理。完成后浏览器会自动下载导出文件。

📱 移动端导出

在移动设备上访问导出

在全屏模式下，点击更多（⋮）→ 导出。

选择格式并下载

选择 OBJ / glTF / 优化 GLB 等格式并导出，文件会保存到“下载”。

移动端提示：

OBJ 兼容性更好（保留基础材质）
含大纹理的 GLB 建议使用 Wi-Fi
导出后到“下载”中查找文件

按工作流的导出建议

CAD/工程交换（GLB → OBJ）

软件集成

转换为：OBJ

保留几何，并通过 MTL 保留部分材质
被 DCC 与部分 CAD 工具广泛支持

游戏引擎导入

保持为：优化 GLB

Unity/Unreal 等引擎支持 GLB
保留材质与动画，体积优化后加载更快

CAD 软件导入

转换为：OBJ

设计需要材质引用时优先 OBJ
请确认目标 CAD 的首选格式

导出故障排除

🚫 导出按钮变灰

快速修复：等待 GLB 模型（含纹理）完全加载

排查步骤：

确保 GLB 文件与纹理已全部加载
检查是否仍在加载动画/资源
验证浏览器 WebGL 2.0 支持
尝试 Chrome/Edge 获得最佳性能

⚠️ 导出失败或耗时过长

立即解决：

关闭其他标签页与应用，释放内存
选择更简单的格式（OBJ/PLY 速度较快）
检查模型复杂度（大量纹理会更慢）

高级排查：

对大 GLB 文件，优先尝试导出为 OBJ 或优化 GLB
若持续失败，清除浏览器缓存后重试
禁用可能干扰下载的扩展

📁 导出文件未下载

下载问题：

检查“下载”文件夹
确认浏览器下载权限
尝试不同导出格式
关闭下载管理器/拦截器

🔧 导出质量问题

常见问题：

OBJ 纹理缺失：纹理为外链，请确保纹理文件与 MTL 一并保留
动画未导出：仅 GLB/glTF 保留动画
尺度不正确：检查目标软件单位设置

导出说明：系统基于当前加载的 GLB 模型进行转换。材质与纹理仅在支持的格式中保留（OBJ 为部分保留）。若需完整保真，请选择优化 GLB 或 glTF。

导出质量与兼容性

格式功能对比

功能	GLB	glTF	OBJ	PLY
几何	✓ 完整	✓ 完整	✓ 完整	✓ 完整
PBR 材质	✓ 完整	✓ 完整	✓ 基础	❌ 不支持
纹理	✓ 内嵌	✓ 外链	✓ 外链	❌ 不支持
动画	✓ 支持	✓ 支持	❌ 不支持	❌ 不支持
顶点色	✓ 支持	✓ 支持	✓ 限制	✓ 支持
文件大小	✓ 优化	◆ 中等	◆ 中等	✓ 小

软件兼容性矩阵

软件类型	GLB	glTF	OBJ	PLY
游戏引擎	✓ 原生	✓ 原生	✓ 良好	❌ 较差
3D 编辑器	✓ 极佳	✓ 极佳	✓ 通用	✓ 良好
CAD 软件	◆ 需插件	◆ 需插件	✓ 良好	✓ 良好
3D 打印	❌ 不适用	❌ 不适用	◆ 部分	◆ 有限
Web 查看	✓ 原生	✓ 原生	◆ 有限	❌ 较差
AR/VR 平台	✓ 原生	✓ 原生	◆ 需转换	❌ 不适用

工作流集成建议

工作流	推荐格式	理由
Web 发布	优化 GLB	Draco 压缩，加载快
游戏开发	GLB	保留材质/动画
CAD/工程	OBJ	通用网格交换，材质部分保留
归档/备份	原始 GLB	完整保留全部数据
跨平台	OBJ + MTL	兼容性最佳

导出前的优化与校验

准备 GLB 模型

检查纹理：确保纹理已优化并正确引用/内嵌
验证材质：确认 PBR 材质显示正确
测试动画：如有动画，请播放检查
体积优化：如导出 GLB，建议使用 Draco 压缩

选择合适格式

完整保真：优化 GLB
通用兼容：OBJ（含 MTL）
多文件管线：glTF（JSON + BIN）
点云/扫描：PLY（顶点色）

验证导出质量

在目标软件中导入测试
检查功能保留（材质/纹理/动画）
验证几何完整，无丢失/穿帮
确认单位/尺度 是否正确

高级导出技术详情

导出实现

多格式导出的 ExportDialog 组件

导出由 ExportDialog 组件（src/components/glb-viewer/fullscreen/ExportDialog.tsx）实现，支持多种格式：

// 多格式导出
const handleExport = useCallback(async () => {
  if (!online3DViewerAPI?.exportModel) return;
  await online3DViewerAPI.exportModel(
    formatConfig.fileFormat,   // 'Binary' | 'Text'
    formatConfig.extension     // 'obj' | 'ply' | 'off' | 'gltf' | 'glb' | '3dm' | 'bim'
  );
}, [formatConfig, online3DViewerAPI]);

转换与优化

几何保真：保持网格拓扑正确
材质处理：在不支持材质的格式中进行“降级”保留
纹理管理：根据目标格式选择内嵌或外链
性能优化：在 GLB 导出时应用压缩与尺寸优化

下一步

学习测量工具进行精确分析
探索渲染与性能优化查看体验
查看故障排除获取导出/格式相关解答
浏览移动设备指南了解移动端能力

本指南介绍了 GLB File Viewer 全屏模式下的专业导出功能，面向数字内容创作、游戏与 Web 可视化工作流。

GLB导出指南 - 专业3D格式转换

多格式转换

材质保留

优化选项

工作流集成

目录

GLB导出指南 - 专业3D格式转换

多格式转换

材质保留

优化选项

工作流集成

目录