設定 Unreal Engine 的直接預覽功能

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

Direct Preview 可讓您使用 Android XR 裝置的即時資料，直接在 Unreal Editor 中測試及疊代複雜的互動。使用 Direct Preview 時，主機機器會轉譯及偵錯內容，將視覺可視區域直接串流至實體 Android XR 裝置，並將支援的 OpenXR 擴充功能即時串流回主機。

請按照本指南，在 Unreal Engine 中為專案設定 Direct Preview。

必要條件

開始前，請確認開發環境符合下列需求：

  • Android XR 引擎控制中心：完成 Android XR 引擎控制中心指南「開始使用」一節中的所有步驟，安裝並設定主機，以便使用 Direct Preview。

  • 硬體：

    • 使用搭載 Windows 11 的主機。
    • 使用支援 Vulkan 影片編碼的新型顯示卡。

設定 Android XR 外掛程式

使用必要的 Android XR 外掛程式設定 Unreal Engine：

  1. 請按照「Android XR Extensions for Unreal Engine 快速入門導覽課程」指南中的步驟操作。

    日後，如果您建立新專案或開啟未與 Direct Preview 搭配使用的專案，請再次按照相同步驟操作。

  2. 確認每個專案都有指向供應商外掛程式資料夾的符號連結。

配置專案設定

設定 Direct Preview 串流的專案設定：

  1. 依序前往「專案設定」>「Platforms」>「Windows」。
  2. 將「RHI」設為「Vulkan」。
  3. 依序前往「Edit」>「Plugins」。
  4. 啟用 AndroidXRStreaming 外掛程式。
  5. 依序前往「Edit」 >「Project Settings」 >「Description」。
  6. 啟用「Start In VR」。

啟用串流執行階段

專案已啟用 AndroidXRStreaming 外掛程式，請檢查 Android XR Streaming 執行階段是否存在：

  1. 依序前往「Project Settings」>「Plugins」>「AndroidXRStreaming」。

  2. 按一下「Enable AndroidXR Streaming」。

    啟用 Android XR 串流執行階段

  3. 重新啟動 Unreal Engine 即可套用這些變更。

設定串流用戶端

根據專案需求，使用不同選項設定串流用戶端：

  1. 依序前往「Project Settings」>「Plugins」。

  2. 在「AndroidXRStreamingClient」部分，查看下列各個選項，並根據專案需求啟用或停用：

    • Auto Start Client On Preview：啟用後，在編輯器中點選「Start VR Preview」，即可在任何有效的所選裝置上啟動預覽用戶端應用程式。
    • Auto Stop Client On Preview：啟用後，當編輯器的 VR 預覽停止時，系統會終止預覽用戶端。
    • 自動選取相容裝置：啟用後，系統會在搜尋裝置時，自動選取第一部連線至機器的相容裝置。
    • 顯示錯誤對話方塊：啟用後，系統會顯示其他錯誤對話方塊 (例如，如果您嘗試啟動 VR 預覽，但未選取用戶端裝置，系統就會顯示錯誤對話方塊)。停用這個選項即可隱藏這些對話方塊。
    • 重新整理：啟用後，點選「重新整理」按鈕會搜尋已連結的裝置，並列出相容的裝置 (取決於 Android XR 引擎控制中心中是否有 Direct Preview 用戶端應用程式)。

啟動 Direct Preview

啟動 Direct Preview，直接從 Unreal Engine 串流：

  1. 使用高品質的 USB-C 傳輸線，將 Android XR 裝置連接至主機。

  2. 如果您從未在這部裝置上使用 Direct Preview，請先在 Android XR 引擎控制中心中連線並設定裝置，再透過遊戲引擎啟動 Direct Preview。

  3. 在 Unreal 編輯器中，按一下「Play level in VR」。啟動 Direct Preview 時，請勿使用一般的「Play in Editor」選項。