サンプルアプリを実行する: 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 May 2020 Update 以降がデバイスにインストールされている必要があります。 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」を検索します。

[Spatial Anchors] を選択し、 [作成] を選択します。

[Spatial Anchors アカウント] ウィンドウで次を行います。

通常の英数字を使用して一意のリソース名を入力します。
リソースをアタッチするサブスクリプションを選択します。
[新規作成] を選択して、リソースグループを作成します。「myResourceGroup」と名前を付け、 [OK] を選択します。

リソースグループとは、Web アプリ、データベース、ストレージアカウントなどの Azure リソースのデプロイと管理に使用する論理コンテナーです。たとえば、後から簡単な手順で一度にリソースグループ全体を削除することもできます。
リソースを配置する場所 (リージョン) を選択します。
[作成] を選択して、リソースの作成を開始します。

Screenshot of the Spatial Anchors pane for creating a resource.

リソースが作成されると、Azure portal に、デプロイが完了したことが表示されます。

Screenshot showing that the resource deployment is complete.

[リソースに移動] を選択します。これでリソースのプロパティを表示できます。

リソースの [アカウント ID] 値は後で使用するためにテキストエディターにコピーしておきます。

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 コマンドを使用して、Spatial Anchors アカウントを設定するサブスクリプションを選択します。
```
az account set --subscription 00000000-0000-0000-0000-000000000000
```
az group create コマンドを実行してリソースグループを作成するか、既存のリソースグループを使用します。
```
az group create --name myResourceGroup --location eastus2
```
リソースグループとは、Web アプリ、データベース、ストレージアカウントなどの Azure リソースのデプロイと管理に使用する論理コンテナーです。たとえば、後から簡単な手順で一度にリソースグループ全体を削除することもできます。

リソースグループの現在の Spatial Anchors アカウントを表示するには、az spatial-anchors-account list コマンドを使用します。
```
az spatial-anchors-account list --resource-group myResourceGroup
```
また、ご利用のサブスクリプションの Spatial Anchors アカウントを表示することもできます。
```
az spatial-anchors-account list
```

