Unity 專案設定

本指南詳細說明為 Android XR 開發 Unity 應用程式時,建議使用的編輯器版本、圖像設定、URP 設定和 Android 專案設定。

必要條件

如要使用 Unity 開發,請下載並安裝 Unity Hub

安裝 Unity 編輯器和 Android 建構支援的6000.0.58f2 以上版本,包括:

  • OpenJDK
  • Android SDK
  • Android NDK 工具

選取算繪引擎

建議使用 Vulkan Graphics API 轉譯 Android XR 應用程式。如要選取 Vulkan 做為圖像 API,請按照下列步驟操作:

  1. 在 Unity 中,依序前往「Edit」>「Project Settings」>「Player」。
  2. 選取「Android」分頁標籤,然後依序前往「Other Settings」>「Rendering」
  3. 如果啟用「自動圖形 API」,請停用這項設定,即可顯示「圖形 API」部分。
  4. 在「Graphics APIs」(圖形 API) 部分,選取「Add」(新增) 按鈕,然後從下拉式選單中選取「Vulkan」

    範例:顯示如何在 UI 中變更 Graphics API 設定

  5. 使用控點 (=) 重新排序 Graphics API,讓 Vulkan 列在最前面。

  6. 視需要選取其他 Graphics API,然後按一下「移除」 (-) 按鈕移除。

Universal Render Pipeline

Android XR 支援通用算繪管線 (URP)。如果您打算使用透視功能,請更新預設 URP 設定,在 Android XR 上獲得最佳透視效能。

下表列出 Unity 建議的 URP 設定,後續章節會詳細說明。

設定

位置

建議值

高動態範圍

通用算繪管道資產

已停用

後置處理

通用轉譯器資料

已停用

通用算繪管道資產設定

請按照下列步驟,針對 Android XR 最佳化通用渲染管線資產:

  1. 找出專案的通用算繪管道資產。其中一種方法是在「Project」視窗的搜尋列中輸入 t:UniversalRenderPipelineAsset

  2. 在「畫質」標題下方,停用「HDR」

    顯示建議設定的通用算繪管道資產

通用 Renderer 資料設定

請按照下列步驟,針對 Android XR 最佳化通用算繪器資料:

  1. 找出專案的通用算繪器資料資產。其中一種方法是在「Project」視窗的搜尋列中輸入 t:UniversalRendererData

  2. 在「檢查器」的「後續處理」標題下方,取消勾選「已啟用」

    建議設定顯示的通用算繪器資料

最低 Android API 級別

將專案的最低 API 級別設為 24,這是 OpenXR Loader 的必要條件。否則建構作業可能會失敗。

請完成下列步驟,設定最低 Android API 級別。

  1. 依序前往「Edit」>「Project Settings」>「Player」。
  2. 選取「Android」分頁標籤,然後開啟「其他設定」
  3. 在「Identification」(識別) 區段中,選取「Minimal API level」(最低 API 級別) 24 以上。

應用程式進入點

設定應用程式進入點的下列設定:

  1. 依序前往「Edit」>「Project Settings」>「Player」。
  2. 選取「Android」分頁,然後開啟「其他設定」
  3. 在「Configuration」部分,確認「Application Entry Point」已勾選「GameActivity」,且未勾選「Activity」

彈出式視窗

大多數 Android XR 應用程式都需要可調整大小的視窗,因為必須顯示系統權限要求等彈出式視窗。

請按照下列步驟操作,確保彈出式視窗正確顯示。

  1. 依序前往「Edit」>「Project Settings」>「Player」。
  2. 選取「Android」分頁標籤,然後開啟「Resolution and Presentation」
  3. 在「解析度」部分,啟用「可調整大小的活動」

另請參閱


OpenXR™ 和 OpenXR 標誌是 The Khronos Group Inc. 的商標,已在中國、歐盟、日本和英國註冊為商標。