共用方式為


執行範例應用程式:Android - Android Studio (Java 或 C++/NDK)

本快速入門說明如何使用 Android Studio 執行適用於 Android 裝置的 Azure Spatial Anchors 範例應用程式(Java 或 C++/NDK)。 Azure Spatial Anchors 是一項跨平臺開發人員服務,可讓您使用物件建立混合實境體驗,這些物件會隨著時間在裝置之間保存其位置。 完成時,您將會有 ARCore Android 應用程式,可儲存並重新叫用空間錨點。

您將學習如何:

  • 建立 Spatial Anchors 帳戶
  • 設定 Spatial Anchors 帳戶標識碼和帳戶密鑰
  • 在Android裝置上部署和執行

如果您沒有 Azure 訂閱,請在開始之前,先建立 Azure 免費帳戶

必要條件

若要完成本快速入門,請確定您有:

  • 具有 Android Studio 3.4+Windows 或 macOS 計算機。
    • 如果在 Windows 上執行,您也需要 適用於 WindowsGit LFS 的 Git。
    • 如果在 macOS 上執行,請透過 HomeBrew 取得 Git 安裝。 在終端機的單行中輸入下列命令: /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"。 然後,執行 brew install gitbrew install git-lfs
    • 若要建置 NDK 範例,您也必須在 Android Studio 中安裝 NDK 和 CMake 3.6 或更新版本的 SDK 工具。
  • 已啟用開發人員且支援ARCore的Android裝置。
    • 您的電腦可能需要額外的設備驅動器才能與 Android 裝置通訊。 如需詳細資訊和指示,請參閱 這裡
  • 您的應用程式必須以 ARCore 1.11.0 為目標。

建立 Spatial Anchors 資源

前往 Azure 入口網站

在左窗格中,選取 [建立資源]。

使用搜尋方塊來搜尋 Spatial Anchors

顯示搜尋 Spatial Anchors 結果的螢幕快照。

選取 [空間錨點],然後選取 [ 建立]。

在 [ 空間錨點帳戶 ] 窗格上,執行下列動作:

  • 使用一般英數位元輸入唯一的資源名稱。

  • 選取您要附加資源的訂用帳戶。

  • 選取 [新建] 以建立資源群組。 將它命名為 myResourceGroup,然後選取 [ 確定]。

    資源群組是一個邏輯容器,可在其中部署與管理 Azure 資源 (例如 Web 應用程式、資料庫和儲存體帳戶)。 例如,您可以選擇在稍候透過一個簡單的步驟刪除整個資源群組。

  • 選取要放置資源的位置(區域)。

  • 選取 [建立] 開始建立資源。

[空間錨點] 窗格的螢幕快照,用於建立資源。

建立資源之後,Azure 入口網站 會顯示您的部署已完成。

顯示資源部署已完成的螢幕快照。

選取 [前往資源] 。 您現在可以檢視資源屬性。

將資源的 [帳戶標識符 ] 值複製到文本編輯器中,以供稍後使用。

資源屬性窗格的螢幕快照。

此外,將資源的 帳戶網域 值複製到文本編輯器中,以供稍後使用。

顯示資源的帳戶網域值的螢幕快照。

在 [設定] 底下,選取 [存取金鑰]。 將 [主要金鑰] 值 [帳戶金鑰] 複製到文字編輯器,以供稍後使用。

帳戶 [金鑰] 窗格的螢幕快照。

開啟範例專案

執行下列命令來複製範例存放

git clone https://github.com/Azure/azure-spatial-anchors-samples.git
cd ./azure-spatial-anchors-samples

開啟 Android Studio。

選取 [開啟現有的 Android Studio 專案 ],然後選取位於 Android/Java/的專案。

設定帳戶識別碼和金鑰

下一個步驟是將應用程式設定為使用您的帳戶標識碼和帳戶密鑰。 您在設定 Spatial Anchors 資源,將它們複製到文字編輯器中。

開啟 [Android/Java/app/src/main/java/com/microsoft/sampleandroid/AzureSpatialAnchorsManager.java]。

找出欄位, SpatialAnchorsAccountKey 並以帳戶金鑰取代 Set me

找出欄位, SpatialAnchorsAccountId 並以帳戶識別碼取代 Set me

找出欄位, SpatialAnchorsAccountDomain 並以帳戶網域取代 Set me

將應用程式部署至Android裝置

在 Android 裝置上開啟電源、登入,並使用 USB 纜線將其連線到電腦。

從 Android Studio 工具列選取 [ 執行 ]。

Android Studio 部署和執行

[選取部署目標 ] 對話框中選取 Android 裝置,然後選取 [ 確定 ] 在 Android 裝置上執行應用程式。

請遵循應用程式中的指示來放置並重新叫用錨點。

從 Android Studio 工具列選取 [停止 ] 以停止應用程式。

Android Studio Stop

清除資源

在上述步驟中,您已建立資源群組中的 Azure 資源。 如果您預期未來不需要這些資源,則可以藉由刪除資源群組予以刪除。

從 Azure 入口網站功能表或 [首頁] 頁面,選取 [資源群組]。 然後,在 [資源群組] 頁面上,選取 [myResourceGroup]

在 [myResourceGroup] 頁面上,確定所列出的資源是您想要刪除的項目。

選取 [刪除資源群組],在文字方塊中輸入 myResourceGroup,然後選取 [刪除]

下一步

在本快速入門中,您已建立 Spatial Anchors 帳戶。 然後,您已設定並部署應用程式,以儲存並重新叫用空間錨點。 若要深入瞭解如何改善應用程式,使其可以與其他裝置共享空間錨點,請繼續進行下一個教學課程。