在 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 APIs Intel x86 Atom System Image」API 級別 27 以上版本。

  4. 選取 SDK Tools 分頁標籤，然後新增 Android Emulator 27.2.9 以上版本。

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

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

  7. Accept 元件安裝程式授權協議。

  8. 按一下「Finish」。

建立支援 AR 的虛擬裝置

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

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

  1. 在 Android Studio 中按一下 Tools > Device Manager，開啟「Device Manager」。

  2. 按一下「Device Manager」面板頂端的 Create Device。

  3. 選取或建立所需的「Phone」硬體設定檔，然後選取 Next。

  4. 選取執行 API 級別 27 以上的 x86 或 x86_64 系統映像檔，然後選取 Next。

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

    • 僅支援以 x86 為基礎的 Android Emulator 架構。目前不支援其他架構，例如 arm64-v8a、armeabi-v7。

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

    • 按一下「Show Advanced Settings」。

    • 確認 Camera Back 已設為 VirtualScene。

  6. 按一下 Finish 建立 AVD。

執行應用程式

在模擬器中使用 AR 支援的虛擬裝置測試 ARCore 應用程式。方法是按照 Android Studio 的操作說明，在 Android Emulator 中執行應用程式。

更新「Google Play 服務 - AR 適用」設定

在模擬器中使用的 Google Play 服務 - AR 版本可能過舊。請按照下列步驟更新：

  1. 從 GitHub 版本頁面下載最新的 Google_Play_Services_for_AR_1.41.0_x86_for_emulator.apk。

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

    啟動所需的 AVD，然後從系統資料夾中拖曳下載的 APK (即Downloads) 於執行中的模擬器上，或在虛擬裝置執行時使用 adb 安裝：

    adb install -r Google_Play_Services_for_AR_1.41.0_x86_for_emulator.apk

如要使用其他 AVD，請重複執行上述步驟。

控制虛擬場景

當您的應用程式連線至 ARCore 時，會在模擬器視窗下方看到如何控制相機的重疊元素，以及模擬器視窗下方的狀態列。

移動虛擬攝影機

按住 Shift 即可存取攝影機動作控制選項。 請使用下列控制項移動攝影機：

動作 進行方式
向左或向右移動 按住 Shift + A 或 D 鍵
向下或向上移動 按住 Shift + Q 鍵或 E 鍵
前後移動 按住 Shift + W 鍵或 S 鍵
變更裝置螢幕方向 按住 Shift + 移動滑鼠

發布 Shift 即可返回模擬器中的互動模式。

使用「Extended controls」中的「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 版本。