Unity XR Interaction Toolkit 開發｜二、導入 SDK【3.0 以上版本】

Unity XR Interaction Toolkit 教學說明

本次教學將帶您完成 Unity XR Interaction Toolkit 的 SDK 導入，內容涵蓋安裝 Unity 編輯器與相關平台的打包模組，啟用 OpenXR 並配置互動設定檔，解決環境設定中的常見問題，最後導入必要的範例資產並更新 Input System，為後續的 XR 開發奠定穩固基礎。本篇文章在原作者內容的基礎上進行了一些補充與調整，完整版課程及答疑僅限社群成員專享，歡迎關注原文作者並加入社群！

你可以隨時回到初始頁：Unity XR Interaction Toolkit 開發｜一、OpenXR 與 XRI 概述【3.0 以上版本】來了解從頭開始串連 Unity 與 XR Interaction Toolkit 的完整流程。

安裝 Unity 編輯器與打包模組

在 Unity Hub 中安裝一個 Unity 編輯器（推薦 LTS 長期支援的穩定版），並且安裝硬體設備對應平台的打包模組（目前市面上大部分 XR 頭顯都是安卓系統，如 Quest、Pico，需要安裝 Android Build Support，只有蘋果的頭戴裝置是 visionOS 系統，需要安裝 visionOS Build Support）。

Unity Hub 模組安裝界面，紅框標示 Android 和 visionOS 支援模組，顯示下載大小及磁碟需求。

本教學中使用的 Unity 版本是 2022.3.20f1，因為考慮到大部分人使用的可能還是相對舊一點的版本。如果你能夠安裝最新的 Unity 6000 LTS 版，也是可以的，後續在設定環境時的相容性是更好的。

系列教學會選用 Meta Quest 3 進行最終應用的效果展示。

安裝編輯器後就可以建立新的 Unity 工程，我選用的渲染管線是 URP，需要使用 Universal 3D 模板。

Unity Hub 3.7.0 新專案界面，提供 2D、3D 和 URP 模板，可設定名稱與路徑。

導入 OpenXR

建立 Unity 工程後，在 Unity 編輯器介面選單列的 Edit>Project Settings 裡安裝 XR Plug-in Management，在 PC 端和安卓端勾選 OpenXR。

Unity 專案設定界面，顯示 XR Plug-in Management，啟用了 OpenXR 插件，適用於 Android 平台。

Unity 的 XR Plug-in Management 設定界面，顯示在桌面平台啟用了 OpenXR 插件，並勾選了啟動時初始化 XR 的選項。

然後在 XR Plug-in Management 下方的 OpenXR 裡加入對應裝置的互動設定檔 Interaction Profile（PC 端和安卓端都要新增）：

Unity 的 OpenXR 設定界面，啟用了互動配置檔案，包括 Meta Quest Touch Pro 與 Oculus Touch 控制器配置，並設定了渲染模式為 Single Pass Instanced。

因為我開發的是 Meta Quest，我就把 Meta 相關的互動設定檔都進行加入（Meta Quest Touch Pro Controller Profile 和Oculus Touch Controller Profile）。

然後在下方的 OpenXR Feature Groups 當中勾選 Meta Quest Support（如上圖）。如果不勾選，打包到 Quest 後會變成 2D 視窗應用程式。

然後在 Project Validation 中如果有看到紅色的報錯或黃色的警告，需要點擊 Fix All 進行環境配置的修復（PC 端和安卓端都要進行修復）。當清單每一項前方出現綠色的✔，就代表環境配置是正確的。

Unity 的 Project Validation 設定界面，檢查 OpenXR 配置的潛在問題，如互動配置檔案、Gamma 色彩空間支援和設備選擇，並提供修正選項以確保專案符合設定需求。

如果 Unity 是 URP 項目，則需要移除 URP 設定檔裡的 Screen Space Ambient Occlusion 渲染特性。

URP 設定檔預設在專案中的 Assets > Settings 資料夾中：

