XR 適用的 Android Studio 工具

這份文件將逐步說明如何使用 Android XR 模擬器,以及 Android Studio 中的版面配置檢查器,建構 XR 應用程式。

Android Studio 包含下列 XR 新功能:

  • Android XR 模擬器
  • 版面配置檢查器中的 XR 支援

Android Studio 模擬器畫面

Android XR 模擬器

Android XR 模擬器提供虛擬 XR 裝置,方便您在 Android Studio 中測試及偵錯 XR 應用程式。這項工具會模擬 XR 裝置,讓您在 3D 空間環境中體驗應用程式。這樣一來,您就能在早期開發階段建構應用程式,不必使用實體硬體,可簡化工作流程並加快疊代速度。

如果您是第一次使用 Android Studio 模擬器,建議先參閱 Android 模擬器一般說明文件

啟動 Android XR 模擬器

安裝 Android XR 模擬器後,按一下裝置管理員中的「Run」按鈕。

Android Studio 裝置管理員畫面

啟用滑鼠和鍵盤

目前模擬器僅支援滑鼠和鍵盤輸入。使用模擬器時,請務必選取鍵盤和滑鼠圖示。

Android Studio 裝置滑鼠和鍵盤圖示

完成上述步驟後,您就能將滑鼠游標移至模擬器視窗上方,開始與虛擬空間中的各種元素互動。

在虛擬環境中查看及移動

Android XR 模擬器會在虛擬 3D 環境中算繪應用程式元素。使用下列控制項變更檢視方向、平移、推拉、旋轉及重設:

Android Studio 平移圖示

平移:按住滑鼠並拖曳,即可向上、向下和左右移動。這樣就能從不同角度查看模擬器內容

Android Studio 貨車圖示

推拉鏡頭:按住滑鼠並拖曳,即可拉近或拉遠檢視畫面中的物件

Android Studio 旋轉圖示

旋轉:按住並拖曳滑鼠,即可朝該方向旋轉檢視畫面

Android Studio 重設圖示

重設:按一下這個按鈕,即可將模擬器恢復為預設檢視畫面

你也可以使用下列鍵盤快速鍵在虛擬環境中移動。如要在使用滑鼠和鍵盤輸入時使用這些功能,請按住 Option 鍵 (macOS) 或 Alt 鍵 (Windows)。

  • W 鍵 (或向上箭頭鍵):在目前檢視畫面中向前移動。
  • A 鍵 (或向左鍵):向左側步。
  • S 鍵 (或向下鍵):向後移動。
  • D 鍵 (或向右鍵):向右側步。
  • Q:垂直向下移動。
  • E:向上垂直移動。

啟用直通模式

使用下列選單選項啟用或停用模擬網址傳輸環境。

Android Studio Passthrough 模式 UI

啟用後,穿透模式會顯示模擬的室內環境。您可以使用這個模式測試混合實境應用程式。

Android Studio 模擬器畫面

其他模擬器控制項

Android Studio 電源圖示

電源:模擬開啟或關閉裝置

Android Studio 調高音量圖示 Android Studio 調低音量圖示

音量:模擬音量控制

Android Studio 螢幕截圖圖示

螢幕截圖:擷取裝置目前狀態的螢幕截圖

Android Studio 返回圖示 Android Studio 主畫面圖示 Android Studio 總覽圖示

Android 3 鍵控制:模擬「返回」、「主畫面」和「總覽」按鈕

疑難排解

請參閱版本資訊,瞭解所有已知問題和解決方法。

如果遇到的問題並非已知問題,請參閱支援頁面,瞭解如何取得協助及回報問題。

附上當機報告或錯誤報告,有助於我們進一步瞭解問題。螢幕截圖和錄影畫面也能提供所需的額外詳細資料。本節的說明將介紹如何上傳當機報告,以及如何使用 adb 產生錯誤報告。

搭配 XR 應用程式使用 Android Studio 版面配置檢查器

開始建構空間面板和軌跡物後,您可以使用 Android Studio 版面配置檢查器檢查版面配置。如果您不熟悉版面配置檢查器,請參閱版面配置偵錯指南

如要搭配 Android XR 應用程式使用版面配置檢查器,請按照下列步驟操作:

  1. 在 Android Studio 中開啟專案後,請務必停用內嵌的版面配置檢查器 (取消勾選選項並重新啟動 Android Studio)。Android Studio 設定頁面
  2. 執行應用程式。
  3. 應用程式部署完成後,請依序選擇「Tools」>「Layout Inspector」

這個版面配置檢查器會在內嵌視窗中開啟。幾秒後,左側會顯示預覽畫面,右側則會顯示元件樹狀結構。軌道和面板會顯示在主要內容下方,做為個別物件。

Android Studio 版面配置檢查器頁面

現在,您可以在模擬器中與應用程式互動。如要檢查任何元件,請在預覽畫面或元件樹狀結構中點選該元件。

按一下右下角的「屬性」分頁,即可查看元件屬性。

Android Studio 版面配置檢查器頁面

啟用使用統計資料,協助我們改善 Android Studio for XR

建議啟用使用統計資料並傳送意見回饋,協助我們改善這些工具。由於這是 Android Studio 的 Canary 版,因此許多功能仍在開發中。

依序點選「Settings」>「Appearance & Behavior」>「System Settings」>「Data Sharing」,然後確認已選取「Send usage statistics to google」

Android Studio 設定頁面


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