Distribuzione in Quest - MRTK2

È necessario un meta quest (1 o 2).

Configurazione del progetto per la ricerca

1. Seguire questa procedura per assicurarsi che il progetto sia pronto per la distribuzione in Quest.
2. Assicurarsi che la modalità sviluppatore sia abilitata nel dispositivo. L'installazione dei driver Oculus ADB è facoltativa.

Configurazione della scena

1. Creare una nuova scena unity o aprire una scena preesistente, ad esempio HandInteractionExamples.
   1. Se si crea una nuova scena, aggiungere MRTK alla scena passando a Realtà mista Toolkit>Aggiungi alla scena e Configura.

Integrazione MRTK

OpenXR (XR SDK)

Il supporto di MRTK per i dispositivi Quest viene fornito tramite due origini diverse: il pacchetto plug-in OpenXR di Unity per la pipeline XR SDK e il pacchetto Realtà mista plug-in OpenXR. Il provider di dati OpenXR XRSDK consente l'uso di entrambe le origini e deve essere usato per distribuire MRTK nella ricerca.

È possibile usare il plug-in OpenXR Realtà mista per distribuire applicazioni MRTK nella ricerca. Dopo l'abilitazione di OpenXR, assicurarsi che le funzionalità necessarie siano abilitate (probabilmente "Rilevamento mano" e "Meta Quest Support").

Verificare che il profilo (se non usi il valore predefinito MRTK) sia configurato con l'Gestione dispositivi OpenXR. Vedere Configurazione di MRTK per la pipeline XR SDK per altre informazioni sulla garanzia che il profilo sia pronto per OpenXR.

Oculus (XR SDK)

Il supporto di MRTK per i dispositivi Quest viene fornito tramite due origini diverse: il pacchetto plug-in Oculus di Unity per la pipeline XR SDK 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 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 Quest.

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

Configurazione della pipeline di XR SDK per quest

1. Assicurarsi che il plug-in Oculus XR sia installato in Window --> Package Manager

   

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

   

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

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 > Utilities > Oculus Integrare moduli Unity di integrazione Oculus>. A tale scopo, l'asmdef verrà aggiornato con definizioni e riferimenti necessari per la funzione del codice 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.

   

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

   

Uso del provider di dati Oculus XR SDK

1. Configurare il profilo per usare il provider di dati Oculus XR SDK
   • Se non intende modificare i profili di configurazione
     • Usare uno dei profili MRTK predefiniti, che sono tutti configurati tra le pipeline XR di Unity. Il precedente DefaultXRSDKConfigurationProfile è ora contrassegnato come obsoleto.
     • Passare a Compilare e distribuire il progetto in Quest.
   • 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.

       

     • Selezionare il profilo di configurazione di input .

       

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

       

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

       

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

Rimozione dell'integrazione di Oculus dal progetto

1. Passare a Realtà mista Toolkit > Oculus Separate Oculus Integration Unity Modules Oculus >
2. Consentire l'aggiornamento di Unity come 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 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

Compilare e distribuire il progetto in Quest

1. Collegare 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 quest sia selezionata come dispositivo di esecuzione applicabile

   

5. Selezionare Compilazione ed esecuzione

   • È possibile che si verifichino gli errori di compilazione seguenti quando si seleziona Compila ed esegui la prima volta. Non dovrebbe impedire la distribuzione. Per altre informazioni e possibili opzioni di mitigazione, vedere il problema #10449 .

   

6. Accettare il prompt Consenti debug USB dall'interno di Quest

7. Vedere la scena all'interno di Quest

Errori comuni

Quest non riconosciuto da Unity

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

Cercare in Modifica > preferenze > Strumenti > esterni Android: