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 應用程式。執行應用程式之前,您必須先在模擬器中更新 AR 適用的 Google Play 服務。詳情請參閱在 Android Emulator 中執行 AR 應用程式

執行範例

確認你的 Android 裝置已連接至開發機器,然後按一下 Android Studio 中的 [Run]

Android Studio 將您的專案建構成可偵錯的 APK、安裝 APK,然後在裝置上執行應用程式。詳情請參閱建構並執行應用程式一文。

如果 AR 服務遺失或過舊,系統可能會提示您安裝或更新 Google Play 服務 AR 適用。選取 CONTINUE 從 Google Play 商店安裝,或是按照更新 AR 適用的 Google Play 服務一文的說明手動更新。

hello_ar_java 應用程式可讓您在偵測到的 AR 平面表面上放置 3D ARCore pawn。這項功能是透過 Android GL SurfaceView 導入,用來呈現相機預覽畫面以及基本的 AR 物件 (例如飛機和錨點)。hello_ar_javacom/google/ar/core/examples/java/common/samplerender 的範例轉譯架構。

使用即時刊登位置

Instant Placement API 可讓使用者直接在畫面中放置 AR 物件,而不需等待 ARCore 偵測表面幾何圖形。當使用者在環境間移動時,物件刊登位置會即時修正。一旦 ARCore 偵測到 AR 物件所在的位置正確位置,白物件就會自動更新為 姿勢準確,且會變得不透明。

使用即時刊登位置放置虛擬物件

系統會自動在 hello_ar_java 中啟用「即時刊登位置」。輕觸畫面上的齒輪圖示,然後在下拉式選單中選擇 [Instant Placement]。「Enable Instant Placement」核取方塊應已勾選。

輕觸螢幕以放置物件。螢幕上顯示全貌物件時,請務必持續移動裝置,讓 ARCore 能取得足夠的周遭環境資料,以準確地鎖定虛擬物件。

後續步驟