Skip to content

Latest commit

 

History

History
54 lines (39 loc) · 3.72 KB

porting-guides.md

File metadata and controls

54 lines (39 loc) · 3.72 KB
Raw
title description author ms.author ms.date ms.topic keywords ms.custom
Port VR apps to Windows Mixed Reality
Walk through requirements, common steps, and Unity-specific steps for porting existing immersive Unity applications to Windows Mixed Reality.
JBrentJ
alexturn
05/21/2022
how-to
port, unity, unreal, middleware, engine, UWP, Win32, porting, HoloLens 1st gen, mixed reality headset, windows mixed reality headset, migration, Windows 10, input mapping,
kr2b-contr-experiment

Port VR apps to Windows Mixed Reality

Windows 10 includes support for immersive and holographic headsets. Other devices like the Oculus Rift or HTC Vive have dependencies on libraries that exist above the operating system's platform API. To bring existing Win32 Unity VR apps over to Windows Mixed Reality, you need to retarget vendor-specific VR SDK usage to Unity's cross-vendor VR APIs and plugins.

Porting VR apps to Windows Mixed Reality requires the following high-level processes:

  1. Make sure your PC is running the Windows 10, version 1709 (the Fall Creator's Update) or newer, or Windows 11.
  2. Upgrade to the latest version of your graphics or game engine. Game engines must support the Windows 10 SDK version 10.0.15063.0 or higher.
  3. Upgrade middleware, plug-ins, and components. If your app contains any components, upgrade to the latest versions.
  4. Target the latest Unity version and OpenXR plugin. Remove dependencies on duplicate SDKs. Depending on which device your content targeted, remove or conditionally compile out that SDK.
  5. Work through build issues specific to your app, your engine, and your component dependencies.

Common porting steps

Start with the following common porting steps:

  1. Make sure you have the right development hardware. The VR enthusiast guide lists the recommended development hardware.

  2. Upgrade to the latest flight of Windows 10.

    1. Install the Windows 10 Creators Update
    2. Join the Windows Insider Program.
    3. Enable Developer Mode
    4. Switch to the Windows Insider Fast flights through Settings > Update & Security Section.

    [!NOTE] The Windows Mixed Reality platform is still under active development. Join the Windows Insider Program to access the Windows Insider Fast flight. Don't get preview builds from the Insider Skip Ahead ring, because those builds aren't the most stable for mixed reality development.

  3. If you're using Visual Studio, upgrade to the most recent build. See Install the tools under Visual Studio 2022. Be sure to install the Game Development with Unity workload.

Unity porting steps

[!INCLUDE]

See also