執行範例應用程式：HoloLens - Unity （C#）

發行項
01/10/2024

在本快速入門中，您將使用 Unity 執行適用於 HoloLens 的 Azure Spatial Anchors 範例應用程式（C#）。 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 應用程式、資料庫和記憶體帳戶。例如，您可以選擇稍後在一個簡單的步驟中刪除整個資源群組。
選取要放置資源的位置（區域）。
選取 [建立] 以開始建立資源。

Screenshot of the Spatial Anchors pane for creating a resource.

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

Screenshot showing that the resource deployment is complete.

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

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

Screenshot of the resource properties pane.

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

Screenshot showing the resource's account domain value.

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

Screenshot of the Keys pane for the account.

從準備 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 模組。
- 使用連線-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
```
將 property 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 編輯器。

Screenshot of the Unity pane.

選取 [檔案>建置設定]，以開啟 [建置 設定]。

在 [平臺] 區段中，選取 [通用 Windows 平台]。將 目標裝置 變更為 HoloLens。

選取 [切換平臺] 將平台變更為 [通用 Windows 平台]。如果缺少UWP支援元件，Unity可能會提示您安裝UWP支援元件。

Screenshot of the Unity Build Settings pane - HoloLens

關閉 [建置設定] 視窗。

設定帳戶資訊

下一個步驟是將應用程式設定為使用您的帳戶資訊。您稍早在[建立空間錨點資源] 區段中，將帳戶密鑰、帳戶標識碼和帳戶網域值複製到文本編輯器。

在 [ 專案 ] 窗格中，移至 Assets\AzureSpatialAnchors.SDK\Resources。

選取 [SpatialAnchorConfig]。在 [偵測器] 窗格中，輸入 Account Key 作為 [空間錨點帳戶密鑰] 的值、Account ID作為 [空間錨點帳戶標識符] 的值，以及 Account Domain 作為 [空間錨點帳戶網域] 的值。