HoloLens 2 Streaming Quick Start

Instructions for configuring and running HoloLens 2 Streaming with Unreal Engine 4.

Windows
MacOS
Linux
Prerequisite Topics

This page assumes you have prior knowledge of the following topics. Please read them before proceeding.

Streaming_ScreenShot.png

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

  1. Verify that you have installed the necessary prerequisites to run the HoloLens 2. See HoloLens 2 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

  1. Make sure that your HoloLens is charged. 

  2. If this is your first time launching the HoloLens, turn it on and proceed with the calibration process.

  3. Log in with your account or create a new account.

  4. Open the Settings menu.

    SettingsMenu.jpg

  5. Open Update & Security.

    UpdateandSecurity.jpg

  6. Open For developers.

    UpdateForDevelopers.jpg

  7. Enable Use developer features.

    EnableDeveloperFeatures.jpg

  8. Enable the Device Portal.

    EnableDevicePortal.jpg

3 - Configure HoloLens Streaming

Steps

  1. On your HoloLens, go to the Microsoft Store, then download and install the Holographic Remoting Player app.

    MSStore_HolographicRemotingPlayer2.PNG

  2. On your HoloLens, start the Holographic Remoting Player app.

    HolographicRemotingMenu.png

  3. Run Remote Connection (note the IP address that appears for use in a later step).

    holographicremotingplayer.png

  4. 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.

  5. 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.

  6. Go to Project Settings > Platform > Windows Mixed Reality > Holographic Remoting.

  7. Enable Enable Remoting for Editor and enter the IP address of your HoloLens in IP of HoloLens to remote to.

    ProjectSettings_IP_NotConfigured.png

    ProjectSettings_IP_Configured.png

    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.

  8. 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

  1. The Hololens should now be connected to the PC, and ready for streaming. 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.

    HolographicRemotingPlayer_ScreenShot.jpg

5 - On Your Own!

Now that HoloLens Streaming is configured and working, try loading a new Unreal Project on your PC.

Select Skin
Light
Dark

Welcome to the new Unreal Engine 4 Documentation site!

We're working on lots of new features including a feedback system so you can tell us how we are doing. It's not quite ready for use in the wild yet, so head over to the Documentation Feedback forum to tell us about this page or call out any issues you are encountering in the meantime.

We'll be sure to let you know when the new system is up and running.

Post Feedback