クイック スタート:Azure Spatial Anchors を使用する Unity HoloLens アプリを作成するQuickstart: Create a Unity HoloLens app that uses Azure Spatial Anchors

このクイックスタートでは、Azure Spatial Anchors を使用する Unity HoloLens アプリを作成します。In this quickstart, you'll create a Unity HoloLens app that uses Azure Spatial Anchors. Spatial Anchors は、クロスプラットフォーム対応の開発者向けサービスです。このサービスを使用すると、複数のデバイス間でその位置を長期にわたって保持するオブジェクトを使用して複合現実エクスペリエンスを作成できます。Spatial Anchors is a cross-platform developer service that allows you to create mixed reality experiences with objects that persist their location across devices over time. 完了すると、Unity でビルドされた、空間アンカーを保存して再呼び出しできる HoloLens アプリが作成されます。When you're finished, you'll have a HoloLens app built with Unity that can save and recall a spatial anchor.

学習内容は次のとおりです。You'll learn how to:

  • Spatial Anchors アカウントを作成する。Create a Spatial Anchors account.
  • Unity のビルド設定を準備する。Prepare Unity build settings.
  • Spatial Anchors アカウント識別子とアカウント キーを構成する。Configure the Spatial Anchors account identifier and account key.
  • HoloLens Visual Studio プロジェクトをエクスポートする。Export the HoloLens Visual Studio project.
  • HoloLens デバイスにアプリをデプロイして実行する。Deploy the app and run it on a HoloLens device.

Azure サブスクリプションをお持ちでない場合は、開始する前に無料アカウントを作成してください。If you don't have an Azure subscription, create a free account before you begin.

前提条件Prerequisites

このクイック スタートを完了するには、以下が必要です。To complete this quickstart:

  • Unity 2019.4 (LTS) および Visual Studio 2019 以降がインストールされている Windows コンピューターが必要です。You need a Windows computer with Unity 2019.4 (LTS) and Visual Studio 2019 or later are installed. Visual Studio インストールには、ユニバーサル Windows プラットフォーム開発 ワークロードと Windows 10 SDK (10.0.18362.0 以降) コンポーネントが含まれている必要があります。Your Visual Studio installation must include the Universal Windows Platform development workload and the Windows 10 SDK (10.0.18362.0 or newer) component. Git for Windows および Git LFS もインストールする必要があります。You must also install Git for Windows and Git LFS.
  • 開発者モードが有効になっている HoloLens デバイスが必要です。You need a HoloLens device on which developer mode enabled. Windows 10 May 2020 Update がデバイスにインストールされている必要があります。Windows 10 May 2020 Update must be installed on the device. HoloLens を最新のリリースに更新するには、 [設定] アプリを開き、 [更新とセキュリティ] を選択し、 [更新プログラムの確認] を選択します。To update to the latest release on HoloLens, open the Settings app, go to Update & Security, and then select Check for updates.
  • アプリで SpatialPerception 機能を有効にする必要があります。On your app, you need to enable the SpatialPerception capability. この設定は、 [ビルド設定] > [プレーヤーの設定] > [発行の設定] > [機能] にあります。This setting is in Build Settings > Player Settings > Publishing Settings > Capabilities.
  • アプリで [Virtual Reality Supported](サポートされている仮想現実)Windows Mixed Reality SDK と共に有効にする必要があります。On your app, you need to enable Virtual Reality Supported with Windows Mixed Reality SDK. この設定は、 [ビルド設定] > [プレーヤーの設定] > [XR Settings](XR 設定) にあります。This setting is in Build Settings > Player Settings > XR Settings.

Spatial Anchors リソースを作成するCreate a Spatial Anchors resource

Azure ポータルにアクセスします。Go to the Azure portal.

左側のウィンドウで、 [リソースの作成] を選択します。On the left pane, select Create a resource.

検索ボックスを使用して、「Spatial Anchors」を検索します。Use the search box to search for Spatial Anchors.

「Spatial Anchors」の検索結果を示すスクリーンショット。

[Spatial Anchors] を選択し、 [作成] を選択します。Select Spatial Anchors, and then select Create.

