Snapdragon Spaces 开发指南（11）

---

5.10 统一变更日志

[0.15.0] - 2023-07-31

新增

• 对相机帧访问纹理的下采样支持。
• 示例支持手部追踪和控制器之间的自动切换。
• 在空间网格示例中添加了不透明度滑块以设置渲染的空间网格的不透明度。
• 新的空间合成层组件用于将纹理直接渲染到 HMD 并绕过后处理步骤。

变更

• 相机帧访问 OpenXR 调用支持最新的 OpenXR 运行时规范。
• VRX 上阻止了相机帧访问，以进一步改进设备的实现。
• 凝视指针使用新的空间合成层来实现更稳定的渲染，因为没有对元素应用移动引起的后处理。
• QCHT3 兼容性已被删除。
• 在 OriginLocationUtility.GetOriginCamera() 方法中添加标志以包含非活动游戏对象。
• 现在导入时默认启用使用平面检测的场景理解后端功能。
• 图像跟踪示例的目标增强已更改。
• 附带的QCHT交互包已更新至版本4.0.1。

修正

• 提高了不同时使用平面检测和场景理解时的性能。
• 在 XRIT 示例中选择一个立方体将不再使其更接近。
• 使用手部追踪时，捕捉问题已减少。
• 凝视指针应多次与 UI 元素交互。
• 待机后以手部追踪为准。
• 锚样本中的空参考错误已修复。
• 修复了 InteractionManager 脚本，使其不会在 Unity 2022 LTS 上引发任何错误。

[0.14.0] - 2023-05-31

新增

• 现在支持XRCpuImage的GetPlane函数，以及AR相机管理器的frameReceived事件回调。
• Spaces AR 网格管理器配置是一个可选组件，用于更好地控制生成的空间网格的特征，如感知示例描述中所述。通过此组件，空间网格提供程序还可以处理来自运行时端的可能的 TrackingOriginMode.Floor 相关相机高度偏移。如果在这种情况下不使用此组件，网格可能会出现在错误的位置。
• Spaces AR 平面管理器配置是一个可选组件，用于启用或禁用凸包平面。
• 启动主应用程序活动之前的启动过程包括检查 Snapdragon Spaces 服务的显示于其他应用程序设置。如果运行时未授予相机权限或未启用该设置，则会显示一条提示，将用户转发至 Snapdragon Spaces 服务的配置页面。

变更

• 更改了迁移指南中提到的某些类的可访问级别。
• 在除相机访问之外的所有示例上禁用 AR 相机管理器和 AR 相机后台组件，以避免与相机生命周期相关的问题，如已知问题部分中所述。目的是在未来重新启用移动 AR 平台的可移植性。
• 示例和包代码已重新设计，以遵守 Microsoft 建立并由 Unity (打开新窗口) 使用的 C# 编码约定 (打开新窗口)。
• 示例 UI 面板现在始终跟随视线。
• 使用指针或凝视交互时的示例 UX 已得到改进。

修正

• 停止图像跟踪时出现未处理的异常。
• 尝试调用 ARTrackedImageManager.CreateRuntimeLibrary 时发生崩溃。
• 再次可以在使用凝视交互的同时使用控制器选择某些内容。

[0.13.0] - 2023-05-04

新增

• 如果项目中包含 QCHT 包，则手部跟踪已作为示例中的默认输入模式启用。否则，凝视指针是默认输入模式。
• 可以设置可选的图像跟踪模式，以便更好地控制底层图像跟踪算法的计算周期。有关此更改的更多信息，请访问图像跟踪部分。
• 基本运行时设置中的防止睡眠模式项目设置可防止所有设备上的应用程序屏幕超时。
• 新的 OriginLocationUtility 类可帮助获取会话源，与类型无关（ARSessionOrigin 或 XROrigin）。
• 如果启用直通时会话摄像头的背景设置不正确，将会引发警告。
• Unity 构建版本现在包含在示例主菜单的信息面板中。

变更

