Introduzione a MRTK2 e XR SDK

XR SDK è la nuova pipeline XR di Unity in Unity 2019.3 e versioni successive. In Unity 2019 offre un'alternativa alla pipeline XR esistente. In Unity 2020 è l'unica pipeline XR in Unity.

Configurazione di Unity per la pipeline XR SDK

La pipeline XR SDK supporta attualmente 3 piattaforme: Windows Mixed Reality, Oculus e OpenXR. Le sezioni seguenti illustrano i passaggi necessari per configurare XR SDK per ogni piattaforma.

Windows Mixed Reality

Passare alla Gestione pacchetti di Unity e installare il pacchetto plug-in XR Windows, che aggiunge il supporto per Windows Mixed Reality in XR SDK. Verrà eseguito anche il pull di alcuni pacchetti di dipendenza.

  1. Verificare che siano stati installati tutti gli elementi seguenti:

    • Gestione del plug-in XR
    • plug-in XR Windows
    • Helper di input legacy XR
  2. Passare a Modifica > Project Impostazioni.

  3. Fare clic sulla scheda Gestione plug-in XR nella finestra Project Impostazioni.

  4. Passare alle impostazioni piattaforma UWP (Universal Windows Platform) e assicurarsi che Windows Mixed Reality sia selezionato in Provider plug-in.

  5. Verificare che l'opzione Initialize XR on Startup (Inizializza XR all'avvio) sia selezionata.

  6. (Obbligatorio per la comunicazione remota nell'editor HoloLens, in caso contrario facoltativo) Passare alle impostazioni autonome e assicurarsi che Windows Mixed Reality sia selezionato in Provider plug-in. Assicurarsi anche che l'opzione Inizializza XR all'avvio sia selezionata.

    XR Plugin management with Standalone tab selected

  7. (Facoltativo) Fare clic sulla scheda Windows Mixed Reality in Gestione plug-in XR e creare un profilo di impostazioni personalizzate per modificare le impostazioni predefinite. Se l'elenco delle impostazioni è già presente, non è necessario creare alcun profilo.

    XR Plugin management with Windows tab selected

Oculus

  1. Seguire la guida Come configurare Oculus Quest in MRTK usando la guida alla pipeline di XR SDK alla fine. La guida descrive i passaggi necessari per configurare Unity e MRTK per l'uso della pipeline XR SDK per Oculus Quest.

OpenXR

Importante

OpenXR in Unity è supportato solo in Unity 2020.2 e versioni successive. Supporta anche solo build x64, ARM e ARM64.

  1. Seguire le istruzioni configurare un nuovo progetto OpenXR con MRTK per aggiungere il plug-in OpenXR al progetto. Verificare che siano stati installati correttamente gli elementi seguenti:
    1. Gestione del plug-in XR
    2. Plug-in OpenXR
    3. plug-in OpenXR Realtà mista
  2. Passare a Modifica > Project Impostazioni.
  3. Fare clic sulla scheda Gestione plug-in XR nella finestra Project Impostazioni.
  4. Verificare che l'opzione Initialize XR on Startup (Inizializza XR all'avvio) sia selezionata.
  5. (Facoltativo) Se la destinazione è HoloLens 2, assicurarsi di essere nella piattaforma UWP e selezionare Microsoft HoloLens Set di funzionalità

Plugin management OpenXR

Nota

Se si dispone di un progetto preesistente che usa MRTK da UPM, assicurarsi che la riga seguente si trovi nel file link.xml che si trova nella cartella MixedRealityToolkit.Generated.

<assembly fullname = "Microsoft.MixedReality.Toolkit.Providers.OpenXR" preserve="all"/>

Nota

Per la versione iniziale di MRTK e OpenXR, solo le mani articolate HoloLens 2 e i controller di movimento Windows Mixed Reality sono supportati in modo nativo. Il supporto per hardware aggiuntivo verrà aggiunto nelle versioni future.

Configurazione di MRTK per la pipeline XR SDK

Usare uno dei profili MRTK predefiniti, tutti configurati nelle pipeline XR di Unity. Il precedente "DefaultOpenXRConfigurationProfile" e "DefaultXRSDKConfigurationProfile" sono ora etichettati come obsoleti.

Se si usa OpenXR, scegliere "DefaultOpenXRConfigurationProfile" come profilo attivo o clonarlo per apportare personalizzazioni.

Se si usano altri runtime XR nella configurazione di gestione plug-in XR, ad esempio Windows Mixed Reality o Oculus, scegliere "DefaultXRSDKConfigurationProfile" come profilo attivo o clonarlo per apportare personalizzazioni.

Questi profili vengono configurati con i sistemi e i provider corretti, se necessario. Per altre informazioni sul profilo e sul supporto di esempio con XR SDK, vedere la documentazione sui profili .

Per eseguire la migrazione di un profilo esistente a XR SDK, è necessario aggiornare i servizi e i provider di dati seguenti.

Sarà possibile visualizzare i nuovi provider di dati nella scheda XR SDK in Unity 2019 o nella visualizzazione main/only in Unity 2020+, dove XR legacy non esiste.

The XR SDK tab

Fotocamera

Aggiungere i provider di dati seguenti

XR SDK camera settings

Input

Aggiungere i provider di dati seguenti

Plug-in OpenXR plug-in XR Windows
OpenXRDeviceManager XRSDK.WindowsMixedReality.WindowsMixedRealityDeviceManager

OpenXR:

OpenXR input settings

Windows Mixed Reality:

XR SDK input settings

Limite

Aggiungere i provider di dati seguenti

Plug-in OpenXR plug-in XR Windows
XRSDKBoundarySystem XRSDKBoundarySystem

XR SDK boundary settings

Consapevolezza spaziale

Aggiungere i provider di dati seguenti

XR SDK spatial awareness settings

Mapping dei controller

Se si usano profili di mapping controller personalizzati, aprire uno di essi ed eseguire la voce di menu Realtà mista Toolkit -> Utilità - Aggiornamento ->> Profili mapping controller per assicurarsi che siano definiti i nuovi tipi di controller XR SDK.

Vedi anche