Skip to content

Latest commit

 

History

History
88 lines (69 loc) · 4.33 KB

unreal-streaming.md

File metadata and controls

88 lines (69 loc) · 4.33 KB
title description author ms.author ms.date ms.topic ms.localizationpriority keywords appliesto
Streaming in Unreal
A guide to streaming in Unreal to HoloLens 2
sw5813
suwu
7/10/2020
article
high
Unreal, Unreal Engine 4, UE4, HoloLens, HoloLens 2, mixed reality, streaming, PC, holographic app remoting, holographic remoting player, documentation, mixed reality headset, windows mixed reality headset, virtual reality headset
HoloLens
HoloLens 2

Streaming in Unreal

Overview

Streaming from a PC to HoloLens provides two major advantages:

  • It lets your mixed reality app take advantage of your PCs computational power.
  • It helps speed up development iteration time.

To get started, you'll need to download the Holographic Remoting Player to your HoloLens device. This allows your app to stream directly to the remoting player on your HoloLens from the following sources:

  • The Unreal Engine editor
  • A packaged Windows executable

When streaming, you have access to almost all of the same HoloLens capabilities as you would when running an application on a device. This includes hand joint tracking (if you're on a HoloLens 2), spatial mapping, and spatial anchors, but leaves out the features on this list of limitations.

Note

  • Streaming quality is highly dependent on the strength of your wifi network.
  • All capabilities are automatically enabled for the holographic remoting player. If you find a capability that requires user permission (ex: eye tracking) to be working over streaming but not when running on device, check to ensure you've enabled the proper capabilities under your project settings.

Device support

Source HoloLens 1st Gen HoloLens 2 Immersive Headsets
Unreal editor ✔️ ✔️ ❌
Windows package ❌ ✔️ ❌

Streaming from the Unreal editor

As a developer, you'll find that streaming from the Unreal editor to your HoloLens device provides big benefits when testing, namely that you no longer have to wait for your app to build and deploy before trying out your updates.

You can find detailed instructions on streaming from the Unreal editor in the last section of the Getting Started with Unreal tutorial series.

Streaming from a packaged Windows executable

As of Unreal 4.25.1, you can stream your app to a HoloLens 2 device from a packaged Windows executable by following the steps below:

  1. Go to File > Package Project > Windows in the editor menu.

    • Choose a location to save your package and click Select Folder.

  2. Once the package has finished building, open the Holographic Remoting Player on your HoloLens 2 and make note of the IP Address.

  3. Leave the Holographic Remoting Player open and use the command line prompt to:

    • cd into the local directory where you saved your package.
    • Enter the following command: <App Name>.exe -vr -HoloLensRemoting=<IP Address>

Note

The application name in your project settings should be automatically used to create the Windows package. If these are different for some reason, use the Windows executable name in the command prompt.

Hit enter and watch your application start streaming!

See also