Uso del plug-in OpenXR per la realtà mista per UnityUsing the Mixed Reality OpenXR Plugin for Unity

A partire da Unity versione 2020,2, il pacchetto di plug-in per la realtà mista di Microsoft OpenXR è disponibile tramite Gestione pacchetti Unity (UPM).Starting with Unity version 2020.2, Microsoft’s Mixed Reality OpenXR Plugin package is available using the Unity Package Manager (UPM).

PrerequisitiPrerequisites

  • Unity 2020,2 o versione successivaUnity 2020.2 or later
  • Plug-in OpenXR Unity 0.1.2 o versione successivaUnity OpenXR plugin 0.1.2 or later
  • Visual Studio 2019 o versione successivaVisual Studio 2019 or later
  • Installare il supporto della piattaforma UWP in Unity per le app HoloLens 2Install UWP platform support in Unity for HoloLens 2 apps

Nota

Se si stanno compilando applicazioni VR in PC Windows, il plug-in OpenXR per realtà mista non è necessariamente obbligatorio.If you're building VR applications on Windows PC, the Mixed Reality OpenXR plugin is not necessarily required. Tuttavia, è necessario installare il plug-in se si sta personalizzando il mapping del controller per i controller HP Reverb G2 o la creazione di app che funzionano sia con le cuffie HoloLens 2 sia con le cuffie VR.However, you'll want to install the plugin if you're customizing controller mapping for HP Reverb G2 controllers or building apps that work on both HoloLens 2 and VR headsets.

Installare il plug-in OpenXR per la realtà mistaInstalling the Mixed Reality OpenXR plugin

Il progetto deve installare il plug-in OpenXR e i pacchetti di gestione dei plug -in XR prima di usare il plug-in OpenXR realtà mista.Your project needs to install the OpenXR Plugin and XR Plugin Management packages before using the Mixed Reality OpenXR Plugin. Se sono già stati installati,If you've already installed them, great! In caso contrario, l'installazione del plug-in OpenXR per la realtà mista li installerà automaticamente come dipendenze:If not, installing the Mixed Reality OpenXR plugin will automatically install them as dependencies:

  1. Nell'editor di Unity passare a modifica > impostazioni progetto > gestione pacchettiIn the Unity Editor, navigate to Edit > Project Settings > Package Manager

  2. Espandere la sezione registri con ambito , immettere le informazioni seguenti e selezionare Salva:Expand the Scoped Registries section, enter the following information, and select Save:

  3. In Impostazioni avanzate selezionare Abilita pacchetti di anteprimaUnder Advanced Settings, select Enable Preview Packages

Screenshot della finestra di gestione pacchetti Unity aperta in Impostazioni progetto

Gestione pacchetti Unity usa un file manifesto denominato manifest.json per determinare i pacchetti da installare e i registri da cui possono essere installati.The Unity Package Manager uses a manifest file named manifest.json to determine which packages to install and the registries they can be installed from.

Importante

OpenXR è ancora sperimentale in Unity e questo processo può variare nel tempo mentre si lavora per ottimizzare l'esperienza degli sviluppatori.OpenXR is still experimental in Unity and this process may change over time as we work to optimize the developer experience.

Registrazione della dipendenza della realtà mistaRegistering the Mixed Reality dependency

Quando il registro con ambito Microsoft Mixed Reality è stato aggiunto al manifesto, è possibile specificare il pacchetto OpenXR.Once the Microsoft Mixed Reality scoped registry has been added to the manifest, the OpenXR package can be specified.

