クイックスタート: Azure Object Anchors を使用する HoloLens アプリを Unity で作成する

このクイックスタートでは、Azure Object Anchors を使用する Unity HoloLens アプリを作成します。 Azure Object Anchors は、3D アセットを HoloLens の物体認識 Mixed Reality エクスペリエンスを実現する AI モデルに変換するマネージド クラウド サービスです。 作業を終えると、Unity で作成された HoloLens アプリで、物理世界のオブジェクトを検出できるようになります。

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

• Unity のビルド設定を準備する。
• HoloLens Visual Studio プロジェクトをエクスポートする。
• HoloLens 2 デバイスにアプリを配置して実行する。

前提条件

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

• ご利用環境にある対象物と、その 3D モデル (CAD またはスキャン済みのいずれか)。
• 次のものがインストールされている Windows マシン:
  • Git for Windows
  • ユニバーサル Windows プラットフォーム開発ワークロードを含む Visual Studio 2019 と Windows 10 SDK (10.0.18362.0 以降) コンポーネント
  • Unity 2019.4
• 開発者モードが有効になっている最新の HoloLens 2 デバイス。
  • HoloLens を最新のリリースに更新するには、[設定] アプリを開き、[更新とセキュリティ] を選択し、[更新プログラムの確認] を選択します。

Object Anchors アカウントを作成する

まず、Object Anchors サービスを使用してアカウントを作成する必要があります。

1. Azure portal にアクセスし、 [リソースの作成] を選択します。

   

2. Object Anchors リソースを検索します。

   「Object Anchors」を検索します。

   

   検索結果の Object Anchors リソースで、[作成] -> [Object Anchors] の順に選択します。

   

3. [オブジェクト アンカー アカウント] ダイアログ ボックスで以下を行います。

   • 一意のリソース名を入力します。
   • リソースを接続するサブスクリプションを選択します。
   • リソース グループを作成するか、既存のものを使用します。
   • リソースが属するリージョンを選択します。

   

   [作成] を選択して、リソースの作成を開始します。

4. リソースが作成されたら、[リソースに移動] を選択します。

   

5. 概要ページで、以下を行います。

   アカウント ドメインをメモします。 この情報は後で必要になります。

   

   アカウント ID をメモします。 この情報は後で必要になります。

   

   [アクセス キー] ページに移動し、主キーをメモします。 この情報は後で必要になります。

   

デバイスのセットアップ

HoloLens にアプリを展開するには、HoloLens をコンピューターとペアリングする必要があります。

1. HoloLens で、[設定 - 更新プログラムとセキュリティ ->> 開発者向け] に移動します。
2. [Pair](ペアリング) をクリックし、最初の展開時に Visual Studio に PIN を入力するまで画面を開いたままにします。

モデルをアップロードする

アプリを実行する前に、モデルをアプリで使用できるようにする必要があります。 Object Anchors モデルをまだお持ちでない場合は、モデルの作成の手順に従ってモデルを作成します。 その後、ここに戻ります。

HoloLens をオンにして開発デバイス (PC) に接続したら、次の手順に従って、HoloLens の 3D Objects フォルダーにモデルをアップロードします。

1. Ctrl キーと C キー (Ctrl + C) を押しながら、操作するモデルを選択してコピーします。

2. Windows ロゴ キーと E キー (Win + E) を押して、エクスプローラーを起動します。 HoloLens が他のドライブやフォルダーと共に、左側のウィンドウに表示されます。

   

3. HoloLens のリンクをタップすると、HoloLens デバイスのストレージが右側のペインに表示されます。

   

4. エクスプローラーで、[内部ストレージ] > [3D Objects] にアクセスします。 これで、Ctrl キーを押しながら V キー (Ctrl + V) を押すことで、3D Objects フォルダーにモデルを貼り付けることができます。

   

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

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

git clone https://github.com/Azure/azure-object-anchors.git

cd ./azure-object-anchors

次の手順は、Unity 用 Azure Object Anchors パッケージのダウンロードです。

Web ダウンロード

ここで Unity 用 Azure Object Anchors パッケージ (com.microsoft.azure.object-anchors.runtime) を見つけます。 目的のバージョンを選択し、 [Download]\(ダウンロード\) ボタンを使用してパッケージをダウンロードします。

NPM ダウンロード

この手順の場合、NPM がインストールされ、使用できる状態である必要があります。

<version_number> をダウンロードする Azure Object Anchors のバージョンに置き換えて、次のコマンドを実行します。

npm pack com.microsoft.azure.object-anchors.runtime@<version_number> --registry https://pkgs.dev.azure.com/aipmr/MixedReality-Unity-Packages/_packaging/Unity-packages/npm/registry/

