Hololens 2 development 101: create the first hololens 2 Application

notes : Source of this tutorial Microsoft official documents
https://docs.microsoft.com/zh-cn/windows/mixed-reality/mrlearning-base
https://docs.microsoft.com/zh-cn/windows/mixed-reality/mrlearning-base-ch1
There are refinements and changes

1. Overview and objectives

This tutorial is for :HoloLens 2

System essentials

• Use and install correctly Tools Configured WINDOWS 10 The computer
• Windows 10 SDK 10.0.18362.0 Or later
• Some basic C# Programming capabilities .
• Enable Developer model Of HoloLens 2 equipment .

2. Initialize the project and the first application

In this tutorial , You will learn about the hybrid reality toolkit (MRTK) Some functions that must be provided , start-up HoloLens 2 The first application of , And deploy it to the device .

The goal is

• by HoloLens Development goes on Unity Set up .
• Import resources and set the scene .
• Spatial grid 、 Visualization of hand grids and frame rate counters .

explain

Create a new Unity project

1. start-up Unity.
2. choice “New” .
   
3. Enter the project name （ for example “MixedRealityBase”）.
   
4. Enter the location to save the project .
   
5. Please make sure that the project is set to “3D” .
   
6. single click “Create Project” .
   

Configure for Windows Mixed Reality Of Unity project

1. go to “File > Build Settings”, open “Build Settings” window .
   
2. By choice "Universal Windows Platform" Switch to general Windows platform . single click “Switch Platform” Button switch platform . stay HoloLens 2 Applications running on need to be generic Windows platform (UWP) compatible .
   
3. By clicking " Build" Window “Player Settings” Enable virtual reality , And then in “Inspector” In the panel “XR Settings” Next enable “Virtual Reality Supported” Check box , As shown in the figure below . Please note that , You may need to “Build Settings” Drag the window out , To see Inspector panel . “Virtual Reality Supported” The check box also applies to mixed reality and augmented reality head displays , Because it refers to enabling stereoscopic effects ( Each eye presents a different image ).
4. In the same Inspector The palette , Make sure that the “Publishing Settings” Next enable “Capabilities” In section “Spatial Perception” Check box . Spatial awareness enables us to work on hybrid reality devices ( Such as HoloLens 2) Visually display the spatial mapping grid . Publishing settings are located at “Inspector” In the panel “XR Settings” and “Other Settings” In the middle of the .
   
   Be careful ： Although this tutorial does not use , But you may want to enable others Including the microphone ( For voice commands ) as well as InternetClient( For connecting to services that require a network connection ) Common features of .

Import the mixed reality toolkit （MRTK）

1. download MRTK Unity package, And save it to a folder on your computer .
2. By clicking ”Assets”>“Import”>“Custom Package” Import the mixed reality toolkit . Find the downloaded hybrid reality toolkit and open it to start the import process . The import process takes a few minutes .
   
   
3. In the next pop-up window , single click “Import” To start importing the hybrid reality toolkit . Make sure all items are selected , As shown in the figure . If you see a pop-up dialog , It is required to apply the default settings of the hybrid reality toolkit , Please click on the “ application ”.
   
   

Configure the hybrid reality toolkit

1. By selecting “Mixed Reality Toolkit” > “Configure” To configure the MRTK. If you don't see this menu item after importing the hybrid reality toolkit , Please restart. Unity.
   
   [ Be careful ]: You may see a pop-up dialog box , Requirements for The hybrid reality toolkit selects a profile . If it is , Please select “ determine ”, Then choose the name “DefaultMixedRealityToolkitConfigurationProfile” Configuration file for .

2. Your scene will be MRTK There are many new items and modifications in . single click “File” > “Save As”, Save the scene under another name , And assign a name to the scene , for example BaseScene. By saving the scene to the “Assets” In the folder “Scenes” Folder , Keep the scene in order .
   
   
   Building applications on devices

3. If you close “Build Settings” window , Please go to “ file > Build Settings”, Reopen “Build Settings” window .
   

4. single click “Add Open Scenes” Button , Make sure the scene you want to try is “Build” In the scene in the list .

5. Press ”Build” Button to start the generation process .
   

6. Create a new folder for your application and name it . In the following illustration , Created a containing application named “App” Folder . single click “Select Folder”, Start generating to the newly created folder . After the generation , It can be turned off Unity Medium “Build Settings” window .
   
   [ Be careful ]： If the build fails , Try building or restarting again Unity And generate again . If you see an error , Such as " error :CS0246 = Type or namespace name not found “XX” ( Is there a lack of using Instruction or assembly reference ？). If so , You may need to install Windows 10 SDK (10.0.18362.0)

7. After the build is complete , Open the newly created folder containing the newly generated application file . double-click “MixedRealityBase” Solution or corresponding name ( If you use an alternate name for the project ) In the Visual Studio Open the solution file in .
   Be careful : If you follow the naming in the previous steps , Make sure you open the newly created folder ( namely App Folder ), Because there are people with the same name inside and outside the folder .sln file , This will not be confused by the name .
   
   Be careful : If Visual Studio You are required to install new components , Please take a moment to ensure that “ Installation tools ” Install all prerequisites according to the instructions in the page

8. take HoloLens 2 Connect to your PC. Although these instructions assume that you want to use HoloLens 2 Equipment deployment test , But you can also choose to deploy to hololens 2 Simulator , Or choose to create an application package for side loading

9. Before deploying to the device , Please make sure the device is in developer mode . If this is your first deployment to HoloLens 2, be Visual Studio You may be asked to HoloLens 2 And PIN pairing . If you need to enable Developer mode or with Visual Studio pairing , Please follow these instructions .

10. By choice “ Release ” Configuration and ARM Architecture , take Visual Studio Configured to generate to HoloLens 2.
    

11. The last step is to select “ debugging ” > “ Start execution ( Don't debugging )” To generate devices . If you choose “ Start without debugging ”, It will cause the application to start immediately after successful generation , But not in Visual Studio Debugging information is displayed in . This also means that you can HoloLens 2 Disconnect while running the application on USB Connect , Without stopping the application . You have a choice “Build” > Deploy the solution to the device , Without the application starting automatically .
    

Congratulations on

Now? , You have deployed the first HoloLens 2 Applications . When browsing , You should see a spatial grid , It contains information that has been provided by HoloLens 2 All surfaces detected . Besides , You should see indicators on your hands and fingers for hand tracking , And a frame rate counter for tracking application performance . These are just some of the basic functions that are readily available in the hybrid reality toolkit . In the following tutorial , You start adding more content and interactivity to the scene , So that you can fully explore HoloLens 2 Features and hybrid reality toolkit .