PL4DGSBin 插件包使用手册
【支持的 Unity 版本与平台】
- Unity 版本支持情况 ✅ Unity 6 (6000.3.x)：需 URP 17.x（原生支持） ✅ Unity 2023.2：需 URP 16.x（兼容，传统渲染路径） ✅ Unity 2022.3 LTS：需 URP 14.x（兼容，传统渲染路径） 注意：本插件最低支持版本为 Unity 2022.3 LTS。
- 目标平台支持情况 ✅ Windows PC：支持 DirectX 12 或 Vulkan ✅ Android：支持 Vulkan ❌ 暂不支持：OpenGL ES、OpenHarmony、各类小游戏、iOS / iPadOS (Metal)
【使用说明】
一、 快速开始（推荐） 本插件包已包含配置完成的样板间 SampleScene，最快的验证方式如下：
- 将插件包中的 PL4DGSBin 和 Resources 两个文件夹，解压到目标 Unity 工程的 Assets 目录下。
- 插件导入后，Unity 会自动弹出“PL4DGSBin 插件已导入”提示框，点击“立即执行”即可一键完成设置（包括 IL2CPP、URP、图形 API 等）。 （如果跳过了弹窗，也可以通过顶部菜单 Tools -> PL4DGSBin -> Auto Configure Project 手动执行）
- 按提示重启 Unity Editor。
- 直接打开 Assets/PL4DGSBin/Scenes/SampleScene.unity。
- 进入 Play Mode 即可看到 4D Gaussian Splat 播放效果。样板间参数已配置完成，无需手动调整。
二、 在自己场景中手动使用 如果你希望在自己的场景中使用，请按以下步骤操作：
- 完成下方的 URP 与 IL2CPP 设置。
- 将预处理好的 4DGS 帧数据（.asset 文件及其对应的 .bytes 二进制文件）放入 Assets/Resources/自定义文件夹名/ 下。
- 将 Assets/PL4DGSBin/Prefabs/PL4DGSBin.prefab 拖入场景。
- 选中场景中的 PL4DGSBin 实例，在右侧面板按需调整以下核心参数：
[4D 播放器参数]
- 本地资源设置：填入 Resources 下的子文件夹名称。
- 4D 动画设置：可调整播放帧率、每段包含帧数、是否自动播放、是否循环。
- 帧范围：设置起始帧与结束帧（-1表示播放到最后一帧）。
- 播放模式：可勾选“严格逐帧播放”避免闪烁，或取消勾选使用平滑插值。
[高斯渲染器参数]
- 静态高斯素材：指定当前渲染的资源。
- 变换与可见性：可调整整体缩放、不透明度缩放、裁剪体积等。
- 着色质量：球谐阶数（0至3，3为最高质量）。
- 性能优化：可设置每 N 帧执行一次排序，数值越大性能越好。
- 进入 Play Mode 即可播放。
【工程配置要求】 （注：推荐使用插件自带的一键配置工具，以下为手动配置说明，供需要自定义的用户参考）
- 依赖包要求
- 必需包：数学库 (mathematics)、原生容器 (collections)、Burst 编译、URP 渲染管线 (universal)。
- 可选包：新输入系统、XR 相关包、UI 文本等。
- URP 渲染管线配置
- 将插件自带的 Medium_PipelineAsset 设为当前使用的 URP 管线资源（在 Project Settings -> Graphics 中设置）。
- 或者在你自己的 URP Forward Renderer Data 中，添加 Renderer Feature：GaussianSplatURPFeatureBin。
- IL2CPP 与 Player Settings
- 脚本后端：必须设为 IL2CPP。
- API 兼容级别：设为 .NET Standard 2.1。
- Windows 平台：架构选 x86_64，图形 API 必须包含 Direct3D 12 或 Vulkan。
- Android 平台：架构选 ARM64，图形 API 仅保留 Vulkan，最低 API 级别设为 Android 7.0 (API level 25) 或更高。
【常见问题】
问：编辑器中编译报错，提示 GaussianSplatURPFeatureBin 相关 API 找不到。 答：请确认目标工程已安装 URP 包，且插件的 asmdef 文件已正确识别到 URP。
问：Android 真机上黑屏或没有画面显示。 答：请检查：图形 API 是否只有 Vulkan；手机是否支持 Vulkan；是否使用了 IL2CPP 后端；URP 设置中是否正确添加了 Feature。
问：Windows 编辑器下报错 D3D shader create error。 答：请检查图形 API 是否已切换为 Direct3D 12 或 Vulkan。
【打包前检查清单】
通用检查： □ 脚本后端已设为 IL2CPP，API 兼容级别为 .NET Standard 2.1。 □ URP 管线已正确引用，且 Renderer Feature 已添加。 □ 场景中的 prefab 已正确配置资源文件夹名称。 □ Resources 目录下包含完整的 4DGS 帧数据。
Windows PC 打包： □ 平台已切换为 PC, Mac & Linux Standalone，架构为 x86_64。 □ 图形 API 包含 Direct3D 12 或 Vulkan（建议移除 DX11）。 □ 确认最终 exe 与数据目录大小在可接受范围。
Android 打包： □ 平台已切换为 Android。 □ 架构建议只勾选 ARM64。 □ 图形 API 仅保留 Vulkan，移除 OpenGL ES。 □ 最低 API 级别设为 Android 7.0 及以上。 □ 签名证书 (Keystore) 已正确配置并填写密码。 □ 4DGS 数据较大时（如约 1GB），已考虑分包或 OBB 方案，避免 APK 过大导致安装失败。
提示：首次 Android 打包前，建议先用 Build And Run 在支持 Vulkan 的高端设备上验证，确认渲染正常后再做全量发布。