Setting up your Unreal project

  • Commodity
  • iii minutes to read

We recommend installing Unreal Engine version 4.25 or later to take full advantage of built-in HoloLens support.

Go to the Library tab in the Epic Games Launcher, select the dropdown arrow side by side to Launch and click Options. Under Target Platforms, select HoloLens two and click Apply. Unreal Install Option HoloLens 2

MRTK

Mixed Reality Toolkit (MRTK) is an open-source, cross-platform development kit for mixed reality applications. MRTK provides a cantankerous-platform input organisation, foundational components, and common building blocks for spatial interactions. The toolkit is intended to advance the development of applications targeting Microsoft HoloLens, Windows Mixed Reality immersive (VR) headsets, and the OpenVR platform.

If yous don't already have a mixed reality project, follow the first three sections of the HoloLens 2 Getting Started tutorials to get a project set up for the MRTK.

Introducing the MRTK Hub for Unreal

We recommend that you lot employ the MRTK Hub to larn MRTK plugins. It'due south a new fashion for developers to find and update Microsoft Mixed Reality plugins and add them to their Unreal projects. You can view plugins, see their dependencies and install them into your project without leaving the Unreal Editor.

  • Discover new Microsoft Mixed Reality plugins and install them and their dependencies into your Unreal projection.
  • Keep your Microsoft Mixed Reality plugins up to engagement.
  • Remove Microsoft Mixed Reality plugins from your project if you no longer demand them.

Note

The MRTK Hub for Unreal is only available for Unreal Engine version iv.26 or later. For Unreal Engine version four.25, you tin get MRTK plugins from the Unreal Engine Marketplace or GitHub every bit described in the Getting Started section.

Installing the MRTK Hub

Download the plugin from the Unreal Engine Marketplace, then open your project, and and so enable the plugin from the Mixed Reality section of the Plugins menu. When prompted, restart the editor.

Enable the MRTK Hub plugin

In one case the plugin is enabled for your project, yous can access the Hub from the toolbar button.

Open the MRTK Hub window

Installing mixed reality plugins

To install a plugin using the Hub, select the plugin y'all want to add to your project and then press the Install button. To download the plugin, verify that at that place are no conflicts in the Issues box and press Confirm. Once the plugin is downloaded, y'all'll be prompted to restart the editor.

Install a plugin using the MRTK Hub

Once the editor has restarted, your can continue on your mixed reality evolution journey.

Important

In one case the plugin is installed, it must be checked into source command similar any other project-level plugin.

Updating mixed reality plugins

To update a plugin using the Hub, select the plugin you desire to update from the list and press the Install button. To download the updated plugin, verify that there are no conflicts in the Issues box and press Confirm. You'll be prompted to restart the editor to complete the update. Notation that this restart may take some time as the plugins are updated.

Updating a plugin through the MRTK Hub

Removing mixed reality plugins

To uninstall a plugin using the Hub, select the plugin yous want to remove, and then select the version you have installed from the dropdown. To remove the plugin, verify that there are no conflicts in the Issues box and printing Confirm. You lot'll be prompted to restart the editor to complete the removal. Note that this restart may accept some time as the plugins are removed.

Removing a plugin through the MRTK Hub

Reviewing changes and detecting incompatibilities

You can view the exact changes that volition exist made to your projection in the bottom section of the Hub's window. From here you can encounter the plugins that volition be added or removed from your project alongside whatever potential incompatibilities that might cause issues when the changes have been fabricated.

Annotation

The Issues list will surface incompatibilities in the Unreal engine version and plugin dependency versions but it doesn't automatically fix or suggest fixes to issues.

Attempting to install an incompatible plugin

Notation

If you don't want to use MRTK for Unreal, you'll need to script all interactions and behaviors yourself.