執行範例應用程式：HoloLens - Unity (C#)

發行項
03/10/2023

在本快速入門中，您將使用 Unity (C#) 執行 HoloLens 的 Azure Spatial Anchors 範例應用程式。 Spatial Anchors 是一款跨平台開發人員服務，可讓您使用在一段時間之後仍跨裝置保持其位置的物件，建立混合式實境體驗。當您完成時，您將會有搭配 Unity 建置的 HoloLens 應用程式，並可儲存和回收空間錨點。

您將學習如何：

建立 Spatial Anchors 帳戶。
準備 Unity 組建設定。
設定 Spatial Anchors 帳戶識別碼和帳戶金鑰。
匯出 HoloLens Visual Studio 專案。
在 HoloLens 裝置上部署應用程式並加以執行。

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

必要條件

若要完成本快速入門：

您需要已啟用開發人員模式的 HoloLens 裝置。針對HoloLens 2必須在裝置上安裝Windows 10 2020 年 5 月更新或更新版本。若要更新至 HoloLens 上的最新版本，請開啟 [ 設定 ] 應用程式，移至 [ 更新 & 安全性]，然後選取 [ 檢查更新]。
您需要已安裝 Visual Studio 2019 或更新版本的 Windows 電腦。您的 Visual Studio 安裝必須包含通用 Windows 平台開發工作負載和 Windows 10 SDK (10.0.18362.0 或更新版本) 元件。您也必須安裝 Git for Windows 和 Git LFS。
您必須安裝 Unity。如需支援的版本和必要功能，請流覽 Unity 專案設定頁面。

建立 Spatial Anchors 資源

移至 Azure 入口網站。

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

使用搜尋方塊搜尋 Spatial Anchors。

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

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

使用規則英數字元，輸入唯一的資源名稱。
選取您要連結資源的訂用帳戶。
選取 [新建] 來建立資源群組。將其命名為 myResourceGroup，然後選取 [確定]。

資源群組是一個邏輯容器，可在其中部署與管理 Azure 資源 (例如 Web 應用程式、資料庫和儲存體帳戶)。例如，您可以選擇在稍候透過一個簡單的步驟刪除整個資源群組。
選取要在其中放置資源的位置 (區域)。
選取 [建立] 開始建立資源。

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

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

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

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

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

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

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

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

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

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

從準備適用於 Azure CLI 的環境開始：

在 Azure Cloud Shell 中使用 Bash 環境。如需詳細資訊，請參閱Azure Cloud Shell中的 Bash 快速入門。
若要在本地執行 CLI 參考命令，請安裝 Azure CLI。若您在 Windows 或 macOS 上執行，請考慮在 Docker 容器中執行 Azure CLI。如需詳細資訊，請參閱〈如何在 Docker 容器中執行 Azure CLI〉。
- 如果您使用的是本機安裝，請使用 az login 命令，透過 Azure CLI 來登入。請遵循您終端機上顯示的步驟，完成驗證程序。如需其他登入選項，請參閱使用 Azure CLI 登入。
- 出現提示時，請在第一次使用時安裝 Azure CLI 延伸模組。如需擴充功能詳細資訊，請參閱使用 Azure CLI 擴充功能。
- 執行 az version 以尋找已安裝的版本和相依程式庫。若要升級至最新版本，請執行 az upgrade。

登入之後，請使用 az account set 命令來選取要在其中設定空間錨點帳戶的訂用帳戶：
```
az account set --subscription 00000000-0000-0000-0000-000000000000
```
執行 az group create 命令以建立資源群組，或使用現有的資源群組：
```
az group create --name myResourceGroup --location eastus2
```
資源群組是一個邏輯容器，可在其中部署與管理 Azure 資源 (例如 Web 應用程式、資料庫和儲存體帳戶)。例如，您可以選擇在稍候透過一個簡單的步驟刪除整個資源群組。

您可以使用 az spatial-anchors-account list 命令來檢視資源群組的目前空間錨點帳戶：
```
az spatial-anchors-account list --resource-group myResourceGroup
```
您也可以檢視訂用帳戶的空間錨點帳戶：
```
az spatial-anchors-account list
```

執行 az spatial-anchors-account create 命令來建立您的空間錨點帳戶：

az spatial-anchors-account create --resource-group myResourceGroup --name MySpatialAnchorsQuickStart --location eastus2

使用 az spatial-anchors-account show 命令來檢視資源屬性：
```
az spatial-anchors-account show --resource-group myResourceGroup --name MySpatialAnchorsQuickStart
```
將資源 [帳戶識別碼] 值和資源 [帳戶網域] 值複製到文字編輯器以供稍後使用。

執行 az spatial-anchors-account key show 命令來取得主要和次要金鑰：

az spatial-anchors-account key show --resource-group myResourceGroup --name MySpatialAnchorsQuickStart

將金鑰值複製到文字編輯器以供稍後使用。

如果您需要重新產生金鑰，請使用 az spatial-anchors-account key renew 命令：

az spatial-anchors-account key renew --resource-group myResourceGroup --name example --key primary
az spatial-anchors-account key renew --resource-group myResourceGroup --name example --key secondary

您可以使用 az spatial-anchors-account delete 命令來刪除帳戶：

az spatial-anchors-account delete --resource-group myResourceGroup --name MySpatialAnchorsQuickStart

從準備適用於 Azure PowerShell 的環境開始：

如果您選擇在本機使用 Azure PowerShell：
- 安裝 Az PowerShell 模組。
- 使用 Connect-AzAccount Cmdlet 連線至 Azure 帳戶。
如果您選擇使用 Azure Cloud Shell：
- 請參閱 Azure Cloud Shell 概觀以取得詳細資訊。

重要

Az.MixedReality PowerShell 模組處於預覽狀態，因此必須使用 Install-Module Cmdlet 個別安裝。此 PowerShell 模組正式推出後，便會成為未來 Az PowerShell 模組版本的一部分，且預設可從 Azure Cloud Shell 內使用。

Install-Module -Name Az.MixedReality

登入之後，請使用 Set-AzContext Cmdlet 選取要在其中設定空間錨點帳戶的訂用帳戶：
```
Set-AzContext -SubscriptionId 00000000-0000-0000-0000-000000000000
```
請使用 New-AzResourceGroup Cmdlet 建立資源群組，或使用現有的資源群組：
```
New-AzResourceGroup -Name myResourceGroup -Location eastus2
```
資源群組是一個邏輯容器，可在其中部署與管理 Azure 資源 (例如 Web 應用程式、資料庫和儲存體帳戶)。例如，您可以選擇在稍候透過一個簡單的步驟刪除整個資源群組。

您可以使用 Get-AzSpatialAnchorsAccount Cmdlet 檢視資源群組目前的空間錨點帳戶：
```
Get-AzSpatialAnchorsAccount -ResourceGroup myResourceGroup
```
您也可以檢視訂用帳戶的空間錨點帳戶：
```
Get-AzSpatialAnchorsAccount
```

執行 New-AzSpatialAnchorsAccount Cmdlet 以建立空間錨點帳戶：

New-AzSpatialAnchorsAccount -ResourceGroup myResourceGroup -Name MySpatialAnchorsQuickStart -Location eastus2

使用 Get-AzSpatialAnchorsAccount Cmdlet 檢視資源屬性：
```
Get-AzSpatialAnchorsAccount -ResourceGroup myResourceGroup -Name MySpatialAnchorsQuickStart
```
將 accountId 屬性值和 accountDomain 屬性值複製到文字編輯器中，以供後續使用。

執行 Get-AzSpatialAnchorsAccountKey Cmdlet 以取得主要和次要金鑰：

Get-AzSpatialAnchorsAccountKey -ResourceGroup myResourceGroup -Name MySpatialAnchorsQuickStart

將金鑰值複製到文字編輯器以供稍後使用。

如果您需要重新產生金鑰，請使用 New-AzSpatialAnchorsAccountKey Cmdlet：

New-AzSpatialAnchorsAccountKey -ResourceGroupName myResourceGroup -Name MySpatialAnchorsQuickStart -Primary
New-AzSpatialAnchorsAccountKey -ResourceGroupName myResourceGroup -Name MySpatialAnchorsQuickStart -Secondary

您可以使用 Remove-AzSpatialAnchorsAccount Cmdlet 將帳戶刪除：

Remove-AzSpatialAnchorsAccount -ResourceGroup myResourceGroup -Name MySpatialAnchorsQuickStart

下載範例專案並匯入 SDK

複製範例存放庫

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

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

匯入 ASA SDK

請遵循這裡的指示，下載並匯入 HoloLens 平臺所需的 ASA SDK 套件。

設定 Unity

在 Unity 中，開啟 Unity 資料夾中的專案。 Unity 可能會提示您，專案中的版本與您已在電腦上安裝的版本有何差異。只要您的 Unity 編輯器版本比建立專案所使用的版本還要新，這個警告沒有問題。如果您的版本較新，請選取 [繼續]。如果您的版本比專案需要的版本還要舊，請選取 [結束]，並且升級您的 Unity 編輯器。

Unity 窗格的螢幕擷取畫面。