Table of Contents

示例

SDK 在 Samples~ 目录提供示例场景和脚本,可用于验证集成结果及参考交互实现。

导入示例

  1. 打开 Window > Package Manager,选择 Kmax XR Core。
  2. 展开 Samples,找到 basic samples 并点击 Import。
  3. 在 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 实例的视口属性和显示控制接口。