如要開始搭配 Android 使用 ARCore,您可以執行 ARCore SDK 隨附的 hello_ar_kotlin 或 hello_ar_java 範例應用程式。這些範例應用程式使用 OpenGL,這是算繪 2D 和 3D 向量圖形的程式設計介面。應用程式會顯示任何偵測到的飛機,並讓使用者輕觸飛機來放置 3D 模型。
設定開發環境
安裝 Android SDK Platform 7.0 (API 級別 24) 以上版本的 Android Studio 3.1 以上版本。
如果您是 Android 新手,請參閱建構第一個 Android 應用程式。
開啟範例專案
在 Android Studio 中,複製 ARCore SDK GitHub 存放區。
方法有很多種:
如果你已安裝 Android Studio:
- 從 Git 選單中選取 Clone。
- 在 Version control 下拉式選單中,選取 Git 做為版本管控系統。
在 URL 欄位中,輸入下列網址前往 ARCore GitHub 存放區:
https://github.com/google-ar/arcore-android-sdk.git
您也可以開啟 Terminal 並發出
git clone
指令,如下所示:git clone https://github.com/google-ar/arcore-android-sdk.git
按照以下步驟開啟其中一個範例專案 (您必須明確開啟專案才能建構及執行)。
- 從 File 選單中選取 Open。
- 在 arcore-android-sdk/samples 資料夾中,選取 hello_ar_kotlin 或 hello_ar_java 資料夾,然後按一下 Open。
準備裝置或模擬器
您可以在支援的裝置或 Android Emulator 中執行 AR 應用程式。您必須先在模擬器上更新 Google Play 服務 - AR 適用,才能執行應用程式。詳情請參閱「在 Android Emulator 中執行 AR 應用程式 」。
執行範例
確認您的 Android 裝置已連線至開發機器,然後在 Android Studio 中按一下 Run 。
Android Studio 會將專案建構到可進行偵錯的 APK 中,安裝 APK,然後在裝置上執行應用程式。詳情請參閱建構並執行應用程式。
如果 Google Play 服務 - AR 適用遺失或版本過舊,系統可能會提示您安裝或更新。選取 CONTINUE 即可從 Google Play 商店安裝,或是按照「更新適用於 AR 的 Google Play 服務」的說明手動更新。
hello_ar_java 應用程式可讓您在偵測到的 AR 平面上放置 3D 立體 ARCore。可以透過 Android GL SurfaceView 實作,用來轉譯相機預覽畫面和基本 AR 物件 (例如 Planes 和 Anchor)。您可以在 com/google/ar/core/examples/java/common/samplerender
中找到 hello_ar_java 的算繪架構範例。
使用即時刊登位置
Instant Placement API:可讓使用者將 AR 物件放置在螢幕上,不必等待 ARCore 偵測表面幾何圖形。當使用者在環境周圍移動時,物件的位置會即時修正。
輕觸畫面放置物件。在畫面上看到虛擬物件後,請務必繼續移動裝置,讓 ARCore 取得周圍周圍的充足資料,以準確地錨定虛擬物件。
ARCore 偵測到表面幾何圖形,並在放置物件的地區建立可追蹤後,就會自動更新物件的姿勢以提升準確度。
圖 1 停用了即時刊登位置,且未定義表面幾何圖形。放置在撞球桌右側的物件 (四個小藍點) 顯示為消失,並代表其姿勢未定義。
在圖 2 中,按一下齒輪圖示下方的選單已啟用即時刊登位置功能。
在圖 3 中,已啟用即時放置功能,新物件會置於場景中。並以灰階顯示 (而非上色) 代表尚未修正此姿勢來保持準確姿勢。
在圖 4 中,當偵測到表面幾何圖形 (如「可追蹤」格線說明) 時,新物件的顏色會變色,且其姿勢正確無誤。
使用深度
啟用 Depth 時,ARCore 會考量場景中物件的幾何圖形和位置,並計算相較於場景中的其他物件,放置在場景中的物件位置。如此一來,場景中的物件就能遮住放置的物件,為應用程式提供寫實主義。
圖 1 中已停用「深度」。物件位在集區表格下方。
在圖 2 中,當裝置在集區表中移動時,物件會跟隨裝置而顯示,不受場景中的物件影響。
在圖 3 中,已啟用「深度」。
在圖 4 中,當裝置在場景中移動時,集區資料表會遮住物件。
後續步驟
- 嘗試在 ARCore SDK 中建構並執行其他範例專案。
- 請前往擴增實境程式碼研究室,查看更多可供建構及執行的範例應用程式。
- 瞭解如何在應用程式中啟用 ARCore。
- 查看執行階段注意事項。
- 詳閱設計規範。