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 mesh, hand meshes, and the framerate counter.

手順Instructions

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

  1. Unity を起動します。Start Unity.
  2. [新規] を選択します。Select New. Lesson1 Chapter1 Step2Lesson1 Chapter1 Step2
  3. プロジェクト名を入力します (例: "MixedRealityBase")。Enter a project name (e.g. "MixedRealityBase"). Lesson1 Chapter1 Step3Lesson1 Chapter1 Step3
  4. プロジェクトを保存する場所を入力します。Enter a location to save your project. Lesson1 Chapter1 Step4Lesson1 Chapter1 Step4
  5. プロジェクトが [3D] に設定されていることを確認します。Make sure the project is set to 3D. Lesson1 Chapter1 Step5Lesson1 Chapter1 Step5
  6. [プロジェクトの作成] をクリックします。Click Create Project. Lesson1 Chapter1 Step6Lesson1 Chapter1 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. Lesson1 Chapter4 Step1Lesson1 Chapter4 Step1
  2. [ユニバーサル Windows プラットフォーム] を選択して、ユニバーサル Windows プラットフォームに切り替えます。Switch to Universal Windows Platform by selecting Universal Windows Platform. [プラットフォームの切り替え] ボタンをクリックして、プラットフォームを切り替えます。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. Lesson1 Chapter4 Step2Lesson1 Chapter4 Step2
  3. 次の図に示すように、[ビルド] ウィンドウで [プレーヤーの設定] をクリックし、[XR の設定] の下にある [Virtual Reality がサポートする] チェックボックスをオンにして、仮想現実を有効にします。Enable virtual reality by clicking on Player Settings 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. [サポートされている仮想現実] チェックボックスは、混合現実と拡張された現実のヘッドセットにも適用されます。これは、ステレオスコピック構想の有効化 (各視点に異なるイメージをレンダリングする) を指しているためです。Lesson1 Chapter4 Step3The 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 Chapter4 Step3
  4. 同じ [インスペクター] パネルで、[機能] セクションの [空間認識] チェックボックスが [発行の設定] で有効になっていることを確認します。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. Lesson1 Chapter4 Step4Lesson1 Chapter4 Step4

注: このセクションでは使用しませんが、他のいくつかの一般的な機能を有効にするには、音声コマンドのマイクや、ネットワーク接続を必要とするサービスに接続するための InternetClient などがあります。NOTE: 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 パッケージをダウンロードし、PC 上のフォルダーに保存します。Download the Mixed Reality Toolkit Unity package, and save it to a folder on your PC.

  2. [アセット] > [インポート] > [カスタム パッケージ] の順にクリックして、Mixed Reality Toolkit パッケージをインポートします。Import the Mixed Reality Toolkit package by clicking on Assets>Import>Custom Package. 手順 1 でダウンロードした Mixed Reality Toolkit パッケージを見つけて開き、インポート プロセスを開始します。Find the Mixed Reality Toolkit package downloaded in Step 1 and open it to begin the importing process. インポート プロセスには数分お待ちください。Please allow a few minutes for the importing process. Lesson1 Chapter2 Step2a Lesson1 Chapter2 Step2bLesson1 Chapter2 Step2a Lesson1 Chapter2 Step2b

  3. 次のポップアップウィンドウで、[インポート] をクリックして、Mixed Reality Toolkit のインポートを開始します。In the next pop-up window, click Import to begin importing the Mixed Reality Toolkit. 画像に示されているように、すべての項目がオンになっていることを確認します。Ensure all items are checked as shown in the image. Mixed Reality Toolkit の既定の設定を適用するよう求めるポップアップダイアログボックスが表示されたら、[適用] をクリックします。If you see a pop-up dialog box asking to apply the Mixed Reality Toolkit default settings, click Apply. Lesson1 Chapter2 Step3 Lesson1 Chapter2 Step3Lesson1 Chapter2 Step3 Lesson1 Chapter2 Step3

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

  1. メニューバーから [Mixed Reality Toolkit > 構成] を選択して、MRTK を構成します。Configure the MRTK by selecting Mixed Reality Toolkit > 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. Lesson1 Chapter3 Step1Lesson1 Chapter3 Step1

