在 Android Emulator 中執行 AR 應用程式

使用 Android Emulator 測試沒有實體裝置的 AR 情境。Android Emulator 可讓您利用所控制的模擬裝置，在虛擬環境中執行 ARCore 應用程式。

設定開發環境

軟體需求：

• Android Studio 3.1 以上版本。

• Android Emulator 27.2.9 或更高版本。

取得適用於 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 為 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 Emulator 架構。目前不支援 arm64-v8a 和 armeabi-v7 等其他架構。

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

   • 按一下「Show Advanced Settings」。

   • 確認 Camera Back 已設為 VirtualScene。

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

執行應用程式

在模擬器中針對支援 AR 的虛擬裝置測試 ARCore 應用程式。方法很簡單，只要按照 Android Studio 的操作說明，在 Android Emulator 中執行應用程式即可。

注意： 如要在 Android Emulator 中使用 NDK 元件執行應用程式，您的應用程式必須使用 x86 ABI 建構。如需範例，請參閱 ARCore HelloAR C 範例應用程式。

更新 AR 適用的 Google Play 服務

模擬器上的 Google Play 服務 AR 版本可能過舊。請按照以下說明操作：

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

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

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

   adb install -r Google_Play_Services_for_AR_1.36.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 以返回模擬器中的互動模式。

使用「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) 的訊息，可能是因為您安裝的 AR 專用 Google Play 服務 APK 版本有誤。建立新的虛擬裝置，並安裝 x86 版本。