HoloLens 2 Emulator Quick Start

Instructions for setting up and running the HoloLens 2 emulator.

Windows
MacOS
Linux
필요한 사전지식

이 글은 다음 주제에 대한 지식이 있는 분들을 대상으로 합니다. 계속하기 전 확인해 주세요.

HoloLens2Emulator.png

The HoloLens Emulator lets you test holographic applications on your PC without a physical HoloLens. The emulator uses a Hyper-V virtual machine. The human and environmental inputs that are usually read by Hololens sensors are simulated from your keyboard, mouse, or Xbox controller. Applications don't need to be modified to run on the emulator; applications don't know that they aren't running on a real HoloLens.

1 - Verify System Requirements

Steps

  1. Verify that you have installed the necessary prerequisites to run the HoloLens 2 Emulator, see HoloLens 2 Prerequisites for more information.

2 - Install the HoloLens 2 Emulator

Steps

  1. Download and install the HoloLens 2 Emulator

    HL2EmulatorInstallationLink.png

  2. Review the default settings and proceed, but make sure to install the Emulator, the Emulator Image, and the Visual Studio Templates.

    HL2EmulatorInstallation_Items.png

  3. Once the HoloLens 2 Emulator is installed, you should see a success message. Click the Close button.

    hololens2eumlatorsuccess.png

If the emulator fails to install, review the HoloLens 2 Prerequisites.

3 - Run the HoloLens 2 Emulator

Steps

  1. Run the HoloLens 2 Emulator by pressing the Windows key, typing in HoloLens and selecting HoloLens 2 Emulator.

    HoloLensEmulatorInMenu.png

  2. The HoloLens 2 Emulator loads into a separate window.
    HoloLens2Emulator.png

  3. Review the HoloLens 2 Emulator controls.

    • Walk forward, back, left, and right - Use the W,A,S, and D keys on your keyboard, or the left stick on an Xbox controller.

    • Look up, down, left, and right - Click and drag the mouse, use the arrow keys on your keyboard, or the right stick on an Xbox controller.

    • Air tap gesture - Right-click the mouse, press the Enter key on your keyboard, or use the A button on an Xbox controller.

    • Bloom/System gesture - Press the Windows key or F2 key on your keyboard or press the B button on an Xbox controller.

    • Hand movement for scrolling - Simultaneously hold the Alt key and the right mouse button, and drag the mouse up or down, or in an Xbox controller, hold the right trigger and A button down, and move the right stick up and down.

    • Hand movement and orientation - Hold the Alt key and drag the mouse up or down, left or right to move the hand, or use the arrow keys and Q or E to rotate, and tilt the hand. For an Xbox controller, hold the left or right bumper, and use the left thumbstick to move the hand left, right, forward, and back, the right thumbstick to rotate it, and up or down on the Dpad to raise or lower the hand.

4 - Install a Package to the HoloLens 2 Emulator

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

The steps below have you load two files, both an *.appx file and an *.appxbundle file. Both files need to be loaded before continuing on with Next to install and register the app. The user interface only shows the last file loaded, which can be confusing.  

  1. From the right-hand menu, open the Device Portal for the HoloLens 2 Emulator.

    DevicePortalButton.png

  2. The Windows Device Portal will open up in a browser window.

    DevicePortal.png

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

    ![](DeployApps.png "DeployApps.png")

  4. In the Deploy Apps section, check the Allow me to select optional packages box.

    ![](SelectOptionalPackages.png "SelectOptionalPackages.png")

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

    ![](SelectOptionalPackagesChooseFile.png "SelectOptionalPackagesChooseFile.png")

    ![](BrowsetoPackage.png "BrowsetoPackage.png")

  6. Select the .appx file to specify the archtecture you're installing to (x64 for the Emulator).

    ChooseAppx.png

  7. After you have selected the .appx file, the file name will show next to the Choose File button. In the following steps you will select the matching .appxbundle file.

    ![](EndofAppxPackageSelection.png "EndofAppxPackageSelection.png")

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

    ![](ChooseFileBundle.png "ChooseFileBundle.png")

    ![](BrowsetoPackage.png "BrowsetoPackage.png")

  9. Now select the .appxbundle file to specify the package you want to install.

    ChooseAppxBundle.png

  10. After you have selected the *.appxbundle file, the file name will show next to the **Choose File** button.

    ![](EndofAppxBundleSelection.png "EndofAppxBundleSelection.png")

  11. Select the Next button.

    ![](SelectNext.png "SelectNext.png")

  12. Select the Install button.

    ![](Install.png "Install.png")

  13. Wait for the app to finish installing.

    ![](PackageInstallationProgress.png "PackageInstallationProgress.png")
    ![](PackageInstallationComplete.png "PackageInstallationComplete.png")

  14. Once the app installation is complete, scroll through All Apps on the Emulator to find your app (it's usually at the bottom of the list).

    AllApps.png AppOnDevice.png

5 - On Your Own!

Now that you have your app installed on the HoloLens 2 Emulator, try running the App to load an Unreal Project.

Select Skin
Light
Dark

새로운 언리얼 엔진 4 문서 사이트에 오신 것을 환영합니다!

문서 사이트에 대한 의견을 모을 수 있는 피드백 시스템을 포함해서 여러가지 새로운 기능을 준비하고 있습니다. 아래 Documentation Feedback 포럼(영문) 또는 언리얼 엔진 네이버 공식 카페(한글) 중 편하신 곳에 의견이나 문제점을 알려 주세요.

새 시스템이 준비되면 알려 드리겠습니다.

네이버 카페
공식 포럼