Uso del plug-in Windows XRUsing Windows XR plugin

Per gli sviluppatori che hanno come destinazione Unity 2020, il plug-in Windows XR consente l'accesso alle funzionalità di realtà mista HoloLens 2 e Windows Mixed Reality visori VR.For developers targeting Unity 2020, the Windows XR plugin enables access to mixed reality features on HoloLens 2 and Windows Mixed Reality headsets. Questo plug-in è supportato anche in Unity 2019, anche se esistono alcune incompatibilità note con Ancoraggi nello stato di Azure quando si usa questo plug-in in tale versione.This plugin is also supported on Unity 2019, although there are some known incompatibilities with Azure Spatial Anchors when using this plugin on that version.

Anche se Microsoft e la community hanno creato strumenti opensource come Mixed Reality Toolkit (MRTK) che configurano automaticamente l'ambiente WMR, molti sviluppatori vogliono creare le proprie esperienze da zero.While Microsoft and the community have created opensource tools such as the Mixed Reality Toolkit (MRTK) that will automatically set up the WMR environment, many developers wish to build their experiences from the ground up. La documentazione seguente illustra come configurare correttamente un progetto per lo sviluppo di realtà mista indipendentemente dal fatto che si utilizzi o meno MRTK.The following documentation will demonstrate how to properly set up a project for Mixed Reality development whether you are using MRTK or not. Le impostazioni che è necessario modificare sono suddivise in due categorie: impostazioni per progetto e impostazioni per scena.The settings you need to change are broken down into two categories: per-project settings and per-scene settings.

Configurazione del progetto con MRTKSetting up your project with MRTK

MRTK per Unity offre un sistema di input multipiattaforma, componenti fondamentali e blocchi predefiniti comuni per le interazioni spaziali.MRTK for Unity provides a cross-platform input system, foundational components, and common building blocks for spatial interactions. MRTK versione 2 intende accelerare lo sviluppo di applicazioni per Microsoft HoloLens, i visori VR immersive di Windows Mixed Reality e la piattaforma OpenVR.MRTK version 2 intends to speed up application development for Microsoft HoloLens, Windows Mixed Reality immersive (VR) headsets, and OpenVR platform. Il progetto mira a ridurre le barriere di accesso, creare applicazioni di realtà mista e restituire contributi alla community per continuare a crescere insieme.The project is aimed at reducing barriers to entry, creating mixed reality applications, and contributing back to the community as we all grow.

Per altri dettagli sulle funzionalità, vedere la documentazione di MRTK.Take a look at MRTK's documentation for more feature details.

Configurazione manuale senza MRTKManual setup without MRTK

Se si usa la realtà virtuale desktop come destinazione, è consigliabile usare la piattaforma pc autonoma selezionata per impostazione predefinita in un nuovo progetto Unity:If you're targeting Desktop VR, we suggest using the PC Standalone Platform selected by default on a new Unity project:

Screenshot della finestra Build Settings (Impostazioni di compilazione) aperta nell'editor di Unity con PC, Mac & piattaforma autonoma evidenziata

Se la destinazione è HoloLens 2, è necessario passare al piattaforma UWP (Universal Windows Platform):If you're targeting HoloLens 2, you need to switch to the Universal Windows Platform:

  1. Selezionare Impostazioni > file...Select File > Build Settings...
  2. Selezionare piattaforma UWP (Universal Windows Platform) nell'elenco Piattaforma e selezionare Cambia piattaformaSelect Universal Windows Platform in the Platform list and select Switch Platform
  3. Impostare Architecture (Architettura) su ARM 64Set Architecture to ARM 64
  4. Impostare Dispositivo di destinazione su HoloLensSet Target device to HoloLens
  5. Impostare Tipo di compilazione su D3DSet Build Type to D3D
  6. Impostare UWP SDK su Latest installed (Versione più recente installata)Set UWP SDK to Latest installed
  7. Impostare Build configuration (Configurazione build) su Release (Versione) perché sono presenti problemi di prestazioni noti con DebugSet Build configuration to Release because there are known performance issues with Debug

Screenshot della finestra Build Settings (Impostazioni di compilazione) aperta nell'editor di Unity con piattaforma UWP (Universal Windows Platform) evidenziato

Dopo aver impostato la piattaforma, è necessario invii a Unity una visualizzazione immersiva anziché una visualizzazione 2D quando viene esportata:After setting your platform, you need to let Unity know to create an immersive view instead of a 2D view when exported:

  1. Nell'editor di Unity passare a Edit > Project settings (Modifica impostazioni progetto) e selezionare XR Plugin Management (Gestione plug-in XR)In the Unity Editor, navigate to Edit > Project settings and select XR Plugin Management

  2. Selezionare Install XR Plugin Management (Installa gestione plug-in XR)Select Install XR Plugin Management

Screenshot della finestra Project Settings (Impostazioni progetto) aperta nell'editor di Unity con la gestione del plug-in XR evidenziata

  1. Selezionare Initialize XR on Startup (Inizializza XR all'avvio) Windows Mixed RealitySelect Initialize XR on Startup and Windows Mixed Reality

Screenshot della finestra Delle impostazioni del progetto aperta nell'editor di Unity con la gestione del plug-in XR evidenziata

  1. Espandere la sezione XR Plug-in Management (Gestione plug-in XR) e selezionare la scheda Univeral Windows Platform Settings (Impostazioni piattaforma Windows univeral)Expand the XR Plug-in Management section and select Univeral Windows Platform Settings tab
  2. Se si usa Unity 2020 o versione successiva, verranno visualizzati i controlli OpenXR o Windows Mixed Reality.If you're using Unity 2020 or later, you'll see the options to check OpenXR or Windows Mixed Reality.
    • È possibile scegliere uno dei due runtime.You can choose either runtime. Se si sviluppa specificamente per il HoloLens 2 o HP Reverb G2 e si decide di provare OpenXR, selezionare la casella OpenXR ed esaminare la guida Uso del plug-in OpenXR di Realtà mista per Unity per configurare correttamente questi dispositivi prima di tornare a questa esercitazioneIf you're specifically developing for the HoloLens 2 or the HP Reverb G2 and decide to try the OpenXR, select the OpenXR box and review our guide to Using the Mixed Reality OpenXR Plugin for Unity to get yourself set up correctly for these devices before returning to this tutorial

Nota

A partire da Unity 2020 LTS, Microsoft sta iniziando lo sviluppo con OpenXR.Starting in Unity 2020 LTS, Microsoft is embracing development with OpenXR. Durante la migrazione a questo percorso, in Unity 2021.1 il plug-in Windows XR verrà deprecato e rimosso nella versione 2021.2 rendendo OpenXR l'unico percorso supportato.As we migrate to this path, in Unity 2021.1 the Windows XR plugin will be deprecated and removed in 2021.2 making OpenXR the only supported path. Per altre informazioni, vedere Using the Mixed Reality OpenXR plugin (Uso del plug-in OpenXR di Realtà mista).You can find more information in Using the Mixed Reality OpenXR plugin.

  1. Se si decide di scegliere il plug-Windows Mixed Reality, selezionare tutte le caselle e impostare Modalità di invio profondità su Depth 16 Bit (Profondità 16 bit)If you decide to choose the Windows Mixed Reality plugin, check all boxes and set Depth Submission Mode to Depth 16 Bit

Screenshot della finestra Project settings (Impostazioni progetto) aperta nell'editor di Unity con Windows Mixed Reality sezione evidenziata