Introduzione a MRTK2 e XR SDK

  • Articolo

XR SDK è la nuova pipeline XR di Unity in Unity 2019.3 e oltre. 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 a Gestione pacchetti di Unity e installare il pacchetto plug-in Windows XR, che aggiunge il supporto per Windows Mixed Reality in XR SDK. Verrà eseguito anche il pull di alcuni pacchetti di dipendenza.

  1. Assicurarsi che tutti i seguenti siano stati installati correttamente:

    • Gestione plug-in XR
    • Plug-in Windows XR
    • Helper di input legacy XR

  2. Passare a Modifica > impostazioni progetto.

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

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

  5. Assicurarsi che inizializzare XR in Avvio sia selezionato.

  6. (Obbligatorio per HoloLens Remoting, altrimenti facoltativo) Passare alle impostazioni autonome e assicurarsi che Windows Mixed Reality sia selezionata in Provider plug-in. Assicurarsi inoltre che inizializzare XR in Avvio sia selezionato.

    Gestione plug-in XR con scheda autonoma selezionata

  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.

    Gestione plug-in XR con scheda Windows selezionata

Oculus

  1. Seguire la procedura per configurare Oculus Quest in MRTK usando la guida alla pipeline XR SDK alla fine. La guida descrive i passaggi necessari per configurare Unity e MRTK per usare la 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 il comando Configura un nuovo progetto OpenXR con istruzioni MRTK per aggiungere il plug-in OpenXR al progetto. Verificare che siano stati installati correttamente gli elementi seguenti:

    1. Gestione plug-in XR
    2. Plug-in OpenXR
    3. plug-in OpenXR Realtà mista

  2. Passare a Modifica > impostazioni progetto.

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

  4. Assicurarsi che inizializzare XR in Avvio sia selezionato.

  5. (Facoltativo) Se la destinazione HoloLens 2, assicurarsi di essere nella piattaforma UWP e selezionare "Microsoft HoloLens gruppo di funzionalità".

  6. (Facoltativo) Se si punta a Quest 2, assicurarsi di essere nella piattaforma Android e selezionare "Rilevamento mano" e "Meta Quest Support".

    Gestione dei plug-in 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"/>

Configurazione di MRTK per la pipeline XR SDK

Usare uno dei profili MRTK predefiniti, che sono tutti configurati tra le pipeline XR di Unity. I precedenti "DefaultOpenXRConfigurationProfile" e "DefaultXRSDKConfigurationProfile" sono ora contrassegnati come obsoleti.

Se si usa OpenXR, scegliere "DefaultOpenXRConfigurationProfile" come profilo attivo o clonarlo per effettuare 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 effettuare 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 principale/unica in Unity 2020+, dove XR legacy non esiste.

Scheda XR SDK

Fotocamera

Aggiungere i provider di dati seguenti

Impostazioni della fotocamera XR SDK

Input

Aggiungere i provider di dati seguenti

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

OpenXR:

Impostazioni di input OpenXR

Windows Mixed Reality:

Impostazioni di input di XR SDK

Limite

Aggiungere i provider di dati seguenti

Plug-in OpenXR Plug-in Windows XR
XRSDKBoundarySystem XRSDKBoundarySystem

Impostazioni limite di XR SDK

Consapevolezza spaziale

Aggiungere i provider di dati seguenti

Impostazioni di consapevolezza spaziale di XR SDK

Mapping del controller

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

Vedi anche