Preview your work with Holographic Remoting

You can use Holographic Remoting to stream holographic content to your HoloLens 2 in real time. This is a great way to quickly debug your app without building and deploying a full project.

A fast way to work on your Unity project is to use "Play Mode", which runs your app locally in the Unity editor on your PC. Unity uses Holographic Remoting to provide a fast way to preview your content on a real HoloLens device. Play Mode can also be used with a Windows Mixed Reality headset attached to your development PC.

Holographic Remoting setup

  1. First, you need to install the Holographic Remoting Player app from the Microsoft Store on your HoloLens 2

  2. Run the Holographic Remoting Player app on the HoloLens 2 and you'll see the version number and IP address to connect to

    • You'll need v2.4 or later to work with the OpenXR plugin

    Screenshot of the Holographic Remoting Player running in the HoloLens

Unity Play Mode with Holographic Remoting

With Holographic Remoting, you can experience your app on the HoloLens while it runs in the Unity editor on your PC. Gaze, gesture, voice, and spatial mapping input is sent from your HoloLens to your PC. Rendered frames are then sent back to your HoloLens. This is a great way to quickly debug your app without building and deploying a full project.

  1. On your HoloLens, go to the Microsoft Store and install the Holographic Remoting Player app.

  2. On your HoloLens, start the Holographic Remoting Player app.

  3. In Unity, go to the Edit menu and select Project Settings.

  4. Select XR Plug-in Management.

  5. Ensure the Windows Standalone tab is selected, find OpenXR and Windows Mixed Reality feature set in the list, and check their checkboxes.

  6. Next, go to the Window menu, expand the XR submenu, and select OpenXR Editor Remoting.

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

  7. Click Enable Editor Remoting.

    Screenshot of project settings panel open in the Unity Editor with Features highlighted

  8. If the Enable Missing Dependencies button appears, click that as well. The error box above the button describes the features it's enabling and why.

  9. For Remote Host Name, enter the IP address of your HoloLens.

    1. Change other settings as needed.
    2. The editor will attempt to connect once Play Mode is started.
  10. Select the Play button to start Play Mode and experience the app on your HoloLens. To debug C# scripts in play mode, attach Visual Studio to Unity.

Note

As of version 0.1.0, the Holographic Remoting runtime doesn’t support Anchors, and ARAnchorManager functionalities will not work through remoting. This feature is coming in future releases.

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

For best results, make sure your app properly sets the focus point. This helps Holographic Remoting to best adapt your scene to the latency of your wireless connection.

See Also