注意

入手できる Azure Object Anchors パッケージのバージョンを一覧表示するには、次のコマンドを実行します。

npm view com.microsoft.azure.object-anchors.runtime --registry https://pkgs.dev.azure.com/aipmr/MixedReality-Unity-Packages/_packaging/Unity-packages/npm/registry/ versions

コマンドを実行したフォルダーに、Azure Object Anchors パッケージがダウンロードされます。

Mixed Reality Feature Tool (ベータ)

次の手順に進みます。 後の手順で、Mixed Reality Feature Tool を使用します。

Unity で quickstarts/apps/unity/basic プロジェクトを開きます。

Web ダウンロード

こちらの手順に従い、Unity Package Manager を使用して、ダウンロードした Azure Object Anchors パッケージを Unity プロジェクトにインポートします。

NPM ダウンロード

こちらの手順に従い、Unity Package Manager を使用して、ダウンロードした Azure Object Anchors パッケージを Unity プロジェクトにインポートします。

Mixed Reality Feature Tool (ベータ)

この手順では、Mixed Reality Feature Tool をダウンロードして使用できるようにする必要があります。

Note

現在、Mixed Reality Feature Tool は Windows のみをサポートしています。

1. Mixed Reality Feature Tool のドキュメントに従ってツールを設定し、使用方法を確認してください。
2. "Microsoft Azure Object Anchors" 機能パッケージを Unity プロジェクト フォルダーにインストールします。

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

次のステップは、自分のアカウントの情報を使用するようにアプリを構成することです。 [Object Anchors アカウントの作成] セクションのアカウント キー、アカウント ID および アカウント ドメイン値をメモします。

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

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

アプリのビルドと実行

サンプル シーンをビルドする

Unity Editor で、Assets/MixedReality.AzureObjectAnchors/Scenes に移動し、AOASampleScene を開いて、ビルドするシーンの一覧に追加します。

[File](ファイル) -> [Building Settings](ビルド設定) を選択します。 [ユニバーサル Windows プラットフォーム] を選択し、 [Switch Platform](プラットフォームの切り替え) を選択します。 最初にいくつかのコンポーネントをダウンロードする必要がある旨のメッセージが Unity Editor に表示された場合は、それらをダウンロードしてインストールします。 次のスクリーンショットに従って、ビルド設定を構成します。 AOASampleScene のチェック ボックス "だけ" がオンになっていることを確認します。それ以外のシーンは含めないでください。

[Build](ビルド) を選択し、出力フォルダーを選択します。 これで、VS プロジェクトを出力フォルダーに生成できるようになりました。

アプリを構築してデプロイする

Unity によって生成された .sln ファイルを開きます。 ビルド構成を次のように変更します。

次に、アプリをデプロイし、デバッグするために、 [Remote Machine IP address](リモート マシンの IP アドレス) を構成する必要があります。

[App project](アプリ プロジェクト) を右クリックし、 [Properties](プロパティ) をクリックします。 [Properties](プロパティ) ページで、[Configuration Properties](構成プロパティ) -> [Debugging](デバッグ) を選択します。 [Machine Name](マシン名) の値を HoloLens デバイスの IP アドレスに変更し、 [Apply](適用) をクリックします。

プロパティ ページを閉じます。 [Remote Machine](リモート マシン) をクリックします。 アプリのビルドとリモート デバイスへのデプロイが開始されます。 デバイスがアクティブであることを確認します。

Unity のスプラッシュ スクリーンの後に、オブジェクト オブザーバーが初期化されたことを示すメッセージが表示されます。

アプリによって、ビューの現在のフィールドでオブジェクトが検索され、検出されるとそれらが追跡されます。 インスタンスは、ユーザーの場所から 6 メートル離れると削除されます。 デバッグ テキストには、ID、更新されたタイムスタンプ、サーフェス カバレッジの比率など、インスタンスの詳細が表示されます。

トラブルシューティング

ヒント

オブジェクトが検出されない場合は、次の手順を試すことができます。

1. オブジェクトに正しいモデルを使用していることを再確認します。
2. 検索領域を視覚化し、ターゲット オブジェクトが対象になっていることを確認します。
3. MinSurfaceCoverage を減らしてみます。
4. Windows デバイス ポータルで、[表示] -> [3D Views](3D ビュー) をクリックし、スキャンが完了したかどうかを確認します。

次のステップ

Unity HoloLens と MRTK

概念: SDK の概要

FAQ

変換 SDK

オブジェクト検出のトラブルシューティング