Compilazione e distribuzione di MRTK in Oculus Quest usando la pipeline XR SDK

È necessaria un'istanza di Oculus Quest.

Il supporto di MRTK per Oculus Quest viene fornito tramite due origini diverse, la pipeline XR SDK di Unity e il pacchetto Oculus Integration Unity. Il provider di dati Oculus XRSDK consente l'uso di entrambe le origini e deve essere usato per distribuire MRTK in Oculus Quest.

Unity XR SDK Pipeline consente l'uso dei controller Oculus Touch e del rilevamento della testa con Oculus Quest. Questa pipeline è lo standard per lo sviluppo di applicazioni XR in Unity 2019.3 e versioni diverse. Per usare questa pipeline, assicurarsi di usare Unity 2019.3 o versione più recente. Questa operazione è necessaria per distribuire applicazioni MRTK in Oculus Quest.

Il pacchetto Oculus Integration Unity consente di usare il tracciamento delle mani con Oculus Quest. Questo provider di dati NON usa la pipeline XR SDK di Unity o la pipeline XR legacy.

Configurazione del progetto per Oculus Quest

  1. Seguire questa procedura per assicurarsi che il progetto sia pronto per la distribuzione in Oculus Quest.

  2. Assicurarsi che nel dispositivo sia abilitata la modalità sviluppatore. L'installazione dei driver Oculus ADB è facoltativa.

Configurazione della pipeline XR SDK per Oculus Quest

  1. Assicurarsi che il plug-in Oculus XR sia installato in Window --> Gestione pacchetti

    Pacchetto plug-in Oculus XR

  2. Assicurarsi che il provider di plug-in Oculus sia incluso nel progetto selezionando Edit --> Project Settings --> XR Plug-in Management --> Plug-in Providers (Modifica --> Project Settings --> XR Plug-in Management --> Plug-in Providers) (Modifica impostazioni progetto -> XR Plug-in Management -- provider plug-in di >)

    Provider di plug-in Oculus

Configurazione del pacchetto Oculus Integration Unity per abilitare il tracciamento delle mani

  1. Scaricare e importare Oculus Integration da Unity Asset Store. La versione più recente testata per il funzionamento è 20.0.0. Le versioni precedenti sono disponibili in questo archivio.

  2. Passare a Mixed Reality Toolkit > Utilities > Oculus > Integrate Oculus Integration Unity Modules (Integrazione moduli Unity di Oculus Integration). In questo modo gli asmdef verranno aggiornati con le definizioni e i riferimenti necessari per il funzionamento del codice Oculus Quest pertinente. Aggiornerà anche il file csc per filtrare gli avvisi obsoleti generati dagli asset di Oculus Integration. Il repo MRTK contiene un file csc che converte gli avvisi in errori. Questa conversione interrompe il MRTK-Quest di configurazione.

    Asmdef di integrazione oculus

  3. Nella cartella Oculus importata ,disponibile in Assets/Oculus, è presente un oggetto gestibile tramite script denominato OculusProjectConfig. In questo file di configurazione è necessario impostare HandTrackingSupport su "Controllers and Hands".

    Controller di integrazione Oculus e mani

Configurazione della scena

  1. Crea una nuova scena Unity o apri una scena preesiste, ad esempio HandInteractionExamples.
  2. Aggiungere MRTK alla scena passando a Mixed Reality Toolkit Add to Scene > (Aggiungi alla scena) e Configure (Configura).

Uso di Oculus XR SDK provider di dati

  1. Configurare il profilo per l'uso di Oculus XR SDK provider di dati
    • Se non si intende modificare i profili di configurazione

    • In caso contrario, seguire questa procedura:

      • Selezionare l'oggetto gioco MixedRealityToolkit nella gerarchia e selezionare Copia e personalizza per clonare il profilo di realtà mista predefinito.

      Clonare il profilo

      • Selezionare il profilo di configurazione dell'input.

      Profilo di configurazione di input

      • Selezionare Clona nel profilo di sistema di input per abilitare la modifica.

      Clonare il profilo di sistema di input

      • Aprire la sezione Provider di dati di input, selezionare Aggiungi provider di dati nella parte superiore per aggiungere un nuovo provider di dati alla fine dell'elenco. Aprire il nuovo provider di dati e impostare Type su Microsoft.MixedReality.Toolkit.XRSDK.Oculus > OculusXRSDKDeviceManager.

      Oculus Add XRSDK provider di dati

  1. Configurare il profilo per l'uso di Oculus XR SDK provider di dati
    • Se non si intende modificare i profili di configurazione

    • In caso contrario, seguire questa procedura:

      • Selezionare l'oggetto gioco MixedRealityToolkit nella gerarchia e selezionare Copia e personalizza per clonare il profilo di realtà mista predefinito.

      Clonare il profilo

      • Selezionare il profilo di configurazione dell'input.

      Profilo di configurazione di input

      • Selezionare Clona nel profilo di sistema di input per abilitare la modifica.

      Clonare il profilo di sistema di input

      • Aprire la sezione Provider di dati di input, selezionare Aggiungi provider di dati nella parte superiore per aggiungere un nuovo provider di dati alla fine dell'elenco. Aprire il nuovo provider di dati e impostare Type su Microsoft.MixedReality.Toolkit.XRSDK.Oculus > OculusXRSDKDeviceManager.

      Oculus Add XRSDK provider di dati

  1. Oculus XR SDK provider di dati un prefab OVR Camera Rig che configura automaticamente il progetto con un dispositivo OVR Camera Rig e mani OVR per indirizzare correttamente l'input. L'aggiunta manuale di un dispositivo di videocamera OVR alla scena richiederà la configurazione manuale delle impostazioni e dell'input.

Compilare e distribuire il progetto in Oculus Quest

  1. Collegare Oculus Quest tramite un cavo USB 3.0 -> USB C

  2. Passare a Impostazioni di compilazione > file

  3. Modificare la distribuzione in Android

  4. Assicurarsi che Oculus Quest sia selezionato come dispositivo di esecuzione applicabile

    Dispositivo di esecuzione Oculus

  5. Selezionare Build and Run (Compila ed esegui)

    • È probabile che si verifichi il set di errori di compilazione seguente quando si seleziona Compila ed esegui la prima volta. Dovrebbe essere possibile eseguire correttamente la distribuzione selezionando di nuovo Compila ed esegui.

    Errori di compilazione previsti di Oculus

  6. Accettare il prompt Consenti debug USB dall'interno della ricerca

  7. Vedere la scena all'interno di Oculus Quest

Rimozione dell'integrazione di Oculus dal progetto

  1. Passare a Mixed Reality Toolkit > Oculus > Separate Oculus Integration Unity Modules  Oculus Separation Asmdef
  2. Consentire l'aggiornamento di Unity quando i riferimenti in Microsoft.MixedReality.Toolkit.Providers.Oculus.asmdef e altri file vengono modificati in questo passaggio
  3. Chiudere Unity
  4. Chiudere Visual Studio, se è aperto
  5. Aprire Esplora file e passare alla radice del progetto Unity MRTK
  6. Eliminare la directory UnityProjectName/Library
  7. Eliminare la directory UnityProjectName/Assets/Oculus
  8. Eliminare il file UnityProjectName/Assets/Oculus.meta
  9. Riaprire Unity

Errori comuni

Ricerca non riconosciuta da Unity

Assicurarsi che i percorsi di Android siano configurati correttamente. Se si continuano a riscontrare problemi, seguire questa guida

Modificare > preferenze > strumenti esterni > Android

Configurazione di Android Tools