2. プロジェクトと最初のアプリケーションを初期化する2. Initializing your project and first application

この最初のレッスンでは、 Mixed Reality Toolkit (MRTK)が提供する必要があるいくつかの機能について説明します。 HoloLens 2 の最初のアプリケーションを起動し、デバイスにデプロイします。In this first lesson, you'll learn about some of the capabilities the Mixed Reality Toolkit (MRTK) has to offer, start your first application for the HoloLens 2, and deploy it to the device.

目標Objectives

  • HoloLens 用 Unity の開発を最適化する。Optimize Unity for HoloLens development.
  • アセットをインポートし、シーンをセットアップする。Import assets and setup the scene.
  • 空間マッピングメッシュ、手メッシュ、フレームレートカウンターの視覚化。Visualization of the spatial mapping mesh, hand meshes, and the framerate counter.

手順Instructions

新しい Unity プロジェクトを作成しますCreate new Unity project

  1. Unity を起動します。Start Unity.

  2. [新規] を選択します。Select New. レッスン1から Section1 のステップLesson1 Section1 Step2

  3. プロジェクト名を入力してください (例: "MixedRealityBase")。Enter a project name (e.g. "MixedRealityBase"). レッスン1から Section1 手順 3Lesson1 Section1 Step3

  4. プロジェクトを保存する場所を入力します。Enter a location to save your project. レッスン1から Section1 手順 4Lesson1 Section1 Step4

  5. プロジェクトが [3D] に設定されていることを確認します。Make sure the project is set to 3D. レッスン1から Section1 手順 5Lesson1 Section1 Step5

  6. [プロジェクトの作成] をクリックします。Click Create Project. レッスン1から Section1 手順 6Lesson1 Section1 Step6