注:Mixed Reality Toolkit のプロファイルを選択するよう求めるポップアップダイアログボックスが表示される場合があります。Note: You may see a pop-up dialog box asking to select a profile for the Mixed Reality Toolkit. その場合は、[Ok] を選択し、"DefaultMixedRealityToolkitConfigurationProfile" という名前のプロファイルを選択します。If so, select Ok, and choose the profile named "DefaultMixedRealityToolkitConfigurationProfile."

  1. シーンには、MRTK からいくつかの新しい項目と変更が加えられています。Your scene will have several new items and modifications in it from the MRTK. [ファイル > 名前を付けて保存] をクリックし、シーンに 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. Lesson1 Chapter3 Step2a Lesson1 Chapter3 Step2bLesson1 Chapter3 Step2a Lesson1 Chapter3 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. Lesson1 Chapter5 Step1Lesson1 Chapter5 Step1

  2. [開いているシーンを追加] ボタンをクリックして、目的のシーンがビルドリストのシーンにあることを確認します。Ensure the scene you want to try is in the Scenes in Build list by clicking on the Add Open Scenes button.

  3. [ビルド] ボタンを押して、ビルド プロセスを開始します。Press the Build button to begin the build process. Lesson1 Chapter5 Step3Lesson1 Chapter5 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. Lesson1 Chapter5 Step4Lesson1 Chapter5 Step4

注: ビルドが失敗した場合は、もう一度構成してみるか、Unity を再起動してから再度ビルドしてください。NOTE: 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 ファイルが存在するためです。Note: 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.

Lesson1 Chapter5 Step5

注:Visual Studio から新しいコンポーネントをインストールするよう求められたら、少し時間を取って、「ツールのインストール」ページで示されている、前提条件となるすべてのコンポーネントがインストールされていることを確認してくださいNote: 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. HoloLens 2 を PC に接続します。Connect your HoloLens 2 into your PC. これらの手順では、HoloLens 2 デバイスでテストをデプロイすることを前提としていますが、 hololens 2 エミュレーターにデプロイするか、サイドローディング用のアプリパッケージの作成を選択することもできます。While these instructions assume you will be deploying a test with a HoloLens 2 device, you might also choose to deploy to the HoloLens 2 emulator or choose to create an app package for sideloading

  2. デバイスにビルドする前に、デバイスが開発者モードであることを確認してください。Before building to your device, ensure that the device is in Developer Mode. 初めて HoloLens 2 にデプロイする場合、Visual Studio によって HoloLens 2 と PIN をペアリングするように求めるメッセージが表示されることがあります。If this is your first time deploying to the HoloLens 2, Visual Studio might ask you to pair your HoloLens 2 with a PIN. 開発者モードを有効にするか、Visual Studio とペアリングする必要がある場合は、こちらの手順に従ってください。Please follow these instructions if you need to enable developer mode or pair with Visual Studio.

  3. リリース構成と ARM アーキテクチャを選択して、HoloLens 2 にビルドするように Visual Studio を構成します。Configure Visual Studio for building to your HoloLens 2 by selecting the Release configuration and the ARM architecture. Lesson1 Chapter5 Step8Lesson1 Chapter5 Step8

  4. 最後の手順は、デバッグ > デバッグなしで開始 を選択してデバイスにビルドすることです。The final step is to build 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 debugging 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. Lesson1 Chapter5 Step9Lesson1 Chapter5 Step9

結論Congratulations

これで、最初の HoloLens 2 アプリケーションが展開されました。You have now deployed your first HoloLens 2 application. このチュートリアルでは、HoloLens 2 によって認識されたすべてのサーフェスをカバーする空間メッシュがあることを確認します。As you walk around, you should see a spatial 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 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.

注:音声コマンドを使用してフレームレート カウンターを切り替える方法については、レッスン 5 で説明しますNote: You will cover how to toggle the frame rate counter using a voice command in Lesson 5

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