Spatial Anchors アカウントを作成するには、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
```
リソースの [アカウント ID] 値とリソースの [アカウントドメイン] 値を後で使用するためにテキストエディターにコピーします。
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 コマンドレットを使用して、Azure アカウントに接続します。
Azure Cloud Shell を使用する場合は、次のようにします。
- 詳細については、Azure Cloud Shell の概要に関するページを参照してください。

重要

Az.MixedReality PowerShell モジュールがプレビュー段階にある間は、Install-Module コマンドレットを使用して、これを別途インストールする必要があります。この PowerShell モジュールは、一般提供されると、将来の Az PowerShell モジュールリリースに含まれ、既定で Azure Cloud Shell 内から使用できるようになります。

Install-Module -Name Az.MixedReality

サインインしたら、Set-AzContext コマンドレットを使用して、Spatial Anchors アカウントを設定するサブスクリプションを選択します。
```
Set-AzContext -SubscriptionId 00000000-0000-0000-0000-000000000000
```
New-AzResourceGroup コマンドレットを実行してリソースグループを作成するか、または既存のリソースグループを使用します。
```
New-AzResourceGroup -Name myResourceGroup -Location eastus2
```
リソースグループとは、Web アプリ、データベース、ストレージアカウントなどの Azure リソースのデプロイと管理に使用する論理コンテナーです。たとえば、後から簡単な手順で一度にリソースグループ全体を削除することもできます。

リソースグループの現在の Spatial Anchors アカウントを表示するには、Get-AzSpatialAnchorsAccount コマンドレットを使用します。
```
Get-AzSpatialAnchorsAccount -ResourceGroup myResourceGroup
```
また、ご利用のサブスクリプションの Spatial Anchors アカウントを表示することもできます。
```
Get-AzSpatialAnchorsAccount
```
New-AzSpatialAnchorsAccount コマンドレットを実行して、Spatial Anchors アカウントを作成します。
```
New-AzSpatialAnchorsAccount -ResourceGroup myResourceGroup -Name MySpatialAnchorsQuickStart -Location eastus2
```
Get-AzSpatialAnchorsAccount コマンドレットを使用してリソースのプロパティを表示します。
```
Get-AzSpatialAnchorsAccount -ResourceGroup myResourceGroup -Name MySpatialAnchorsQuickStart
```
accountId プロパティの値と accountDomain プロパティの値を後で使用するためにテキストエディターにコピーします。
Get-AzSpatialAnchorsAccountKey コマンドレットを実行して、プライマリキーとセカンダリキーを取得します。
```
Get-AzSpatialAnchorsAccountKey -ResourceGroup myResourceGroup -Name MySpatialAnchorsQuickStart
```
後で使用するためにキー値をテキストエディターにコピーします。

キーを再生成する必要がある場合は、New-AzSpatialAnchorsAccountKey コマンドレットを使用します。
```
New-AzSpatialAnchorsAccountKey -ResourceGroupName myResourceGroup -Name MySpatialAnchorsQuickStart -Primary
New-AzSpatialAnchorsAccountKey -ResourceGroupName myResourceGroup -Name MySpatialAnchorsQuickStart -Secondary
```

アカウントは、Remove-AzSpatialAnchorsAccount コマンドレットを使用して削除できます。

Remove-AzSpatialAnchorsAccount -ResourceGroup myResourceGroup -Name MySpatialAnchorsQuickStart

サンプルプロジェクトのダウンロードと SDK のインポート

サンプルリポジトリを複製する

次のコマンドを実行して samples リポジトリを複製します。

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 プラットフォーム] を選択します。 [Target Device](ターゲットデバイス) を [HoloLens] に変更します。

[Switch Platform](プラットフォームの切り替え) を選択して、プラットフォームを [ユニバーサル Windows プラットフォーム] に変更します。 UWP をサポートするコンポーネントが不足している場合は、Unity によってそれらをインストールすることを要求される場合があります。

Screenshot of the Unity Build Settings pane - HoloLens

[ビルド設定] ウィンドウを閉じます。

アカウント情報を構成する

次のステップは、自分のアカウントの情報を使用するようにアプリを構成することです。前の「Spatial Anchors リソースを作成する」セクションでテキストエディターに [アカウントキー] 、 [アカウント ID] 、 [アカウントドメイン] 値をコピーしました。

[プロジェクト] ウィンドウで Assets\AzureSpatialAnchors.SDK\Resources に進みます。

[SpatialAnchorConfig] を選択します。 [インスペクター] ウィンドウで Spatial Anchors アカウントキーの値として Account Key を、Spatial Anchors アカウント ID の値として Account ID を、Spatial Anchors アカウントドメインの値として Account Domain を入力します。

HoloLens Visual Studio プロジェクトをエクスポートする

[ファイル]>[ビルド設定] を選択して、 [ビルド設定] を開きます。

[Scenes In Build](ビルド内のシーン) で、すべてのシーンの横にチェックマークが付いていることを確認します。

[Build](ビルド) を選択します。ダイアログボックスで、HoloLens Visual Studio プロジェクトのエクスポート先となるフォルダーを選択します。

エクスポートが完了すると、エクスポートされた HoloLens プロジェクトを含むフォルダーが表示されます。

HoloLens アプリケーションをデプロイする

フォルダー内の HelloAR U3D.sln をダブルクリックして、Visual Studio でプロジェクトを開きます。

[ソリューション構成] を [リリース] に変更し、 [ソリューションプラットフォーム] を [x86] に変更し、デプロイターゲットオプションから [デバイス] を選択します。

HoloLens 2 を使用している場合は、x86 の代わりに ARM64 を [ソリューションプラットフォーム] として使用します。

Visual Studio configuration

HoloLens デバイスの電源をオンにしてサインインし、USB ケーブルを使用してデバイスを PC に接続します。

[デバッグ]>[デバッグの開始] を選択して、アプリのデプロイとデバッグを開始します。

アプリで矢印を使って [BasicDemo] を選び、[実行] ボタンを押してデモを実行します。指示に従って、アンカーを配置し、呼び戻します。

Screenshot 1 Screenshot 2 Screenshot 3 Screenshot 4

Visual Studio で、 [デバッグの停止] を選択するか、Shift + F5 キーを押して、アプリを停止します。

リソースをクリーンアップする

前の手順では、リソースグループ内に Azure リソースを作成しました。これらのリソースが将来必要になると思わない場合は、リソースグループを削除してリソースを削除できます。

Azure portal メニューまたは [ホーム] ページから、 [リソースグループ] を選択します。次に、 [リソースグループ] ページで [myResourceGroup] を選択します。

[myResourceGroup] ページで、一覧表示されたリソースが、削除しようとするリソースであることを確認します。

[リソースグループの削除] を選択し、確認のためテキストボックスに「myResourceGroup」と入力して、 [削除] を選択します。

次のステップ

このクイックスタートでは、Spatial Anchors アカウントを作成しました。次に、空間アンカーを保存して再呼び出しするようにアプリを構成してデプロイしました。他のデバイスと空間アンカーを共有できるようにアプリを改良する方法の詳細を学習するには、次のチュートリアルに進んでください。

チュートリアル:デバイス間で空間アンカーを共有する

方法: Unity プロジェクトで Azure Spatial Anchors を構成する

サンプル アプリを実行する: HoloLens - Unity (C#)