Android 快速入門導覽課程

如要開始搭配 Android 使用 ARCore,您可以執行 ARCore SDK 隨附的 hello_ar_kotlinhello_ar_java 範例應用程式。這些範例應用程式使用 OpenGL,這是算繪 2D 和 3D 向量圖形的程式設計介面。應用程式會顯示任何偵測到的飛機,並讓使用者輕觸飛機來放置 3D 模型。

設定開發環境

開啟範例專案

  1. 在 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
  2. 按照以下步驟開啟其中一個範例專案 (您必須明確開啟專案才能建構及執行)。

    • File 選單中選取 Open
    • arcore-android-sdk/samples 資料夾中,選取 hello_ar_kotlinhello_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 中,當裝置在場景中移動時,集區資料表會遮住物件。

後續步驟