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.
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.
Assicurarsi che il plug-in Oculus XR sia installato in Window --> Package Manager
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
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.
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.
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
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.
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>.
Configurare il profilo per usare il provider di dati Oculus XR SDK
Se non intende modificare i profili di configurazione
Modificare il profilo in DefaultXRSDKConfigurationProfile.
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>.
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
Passare a Realtà mista Toolkit > Oculus Separate Oculus Integration Unity Modules Oculus >
Consentire l'aggiornamento di Unity come riferimenti in Microsoft.MixedReality.Toolkit.Providers.Oculus.asmdef e altri file vengono modificati in questo passaggio
Chiudere Unity
Chiudere Visual Studio, se è aperto
Aprire Esplora file e passare alla radice del progetto MRTK Unity
Eliminare la directory UnityProjectName/Library
Eliminare la directory UnityProjectName/Assets/Oculus
Eliminare il file UnityProjectName/Assets/Oculus.meta
Riaprire Unity
Compilare e distribuire il progetto in Quest
Collegare quest tramite un cavo USB 3.0 -> USB C
Passare a Impostazioni di compilazione file >
Modificare la distribuzione in Android
Assicurarsi che quest sia selezionata come dispositivo di esecuzione applicabile
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 .
Accettare il prompt Consenti debug USB dall'interno di Quest
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:
