Skip to content

XRMan

说明

类。

命名空间:EZXR.Glass.Runtime

继承自类 MonoBehaviour。

描述

EZXRGlass XR 功能的主要入口。

集合了跟踪,手势手柄交互,系统消息响应 2,以及其他附加功能。

其中接口层级大致如下图:

public 静态属性

static bool Exist
XRMan 实例是否存在,即当前场景是否使用了 XRMan。
在通过 XRMan 使用之前,建议都判断检查,有些场景可能并未使用 XRMan 组件。
static Transform Head
XRMan 的 Head 节点。
static Transform Body
XRMan 的身体。
static class Eyes
XRMan 的眼睛描述。包括左中右三个相机,其中左右眼也是左右渲染相机,一般 centerCamera 位于左右眼相机中间,可作为主要相机参考,运行时 centerCamera 是非激活状态,使用时需要注意。
static class Hands
XRMan 的手描述。包括左右手的全部信息,无论当前交互是否是手势,通过 Hands 都可以获取手的信息,因此使用 Hands 时建议判断当前交互类型及手的状态。
static class Controllers
XRMan 的手柄描述。包括左右手柄的全部信息,无论当前交互是否是手柄,通过 Controllers 都可以获取手柄的信息,因此使用 Controllers 时建议判断当前交互类型及手柄的状态。
static class Input
XRMan 的当前活动的输入设备。包括左右手柄的全部信息,无论当前交互是否是手柄,通过 Controllers 都可以获取手柄的信息,因此使用 Controllers 时建议判断当前交互类型及手柄的状态。
ControllerInfo rightHand
右手柄信息的当前实例。

public 属性

bool showModelInEditor
在 Editor 模式中是否显示 XRMan 模型(头、身体、眼镜)
- true:显示
- False:隐藏
bool simulateInEditor
在 Editor 中通过键盘鼠标模拟操作(与 remoteDebug 互斥)
- true:启用
- false:禁用
bool remoteDebug
开启远程调试(与 simulateInEditor 互斥)
string editorIP
启用远程调试后,输入本机 IP 地址,用于接收眼镜端的调试数据并同步
bool supportsMultipleLanguages
设置是否支持多语言,启用后可接收系统的语言信息和切换事件,通过 OSEventSystem.OnInstructionsReceived_LanguageReceived 接收,使用时建议参考 Unity Localization 的使用。
- true:同步系统语言。
- false:禁用系统语言同步。

Inspector 选项

SpatialTracking
启用环境跟踪功能。
强制勾选。
InputSystem
启用交互输入(手势或手柄)。
强制勾选。
PlaneDetection
勾选后启用平面检测功能。
ImageDetection
勾选后启用图片图像跟踪功能。
SpatialComputing
勾选后启用空间计算功能。
SpatialMesh
勾选后启用空间网格检测计算功能。
Extras
勾选后启用附加功能,可选 Editor 模式可见模型,Editor 模拟手势输入,远程调试,多语言支持。
showModelInEditor
勾选后 Editor 模式显示 XRMan 模型。
simulateInEditor
勾选后可在 Editor 运行时 PC 模拟手势交互。
remoteDebug

勾选后启用远程调试功能,需要输入本机 IP 地址。编译运行后,PC 端可接收眼睛端的运行数据,并同步显示到 Scene 中,便于实时调试观察。
editorIP
开启 remoteDebug 后输入本机 IP 到该输入框,用于眼镜端传输同步数据到本机。
supportsMultipleLanguages
勾选后启用系统语言信息同步。