HoloLens 2 Device Quick Start

Instructions for configuring and running the HoloLens 2 Device 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.

Device_ScreenShot.png

Starting With the HoloLens 2, you can deploy and run an Unreal app directly on the device.

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. On the HoloLens, 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 - Install a Package to the HoloLens 2

If you do not already have an app built and available for the HoloLens, see Packaging an App for the HoloLens 2 for more information on packaging an app for the HoloLens 2. 

In the steps you will load two files, an *.appxbundle file and an *.appx file. The *.appxbundle file is the game's package. The *.appx file is the dependency package containing supporting files for the target architecture (arm64 or x64). The dependency package only needs to be installed a single time per device. If you have already installed the dependency file, just continue with the installation without selecting an optional package. If you reflash your device, you will lose everything that had been deployed to the device, including the dependency packages.  

  1. In your browser, enter 127.0.0.1:10080 to open the Windows Device Portal.

    Ensure that your device is plugged into your PC over USB, and that IPOverUSB is installed from the Windows 10 SDK.

    DevicePortal.png

  2. In the Windows Device Portal, select Views > Apps from the toolbar.

    DeployApps2.png

  3. Click the Choose File button, and browse to the location of your project, such as \Unreal Projects\TestProject\Hololens.

    ChooseFileButton.png

    BrowseToAppxPackage.png

  4. Select the .appxbundle file to specify the package you want to install.

    ChooseAppxBundle.png

  5. Select the Allow me to select optional packages option, and select Next.

    The *.appx file is the dependency package and only needs to be installed a single time per device. If you have already installed the dependency file, just continue with the installation without selecting an optional package.

    CheckSelectOptionalPackages.png

  6. Select the Choose File button, and browse to the location of your project, such as \Unreal Projects\TestProject\Hololens.

    ChooseOptionalPackage_ChooseFileButton.png

    BrowseToOptionalPackage.png

  7. Selected the *.appx file for the platform you are targeting (x64 for the Emulator, arm64 for the device), and click Next.

    ChooseAppx.png

  8. Click the Install button.

    InstallPackages_Device.png

  9. Wait for the app to finish installing.

    InstallationProgress.png Success_PackageRegistered.png

  10. Once the app installation is complete, scroll through All Apps on the to find your app.

    AllApps.png AppOnDevice.png

4 - On Your Own!

Try running the new Unreal app on your HoloLens 2.

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