顯示 Assets > Settings 資料夾中的 URP（Universal Render Pipeline）相關設定檔案，如 URP-Balanced 和 URP-HighFidelity，標記為重要渲染配置。

Unity 的 Project Validation 設定界面，用於檢查專案的配置問題，例如 OpenXR 的互動配置、設備支援及渲染需求，提供修正選項確保專案正確運行。

移除過後，重啟 Unity 編輯器，正常來說就不會看到 Project Validation 視窗中的警告了。

導入 XR Interaction Toolkit

XR Interaction Toolkit 官方開發者文件：

Unity XR Interaction Toolkit 文件，介紹其跨平台控制器支援與互動功能，用於 VR/AR 開發。

可在文件中選擇自己想要查看的版本。

在 Unity 選單列 Window > Package Manager 當中先在左上角切換到 Packages : Unity Registry，搜尋 XR Interaction Toolkit，查看目前 Unity 版本裡預設的 XRI 版本是否是最新的，如果不是，需要在 Unity 的 Package Manager 當中通過套件名稱 com.unity.xr.interaction.toolkit，使用 Add package by name 導入最新版的 XRI。

Unity Package Manager 中，通過輸入名稱 com.unity.xr.interaction.toolkit 添加 XR Interaction Toolkit 套件。

製作本教學時 XR Interaction Toolkit 已經更新到了 3.0.6。

將 XRI 匯入，成功後需要匯入XRI 的範例套件（本節課程先導入 Starter Assets 和 XR Device Simulator）。

Unity Package Manager 界面顯示 XR Interaction Toolkit 的詳細信息，包含版本 3.0.6，並提供 Starter Assets（8.85 MB）等範例資源以快速設定行為和預設值。

然後確保 Input System 的版本更新到了 1.11.0 以上，如果是舊版，可以在 Unity 的 Package Manager 當中透過套件名稱 com.unity.inputsystem，使用 Add package by name 導入最新版的 Input System。

Unity Package Manager 界面顯示 Input System 套件（版本 1.1.1），包含多個範例，如自定義綁定、設備實現和遊戲手柄游標控制，可供導入使用。

最後在 Project Validation 進行配置修復。

打包發布

可以在 Assets > Samples 中開啟官方提供的一個範例場景。

XR Interaction Toolkit Starter Assets，包括範例資源與 DemoScene 場景檔。

在 Unity 的 File > Build Settings，將需要打包的場景加入到打包清單下（點擊 Add Open Scene 能新增目前開啟的場景），確保裝置開啟了開發者模式後，可以將裝置與電腦透過 USB 線連接，點選 Build and Run 進行打包。

Unity Build Settings 界面，選擇了 Android 平台，配置為 32 位元，並指定 Oculus Quest 3 作為執行裝置。

課程總結

SDK 導入和環境配置的思維導圖，包含安裝 Unity 模組、導入 OpenXR（底層插件）和 XR Interaction Toolkit（高層 SDK），以及進行項目驗證和打包發布的步驟詳細說明。

上一步：Unity XR Interaction Toolkit 開發｜一、OpenXR 與 XRI 概述【3.0 以上版本】

下一步：Unity XR Interaction Toolkit 開發｜三、快速設定互動：行動、抓取、UI 互動【3.0 以上版本】

————————————————

以上內容來自 CSDN 作者：YY-nb

覺得文章有用

給作者鼓勵

收藏這篇文章

本文原創(或整理)於亞洲電玩通，未經作者與本站同意不得隨意引用、轉載、改編或截錄。

特約作家簡介

JamXu

十年遊戲研發

二十年遊戲台主

三十年遊戲玩家

經中華網龍遊戲企劃進入遊戲圈，然後被雷打到去學程式前後端又學了點設計再帶帶幾個研發團隊，見證了 3D 渲染技術及遊戲引擎互相進步，也見證了研發代理的更迭與博弈遊戲的興起，再毅然研究起 SEO 網路行銷與社群廣告投放，深信自研自賣才是最大贏家，期望能為台灣研發重回輝煌時光貢獻一點力量。如果你也有遊戲夢，歡迎交流認識。