Sur cette page

Premiers pas avec Meta Quest 3

Introduction

Cette rubrique fournit des instructions pour vous aider à démarrer avec le Meta™ Quest et OpenXR. Le déploiement d’applications sur le Meta Quest peut s’effectuer de deux manières : en tant qu’application « à faible immersion », où l’application est contenue dans une fenêtre au sein de l’environnement VR par défaut du casque, ou en tant qu’application VR « à forte immersion », où l’application prend en charge l’intégralité du rendu de l’environnement VR.

Remarque : ces instructions concernent principalement le Quest 3, mais de nombreuses étapes s’appliquent également à d’autres casques Android utilisant OpenXR.

Prérequis

Pour commencer, vous aurez besoin de Qt 6.8 ou d’une version ultérieure, ainsi que du module 3D Xr d’ Qt Quick. Le module 3D Xr d’ Qt Quick fait partie d’ QtQuick3D et sera installé avec celui-ci. Vous devrez également disposer de l'NDK, du SDK et du JDK Android, installés et configurés. Vous trouverez plus d'informations sur la configuration d'Qt Creator pour le développement Android ici : Premiers pas avec Qt pour Android.

Configuration du Meta Quest

Vous devrez activer le mode développeur sur l’appareil pour déployer des applications sur le Meta Quest. Téléchargez le Meta Quest Developer Hub pour diffuser des vidéos depuis l’appareil, activer le débogage sans fil, et plus encore.

Déploiement d’une application à faible immersion

Le déploiement d'une application à faible immersion suit les mêmes étapes que celles du développement et du déploiement avec Qt pour Android. Vous pouvez d'ores et déjà déployer les exemples Qt sur le Quest de cette manière, sans aucune modification.

Modifications du projet nécessaires pour que les applications XR soient compatibles avec le Meta Quest

La préparation d’une application XR pour le Quest nécessite quelques étapes supplémentaires, car l’ QtQuick3D, le point d’entrée de l’application en QML, est légèrement différente. Dans une application QtQuick3D classique, la vue de la scène 3D s’effectue via le type ` View3D `, mais dans une application XR, la vue s’effectue via le type ` XrView `. De plus, il existe APIs in Qt Quick 3D Xr des éléments spécifiques à la mise en œuvre d’applications XR, par exemple le suivi des mains, les ancrages spatiaux et le passthrough.

Le fichier AndroidManifest.xml devra également être modifié pour inclure les autorisations et fonctionnalités nécessaires spécifiées par le fabricant de l'appareil cible. Pour le Quest, les éléments suivants :

<meta-data android:name="com.oculus.intent.category.VR" android:value="vr_only"/>
<uses-permission android:name="com.oculus.permission.HAND_TRACKING" />
<uses-feature android:name="oculus.software.hand-tracking" android:required="false" />

Consultez la documentation de Meta sur les manifestes pour plus d’informations.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.