HoloLens Streaming Quick Start

Instructions for configuring and running HoloLens Streaming.

Windows
MacOS
Linux

HolographicRemotingPlayer_ScreenShot.jpg

With Holographic Remoting, you can experience your app on the HoloLens, while it runs in the Unreal Editor on your PC. 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.

1 - Required Setup

Before setting up Unreal Engine and HoloLens for streaming, it is important that the HoloLens is initially configured, the user is familiar with HoloLens operations, and some basic configurations are set. Below are some brief instructions to help complete this essential setup.

Steps

  1. Make sure that your HoloLens is charged. 

  2. If this is the first time launching the HoloLens, turn it on and go through the Hololens New User eXperience (NUX). 

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

  4. Open the Settings > menu > Updates For Developers

    1. Enable Developer Mode

    2. Enable Device Portal

For more information on HoloLens setup and configuration, see Microsoft's HoloLens documentation.

To use Unreal Engine's HoloLens streaming support, you must be running Windows 10 October 2018 Update (Version 1809) or later. If you are are not on the correct version of Windows, you can enable the Windows Mixed Reality Plugin - however, the plugin will not be functional. You can use the Windows command winver to check your version of Windows.

2 - Configure HoloLens Steaming

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 **Windows Mixed Reality Plugin** is enabled. If the **Windows Mixed Reality Plugin** is not enabled, enable it and restart the editor when prompted.  
  5.  Go to **Project Settings** \> **Platform** \> **Windows Mixed Reality** \> **Holographic Remoting.**  
  6. For IP of HoloLens to remote to, enter the IP address of your HoloLens (noted earlier).

    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.

  7. Click Connect

3 - End Result

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

4 - On Your Own!

Now that HoloLens Streaming is configured and working, try loading up an Unreal Project to preview development efforts.

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