設置指南(nán)

本指南(nán)将詳細介紹如何在 Unity 中開始使用(yòng) Snapdragon Spaces SDK。

安裝 Unity 編輯器時(shí)，必須添加Android Build Support才能導出 apk 文件，該模塊也(yě)可(kě)以通(tōng)過 Unity Hub 後續添加。

下(xià)載開發者包

從 Snapdragon Spaces 開發者門戶下(xià)載開發者包。

導入包

Snapdragon Spaces SDK 以 tarball 文件形式提供，請按照(zhào) Unity 的(de)說明(míng)，使用(yòng)位于 Unity Package 文件夾中的(de) tgz 文件将包導入項目。

XR交互工具包導入

Snapdragon Spaces Unity 包對(duì) XR Interaction Toolkit 包有依賴關系。在導入 Snapdragon Spaces 包期間，導入 XR Interaction Toolkit 時(shí)可(kě)能會彈出兩個(gè)提示：

●啓用(yòng)新輸入系統：建議(yì)單擊“是”以包含新輸入系統包，以确保 OpenXR 和(hé) XR Interaction Toolkit 包的(de)完整功能，如果還(hái)需要舊(jiù)輸入系統，則可(kě)以将下(xià)方的(de)“Active Input Handling”Player > Other Settings > Configuration值設置爲 Both。

●交互層掩碼更新：交互層掩碼更新程序可(kě)能會提示升級交互層蒙版。如果之前沒有将 XR 交互工具包添加到項目中，則可(kě)以選擇“不，謝謝”。如果已經導入了(le) 2.0.0 之前版本的(de) XR 交互工具包包，建議(yì)點擊“我已備份”以升級交互層掩碼。

更改項目設置

要啓用(yòng) Snapdragon Spaces OpenXR 插件，請依次導航到 Edit > Project Settings > XR Plug-in Management 并打開 Android 選項卡。勾選 OpenXR 插件和(hé) Snapdragon Spaces 功能組。最初，會有一些項目設置需要更新或修複，爲此，請點擊 OpenXR 旁邊的(de)紅色感歎号，進入 OpenXR 項目驗證窗(chuāng)口，點擊條目旁邊的(de)修複按鈕，應用(yòng)所需的(de)項目設置。最後應用(yòng)啓用(yòng)兩種輸入系統的(de)設置，因爲這(zhè)可(kě)能需要編輯器重啓。

啓用(yòng) Spaces 功能

在 OpenXR 設置中啓用(yòng)需要在運行時(shí)激活的(de)功能。當前支持的(de)功能及其對(duì)應的(de) AR Foundation 管理(lǐ)器或 XR 子系統列在下(xià)表中。

導入示例

Snapdragon Spaces SDK 包含一些示例資産，展示如何使用(yòng)包中包含的(de)感知功能。要導入這(zhè)些示例，隻需在包管理(lǐ)器中選擇該包（位于菜單欄的(de) Window > Package Manager 下(xià)），然後點擊導入核心示例。

導入示例後，可(kě)以通(tōng)過菜單欄中的(de)“窗(chuāng)口”>“Snapdragon Spaces”>“将場(chǎng)景添加到構建設置”來(lái)使用(yòng)輔助工具将示例場(chǎng)景添加到構建設置中。