版本更新与迁移
本文汇总旧版文档发布后与集成相关的变化，当前对应 2.7.2。完整版本记录见包内 CHANGELOG.md。
近期更新
| 版本 | 日期 | 变化 |
|---|---|---|
| 2.7.2 | 2026-09-14 | 新增 XRRig.MainCamera，返回立体相机的中心相机。 |
| 2.7.1 | 2026-09-08 | 优化输入模块配置与迁移体验。 |
| 2.7.0 | 2026-09-07 | 新增可选 Input System 支持及示例；两套输入系统均支持触笔和触摸拖拽，示例脚本兼容 Legacy、Input System 和 Both。 |
| 2.6.1 | 2026-04-02 | 修复 Fix Canvas 在编辑器中可能使用错误窗口尺寸的问题。 |
| 2.6.0 | 2026-02-06 | 支持不同屏幕比例；原生库改为使用窗口句柄切换立体显示。 |
| 2.5.2 | 2025-12-01 | 修复插入副屏导致的立体显示异常。 |
| 2.5.0 | 2025-10-30 | 新增 G1 设备支持。 |
包更新日志将 Linux 支持记录在 2.3.1，普通 PC 兼容记录在 2.3.11。平台支持不等于所有设备与系统组合均已完成验证。
升级检查
- 更新包后，确认 Package Manager 显示的版本，并等待 Unity 完成编译。
- 检查 Active Input Handling 与场景输入模块是否匹配。Legacy 项目可以继续使用原输入后端，无需为了升级安装 Input System。
- 如需迁移到 Input System，按照输入系统记录并重新配置 Actions 和模块参数。
- 检查 Canvas 的 Event Camera、虚拟屏幕比例和 UI 布局；需要重新适配时执行 Fix Canvas。
- 重新导入当前版本示例，避免使用旧目录中的场景验证新功能。
- 在目标设备测试立体显示、追踪、触笔、触摸和多场景切换；涉及副屏的应用还应检查实际多屏配置。
使用中心相机
从 2.7.2 起，可通过 XRRig.MainCamera 获取中心相机，无需依赖 Camera.main 的标签查找。该属性不会返回左右眼相机；在 XRRig 或立体相机尚未就绪时返回 null。
UnityEngine.Camera camera = KmaxXR.XRRig.MainCamera;
if (camera != null)
{
// 使用中心相机进行坐标转换。
UnityEngine.Vector3 screenPoint =
camera.WorldToScreenPoint(UnityEngine.Vector3.zero);
}