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 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. Verificare che siano stati installati tutti gli elementi seguenti:

    • Gestione del 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. Verificare che l'opzione Initialize XR on Startup (Inizializza XR all'avvio) sia selezionata.

  6. (Obbligatorio per HoloLens Remoting nell'editor, altrimenti facoltativo) Passare alle impostazioni autonome e verificare che Windows Mixed Reality sia selezionata in Provider plug-in. Assicurarsi anche che l'opzione Inizializza XR all'avvio sia selezionata.

    Gestione del 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 del plug-in XR con scheda Windows selezionata

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 > impostazioni progetto.
  3. Fare clic sulla scheda Gestione plug-in XR nella finestra Impostazioni progetto.
  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à

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"/>

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.

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 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