本指南将详细说明如何在 Unity 中使用 Snapdragon Spaces SDK 来启用双重渲染融合功能。

安装 Unity Editor 时必须添加 Android Build Support 模块才能导出 .apk 文件。也可以随后通过 Unity Hub 添加该模块。

本指南假设您有一个 Snapdragon Spaces 项目，该项目已根据Unity 设置指南中列出的初始步骤进行配置。

导入

Snapdragon Spaces SDK 包含额外的样本资源，用于展示如何使用双重渲染融合功能。要导入这些样本，请在包管理器中选择该包（在菜单栏中选择“窗口” > “包管理器”），然后点击“导入”按钮以导入融合样本。

1.Controller Prefab Sample Scene - 这是一个样本场景，用于将 Snapdragon Spaces 的 Android Companion Controller 转换为 Unity Prefab，提供对设置和退出按钮的完全控制。有关详细信息，请参见 Companion Controller。

 2. LandscapeUISampleScene - 这是一个简单的场景，包含一个横向 Canvas 和可交互的 Canvas UI 元素，用于操作一个立方体。

 3. OpenXRLoadingTest - 这是一个场景，演示如何在智能手机上立即启动应用程序，并在与眼镜建立连接后启用 OpenXR。有关详细信息，请参见下文的 Dynamic OpenXR Loader。

 4. PortraitUISampleScene - 这是一个简单的场景，包含一个纵向 Canvas 和可交互的 Canvas UI 元素。

启用双重渲染融合（实验性）

前往 项目设置 > XR 插件管理 > OpenXR（> Android 选项卡），启用双重渲染融合（实验性）功能。

更改项目设置

使用菜单项 Snapdragon Spaces > 双重渲染融合 > 配置融合项目 是配置 Fusion 项目设置的最简便方法。

这将调整项目设置如下：

在 项目设置 > XR 插件管理 > （Android 设置选项卡） 下，禁用 启动时初始化 XR。

在 项目设置 > XR 插件管理 > OpenXR > 基础运行时功能设置（齿轮图标）中：

        ○禁用在查看器上启动应用。

        ○禁用在主机上启动控制器

        ○禁用导出无头模式

●将项目设置 > 播放器 > 其他设置 > 配置 下的 活动输入处理 设置为 两者。这允许同时使用新的输入系统包和传统输入系统。

●调整项目设置 > 播放器 下的 产品名称 和 版本，添加后缀 -Fusion。这样可以在开发过程中更容易识别使用双重渲染融合构建的产品。

●调整项目设置 > 播放器 > 其他设置 > 识别 下的 包名，添加后缀 .fusion。

应用项目验证修复

前往 项目设置 > XR 插件管理 > OpenXR > （Android 设置选项卡），找到 双重渲染融合（实验性） 功能。点击齿轮图标打开功能设置。

单击 Dual Render Fusion 旁边的红色感叹号，打开项目验证窗口。

项目验证窗口将显示几个修复选项，用于更新 Unity 项目和当前打开的场景，因此请确保在项目中打开了正确的场景。

此时，Dual Render Fusion 应该可以正确启动了。

对于新项目，场景层次结构现在应该包含其他游戏对象：

关于这些游戏对象和附加组件的更多信息可以在组件页面上找到。

配置双重渲染融合

双重渲染融合功能的可用设置包括：

1、验证开放场景 - 启用此设置时，项目验证窗口会检查当前场景是否已正确配置以支持双重渲染融合。如果项目的构建系统没有完整功能的场景（例如附加场景），请禁用此设置，以避免构建时出现阻塞。

2、 模拟融合设备 - 启用后，当进入播放模式时，编辑器将模拟两个有效的屏幕：显示器 1 将是双重渲染融合的主视图（智能手机屏幕），显示器 2 将是 AR 观察器（头戴设备屏幕）。如果禁用，进入播放模式时，编辑器将模拟连接的设备只能显示 XR 内容（作为一个 MR/VR 一体机）。此设置需要场景中存在一个 Fusion Simulator 组件，更多详细信息，请参见 Fusion Simulator 组件。