• 改变了所有样品的外观。
• 将 QCHT 交互包更新至版本 4.0.0-pre.11。
• 示例中已弃用的 ARPoseDriver 组件已替换为 TrackedPoseDriver。
• 精炼代码以确保与 Unity 2022.1、2022.2 和 2023.1（测试版）基本兼容。
• 包内 SpacesLauncher.aar 和 ServicesHelper.aar 档案的代码改进和更新。
• 命中测试和平面检测生命周期的改进和变化：
  • 删除了内部为 AR 光线投射设置的距离限制。
  • 平面范围的计算已更改，可能会破坏向后兼容性。
• 强制启用不安全代码的验证规则已从插件中删除并移至 CameraFrameAccessSampleController.cs，因为仅在示例中需要它。
• 当场景理解后端被禁用时，平面检测、图像跟踪和命中测试子系统将请求运行时相机权限，而不是应用程序相机权限。

修正

• 修复了计算注视交互器位置的问题。
• 修复了禁用“在主机上启动控制器”选项时，windowFocusChanged 添加内容未添加到 Unity 活动中的问题。
• 基本运行时功能选项中的导出无头选项可以正确删除最终清单中 SpacesLauncher 活动的意图。
• 如果不再需要，底层的命中测试、平面检测和空间网格划分提供程序将正确停止。在较旧的运行时中，此行为可能会破坏预期的应用程序功能，因为提供程序无法在 20-40 秒内启动。因此，此修复可能会破坏向后兼容性。
• 相机框架访问生命周期改进，以防止该功能错误初始化。

[0.12.1] - 2023-04-03

新增

• Oculus Touch 控制器交互配置文件已添加到功能验证列表中。默认情况下应启用它以确保对示例的完全支持。
• Spaces Hand 组件已被标记为已弃用。
• 使用 QCHT 交互包中的示例代替旧的手部跟踪示例。

变更

• VR 中的直通可以在每个场景中使用 X 和 A 按钮打开和关闭。
• 命中测试可视化已得到改进。

修正

• 空间网格子系统创建的空间网格会自行更新，而不是在每一帧上重新创建。
• 权限检查已经过改进，不会在 Android 13 上中断。

[0.11.1] - 2023-02-14

新增

• ⚠ 实验空间网格子系统支持和新的示例场景。
• ⚠ 实验性相机框架访问支持和新的示例场景。
• 对 MR 设备的直通支持。

变更

• 支持的 Unity 版本更改为 2021.3.16f1，并升级到特定软件包：
  • Unity OpenXR插件版本升级至1.6.0。
  • AR Foundation版本增加至4.2.7。
  • XRIT版本增加至2.0.6。
• 在禁用查看器上的启动应用程序和主机上的启动空间控制器的情况下进行构建会将 UnityCustomLauncher.aar 作为一个整体从构建中删除。
• 如果感知子系统尚未启动或相机权限未启用，示例中的 UI 会显示警告消息。
• 主机控制器射线将在切换到它后在样本中重置。
• 将使用的 OpenXR 结构更新为最新版本。
• 默认的命中测试后端已从运行时更改为 XR_APILAYER_QTI_scene_understanding 层。
• 默认的平面检测后端已从运行时更改为 XR_APILAYER_QTI_scene_understanding 层。
• 删除了一项功能验证规则，该规则阻止在打开多线程渲染的情况下构建应用程序。
• QCHT 包已更新，支持 MRTK 和较小的改进。

修正

• 现在，在应用内部变换后，SpacesHand 组件的手部关节数组会被缓存，直到下一次更新关节姿势为止。
• 修复了 OpenXR 功能中错误的 OpenXR 结构初始化。

[0.10.0] - 2022-12-15

新增

• 新的 XR 控制器模型，包括按钮和操纵杆动画。
• 添加了控制器触觉。

[0.9.0] - 2022-11-24

新增