Windows Mixed Reality 用に Unity プロジェクトを構成するConfigure the Unity project for Windows Mixed Reality

  1. [ビルドの設定] ウィンドウを開き、[ファイル > ビルドの設定] に移動します。Open the Build Settings window by going to File > Build Settings. レッスン1から Section2 ステップLesson1 Section2 Step1

  2. ユニバーサル Windows プラットフォームを選択し、 [プラットフォームの切り替え] ボタンをクリックしてプラットフォームを切り替えます。Select the Universal Windows Platform and click the Switch Platform button to switch platforms. HoloLens 2 で実行されるアプリケーションは、ユニバーサル Windows プラットフォーム (UWP) と互換性がある必要があります。Applications running on HoloLens 2 are required to be Universal Windows Platform (UWP) compatible. レッスン1から Section2 のステップLesson1 Section2 Step2

  3. 次の図に示すように、ビルド] ウィンドウの [プレーヤーの設定] ボタンをクリックして仮想現実を有効にし、[XR の設定 の下の [仮想化の詳細] チェックボックスをオンにします。Enable virtual reality by clicking on Player Settings button in the Build Window, and enable the Virtual Reality Supported checkbox under XR Settings from the inspector panel, as shown in the image below. [インスペクター] パネルを表示するには、[ビルドの設定] ウィンドウをそのままドラッグする必要があることに注意してください。Note that you might need to drag the Build Settings window out of the way in order to see the inspector panel. [サポートされている仮想現実] チェックボックスは、ステレオスコピック構想の有効化 (各目に異なるイメージのレンダリング ) を参照するため、Mixed reality と拡張された現実のヘッドセットにも適用されThe Virtual Reality Supported checkbox also applies to Mixed Reality and Augmented Reality headsets because it refers to the enabling of stereoscopic vision (rendering different images for each eye.) Lesson1 Section2 Step3

  4. また、[XR の設定] で、ステレオレンダリングモードシングルパスインスタンス化に変更します。Also under XR Settings, change the Stereo Rendering Mode to Single Pass Instanced. 通常、この表示パイプラインスタイルは HoloLens 2 で最も高いパフォーマンスを備えています。This rendering pipeline style is generally most performant for HoloLens 2. Unity 環境の他のパフォーマンスの高い構成に関心がある場合は、こちらの手順に従ってください。If interested in other performant configurations for your Unity environment, follow these instructions. レッスン1から Section2 手順 4Lesson1 Section2 Step4

  5. 同じ [インスペクター] パネルで、[機能] セクションの [空間認識] チェックボックスが [発行の設定] で有効になっていることを確認します。From the same inspector panel, ensure that the Spatial Perception checkbox in the capabilities section is enabled under Publishing Settings. 空間認識を使用すると、HoloLens 2 などの混合の現実デバイスで空間マッピングメッシュを視覚化できます。Spatial Perception allows us to visualize the spatial mapping mesh on a mixed reality device, such as HoloLens 2. 発行の設定は、[インスペクター] パネルの [XR Settings (その他の設定)] の下にあります。Publishing Settings are found in the inspector panel, above XR Settings and under Other Settings. レッスン1から Section2 手順 5Lesson1 Section2 Step5

    注意

    このセクションでは使用しませんが、他のいくつかの一般的な機能を有効にするには、音声コマンドのマイクや、ネットワーク接続を必要とするサービスに接続するためのinternetclientなどがあります。While not used in this section, some other common capabilities you might want to enable include the Microphone for voice commands, and InternetClient for connecting to services requiring a network connection.

Mixed Reality ツールキットをインポートするImport the Mixed Reality Toolkit

  1. Mixed Reality Toolkit Unity foundation パッケージバージョン 2.1.0をダウンロードし、PC 上のフォルダーに保存します。Download the Mixed Reality Toolkit Unity foundation package version 2.1.0 and save it to a folder on your PC.

  2. 前の手順でダウンロードしたMixed Reality Toolkitパッケージをインポートします。Import the Mixed Reality Toolkit package that you downloaded in the previous step. まず、 [アセット] をクリックし > カスタムパッケージ > インポートし、 unitypackageを選択して開き、インポートプロセスを開始します。Start by clicking on Assets > Import > Custom Package and select Microsoft.MixedReality.Toolkit.Unity.Foundation.2.1.0.unitypackage and open it to begin the importing process. インポート処理が完了するまで数分かかります。Please allow a few minutes for the importing process to complete. レッスン1から Section3 Step2a レッスン1から Section3 Step2bLesson1 Section3 Step2a Lesson1 Section3 Step2b

  3. 次のポップアップウィンドウで、 [インポート] をクリックして、選択したパッケージの Unity プロジェクトへのインポートを開始します。In the next pop-up window, click Import to begin importing the selected package into the Unity project. 画像に示されているように、すべての項目がオンになっていることを確認します。Ensure all items are checked as shown in the image. レッスン1から Section3 手順 3Lesson1 Section3 Step3

    注意

    Mixed Reality Toolkit の既定の設定を適用するよう求めるポップアップダイアログボックスが表示されたら、 [適用] をクリックします。If you see a pop-up dialog box asking to apply the Mixed Reality Toolkit default settings, click Apply. MRTK では、自動セットアップのためにインポートするときに、推奨されていない設定があればプロジェクトを分析します。MRTK analyzes your project for any missing recommended settings when imported for automated setup. 設定によっては、次の図のようなポップアップが表示される場合があります。Depending on your settings the popup might look different then the image below.

    レッスン1から Section3 手順 4 Note1

Mixed Reality ツールキットを構成するConfigure the Mixed Reality Toolkit

  1. Mixed reality toolkit を選択して、現在のシーンにmixed reality toolkitを追加し > [シーンに追加] および [構成] を選択しますAdd the Mixed Reality Toolkit to your current scene by selecting Mixed Reality Toolkit > Add to Scene and Configure.. メニューバーから。from the menu bar. Mixed Reality Toolkit をインポートした後でこのメニュー項目が表示されない場合は、Unity を再起動してください。If you don't see this menu item after importing the mixed reality toolkit, please restart Unity. レッスン1から Section4 ステップLesson1 Section4 Step1

    注意

    Mixed Reality Toolkit のプロファイルを選択するためのポップアップダイアログボックスが表示される場合があります。You may see a pop-up dialog box for selecting a profile for the Mixed Reality Toolkit. DefaultHoloLens2ConfigurationProfileという名前のプロファイルをダブルクリックして選択します。Choose the profile named DefaultHoloLens2ConfigurationProfile by double-clicking it.

  2. シーンに新しい項目と変更がいくつか追加されます。Your scene will have several new items and modifications. [ファイル > 名前を付けて保存... ] をクリックしてシーンを別の名前で保存し、シーンにbasesceneなどの名前を付けます。Save your scene under a different name by clicking File > Save As..., and give your scene a name, such as BaseScene. シーンを整理して、プロジェクトの [ Assets ] フォルダー内の [シーン] フォルダーに保存します。Keep your scene organized by saving it to the Scenes folder in your project’s Assets folder. レッスン1から Section4 Step2a レッスン1から Section4 Step2bLesson1 Section4 Step2a Lesson1 Section4 Step2b

デバイスへのアプリケーションのビルドBuild your application to your device

  1. 前のセクションの [ビルドの設定] ウィンドウを閉じた場合は、[ファイル > ビルドの設定] に移動して [ビルドの設定] ウィンドウを再び開きます。If you closed the Build Settings window from the previous sections, open the Build Settings window again by going to File > Build Settings. レッスン1から Section5 ステップLesson1 Section5 Step1

  2. 作成したシーンが、Unity でシーンが開いているときに [開いているシーンを追加] ボタンをクリックして、[ビルド] の一覧シーンにあることを確認します。Ensure the scene you just created is in the Scenes in Build list by clicking on the Add Open Scenes button while your scene is open in Unity.

  3. ビルドを開始するには、 [ビルド] をクリックします。Press the Build button to begin the build process. レッスン1から Section5 手順 3Lesson1 Section5 Step3

  4. アプリケーション用の新しいフォルダーを作成して、名前を付けます。Create and name a new folder for your application. 次の図では、アプリケーションを格納するために、App という名前のフォルダーが作成されています。In the image below, a folder with the name App was created to contain the application. [フォルダーの選択] をクリックして、新しく作成したフォルダーへのビルドを開始します。Click Select Folder to begin building to the newly created folder. ビルドが完了したら、Unity の [ビルドの設定] ウィンドウを閉じることができます。After the build has completed, you can close the Build Settings window in Unity. レッスン1から Section5 手順 4Lesson1 Section5 Step4

重要

ビルドが失敗した場合は、もう一度構成してみるか、Unity を再起動してから再度ビルドしてください。If the build fails, try building again or restarting Unity and building again. "エラー: CS0246 = 型または名前空間の名前" XX "が見つからないなどのエラーが表示された場合は、using ディレクティブまたはアセンブリ参照が不足しています。If you see an error, such as "Error: CS0246 = The type or namespace name “XX” could not be found (are you missing a using directive or an assembly reference?). その場合は、 Windows 10 SDK (10.0.18362.0)のインストールが必要になることがあります。If so, then you might need to install Windows 10 SDK (10.0.18362.0)

  1. ビルドが完了したら、新しくビルドされたアプリケーション ファイルが含まれている、新しく作成されたフォルダーを開きます。After the build is completed, open the newly created folder containing your newly built application files. MixedRealityBaseソリューションをダブルクリックするか、プロジェクトに別の名前を使用している場合は対応する名前をダブルクリックして、Visual Studio でソリューションファイルを開きます。Double click on the MixedRealityBase.sln solution, or the corresponding name, if you used an alternative name for your project, to open the solution file in Visual Studio.

    注意

    新しく作成されたフォルダー (前の手順の名前付け規則に従っている場合はアプリフォルダー) を必ず開いてください。これは、ビルドフォルダー内の .sln ファイルと混同しないように、同じ名前の .sln ファイルがそのフォルダー外に存在するためです。Be sure to open the newly created folder (i.e. the App folder, if following the naming conventions from the previous steps), as there will be a similarly named .sln file outside of that folder that is not to be confused with the .sln file inside the build folder. フォルダー構造は次の図のようになります。The folder structure should look similar to the image below.

    Visual Studio から新しいコンポーネントをインストールするよう求められたら、少し時間を取って、「ツールのインストール」ページで示されている、前提条件となるすべてのコンポーネントがインストールされていることを確認してくださいIf Visual Studio asks you to install new components, please take a moment to ensure that all prerequisite components are installed as specified in the "Install the Tools" page

    レッスン1から Section5 手順5

  2. HoloLens 2 を PC に接続します。Connect your HoloLens 2 into your PC. これらの手順では HoloLens 2 デバイスにデプロイすることを前提としていますが、 hololens 2 エミュレーターにデプロイするか、サイドローディング用のアプリパッケージの作成を選択することもできます。While these instructions assume you will be deploying to a HoloLens 2 device, you might also choose to deploy to the HoloLens 2 emulator or choose to create an app package for sideloading

    重要

    デバイスをビルドする前に、デバイスが開発者モードであり、開発用コンピューターとペアリングされている必要があります。Before building to your device, the device must be in Developer Mode and paired with your development machine. これらの手順は、次の手順に従って完了できます。Both of these steps can be completed by following these instructions

  3. リリースまたはマスター構成、 ARMアーキテクチャ、およびデバイスをターゲットとして選択して、HoloLens 2 にビルドするように Visual Studio を構成します。Configure Visual Studio for building to your HoloLens 2 by selecting the Release or Master configuration, the ARM architecture, and Device as target. レッスン1から Section5 Step8Lesson1 Section5 Step8

  4. 最後の手順は、デバッグ > デバッグ なしで開始 を選択して、デバイスにビルドしてデプロイすることです。The final step is to build and deploy to your device by selecting Debug > Start without debugging. [デバッグなしで開始] を選択すると、ビルドが成功したときに、アプリケーションがすぐにデバイスで開始されます。ただし、デバッガーがアタッチされていない場合は、Visual Studio に情報が表示されます。Selecting Start without Debugging causes the application to immediately start on your device upon a successful build, but without the debugger attached and information appearing in Visual Studio. これは、アプリケーションが停止することなく HoloLens 2 上で実行されている間は、USB ケーブルを取り外すことができることも意味します。This also means that you can disconnect your USB cable while your application is running on your HoloLens 2 without stopping the application.

    注意

    また、[ビルド > デプロイ] を選択して、アプリケーションを自動的に起動せずにデバイスにデプロイすることもできます。You might also select Build > Deploy Solution to deploy to your device without having the application automatically start.

    レッスン1から Section5 Step9

結論Congratulations

これで、最初の HoloLens 2 アプリケーションが展開されました。You have now deployed your first HoloLens 2 application. このチュートリアルでは、HoloLens 2 によって認識されたすべてのサーフェスをカバーする空間マッピングメッシュがあることを確認します。As you walk around, you should see a spatial mapping mesh covering all the surfaces that have been perceived by the HoloLens 2. さらに、ハンドトラッキングのためのインジケーターと、アプリケーションのパフォーマンスを監視するためのフレームレートカウンターが表示されます。Additionally, you should see indicators on your hands and fingers for hand tracking and a frame rate counter for keeping an eye on application performance. これらは、Mixed Reality ツールキットに含まれている、すぐに使用できる基礎となる部分のほんの一部です。These are just a few of the foundational pieces, included out of the box, with the Mixed Reality Toolkit. このレッスンでは、HoloLens 2 と Mixed Reality Toolkit の機能を十分に調べることができるように、シーンにコンテンツと対話機能を追加します。In the lessons to come, you will start adding more content and interactivity to your scene so that you can fully explore the capabilities of HoloLens 2 and the Mixed Reality Toolkit.

注意

アプリでは、ビジュアルプロファイラーに気付くことがあります。In the app you may notice the visual profiler. レッスン 5では、音声コマンドを使用してフレームレートカウンターを切り替える方法について説明します。You will cover how to toggle the frame rate counter using a voice command in Lesson 5. 一般に、コードの変更によってパフォーマンスが低下した可能性がある場合は、開発中に常にビジュアルプロファイラーを表示したままにしておくことをお勧めします。It is generally recommended to keep the visual profiler visible at all times during development to understand when code changes may have impacted perf. HoloLens 2 アプリケーションは、 60 FPS で継続的に実行する必要があります。HoloLens 2 application should continuously run at 60 FPS.

次のレッスン: 3. ユーザーインターフェイスを作成し、Mixed Reality Toolkit を構成するNext Lesson: 3. Creating user interface and configure Mixed Reality Toolkit