[Spatial Anchors アカウント] ウィンドウで次を行います。On the Spatial Anchors Account pane, do the following:

  • 通常の英数字を使用して一意のリソース名を入力します。Enter a unique resource name by using regular alphanumeric characters.

  • リソースをアタッチするサブスクリプションを選択します。Select the subscription that you want to attach the resource to.

  • [新規作成] を選択して、リソース グループを作成します。Create a resource group by selecting Create new. myResourceGroup」と名前を付け、 [OK] を選択します。Name it myResourceGroup, and then select OK.

    リソース グループとは、Web アプリ、データベース、ストレージ アカウントなどの Azure リソースのデプロイと管理に使用する論理コンテナーです。A resource group is a logical container into which Azure resources, such as web apps, databases, and storage accounts, are deployed and managed. たとえば、後から簡単な手順で一度にリソース グループ全体を削除することもできます。For example, you can choose to delete the entire resource group in one simple step later.

  • リソースを配置する場所 (リージョン) を選択します。Select a location (region) in which to place the resource.

  • [新規] を選択して、リソースの作成を開始します。Select New to begin creating the resource.

リソースを作成するための [Spatial Anchors] ウィンドウのスクリーンショット。

リソースが作成されると、Azure portal に、デプロイが完了したことが表示されます。After the resource is created, the Azure portal shows that your deployment is complete.

リソースのデプロイが完了したことを示すスクリーンショット。

[リソースに移動] を選択します。Select Go to resource. これでリソースのプロパティを表示できます。You can now view the resource properties.

リソースの [アカウント ID] 値は後で使用するためにテキスト エディターにコピーしておきます。Copy the resource's Account ID value into a text editor for later use.

[リソース プロパティ] ウィンドウのスクリーンショット。

また、リソースの [アカウント ドメイン] 値を後で使用するためにテキスト エディターにコピーします。Also copy the resource's Account Domain value into a text editor for later use.

リソースのアカウント ドメイン値を示すスクリーンショット。

[設定][キー] を選択します。Under Settings, select Key. [主キー] 値の [アカウント キー] を後で使用するためにテキスト エディターにコピーします。Copy the Primary key value, Account Key, into a text editor for later use.

アカウントの [キー] ウィンドウのスクリーンショット。

Unity のサンプル プロジェクトをダウンロードして開くDownload and open the Unity sample project

次のコマンドを実行して samples リポジトリを複製します。Clone the samples repository by running the following commands:

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

Unity で、 [Unity] フォルダー内のプロジェクトを開きます。In Unity, open the project in the Unity folder. Unity からは、プロジェクトのバージョンと、お使いのコンピューターにインストールされているバージョンの違いについて問われることがあります。Unity might prompt you about a difference between the version in the project and the version that's installed on your machine. この警告は、Unity エディターのバージョンが、プロジェクトの作成に使用されたバージョンより新しければ、特に問題ありません。This warning is okay, as long as your version of Unity Editor is newer than the one that the project was created with. バージョンが新しい場合は [続行] を選択します。If your version is newer, select Continue. バージョンがプロジェクトに必要なバージョンよりも古い場合は、 [終了] を選択し、Unity エディターをアップグレードします。If your version is older than the one the project needs, select Quit, and upgrade your Unity Editor.

[Unity] ウィンドウのスクリーンショット。

[ファイル] > [ビルド設定] を選択して、 [ビルド設定] を開きます。Open Build Settings by selecting File > Build Settings.

[プラットフォーム] セクションで、 [ユニバーサル Windows プラットフォーム] を選択します。In the Platform section, select Universal Windows Platform. [Target Device](ターゲット デバイス)[HoloLens] に変更します。Change the Target Device to HoloLens.

[Switch Platform](プラットフォームの切り替え) を選択して、プラットフォームを [ユニバーサル Windows プラットフォーム] に変更します。Select Switch Platform to change the platform to Universal Windows Platform. UWP をサポートするコンポーネントが不足している場合は、Unity によってそれらをインストールすることを要求される場合があります。Unity might prompt you to install UWP support components if they're missing.

Unity の [Build Settings](ビルド設定) ウィンドウ

[ビルド設定] ウィンドウを閉じます。Close the Build Settings window.

アカウント情報を構成するConfigure the account information

次のステップは、自分のアカウントの情報を使用するようにアプリを構成することです。The next step is to configure the app to use your account information. 前の「Spatial Anchors リソースを作成する」セクションでテキスト エディターに [アカウント キー][アカウント ID][アカウント ドメイン] 値をコピーしました。You copied the Account Key, Account ID, and Account Domain values to a text editor earlier, in the "Create a Spatial Anchors resource" section.

[プロジェクト] ウィンドウで Assets\AzureSpatialAnchors.SDK\Resources に進みます。On the Project pane, go to Assets\AzureSpatialAnchors.SDK\Resources.