Per aggiungere il pacchetto OpenXR:To add the OpenXR package:

  1. Aprire [projectRoot]/Packages/manifest.js in un editor di testo, ad esempio Visual Studio CodeOpen [projectRoot]/Packages/manifest.json in a text editor like Visual Studio Code

    1. Per ottenerlo, fare clic con il pulsante destro del mouse su pacchetti nel riquadro sinistro della finestra del progetto.To get here, right click on Packages in the left panel of the Project window. Quindi, fare clic su Mostra in Esplora.Then, click Show in Explorer. Screenshot dell'elenco di pacchetti nella finestra del progettoScreenshot of the packages listing in the Project window
  2. Modificare la sezione relativa alle dipendenze dei pacchetti/manifest.jsnel file come indicato di seguito:Modify the dependencies section of the Packages/manifest.json file as follows:

    Importante

    Nel file manifesto potrebbero essere presenti più dipendenze di quelle illustrate qui.There may be more dependencies in your manifest file than shown here. Non eliminare alcun oggetto, ma è sufficiente aggiungere la dipendenza OpenXR all'elenco.Don't delete any of them, just add the OpenXR dependency to the list.

      "dependencies": {
        "com.microsoft.mixedreality.openxr": "0.1.2",
      }
    
  3. Salvare il file, tornare all'editor di Unity e aprire Gestione pacchetti per verificare che il plug-in sia installato:Save the file, switch back to the Unity Editor, and open the Package Manager to confirm the plugin is installed:

    Screenshot di gestione pacchetti Unity aperto nell'editor di Unity con il plug-in di OpenXR realtà mista evidenziato

    Nota

    Se il pacchetto OpenXR viene rimosso usando Gestione pacchetti Unity, sarà necessario aggiungerlo di nuovo usando i passaggi descritti in precedenza.If the OpenXR package is removed using the Unity Package Manager, you'll have to re-add it using the previously described steps.

Configurazione della gestione dei plug-in XR per OpenXRConfiguring XR Plugin Management for OpenXR

Per impostare OpenXR come runtime in Unity:To set OpenXR as the the runtime in Unity:

  1. Nell'editor di Unity passare a modifica > impostazioni progettoIn the Unity Editor, navigate to Edit > Project Settings
  2. Nell'elenco delle impostazioni selezionare Gestione plug -in XRIn the list of Settings, select XR Plugin Management
  3. Selezionare le caselle Inizializza XR all'avvio e OpenXR (anteprima)Check the Initialize XR on Startup and OpenXR (Preview) boxes
  4. Se la destinazione è HoloLens 2, assicurarsi di trovarsi nella piattaforma UWP e selezionare il set di funzionalità di Microsoft HoloLensIf targeting HoloLens 2, make sure you're on the UWP platform and select Microsoft HoloLens Feature Set

Screenshot del pannello Impostazioni progetto aperto nell'editor di Unity con la gestione dei plug-in di XR evidenziata

Importante

Se viene visualizzata un'icona di avviso rossa accanto a plug-in OpenXR (anteprima), fare clic sull'icona e selezionare Correggi tutto prima di continuare.If you see a red warning icon next to OpenXR Plugin (Preview), click the icon and select Fix all before continuing. Per rendere effettive le modifiche, potrebbe essere necessario riavviare l'editor di Unity.The Unity Editor may need to restart itself for the changes to take effect.

Screenshot della finestra di convalida del progetto OpenXR

A questo punto si è pronti per iniziare a sviluppare con OpenXR in Unity.You're now ready to begin developing with OpenXR in Unity! Continuare con la sezione successiva per informazioni su come usare gli esempi di OpenXR.Continue on to the next section to learn how to use the OpenXR samples.

OptimizationOptimization

Se si sta sviluppando per HoloLens 2, passare a realtà mista> OpenXR > applicare le impostazioni di progetto consigliate per HoloLens 2 per ottenere prestazioni migliori per le app.If you're developing for HoloLens 2, navigate to Mixed Reality> OpenXR > Apply recommended project settings for HoloLens 2 to get better app performance.

Screenshot della voce di menu della realtà mista aperta con OpenXR selezionato

Provare le scene di esempio di UnityTry out the Unity sample scenes

