在 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 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. 按一下「裝置管理工具」面板頂端的 Create Device。

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

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

    • 雖然 API 級別 24 以上版本支援實體 ARCore 裝置， 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.45.0_x86_for_emulator.apk 版本頁面。

  2. 在您要使用的每個 AVD 中安裝已下載的 APK：

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

    adb install -r Google_Play_Services_for_AR_1.45.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 版本