LiSplat Unreal SDK 常见问题

1. 导入成功却看不到数据，先检查什么？

1. 选中 LiSplatActor，检查 Splat Asset（Splat 资产） 是否已选择导入的数据。
2. 打开视口 Realtime（实时），点击 Center in Viewport（居中视口），检查数据是否位于当前观察范围。
3. 如果通过远程桌面操作，可点击 Stats（统计） 强制加载数据，查看是否显示。
4. 检查高度过滤、裁剪体、剖切面或透明度设置是否隐藏了数据。仍不显示时，查看导入或运行日志。

操作步骤见快速上手。

2. LiSplat 文件无法导入，怎么办？

确认文件由 LiDAR360MLS V8.2 或以上版本导出。确认导出完整；若文件不符合要求，使用支持的版本重新导出后再导入。操作见导入数据。

3. 画面偏暗或颜色不合适，怎么调整？

先将 Light Mode（光照模式） 设为 UnLit（无光照），查看数据原有颜色。使用 Lit（受光照） 时，在场景中添加光源 Actor，调整光源强度、方向及 Lighting Scale（光照缩放）。如果光源没有作用，还需检查光照通道是否匹配。整体亮暗可在 Color Adjustment（颜色调整）中调节。见渲染调节。

4. 移动时模糊或短暂停顿，怎么处理？

先尝试勾选 Full Rendering（完整渲染 / 全量渲染），并设置合适的最大点数。若电脑负载过高，可关闭完整渲染，适当降低渲染点数、输出分辨率或光照复杂度。每次只修改一项，比较同一区域。见性能优化。

5. 开启碰撞后角色仍穿过地面，怎么办？

显示已加载碰撞，确认碰撞体已生成或导入完成，并与地面位置对齐。再检查 Enable Collision（启用碰撞） 和玩家出生点的位置，将出生点放在地面上方后重新运行。见碰撞。

6. 保存与另存为有什么区别？

Save（保存） 将当前高斯资产中的软删除和调色编辑持久化；软删除不会物理移除原始点数据。Save As（另存为） 输出独立的 Gaussian PLY 文件，包含裁切、删除、调色、裁剪体和剖切面编辑。两者都在 Edit（编辑）页面。见保存与另存。

7. VR 连接后只显示电脑桌面或二维窗口，怎么办？

确认头显与电脑的串流连接正常，所需 VR 运行环境已启动。通过 SDK 的 VR Preview（VR 预览） 或导出的 VR 程序进入场景。连接与串流操作可参见 PICO 4 Ultra PC 串流说明。

8. 蓝图工程可以导出 VR EXE 吗？

可以。SDK 的 Export VR EXE（导出 VR EXE） 支持蓝图工程和 C++ 工程。普通 Windows 项目打包按项目打包操作，使用 C++ 工程。VR 导出步骤见导出 VR EXE。

9. VR 导出失败，先检查什么？

导出前，请使用未进行过编辑操作的 LiSplat Actor。编辑操作不会直接修改模型文件中的数据，相关编辑效果目前无法直接随程序导出。若提示存在编辑内容，先使用 Save As（另存为） 导出编辑结果，重新导入并替换原 Actor，再使用未编辑过的新 Actor 导出。停止运行或预览，确认碰撞已加载完成，并选择可写且空间充足的输出目录。仍失败时，查看输出日志。见VR 预览与导出。

10. 打包程序能启动，但看不到场景，怎么办？

检查 Game Default Map（游戏默认地图） 和 LiSplatActor 关联的 Splat Asset（Splat 资产）。确认 Actor 未进行过编辑，模型文件位于项目 Content 目录下，且 Content\LiDarGs 中有对应的 LOD 和碰撞数据。为两个额外目录各添加一个索引，通过文件夹选择按钮选中项目下的 Content\LiDarGs 文件夹，并取消勾选 Use Pak File（使用 Pak 文件）、Use Io Store（使用 IO 保存）。具体步骤见项目打包。

11. 如何替换原有插件？

先备份工程，并关闭 UE 和 Visual Studio。将项目 Plugins 目录中的旧插件文件夹替换为新的 LiSplatUnrealSDK 文件夹。蓝图工程可直接重新打开。

C++ 工程还需完成以下步骤：

1. 删除项目根目录下的 Intermediate、Saved、Binaries 文件夹。
2. 右键项目的 .uproject 文件，选择 Generate Visual Studio project files（生成 Visual Studio 项目文件），重新生成 Intermediate 目录和 .sln 文件。
3. 打开 .sln 完成编译，再打开项目。编译和运行所需的 Binaries、Saved 等目录会重新生成。

12. 问题仍未解决，反馈时需要提供什么？

提供操作步骤、报错截图、相关日志、数据格式和电脑配置信息，并说明问题发生在编辑器、运行预览还是导出程序中。项目日志通常可在 Saved/Logs 中找到。

---

© Greenvalley International Inc.