概述
Kmax XR Core 以 Unity Package Manager（UPM）包的形式发布，为 Kmax 设备上的 Unity 应用提供立体显示、眼部追踪和触笔交互功能。包名为 com.kmax.xr.core。
本文档对应 2.7.2，根据该版本的源码和更新日志整理，更新日期为 2026-09-20。
功能与平台
| 功能 | 说明 |
|---|---|
| 立体显示 | 通过 XRRig 和立体相机管理单目、左右格式及设备支持的立体渲染模式。 |
| 追踪 | 通过 HeadTracker 和 PenTracker 获取眼部与触笔姿态。 |
| 空间交互 | 基于 Unity Event System 处理触笔、鼠标和触摸事件。 |
| 输入系统 | 支持 Legacy Input Manager；从 2.7.0 起，可选用 Unity Input System。 |
| UI 适配 | 提供世界空间画布的缩放、姿态同步和触笔射线检测。 |
SDK 包含 Android（M1）、Windows/Linux（K 系列等设备）和 WebGL 的平台实现，并从 2.5.0 起支持 G1。具体显示模式取决于设备、图形接口和追踪服务。普通 PC 可用于单目开发与基础交互测试；立体显示和硬件追踪需要在目标设备上验证。
Unity 版本与依赖
package.json 声明的最低 Unity 版本为 2019.4。这表示包的版本要求，不代表所有平台、渲染管线及可选依赖组合均已验证。升级 Unity 或切换平台后，应重新检查编译、渲染和交互。
Input System 为可选功能。其程序集要求安装 com.unity.inputsystem 1.0.0 或更高版本；具体版本还需与项目使用的 Unity 版本匹配。配置方法见输入系统。
接入已有 XR 项目时，应检查相机、追踪和输入模块是否重复工作。场景应使用一个负责当前交互的 EventSystem，并选择一个 Kmax 输入模块。
开始使用
