Distribuzione in Oculus Quest — MRTK2

È necessario un 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 nell'Oculus Quest.

La pipeline di Unity XR SDK consente l'uso dei controller Oculus Touch e del rilevamento head con Oculus Quest. Questa pipeline è lo standard per lo sviluppo di applicazioni XR in Unity 2019.3 e oltre. Per usare questa pipeline, assicurarsi di usare Unity 2019.3 o versione successiva. Questa operazione è necessaria per distribuire applicazioni MRTK in Oculus Quest.

Il pacchetto Oculus Integration Unity consente l'uso di modelli di rilevamento della mano e controller con Oculus Quest.

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 la modalità sviluppatore sia abilitata nel dispositivo. 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

    Oculus XR Plugin Package

  2. Assicurarsi che il provider plug-in Oculus sia incluso nel progetto passando a Modifica --> Project Impostazioni -- Gestione plug-in XR -->> Provider plug-in

    Oculus Plugin Provider

Importante

È possibile usare il plug-in OpenXR per distribuire applicazioni MRTK in Oculus Quest. Tuttavia, la visualizzazione del controller e il rilevamento delle mani non sono attualmente supportati in OpenXR.

È consigliabile usare il plug-in Oculus XR fino a quando il supporto completo non è disponibile con il pacchetto di integrazione Oculus.

Configurazione del pacchetto Oculus Integration Unity per abilitare l'handtracking

  1. Scaricare e importare l'integrazione di Oculus da Unity Asset Store. La versione più recente testata per il lavoro è 39.0.0. Le versioni precedenti non funzioneranno a causa della modifica apportata all'API Oculus. Tutte le versioni del pacchetto di integrazione Oculus sono disponibili in questo archivio.

  2. Passare a Realtà mista Toolkit > utilità > Oculus integrare moduli Unity di integrazione Oculus>. A tale scopo, l'asmdef verrà aggiornato con definizioni e riferimenti necessari per la funzione del codice Oculus Quest pertinente. Aggiornerà anche il file csc per filtrare gli avvisi obsoleti generati dagli asset di integrazione Oculus. Il repository MRTK contiene un file csc che converte gli avvisi in errori, questa conversione arresta il processo di configurazione MRTK-Quest.

    Oculus Integration Asmdef

  3. Nella cartella Oculus importata (dovrebbe essere trovata in Assets/Oculus), è presente un oggetto scriptable denominato OculusProjectConfig. In tale file di configurazione è necessario impostare HandTrackingSupport su "Controller e mani".

    Oculus Integration Controller And Hands

Configurazione della scena

  1. Creare una nuova scena unity o aprire una scena preesistente, ad esempio HandInteractionExamples.
  2. Aggiungere MRTK alla scena passando a Realtà mista Toolkit>Aggiungi a Scena e Configura.

Uso dell'SDK Oculus XR provider di dati

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

    • In caso contrario, seguire quanto segue:

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

      Clone Profile

      • Selezionare il profilo di configurazione di input .

      Input Configuration Profile

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

      Clone Input System Profile

      • Aprire la sezione Provider di dati di input, selezionare Aggiungi provider di dati nella parte superiore e il nuovo provider di dati verrà aggiunto alla fine dell'elenco. Aprire il nuovo provider di dati e impostare Il tipo su Microsoft.MixedReality.Toolkit. XRSDK. Oculus OculusXRSDKDeviceManager>.

      Oculus Add XRSDK Data Provider

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

    • In caso contrario, seguire quanto segue:

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

      Clone Profile

      • Selezionare il profilo di configurazione di input .

      Input Configuration Profile

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

      Clone Input System Profile

      • Aprire la sezione Provider di dati di input, selezionare Aggiungi provider di dati nella parte superiore e il nuovo provider di dati verrà aggiunto alla fine dell'elenco. Aprire il nuovo provider di dati e impostare Il tipo su Microsoft.MixedReality.Toolkit. XRSDK. Oculus OculusXRSDKDeviceManager>.

      Oculus Add XRSDK Data Provider

  1. Il provider di dati Oculus XR SDK include un Fotocamera Rig Prefab di Oculus XR che configura automaticamente il progetto con un OVR Fotocamera Rig e OVR Hands per indirizzare correttamente l'input. L'aggiunta manuale di un Fotocamera 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 Compilazione file > Impostazioni

  3. Modificare la distribuzione in Android

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

    Oculus Run Device

  5. Selezionare Compilazione ed esecuzione

    • È probabile che si verifichino gli errori di compilazione seguenti quando si seleziona Compila ed esegui la prima volta. È necessario essere in grado di distribuire correttamente quando si seleziona Compila ed esegui di nuovo.

    Oculus Expected Build Errors

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

  7. Vedere la scena all'interno dell'Oculus Quest

Rimozione dell'integrazione di Oculus dal Project

  1. Passare ai moduli Oculus Separate Oculus > Integration Unity di Realtà mista Toolkit >Oculus Separation Asmdef
  2. Eseguire l'aggiornamento di Unity come riferimenti in Microsoft.MixedReality. Toolkit. Provider.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 MRTK Unity
  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

Quest non riconosciuto da Unity

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

Modifica > preferenze > Strumenti > esterni Android

Android Tools Config