Android NDK 快速入門導覽課程

設定開發環境

  • 安裝 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 中，當裝置在場景中移動時，集區資料表會遮住物件。

後續步驟