這份文件將逐步說明如何使用 Android XR 模擬器,以及 Android Studio 中的版面配置檢查器,建構 XR 應用程式。
Android Studio 包含下列 XR 新功能:
- Android XR 模擬器
- 版面配置檢查器中的 XR 支援

Android XR 模擬器
Android XR 模擬器提供虛擬 XR 裝置,方便您在 Android Studio 中測試及偵錯 XR 應用程式。這項工具會模擬 XR 裝置,讓您在 3D 空間環境中體驗應用程式。這樣一來,您就能在早期開發階段建構應用程式,不必使用實體硬體,可簡化工作流程並加快疊代速度。
如果您是第一次使用 Android Studio 模擬器,建議先參閱 Android 模擬器一般說明文件。
啟動 Android XR 模擬器
安裝 Android XR 模擬器後,按一下裝置管理員中的「Run」按鈕。

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

完成上述步驟後,您就能將滑鼠游標移至模擬器視窗上方,開始與虛擬空間中的各種元素互動。
在虛擬環境中查看及移動
Android XR 模擬器會在虛擬 3D 環境中算繪應用程式元素。使用下列控制項變更檢視方向、平移、推拉、旋轉及重設:
|
平移:按住滑鼠並拖曳,即可向上、向下和左右移動。這樣就能從不同角度查看模擬器內容 |
|
推拉鏡頭:按住滑鼠並拖曳,即可拉近或拉遠檢視畫面中的物件 |
|
旋轉:按住並拖曳滑鼠,即可朝該方向旋轉檢視畫面 |
|
重設:按一下這個按鈕,即可將模擬器恢復為預設檢視畫面 |
你也可以使用下列鍵盤快速鍵在虛擬環境中移動。如要在使用滑鼠和鍵盤輸入時使用這些功能,請按住 Option 鍵 (macOS) 或 Alt 鍵 (Windows)。
- W 鍵 (或向上箭頭鍵):在目前檢視畫面中向前移動。
- A 鍵 (或向左鍵):向左側步。
- S 鍵 (或向下鍵):向後移動。
- D 鍵 (或向右鍵):向右側步。
- Q:垂直向下移動。
- E:向上垂直移動。
啟用直通模式
使用下列選單選項啟用或停用模擬網址傳輸環境。

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

其他模擬器控制項
|
電源:模擬開啟或關閉裝置 |
|
音量:模擬音量控制 |
|
螢幕截圖:擷取裝置目前狀態的螢幕截圖 |
|
Android 3 鍵控制:模擬「返回」、「主畫面」和「總覽」按鈕 |
疑難排解
請參閱版本資訊,瞭解所有已知問題和解決方法。
如果遇到的問題並非已知問題,請參閱支援頁面,瞭解如何取得協助及回報問題。
附上當機報告或錯誤報告,有助於我們進一步瞭解問題。螢幕截圖和錄影畫面也能提供所需的額外詳細資料。本節的說明將介紹如何上傳當機報告,以及如何使用 adb 產生錯誤報告。
搭配 XR 應用程式使用 Android Studio 版面配置檢查器
開始建構空間面板和軌跡物後,您可以使用 Android Studio 版面配置檢查器檢查版面配置。如果您不熟悉版面配置檢查器,請參閱版面配置偵錯指南。
如要搭配 Android XR 應用程式使用版面配置檢查器,請按照下列步驟操作:
- 在 Android Studio 中開啟專案後,請務必停用內嵌的版面配置檢查器 (取消勾選選項並重新啟動 Android Studio)。

- 執行應用程式。
- 應用程式部署完成後,請依序選擇「Tools」>「Layout Inspector」。
這個版面配置檢查器會在內嵌視窗中開啟。幾秒後,左側會顯示預覽畫面,右側則會顯示元件樹狀結構。軌道和面板會顯示在主要內容下方,做為個別物件。

現在,您可以在模擬器中與應用程式互動。如要檢查任何元件,請在預覽畫面或元件樹狀結構中點選該元件。
按一下右下角的「屬性」分頁,即可查看元件屬性。

啟用使用統計資料,協助我們改善 Android Studio for XR
建議啟用使用統計資料並傳送意見回饋,協助我們改善這些工具。由於這是 Android Studio 的 Canary 版,因此許多功能仍在開發中。
依序點選「Settings」>「Appearance & Behavior」>「System Settings」>「Data Sharing」,然後確認已選取「Send usage statistics to google」。

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