3DGS 本地处理

桌面客户端可以把常见的 3DGS 文件转换为适合在线浏览的资源，并按需生成步行碰撞体。整个流程包括选择文件、预览封面、设置碰撞体、切片、打包和上传。

支持的文件

当前可以选择以下格式：

• PLY
• SPLAT
• SPZ
• PCD
• SOG
• KSPLAT
• XYZ
• GLB

不同来源的文件内容可能存在差异。文件能够选择但无法预览或转换时，请先在原制作软件中确认文件完整，并重新导出常用的 PLY、SPLAT 或 SPZ 格式。

创建 3DGS 处理任务

1. 打开顶部「任务处理」。
2. 选择左侧「泼溅」。
3. 点击「上传泼溅」。
4. 拖入或选择一个或多个 3DGS 文件。
5. 在预览区旋转到合适角度，点击「截取当前画面为封面」。
6. 点击下一步，选择步行碰撞体处理方式。
7. 点击「添加到队列」，然后在任务卡片中查看进度。

批量选择文件时，每次设置当前文件。加入队列后，窗口会自动切换到下一份待处理文件。

封面设置

• 等待场景完整显示后再截取封面。
• 封面应当能看清项目主体，避免对着空白区域或距离过近。
• 未截取封面也可以继续，但素材库中的识别效果会较差。
• 如果预览加载失败，先检查文件格式和文件是否完整，再重新选择。

步行碰撞体

碰撞体决定第一视角步行时哪些位置可以行走，以及墙面、地面和障碍物如何阻挡用户。

自动生成

适合希望快速完成项目的用户。加入队列后，会依次完成场景切片、碰撞体生成、打包和上传。

建议在以下情况使用：

• 首次制作步行项目
• 场景结构清楚，地面和墙体完整
• 暂时没有单独制作的 GLB 碰撞体

手动上传

选择自己制作的 .glb 碰撞体，适合已经精修过步行范围的项目。

上传前请确认：

• 碰撞体与 3DGS 场景使用相同的位置、旋转和缩放
• 地面连续，门口和通道没有被封住
• 不需要参与碰撞的小物件已经删除
• 文件名和场景容易对应，避免选错文件

不需要

只处理 3DGS 场景，不启用第一视角步行。适合仅旋转观看、制作展示或稍后再补碰撞体的项目。

处理阶段

任务通常会经过以下阶段：

1. 读取和检查源文件
2. 生成不同清晰度的空间切片
3. 自动生成或加入手动碰撞体
4. 打包处理结果
5. 上传到账号素材库

3DGS 文件较大时，切片和碰撞体生成可能需要较长时间。处理期间可以切换到其他标签，但不要退出客户端或删除源文件。

完成后检查

1. 返回高斯泼溅素材库，打开刚上传的资源。
2. 检查封面是否正确。
3. 旋转观察场景，确认没有缺块、倒置或比例异常。
4. 如果配置了碰撞体，进入第一视角检查地面、门口、楼梯和边界。
5. 发现穿墙或无法通过时，重新生成碰撞体，或上传精修后的 GLB。

常见问题

一直停留在等待中

检查任务处理中心的并行数量。已有大型任务占满并行位置时，新任务会等待；可以等待前面的任务完成，或适当增加并行数量。

自动碰撞体生成失败

先确认源文件能够正常预览，并检查磁盘剩余空间。复杂场景可以改选「手动上传」，使用简化后的 GLB 碰撞体。

转换后场景方向或比例不对

这通常来自源文件的坐标或缩放。请回到原制作软件统一应用位置、旋转和缩放后重新导出，不要只在上传后调整封面。

上传阶段失败

保留源文件和客户端任务记录，确认网络恢复后点击「重试」。无需重新创建一份相同任务。