在 Android Emulator 中執行 AR 應用程式

使用 Android Emulator 來測試沒有實體裝置的 AR 情境。透過 Android Emulator,您可以在虛擬的環境中使用您控制的模擬裝置執行 ARCore 應用程式。

設定開發環境

軟體需求:

取得適用於 ARCore 的 Android Studio 和 SDK 工具

  1. 安裝 Android Studio 3.1 或更新版本。

  2. 在 Android Studio 中,前往 Preferences > Appearance and Behavior > System Settings > Android SDK

  3. 選取 [SDK Platforms] 分頁標籤,然後勾選 [Show Package Details]。

    在適當的 Android 版本下,選取:
    Google API Intel x86 Atom 系統映像檔 API 級別 27 或以上版本。

  4. 選取 [SDK Tools] 標籤,然後新增 Android Emulator 27.2.9 或更新版本。

  5. 按一下 [OK] 即可安裝所選套件和工具。

  6. 再按一下 OK 確認變更。

  7. Accept 是 Component Installer 的授權協議。

  8. 按一下「Finish」。

建立支援 AR 的虛擬裝置

詳情請參閱 Android Studio 的建立虛擬裝置操作說明。

建立新的 Android 虛擬裝置 (AVD)

  1. 在 Android Studio 中,按一下 Tools > AVD Manager 即可開啟 AVD Manager

  2. 按一下「AVD Manager」對話方塊底部的 [Create Virtual Device]。

  3. 選取或建立所需的電話硬體設定檔,然後選取 Next

  4. 選取執行 API 級別 27 或以上版本x86x86_64 系統映像檔,然後選取 Next

    • 雖然 API 級別 24 以上的版本支援實體 ARCore 裝置,但 Android Emulator 支援需要 API 級別 27 或以上版本。

    • 僅支援 x86 的 Android 模擬器架構。系統目前不支援 arm64-v8aarmeabi-v7 等其他架構。

  5. 確認您的虛擬裝置已正確設定:

    • 按一下「Show Advanced Settings」。

    • 確認 Camera Back 已設為 VirtualScene

  6. 按一下 [Finish] 即可建立 AVD。

執行應用程式

在模擬器中支援 ARCore 的虛擬裝置上測試 ARCore 應用程式。請按照 Android Studio 中的操作說明,在 Android Emulator 中執行應用程式進行操作。

更新 Google Play 服務 - AR 適用

模擬器的 AR 適用的 Google Play 服務版本可能過舊。請按照下列操作說明更新:

  1. 請從 GitHub「版本」頁面下載最新的 Google_Play_Services_for_AR_1.32.0_x86_for_emulator.apk

  2. 將下載的 APK 安裝到您要使用的 AVD 中:

    啟動想要的 AVD,然後從系統資料夾拖曳下載的 APK (例如Downloads) 到執行中的模擬器,或是在虛擬裝置執行時使用 adb 安裝:

    adb install -r Google_Play_Services_for_AR_1.32.0_x86_for_emulator.apk

針對您想使用的額外 AVD,重複執行上述步驟。

控制虛擬場景

當應用程式連線到 ARCore 時,您將會看到一個疊加層,說明如何控制攝影機,模擬器視窗下方會顯示狀態列。

移動虛擬相機

按住 Option (macOS) 或 Alt (Linux 或 Windows) 即可存取相機移動控制項。使用下列控制項移動相機:

平台 動作 建議行動
macOS 左右移動 按住 Option 鍵,然後按下 AD
向上或向上移動 按住 Option 鍵,然後按下 Q 鍵或 E
前後移動 按住 Option 鍵,然後按下 WS
變更裝置螢幕方向 按住 Option + 移動滑鼠
LinuxWindows 左右移動 按住 Alt + AD
向上或向上移動 按住 Alt 鍵,然後按下 Q 鍵或 E
前後移動 按住 Alt + WS
變更裝置螢幕方向 按住 Alt + 移動滑鼠

放開 OptionAlt 即可返回模擬器中的互動模式。

使用「延伸控制項」中的「Virtual Sensors」分頁,更準確地定位裝置。

在場景中新增擴增圖片

將圖片載入模擬器的模擬環境,測試擴增圖片

使用 Extended controls 中的 [Camera] 標籤來新增或修改 Scene images。 兩張圖片位置分別顯示在牆上和桌上各處。

如要在場景中查看這些圖片位置,請啟動模擬器,然後透過相機起始位置後方的門,將攝影機移至用餐室。

疑難排解訣竅

  • 如果 ARCore 應用程式啟動,並顯示「這個裝置不支援 AR」訊息,請檢查系統映像檔上的修訂版本。請確定您使用的是 API 級別 27 修訂版本 4 或以上版本

  • 如果 ARCore 應用程式啟動時無法開啟相機,請確認 Camera Back 已設為 VirtualScene,如以上設定步驟所述。

  • 如果 ARCore 應用程式無法開啟,且出現「無法建立 AR 工作階段」錯誤訊息,請檢查應用程式記錄。如果您使用的 java.lang.UnsatisfiedLinkError 訊息包含 /lib/arm/libarcore_c.so" is for EM_ARM (40) instead of EM_386 (3),可能是因為你安裝的 Google Play 服務 AR 更新 APK 版本有誤。建立新的虛擬裝置並安裝 x86 版本。