• 支持 Oculus Touch 控制器交互配置文件。
• 输入控制器根据可用的输入配置文件（控制器管理器）而变化。
• 预制件中的新公共 SpacesHandManager 字段与其他 TrackableManager 实现保持一致。
• QCHT 核心包添加：
  • 添加了 XR 交互工具包支持。
• QCHT 交互包添加：
  • 添加了十字线激活阈值与激光激活阈值，以便十字线可以设置为在悬停时显示，而激光设置为在静止时显示。新标线激活阈值的默认值可以与激光激活阈值相同，以实现向后兼容性。
  • 添加了 XR 交互工具包支持。

变更

• 主机控制器的重新居中按钮将光线重置为头部姿势向前而不是会话原点。
• 在锚点示例中添加了针对锚点放置的命中测试。
• 凝视十字线位置使用 XR.eyeTexture 大小值，而不是屏幕大小值。

修正

• QCHT 核心包修复：
  • 手部模拟系统的改进。
  • 删除 QCHTUtils 中的警告。
  • QCHTInstanceColor 着色器问题。
• QCHT 交互包修复：
  • 如果交互时不再跟踪手，则释放可交互。

[0.8.0] - 2022-10-13

新增

• 锚点示例场景中的新图例面板可阐明不同小工具可视化的含义。
• BaseRuntimeFeature 设置中的其他选项：
  • 导出 Headless：启用此选项将导出不带启动器标签的 apk，并使其在应用程序启动器中不可见。
  • 备用启动活动：此值允许设置 Unity 默认活动之外的另一个活动，该活动应从 SpacesLauncherActivity 启动。
  • 跳过权限检查：启用此选项将跳过应用程序启动时进行的权限检查。
• QCHT 核心包添加：
  • 现在可以通过右键单击 QCHT > QCHTManager 直接从场景创建 QCHTManager。
  • 网格局部边界框。
• QCHT 交互包添加：
  • 在物理光线投射标线上添加了带有 ZTest 关闭着色器的自定义材质。
  • QCHTRay 相关补充：
    • 添加了射线弯曲能力。
    • 添加了射线 BendRatioActivationThreshold 值。
  • 控制盒相关补充：
    • 在编辑器中添加了比例偏移属性，以避免对象上的框视觉剪辑。
    • 在初始框大小计算中添加了对象旋转，以避免对象不在其枢轴上时出现奇怪的行为。
    • 在编辑器中添加了移动约束以锁定用户水平/垂直移动。

变更

• 应用程序生命周期改进允许按顺序启动 Spaces 应用程序，而无需强制停止 Snapdragon Spaces 服务。
• ⚠ 实验性空间锚点存储加载和保存调用现在是多线程的。加载保存的锚点不会再阻塞主线程。
• 主机控制器存档已更新，具有更好的触摸板视觉效果。
• QCHT 核心包更改：
  • 数据填充改进
• QCHT 交互包更改：
  • Unity 2021.3.x 的新抓取点编辑器
  • 改进了 HandPoseDriver。
  • QCHTRay 相关更改：
    • 如果手没有移动，则停止计算射线中点，以提高射线弯曲时的稳定性感觉。
    • 射线现在仅向上方向弯曲。
    • 手不移动时光线弯曲计算稳定性。
  • 控制盒相关更改：
    • 一般改进

修正

• QCHT 交互包更改：
  • Unity 2021.3.x 的新抓取点编辑器
  • 在 Unity 编辑器中将预制件保存在不可变文件夹中时出现错误。
  • 修复了使用 QCHTControlBox 颜色设置时在十字线上应用的错误颜色。
  • QCHTRay
    • 修复了 QCHTRay 并避免在错误状态下禁用十字线。

[0.7.0] - 2022-08-31

新增

• ⚠ 实验性空间锚点存储，用于将锚点保存和加载到本地存储，并更新锚点示例场景。
• QCHT 核心包添加：
  • 添加了对自定义着色器的 URP（通用渲染管道）支持
  • 提供更好的开发体验的工具提示
