常见问题与排查

找不到文件 / 从其他应用打开失败

问题： 在选择文件时找不到您的 3D 模型，或者从其他应用（如微信、邮件）直接调用本应用打开文件时失败。

排查方法：

1. 检查文件后缀： 请确保您的文件后缀属于我们支持的文件格式（如 .glb, .obj, .fbx 等）。系统文件选择器会自动置灰或隐藏不支持的文件。
2. 先保存到本地： 如果从其他应用直接分享打开失败，建议您先将该文件“保存到设备”或“存储到文件”（如“我的 iPhone”或下载目录），然后再进入我们的应用手动选取该文件。
3. 检查云端下载状态： 如果您从 iCloud Drive 或第三方云盘选择文件，请确保该文件已经完全下载到本地设备，而不是仅有一个云端占位符。

打开大文件时应用崩溃或卡死

问题： 加载体积庞大的 3D 模型时，应用突然闪退、无响应或直接关闭。

解决方法： 移动设备和网页浏览器存在严格的运行内存（RAM）限制，超大模型会导致内存溢出而崩溃。您需要对模型进行轻量化处理：

• 减小模型网格 (Mesh)： 使用 Blender、Maya 或其他减面工具，大幅降低模型的顶点数和多边形面数。
• 压缩纹理贴图 (Textures)： 4K 或 8K 的高清贴图会占用极大的内存。请将贴图分辨率压缩并缩放至 2048x2048 或 1024x1024，并使用 JPG/PNG 格式。
• 推荐使用 GLB： 将优化后的模型和贴图合并导出为单一的 .glb 格式文件，该格式对加载性能极为友好。

贴图显示错误或丢失

问题： 模型能够加载，但是显示为纯白、纯黑，或者原本的颜色和贴图丢失。

解决方法：

• 如果您使用的是 .obj 或 .fbx 格式，请确保材质文件（.mtl）以及所有相关的图片贴图文件与模型文件处于同一个文件夹内。
• 在传输到手机端时，建议将包含模型和贴图的整个文件夹打包为 .zip 压缩包后导入。
• 为了彻底避免贴图路径丢失的问题，强烈建议在电脑端将模型直接导出为内嵌材质的 .glb 格式。