功能	支持状态
观看	支持一切支持 `ToString()` 的内容。矢量有特殊的用户界面来展示单独的字段。另外，呈现的预览支持 `Texture` 数据类型
操作	只支持无参函数。
功能模块	支持可在 `GizmoTypesRegistry` 类中检查的多种 DebugGizmoTypes 类型。所有功能模块（除了轴）均可在 `[DebugMember]` 中通过额外的 `Color` 参数来使用该颜色进行绘制。
调整	支持使用滑块用户界面通过 `[DebugMember(Tweakable = true, Min = xxx, Max = xx)]` 调整浮点数/整数。支持使用用户界面开关调整布尔值，也支持使用下拉用户界面调整枚举。

脚本属性示例

启用沉浸式调试工具后，我们的框架会在编译时自动收集带有注释的符号，并在运行时将它们传送到头戴式设备窗口中。为了在查找这些符号过程中不过分影响运行时性能，我们借助位于 Assets/Resource/ImmersiveDebuggerSettings.asset 的一个可脚本化对象，对项目中的调试成员类进行预烘焙。

using Meta.XR.ImmersiveDebugger;
public class ExampleClass : MonoBehaviour
{
 // gizmo drawing, specifying a category
 [DebugMember(GizmoType = DebugGizmoType.Axis, Category = "MyDebugCategory")]
 private Pose _gameObjectPos;

 [DebugMember(GizmoType = DebugGizmoType.Line, Color = DebugColor.Red)]
 private Tuple<Vector3,Vector3> _direction;

 // just watch, note Tweakable is by default true for all supported types
 [DebugMember(Tweakable = false)]
 private bool _gameState;

 // tweak the value within a range
 [DebugMember(Min = 0.0, Max = 1.0)]
 private float _param;

 // action / call function, static members are also supproted
 [DebugMember]
 private void SpawnObject() {/* some code here */}
 private void Update()
 {
  // Update and consume all the debug options, e.g.:
  _gameObjectPos = new Pose(transform.position, transform.rotation);
 }
}

Meta 功能预先构建调试

为了让沉浸式调试器和 Meta XR SDK 易于使用，我们为一些 SDK 功能预先构建了一些调试功能。这包括：

相机系统

透视

场景调试器（混合现实工具箱/MRUK）

这些内置调试选项默认提供在 Meta 所提供的类别下以供您使用，您可以前往“沉浸式调试器设置”> 检查数据集将其关闭。

高级用例

本节详细说明了更具体的用例。

将沉浸式调试工具用于生产版本

（注意：v77 以后的版本中无需此设置）在项目设置中将 IMMERSIVE_DEBUGGER_ALLOW_USE_IN_PROD 添加为脚本编写预处理器定义，以便在生产版本而非开发版本中使用该工具。这样该工具就可以在非开发版中使用了。

使用您自己的相机，代替 OVRCameraRig

我们提供了一个自定义集成配置，该配置公开了沉浸式调试工具的相机的覆盖设置。如要提供脚本，覆盖 CustomIntegrationConfigBase（请查看 ExampleCustomIntegrationConfig），然后在启用使用自定义集成配置后，在设置部分填写 Mono 脚本。如要查找此设置，请在项目设置页面中点击 Meta XR > 沉浸式调试工具 > 高级 > 集成 > 使用自定义集成配置。

Immersive Debugger Editor settings allows custom integration

在运行时为组件添加检查器

（从 v83 开始可用）RuntimeAPIs 类提供了运行时方法，可用于向沉浸式调试工具添加组件检查器窗口。这样，您就可以在运行时调试组件，而无需使用 DebugMember 属性。这对于调试动态创建的组件或为您无法访问源代码的组件添加检查器非常有用。

向沉浸式调试工具添加自定义窗口

（从 v83 开始可用）您可以通过实施 IPanelRegistrar 接口向沉浸式调试工具添加自定义窗口。您可以使用该接口创建自定义窗口，这些窗口会在运行时通过沉浸式调试工具注册。

已知问题

问题	说明
OVRManager 依赖项 (OVROverlay)	沉浸式调试工具利用 `OVROverlay` 合成器图层来增加文本清晰度，但您的项目需要使用 `OVRManager`。
对 HDR（相机和设备图形设置中）尚不支持	沉浸式调试工具窗口在使用 HDR 期间可能会出现某些视觉故障。