Edit

Preview and debug your app using Holographic Remoting and Play mode

  • Article

This article explains the following use case for Holographic Remoting:

  • You want to preview and debug your app during the development process: You can run your app locally in the Unity editor on your PC in Play Mode and stream the experience to your HoloLens. This provides a way to quickly debug your app without building and deploying a full project. We call this type of app a Holographic Remoting Play Mode Preview app. Inputs from the HoloLens--gaze, gesture, voice, and spatial mapping--are sent to the PC, where content is rendered in a virtual immersive view. The rendered frames are then sent to the HoloLens.

To learn more about Holographic Remoting, see Holographic Remoting Overview

Note that you can also use Holographic Remoting if you want the resources of a PC to power your app instead of relying on the HoloLens on-board resources.

Set up Holographic Remoting

To use Holographic Remoting, you need to install the Holographic Remoting Player app from the Microsoft Store on your HoloLens (in this article, we'll refer to it simply as "the Player"). As explained below, after you download and run the app, you'll see the version number and IP address to connect to. You'll need v2.4 or later in order to work with the OpenXR plugin.

Holographic Remoting requires a fast PC and Wi-Fi connection. You can find more details in the Holographic Remoting Player article linked above.

Screenshot of the Holographic Remoting Player running in the HoloLens

The following steps assume that you have already set up your project to use OpenXR (in other words, you've imported the required packages and chosen settings for the OpenXR plug-in). If you haven't yet done this, see our articles describing how to set up a new OpenXR project with MRTK or without MRTK.

  1. On your HoloLens 2, go to the Microsoft Store and install the Player**.

  2. On your HoloLens 2, launch and play the Player. Note that on the Start menu, the tile for the Player says Holographic Remoting. After launching the Player, make sure to press the "Play" button which appears in the middle of the Player's interface.

  3. In Unity, on the menu bar, select Mixed Reality > Remoting > Holographic remoting for play mode.

    Screenshot of project settings panel open in the Unity Editor with XR Plug-in management highlighted.

  4. In the Holographic Remoting for Play Mode window, in the Remote Host Name box, enter the IP address of your HoloLens 2.

    Tip

    The IP address of your HoloLens 2 is displayed in the interface of the Player after you click "Play" to start it.

    Screenshot of the Holographic Remoting Player running on the HoloLens 2 with IP address circled.

  5. Change other settings as needed.

  6. Click the Enable Holographic Remoting for Play Mode button.

    Screenshot of the Holographic Remoting for Play Mode window.

  7. Select the Play button to enter Play Mode, and then view the app in your HoloLens 2.

    Tip

    To debug C# scripts in play mode, attach Visual Studio to Unity.