• QCHT 交互包添加：
  • 添加了对自定义着色器的 URP（通用渲染管道）支持
  • 即使手部存在，也可以隐藏手部（手部演示者）
  • 是否允许显示幽灵手或不显示（手部演示者）
  • 现在可以更改指针大小以进行远端交互（图形和物理光线投射器）
  • 提供更好的开发体验的工具提示

变更

• 主机控制器存档已更新，具有亮/暗模式设置和触觉反馈切换。
• Raycast 子系统支持使用更新的示例场景进行连续命中测试。
• 更新了手部追踪包。
• 组件版本面板现在包含一个滚动视图，以便将来显示更多组件。
• 更新的 Snapdragon Spaces 服务包含在开发者包中。
• QCHT 核心包更改：
  • 重新组织 UI 组件并重命名变量，以获得更好的理解和更好的开发人员体验
• QCHT 交互包更改：
  • 重新组织 UI 组件并重命名变量，以便更好地理解以下组件并获得更好的开发人员体验：
    • 手持演示器
    • QCHT射线
    • QCHT控制盒
    • 抓点
    • 近端交互器
  • 将交互类型从 Simple、VFF、Ghost Only 改为 Triggering、Colliding、None。
  • 仅启用 4 个手势进行近端交互（捏、抓、点、张开手）
  • 默认不从手.fbx导入材质
  • 所有自定义编辑器脚本逻辑都移动到相应的脚本中
  • 所有纹理资源都移至纹理文件夹中
  • QCHTPhysicsRaycaster 支持事件掩码
  • 创建控制盒设置并添加手柄显示类型

修正

• 空间手组件中的手关节姿势已固定在世界空间中，而不是相对于头部姿势。
• Unity 2021 增量构建管道的构建问题已得到修复。
• QCHT 交互包修复：
  • 指针位置偏移
  • 改进的捕捉
  • 添加 Raycast 拖动时选择的 RayState
  • 单击编辑姿势后重新绘制场景视图
  • QCHT 交互控制器不再需要 HandPresenter
  • 修复了在扳机和碰撞手之间切换时的问题

[0.6.1] - 2022-07-22

新增

• 在应用程序启动时添加了 Snapdragon Spaces Services 的相机权限检查，并提示在 Snapdragon Spaces Services Android 设置中启用它（如果之前未给出）。

[0.6.0] - 2022-07-21

新增

• 自定义手动跟踪子系统支持和新的示例场景。
• 开发人员包中包含单独的手部跟踪包，用于扩展手部跟踪功能。
• ⚠ 实验性 Raycast 子系统支持和新的示例场景。
• 示例添加：
  • 可通过主菜单访问组件版本信息。
  • 控制器类型（注视或设备指针）在应用程序启动和场景切换期间保存。

变更

• 主机控制器存档已更改，现在属于 Microsoft 混合现实运动控制器配置文件（打开新窗口）类型，与上一个版本相比，带有额外的触摸板。
• 更新的 Snapdragon Spaces 服务包含在开发者包中。
• 在图像跟踪子系统中添加了检查，以防止设置和使用错误的候选图像。

修正

• 修复了导致文件名中包含 SpacesController 的自定义控制器无法包含在最终版本中的错误。

[0.5.0] - 2022-06-01

新增

• 跟踪图像子系统支持和新的示例场景。
• 添加到 BaseRuntimeFeature 设置中的启动空间控制器和使用自定义控制器选项。
• 添加了带有 Android Studio 项目的自定义控制器包文件夹，用于将自定义 Android 存档构建到开发人员包中。
• 示例添加：
  • 按住主机控制器的菜单按钮将关闭样本。
  • 将示例脚本封装在自己的命名空间中。
  • 向 GazeInteractor 组件添加垂直偏差以移动标线。

变更

• 主机控制器已从 Snapdragon Spaces Services 中移出，并作为 Android 存档移入 Unity 包中。
• 更新的 Snapdragon Spaces 服务包含在开发者包中。
• 软件包的 OpenXR 插件版本依赖项已更新为 1.4.2（从 1.2.8）。
• 重命名并简化了包的编辑器文件夹中包含的编辑器脚本。

