サンプルアプリを実行する: HoloLens - Visual Studio (C++/WinRT)

[アーティクル]
03/10/2023

このクイックスタートでは、Visual Studio (C++/WinRT および DirectX) を使用して HoloLens 用のAzure Spatial Anchors サンプルアプリを実行する方法について説明します。 Azure Spatial Anchors は、クロスプラットフォーム対応の開発者向けサービスです。このサービスを使用すると、時間が経過した後でも複数のデバイス間で位置情報を保持するオブジェクトを使用して複合現実エクスペリエンスを作成できます。完了すると、空間アンカーを保存して再呼び出しできる HoloLens アプリが作成されます。

学習内容は次のとおりです。

Spatial Anchors アカウントを作成する
Spatial Anchors アカウント識別子とアカウントキーを構成する
HoloLens デバイスにデプロイして実行する

Azure サブスクリプションをお持ちでない場合は、開始する前に Azure 無料アカウントを作成してください。

前提条件

このクイックスタートを実行するには、以下が必要です。

Visual Studio 2019、ユニバーサル Windows プラットフォーム開発ワークロード、および Windows 10 SDK (10.0.18362.0 以降) コンポーネントがインストールされた Windows マシン。 Git for Windows および Git LFS もインストールする必要があります。
Visual Studio Marketplace から Visual Studio 用の C++/WinRT Visual Studio 拡張機能 (VSIX) をインストールする必要があります。
開発者モードが有効になっている HoloLens デバイス。この記事では、Windows 10 May 2020 Update が適用された HoloLens デバイスが必要です。 HoloLens を最新のリリースに更新するには、[設定] アプリを開き、[更新とセキュリティ] を選択し、[更新プログラムの確認] ボタンをクリックします。
アプリにより、その AppX マニフェストに spatialPerception 機能を設定する必要があります。

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

サンプルプロジェクトを開く

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

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

Visual Studio で HoloLens\DirectX\SampleHoloLens.sln を開きます。

アカウント識別子とキーを構成する

次に、自分のアカウント識別子とアカウントキーを使用するようにアプリを構成します。これらの情報は、Spatial Anchors リソースを設定するときにテキストエディターにコピーしました。

HoloLens\DirectX\SampleHoloLens\ViewController.cppを開きます。

SpatialAnchorsAccountKey フィールドを見つけ、Set me をアカウントキーに置き換えます。

SpatialAnchorsAccountId フィールドを見つけ、Set me をアカウント識別子に置き換えます。

SpatialAnchorsAccountDomain フィールドを見つけ、Set me をアカウントドメインに置き換えます。

アプリを HoloLens にデプロイする

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

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

Visual Studio Configuration

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

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

アプリの指示に従って、アンカーを配置し、呼び戻します。

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

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

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

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

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

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

次のステップ

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

チュートリアル:デバイス間で Spatial Anchors を共有する

サンプル アプリを実行する: HoloLens - Visual Studio (C++/WinRT)