Godot Engine 專案設定

適用的 XR 裝置
這份指南可協助您為這類 XR 裝置打造體驗。
瞭解 XR 裝置類型 →
XR 頭戴式裝置
有線 XR 眼鏡
瞭解 XR 裝置類型 →

本指南詳細說明為 Android XR 開發 Godot Engine 應用程式時，建議使用的引擎版本、必要 SDK 和 Android 專案設定。

必要條件

如要設定 Godot Engine 專案以進行 Android XR 開發，請先完成下列必要條件：

  1. 從 Godot 官方網站下載 Godot 4.6.2。
  2. 確認你擁有 XR 頭戴式裝置或 XR 眼鏡。
  3. 安裝 Android Studio。

安裝 Android 建構支援

Godot 需要特定的 Android 建構工具，才能編譯及匯出空間運算套件。

  1. 在 Android Studio 中，使用 SDK Manager 安裝下列套件和工具：

    • Android SDK 平台：Android 14.0 (「UpsideDownCake」) (API 級別 34)
    • Android SDK 建構工具：34.0.0 以上版本
    • NDK：任何 28.x 版本
    • CMake：3.10.2 版

    您可能需要在 SDK Manager 中選取「顯示套件詳細資料」，才能查看工具的所有可用版本。

  2. 在 Godot 中，依序前往「Editor」>「Editor Settings」>「Export」>「Android」，然後提供 SDK 的路徑。

建立 Godot XR 專案

為空間算繪設定新專案：

  1. 開啟 Godot 並建立新專案。

  2. 在「Renderer」(轉譯器) 部分，選取「Mobile」(行動裝置)。

    這是高效能的 Vulkan 優先圖形 API，建議用於 Android XR。

    Godot Engine 中的「Create New Project」(建立新專案) 對話方塊。

  3. 視需要選取其他選項，然後按一下「建立」。

  4. 使用官方 Godot XR 場景設定指南，建構內部 XR 場景 (包括 XROrigin3D 和 XRCamera3D)。

    在新 Godot 專案中建構內部 XR 場景

配置專案設定

接著，您將設定專案設定，啟用 OpenXR 並設定行動裝置效能的算繪管線：

  1. 開啟 Godot。
  2. 設定 OpenXR 的下列專案設定：
    • 依序前往「Project」>「Project Settings」>「XR」>「OpenXR」，然後選取「Enabled」。
    • 依序前往「Project」>「Project Settings」>「XR」>「Shaders」，然後選取「Enabled」。

  3. 依序前往「Rendering」>「Anti Aliasing」>「Quality」>「MSAA 3D」，然後選取「4x」。

    這項設定可提供 Android XR 最佳清晰度。

設定專案，以便匯出至 Android XR

如要設定專案以匯出至 Android XR，請完成下列步驟：

  1. 設定匯出預設集：依序前往「Project」>「Export」，然後按一下「Add...」> Android。

  2. 完成部署指南：請按照官方 Godot Android 部署指南的逐步操作說明，瞭解權限和一鍵部署。

  3. 檢查專案的 SDK 版本：

    • 最低 SDK：34
    • 目標 SDK：34

  4. 設定 XR 模式：在匯出設定中，將 XR 模式設為 OpenXR。

安裝 Godot OpenXR 供應商外掛程式

應用程式必須使用供應商外掛程式，才能存取 Android XR 專屬擴充功能。 請按照下列步驟取得相容版本：

  1. 在 Godot 中選取「AssetLib」。

  2. 搜尋「供應商」。

    搜尋 Godot Asset Library，即可找到不同版本的 Godot OpenXR Vendors 外掛程式

  3. 找到 5.1 以上版本的 Godot OpenXR 供應商外掛程式並下載。

  4. 下載完成後，選取「安裝」。

    安裝 Godot OpenXR 供應商外掛程式

另請參閱

如要進一步瞭解如何使用 Godot 開發 Android XR 應用程式，請參閱 Godot Engine 說明文件中的下列頁面：