示例
SDK 在 Samples~ 目录提供示例场景和脚本,可用于验证集成结果及参考交互实现。
导入示例
- 打开 Window > Package Manager,选择 Kmax XR Core。
- 展开 Samples,找到 basic samples 并点击 Import。
- 在
Assets/Samples/Kmax XR Core/<版本号>/下打开导入的场景。

升级 SDK 后需要重新导入对应版本的示例。不同版本的示例目录可能同时存在,运行前应确认所用版本。
场景说明
| 场景 | 用途 |
|---|---|
menu |
示例入口。 |
input-sample |
展示触笔、鼠标和触摸交互。 |
input-sample-mouse3d |
展示 3D 鼠标输入。 |
input-system-sample |
展示 Input System 输入模块;需要安装并启用 Input System。 |
Simple-PostProcess-built-in |
展示内置渲染管线的后期处理;需要对应后期处理依赖。 |
runtime-load |
展示运行时实例化 XRRig。 |
示例脚本兼容 Legacy、Input System 和 Both 模式,但场景上的输入模块仍应与 Active Input Handling 匹配。切换输入后端后,请按输入系统检查并转换模块。
运行时加载
runtime-load 通过 RuntimeLoader 延迟实例化 XRRig。接入业务场景时,需要管理原相机的启停,避免重复创建 XRRig,并确保输入模块和画布相机引用已经配置。
XRRig.MainCamera 在 XRRig 或立体相机尚未就绪时返回 null。加载完成后再访问依赖 XRRig 实例的视口属性和显示控制接口。