mrtk_developmentreleases/2.0.0releases/2.1.0releases/2.2.0

    Show / Hide Table of Contents

    Getting Started with Holographic Remoting

    Holographic remoting streams holographic content from a PC to your Microsoft HoloLens in real-time, using a Wi-Fi connection. This feature can significantly increase developer productivity when developing mixed reality applications.

    Initial setup

    To enable remoting to a HoloLens, it is important to ensure that the project is using the latest remoting components.

    1. Open Window > Package Manager
      • Verify that latest version of the Windows Mixed Reality package is installed.
    2. Ensure the latest Holographic Remoting application is installed, on the HoloLens, via the Microsoft Store.

    When using a HoloLens 2, support for remoting articulated hand and eye tracking data has been added to MRTK. To enable these features, configure the project using the following steps.

    1. Run the MRTK Configurator Utility (Mixed Reality Toolkit > Utilities > Configure Unity Project)

    2. Expand Modify Configurations

      MRTK Configurator

    3. Ensure that Enable MSBuild for Unity is selected

    4. Click Apply

    Connecting to the HoloLens

    Once the project has been configured, a connection can be established to the HoloLens.

    1. In File > Build Settings, ensure that the project build type is set to Universal Windows Platform

    2. On the HoloLens, launch the Holographic Remoting application.

    3. In Unity, select Window > XR > Holographic Emulation.

      Start Holographic Emulation

    4. Set Emulation Mode to Remote to Device.

      Set Emulation Mode

    5. Select the Device Version.

      Select Device Version

    6. Using the IP Address displayed by the Holographic Remoting application, set the Remote Machine field.

      Select Device Version

    7. Click Connect.

    Note

    If you cannot connect, make sure your HoloLens2 is not plugged in and restart Unity.

    Starting a remoting session

    With Unity connected to the HoloLens, enter play mode in the editor.

    When the session is complete, exit play mode.

    Note

    There is a known issue with some versions of Unity where the editor may hang upon entering play mode during a remoting session. This issue may manifest if the Holographic window is open when the project is loaded. To ensure this issue does not occur, always close the Holographic dialog prior to exiting Unity.

    See Also

    • Holographic Remoting troubleshooting and limitations
    • Microsoft Holographic Remoting software license terms
    • Improve this Doc
    In This Article
    • Initial setup
    • Connecting to the HoloLens
    • Starting a remoting session
    • See Also
    Back to top Generated by DocFX