With HoloLens streaming, you can experience your app on the HoloLens while it runs in the Unreal Editor on your PC. The HoloLens sends eye tracking, gesture, voice, current device pose, and spatial mapping input to your PC, which then sends (or streams) rendered frames back to your HoloLens.
HoloLens streaming boosts app performance, and provides a more streamlined development workflow as you do not need to package and deploy your app before running it.
1 - Verify System Requirements
Steps
- Verify that you have installed the necessary prerequisites to run the HoloLens. See HoloLens Prerequisites for more information.
2 - Required Setup
Before setting up Unreal Engine and the HoloLens for streaming, it is important that the HoloLens is initially configured, and that you are familiar with basic HoloLens operations.
For more information on initial HoloLens setup and configuration, see Get started with HoloLens.
Steps
-
Make sure that your HoloLens is charged.
-
If this is your first time launching the HoloLens, turn it on and proceed with the calibration process.
-
Log in with your account or create a new account.
-
Open the Settings menu.
-
Open Update & Security.
-
Open For developers.
-
Enable Use developer features.
-
Enable the Device Portal.
3 - Configure HoloLens Streaming
Steps
-
On your HoloLens, go to the Microsoft Store, then download and install the Holographic Remoting Player app.
-
On your HoloLens, start the Holographic Remoting Player app.
-
Run Remote Connection (note the IP address that appears for use in a later step).
-
In your Unreal project, make sure that the HoloLens Plugin is enabled (Plugins > Augmented Reality > HoloLens). If the HoloLens Plugin is not enabled, enable it and restart the editor when prompted.
-
In your Unreal project, make sure that the Microsoft Windows Mixed Reality Plugin is enabled (Plugins > Virtual Reality > Microsoft Windows Mixed Reality). If the Microsoft Windows Mixed Reality Plugin is not enabled, enable it and restart the editor when prompted.
-
Go to Project Settings > Platform > Windows Mixed Reality > Holographic Remoting.
- Enable Enable Remoting for Editor and enter the IP address of your HoloLens in IP of HoloLens to remote to.
In order for the HoloLens to connect to your PC, the HoloLens must be connected to the same network as your PC. If you are having trouble connecting to the HoloLens, the instructions for configuring the Device Portal for HoloLens may provide some additional guidance.
-
Click Connect.
If HoloLens 1 Remoting is enabled, only a HoloLens 1 device will be able to connect to the project (a HoloLens 2 device will not be able to connect to the project).
4 - End Result
-
The Hololens should now be connected to the PC, and ready for streaming. Launch the project with VR Preview. You should see the screen go blank in the HoloLens, then the screen will show a window in the middle of your vision. This window is a mirror of the Unreal Engine Viewport window running on your PC.
5 - On Your Own!
Now that HoloLens Streaming is configured and working, try loading a new Unreal Project on your PC.