[SpatialAnchorConfig] を選択します。Select SpatialAnchorConfig. [インスペクター] ウィンドウで Spatial Anchors アカウント キー の値として Account Key を、Spatial Anchors アカウント ID の値として Account ID を、Spatial Anchors アカウント ドメイン の値として Account Domain を入力します。On the Inspector pane, enter the Account Key as the value for Spatial Anchors Account Key, the Account ID as the value for Spatial Anchors Account Id, and the Account Domain as the value for Spatial Anchors Account Domain.

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

[ファイル] > [ビルド設定] を選択して、[ビルド設定] を開きます。Open Build Settings by selecting File > Build Settings.

[Scenes In Build](ビルド内のシーン) で、すべてのシーンの横にチェック マークが付いていることを確認します。Under Scenes In Build, ensure all the scenes have a check mark next to them.

[Build](ビルド) を選択します。Select Build. ダイアログ ボックスで、HoloLens Visual Studio プロジェクトのエクスポート先となるフォルダーを選択します。In the dialog box, select a folder in which to export the HoloLens Visual Studio project.

エクスポートが完了すると、エクスポートされた HoloLens プロジェクトを含むフォルダーが表示されます。When the export is complete, a folder containing the exported HoloLens project will appear.

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

フォルダー内の HelloAR U3D.sln をダブルクリックして、Visual Studio でプロジェクトを開きます。In the folder, double-click HelloAR U3D.sln to open the project in Visual Studio.

[ソリューション構成][リリース] に変更し、 [ソリューション プラットフォーム][x86] に変更し、デプロイ ターゲット オプションから [デバイス] を選択します。Change the Solution Configuration to Release, change the Solution Platform to x86, and select Device from the deployment target options.

HoloLens 2 を使用している場合は、x86 の代わりに ARM64[ソリューション プラットフォーム] として使用します。If using HoloLens 2, use ARM64 as the Solution Platform, instead of x86.

Visual Studio の構成

HoloLens デバイスの電源をオンにしてサインインし、USB ケーブルを使用してデバイスを PC に接続します。Turn on the HoloLens device, sign in, and connect the device to the PC by using a USB cable.

[デバッグ] > [デバッグの開始] を選択して、アプリのデプロイとデバッグを開始します。Select Debug > Start debugging to deploy your app and start debugging.

アプリで矢印を使用して [BasicDemo] を選択し、 [実行] ボタンをIn the app, select BasicDemo using the arrows, then press the Go! 押してデモを実行します。button to run the demo. 指示に従って、アンカーを配置し、呼び戻します。Follow the instructions to place and recall an anchor.

スクリーンショット 1 スクリーンショット 2 スクリーンショット 3 スクリーンショット 4Screenshot 1 Screenshot 2 Screenshot 3 Screenshot 4

Visual Studio で、 [デバッグの停止] を選択するか、Shift + F5 キーを押して、アプリを停止します。In Visual Studio, stop the app by selecting either Stop Debugging or Shift+F5.

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

前の手順では、リソース グループ内に Azure リソースを作成しました。In the preceding steps, you created Azure resources in a resource group. これらのリソースが将来必要になると思わない場合は、リソース グループを削除してリソースを削除できます。If you don't expect to need these resources in the future, you can delete them by deleting the resource group.

Azure portal メニューまたは [ホーム] ページから、 [リソース グループ] を選択します。From the Azure portal menu or Home page, select Resource groups. 次に、 [リソース グループ] ページで [myResourceGroup] を選択します。Then, on the Resource groups page, select myResourceGroup.

[myResourceGroup] ページで、一覧表示されたリソースが、削除しようとするリソースであることを確認します。On the myResourceGroup page, make sure that the listed resources are the ones you want to delete.

[リソース グループの削除] を選択し、確認のためテキスト ボックスに「myResourceGroup」と入力して、 [削除] を選択します。Select Delete resource group, type myResourceGroup in the text box to confirm, and then select Delete.

次のステップNext steps

このクイック スタートでは、Spatial Anchors アカウントを作成しました。In this quickstart, you created a Spatial Anchors account. 次に、空間アンカーを保存して再呼び出しするようにアプリを構成してデプロイしました。You then configured and deployed an app to save and recall spatial anchors. 他のデバイスと空間アンカーを共有できるようにアプリを改良する方法の詳細を学習するには、次のチュートリアルに進んでください。To learn more about how to improve the app so it can share spatial anchors with other devices, continue to the next tutorial.