設定開發環境
使用 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。你可以採取下列其中一種做法:
下載 Android 適用的 ARCore SDK 並解壓縮。
-或是-
使用下列指令複製存放區:
git clone https://github.com/google-ar/arcore-android-sdk.git
準備裝置或模擬器
您可以在支援的裝置或 Android Emulator 中執行 AR 應用程式。執行模擬器之前,您必須先在模擬器上更新 AR 適用的 Google Play 服務。詳情請參閱在 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 典型。
使用即時刊登位置
「互動智慧搜尋刊登位置 API」可讓使用者將 AR 物件置於螢幕上,無需等待 ARCore 偵測表面幾何圖形。當使用者在環境中進一步移動時,物件位置會即時修正。一旦 ARCore 在偵測到 AR 物件所在的區域中偵測到正確的姿勢,物件就會自動更新為姿勢準確。
輕觸螢幕即可放置物件。看到螢幕上的全項物件顯示後,請務必持續移動裝置,讓 ARCore 可以取得與周遭環境相關的足夠資料,以準確地固定虛擬物件。
在圖 1 中,即時刊登位置已停用且未定義表面幾何圖形。 在集區資料表右側 (四個小藍點) 右側的地面物件呈現被淘汰,其姿勢沒有定義。
在圖 2 中,只要從齒輪圖示下方的選單啟用「即時刊登位置」,
在圖 3 中,「即時刊登」功能啟用後,新的物件會插入到場景中。 而是以灰階 (而非彩色) 表示,現在並未針對正確姿勢進行修正。
在圖 4 中,當偵測到表面幾何圖形 (由 trackable 格線線描述) 時,新物件會變色,且其姿勢正確。
使用深度
啟用深度時,ARCore 會將場景中物件的幾何圖形與位置納入考量,並且計算場景中物件相對於場景中其他物件的位置。這個物件可讓場景中的物件遮蔽所配置的物件,並給予應用程式的實際寫實。
在圖 1 中,深度已停用。物件在集區資料表下會放置。
在圖 2 中,當裝置在撞球桌周圍移動時,不論物件是否在場景中,物件看起來都會跟隨裝置。
圖 3 已啟用深度。
在圖 4 中,當裝置在情境中移動時,物件表格已被遮蔽。