快速入門:使用 Azure Spatial Anchors 建立 Xamarin iOS 應用程式

本快速入門說明如何使用 Azure Spatial Anchors 建立搭配 Xamarin 的 iOS 應用程式。 Azure Spatial Anchors 是一款跨平台開發人員服務,可讓您使用在一段時間之後仍跨裝置保持其位置的物件,建立混合實境體驗。 完成作業後,您將會有可儲存和回收空間錨點的 iOS 應用程式。

您將學習如何:

  • 建立 Spatial Anchors 帳戶
  • 設定 Spatial Anchors 帳戶識別碼和帳戶金鑰
  • 在 iOS 裝置上部署和執行

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

Prerequisites

若要完成本快速入門,請確定您具備︰

建立 Spatial Anchors 資源

移至 Azure 入口網站

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

使用搜尋方塊搜尋 Spatial Anchors

顯示空間錨點搜尋結果的螢幕擷取畫面。

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

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

  • 使用規則英數字元,輸入唯一的資源名稱。

  • 選取您要連結資源的訂用帳戶。

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

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

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

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

[空間錨點] 窗格的螢幕擷取畫面,此窗格用於建立資源。

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

顯示資源部署已完成的螢幕擷取畫面。

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

將資源的 [帳戶識別碼] 值複製到文字編輯器,以供稍後使用。

資源屬性窗格的螢幕擷取畫面。

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

顯示資源帳戶網域值的螢幕擷取畫面。

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

帳戶 [金鑰] 窗格的螢幕擷取畫面。

開啟範例專案

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

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

在 Visual Studio 中開啟 Xamarin/SampleXamarin.sln

設定帳戶識別碼和金鑰

下一個步驟是將應用程式設定為使用您的帳戶識別碼和帳戶金鑰。 設定空間錨點資源時,將它們複製到文字編輯器中。

開啟 Xamarin/SampleXamarin.Common/AccountDetails.cs

找出 SpatialAnchorsAccountKey 欄位,並將 Set me 取代為帳戶金鑰。

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

找出 SpatialAnchorsAccountDomain 欄位,並將 Set me 取代為帳戶網域。

將應用程式部署到您的 iOS 裝置

將 iOS 裝置開啟電源並登入,然後使用 USB 纜線將其連接到電腦。

將起始專案設為 SampleXamarin.iOS、將 [解決方案組態] 變更為 [發行],然後在裝置選取器下拉式清單中選取要部署到的裝置。

Visual Studio 設定

選取 [執行] > [啟動但不偵錯] 以部署並啟動您的應用程式。

在應用程式中,選取 [基本] 以執行示範,依照指示放置及回收錨點。

螢幕擷取畫面 1 螢幕擷取畫面 2 螢幕擷取畫面 3

清除資源

在前述步驟中,您在資源群組中建立了 Azure 資源。 如果您認為未來不需要這些資源,可以用刪除資源群組的方式將它們刪除。

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

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

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

後續步驟

在本快速入門中,您建立了 Spatial Anchors 帳戶。 然後設定及部署了應用程式來儲存及回收 Spatial Anchors。 若要深入了解如何改善應用程式,以便與其他裝置共用 Spatial Anchors,請繼續下一個教學課程。