修正

• 头部锁定内容的抖动问题。
• 启动和停止子系统时，锚点和平面检测子系统生命周期改进。
• 示例修复：
  • 凝视指针的大小再次减小。
  • 精炼 GazeInteractor 计算以获得独立于平台的水平半部分。

[0.4.1] - 2022-04-28

修正

• 更新了开发人员包中包含的 Snapdragon Spaces 服务，修复了从 ThinkReality A3 配置中读取错误值的问题。

[0.4.0] - 2022-04-28

新增

• 添加了对 Motorola Edge+、motorola Edge 30 Pro 的支持。
• 平面检测子系统支持和新的示例场景。
• 在启动应用程序之前添加了一个对话框，以授予相机权限（用于平面检测和未来的跟踪类型）。
• 主菜单中添加了退出按钮以退出应用程序。

变更

• 主机控制器更新了新的 UI。
• 不再支持以前的 SM8450 QRD 设备。
• 使用平面检测跟踪层更新了 OpenXR 运行时。
• UnityServicesHelper.aar 分为 UnityServicesHelper.aar 和 UnityCustomLauncher.aar，可以通过 OpenXR 项目设置在 BaseRuntimeFeature 选项中禁用后一个。

修正

• 从 OpenXR 姿势数据转换为 Unity 姿势数据现在会应用正确的坐标系修改。

[0.3.0] - 2022-03-15

新增

• 锚点子系统支持和新的示例场景。
• 主机控制器支持。
• 用于检索跟踪状态和支持的功能的会话子系统。
• 屏幕超时通过示例场景中的 SampleController 以及从其派生的所有控制器禁用。
• 每次场景更改时都会重置 AR 会话原点。可以设置一个值来控制 SampleController 组件中的值。

变更

• 使用锚层更新了 OpenXR 运行时。
• XR Interaction Toolkit 示例场景再次启用。
• 如果未设置 OpenXR 插件和 BaseRuntimeFeature，则 UnityServicesHelper.aar 将从最终版本中删除。
• 头部跟踪示例已重命名为位置跟踪示例。
• 设备和凝视指针预制件与 AR 相机分离，不再需要成为它的父级。
• 自定义 Snapdragon Spaces 控制器配置文件已被删除，取而代之的是 Khronos 简单控制器配置文件作为新的默认配置文件。

修正

• AR 相机的编辑器运动（由 EditorCameraController 控制）现在发生在 AR Session Origin 下的本地空间中。
• 如果启用该功能，则 BaseRuntimeFeature 不再检查运行时并显示对话框，但 OpenXR 插件已禁用。

[0.2.0] - 2022-02-01

新增

• 构建的应用程序现在直接在查看器上启动其上下文，无需自定义 adb 启动命令。

变更

• 更新了 OpenXR 运行时。
• 交互示例已禁用，因为主机上不再显示用于注册 UI 输入的上下文。

修正

• 浮动UI尺寸更小，更容易交互。
• 额外的外观改进。

[0.1.3] - 2021-12-07

变更

• 更新了 OpenXR 运行时。启动和停止问题现已修复。

[0.1.2] - 2021-12-01

新增

• NOTICE.txt 文件已添加到存档中。
• 在Window>Snapdragon Spaces>Add Scenes to Build Settings 下的菜单项中添加了一个帮助程序，以自动将示例场景放入构建设置。

变更

• 场景和脚本得到了完善和精简。
• 用户界面改进。

修正

• GyroOverride 不再在编辑器中抛出错误。
• 修复了缺少长按操作的错误。

[0.1.1] - 2021-11-15

新增

• BaseRuntimeFeature 获取新的项目验证规则以避免丢失项目设置。
• OpenXR 运行时已更新。

[0.1.0] - 2021-11-03

新增

• OpenXR 插件的 BaseRuntimeFeature。
• 演示 6DoF 头部运动的示例场景。
• 有关如何使用 XR 交互工具包的示例场景。