在 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 或以上版本的 x86 或 x86_64 系統映像檔，然後選取 Next。

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

    • 僅支援 x86 的 Android 模擬器架構。系統目前不支援 arm64-v8a 和 armeabi-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.31.0_x86_for_emulator.apk。

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

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

    adb install -r Google_Play_Services_for_AR_1.31.0_x86_for_emulator.apk

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

控制虛擬場景

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

移動虛擬相機

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

平台 動作 建議行動
macOS 左右移動 按住 Option 鍵，然後按下 A 或 D 鍵
向上或向上移動 按住 Option 鍵，然後按下 Q 鍵或 E 鍵
前後移動 按住 Option 鍵，然後按下 W 或 S 鍵
變更裝置螢幕方向 按住 Option + 移動滑鼠
Linux 或 Windows 左右移動 按住 Alt + A 或 D 鍵
向上或向上移動 按住 Alt 鍵，然後按下 Q 鍵或 E 鍵
前後移動 按住 Alt + W 或 S 鍵
變更裝置螢幕方向 按住 Alt + 移動滑鼠

放開 Option 或 Alt 即可返回模擬器中的互動模式。

使用「延伸控制項」中的「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 版本。