Per usare uno o più degli esempi, installare ARFoundation 4.0 + da Gestione pacchetti:To utilize one or more of the examples, install ARFoundation 4.0+ from the Package Manager:

Screenshot di gestione pacchetti Unity aperto nell'editor di Unity con AR Foundation evidenziato

Esempi di HoloLens 2HoloLens 2 samples

  1. Nell'editor di Unity passare a finestra > gestione pacchettiIn the Unity Editor, navigate to Window > Package Manager
  2. Nell'elenco dei pacchetti selezionare il plug-in OpenXR realtà mistaIn the list of packages, select Mixed Reality OpenXR Plugin
  3. Individuare l'esempio nell'elenco degli esempi e selezionare Importa .Locate the sample in the Samples list and select Import

Screenshot di gestione pacchetti Unity aperto nell'editor di Unity con la realtà mista OpenXR plug-in selezionato ed esempi pulsante di importazione evidenziato

Nota

Quando viene aggiornato un pacchetto, Unity offre la possibilità di aggiornare gli esempi importati.When a package is updated, Unity provides the option to update imported samples. L'aggiornamento di un esempio importato sovrascriverà tutte le modifiche apportate all'esempio e alle risorse associate.Updating an imported sample will overwrite any changes that have been made to the sample and associated assets.

Uso di MRTK con il supporto OpenXRUsing MRTK with OpenXR support

MRTK Unity supporta il plug-in OpenXR realtà mista a partire dalla versione 2.5.3.MRTK Unity supports the Mixed Reality OpenXR plugin starting with the 2.5.3 release. I plug-in MRTK possono essere installati dagli stessi registri con ambito impostati quando si installa il plug-in OpenXR realtà mista.MRTK plugins can be installed from the same scoped registries as you set up when installing the Mixed Reality OpenXR plugin. Per informazioni più dettagliate, vedere la documentazione di MRTK.You can find more detailed information in the MRTK documentation.

  1. Aggiungere i pacchetti seguenti in [projectRoot]/Packages/manifest.js nel file:Add following packages in your [projectRoot]/Packages/manifest.json file:
"dependencies": {
    "com.microsoft.mixedreality.toolkit.foundation": "2.5.3",
    "com.microsoft.mixedreality.toolkit.tools": "2.5.3",
    "com.microsoft.mixedreality.toolkit.examples": "2.5.3",
    …
}
  1. Passare allo script del componente MixedReality Toolkit nel controllo e passare al profilo DefaultOpenXRConfigurationProfile :Go to the MixedReality Toolkit component script in the Inspector and switch to the DefaultOpenXRConfigurationProfile profile:

Screenshot del cambio della configurazione di MRTK nel componente del Toolkit per realtà mista del controllo

Problemi notiKnown issues

Quando si usa la funzionalità di rilevamento della mano, aggiungere la riga seguente nel file assets/MixedRealityToolkit. generated/link.xml :When using the Hand Tracking feature, add following line in the Assets/MixedRealityToolkit.Generated/link.xml file:

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

Passaggi successiviNext steps

Ora che il progetto è stato configurato per OpenXR ed è possibile accedere agli esempi, vedere quali funzionalità sono attualmente supportate nel plug-in OpenXR.Now that you have your project configured for OpenXR and have access to samples, check out what features are currently supported in our OpenXR plugin.

Inviare commenti e suggerimenti?Have Feedback?

OpenXR è ancora in fase di sperimentazione, quindi saremmo lieti di ricevere commenti e suggerimenti per aiutarti a migliorarlo.OpenXR is still experimental, so we’d appreciate any feedback you can give us to help make it better. Ci troviamo nei Forum di Unity contrassegnando il post del forum con Microsoft + OpenXR e HoloLens 2 o la realtà mista di Windows.You'll find us on the Unity Forums by tagging your forum post with Microsoft + OpenXR and either HoloLens 2 or Windows Mixed Reality.

Vedere ancheSee also