設定開發環境
安裝 Android SDK Platform 7.0 (API 級別 24) 以上版本的 Android Studio 3.1 以上版本。
使用 SDK Manager 安裝 Android Native Development Kit (NDK) 和 CMake,藉此準備 Android Studio 進行原生開發。詳情請參閱 NDK 入門指南。
您需要取得 Android 適用的 ARCore SDK。你可以採取下列其中一種做法:
下載並擷取 ARCore SDK for Android。
-或是-
使用下列指令複製存放區:
git clone https://github.com/google-ar/arcore-android-sdk.git
準備裝置或模擬器
您可以在支援的裝置或 Android Emulator 中執行 AR 應用程式。您必須先在模擬器上更新 Google Play 服務 - AR 適用,才能執行應用程式。詳情請參閱「在 Android Emulator 中執行 AR 應用程式 」。
開啟範例專案
在 Android Studio 中,開啟 <ARCore SDK Folder>/samples/hello_ar_c
中的 hello_ar_c 範例專案。
範例專案含有特定軟體版本 (例如 Gradle 和 Android SDK) 的建構依附元件。如果未安裝必要的依附元件,Android Studio 會要求您授予在電腦上下載及安裝這些項目的權限。
執行範例
確認您的 Android 裝置已連線至開發機器,然後在 Android Studio 中按一下 Run 。
Android Studio 會將專案建構到可進行偵錯的 APK 中,安裝 APK,然後在裝置上執行應用程式。詳情請參閱建構並執行應用程式。
移動裝置時,應用程式會自動偵測平面並繪製菱形格線。輕觸格線,在表面上放置 3D 立體的 ARCore。
使用即時刊登位置
透過 Instant Placement API,使用者可以將 AR 物件放置在畫面中,不必等待 ARCore 偵測表面幾何圖形。當使用者在環境周圍移動時,物件的位置會即時修正。一旦 ARCore 偵測到 AR 物件所放置區域的正確姿勢,物件就會自動更新,進行姿勢。
輕觸畫面放置物件。在畫面上看到虛擬物件後,請務必繼續移動裝置,讓 ARCore 取得周圍周圍的充足資料,以準確地錨定虛擬物件。
圖 1 停用了即時刊登位置,且未定義表面幾何圖形。放置在撞球桌右側的物件 (四個小藍點) 顯示為消失,並代表其姿勢未定義。
在圖 2 中,按一下齒輪圖示下方的選單已啟用即時刊登位置功能。
在圖 3 中,已啟用即時放置功能,新物件會置於場景中。並以灰階顯示 (而非上色) 代表尚未修正此姿勢來保持準確姿勢。
在圖 4 中,當偵測到表面幾何圖形 (如「可追蹤」格線說明) 時,新物件的顏色會變色,且其姿勢正確無誤。
使用深度
啟用 Depth 時,ARCore 會考量場景中物件的幾何圖形和位置,並計算相較於場景中的其他物件,放置在場景中的物件位置。如此一來,場景中的物件就能遮住放置的物件,為應用程式提供寫實主義。
圖 1 中已停用「深度」。物件位在集區表格下方。
在圖 2 中,當裝置在集區表中移動時,物件會跟隨裝置而顯示,不受場景中的物件影響。
在圖 3 中,已啟用「深度」。
在圖 4 中,當裝置在場景中移動時,集區資料表會遮住物件。