Sur cette page

Démarrage avec Meta Quest 3

Introduction

Cette rubrique fournit des instructions sur la façon de démarrer avec Meta Quest et OpenXR. Meta Quest et OpenXR. Le déploiement d'applications sur Meta Quest peut se faire de deux manières : En tant qu'application "basse immersion", où l'application est contenue dans une fenêtre de l'environnement VR par défaut du casque, ou en tant qu'application VR "haute immersion" où l'application prend en charge l'ensemble du rendu de l'environnement VR.

Remarque : les instructions concernent principalement le Quest 3, mais de nombreuses étapes devraient également s'appliquer à d'autres casques Android utilisant OpenXR.

Conditions préalables

Pour commencer, vous aurez besoin de Qt 3D 6.8 ou d'une version ultérieure et du module Qt Quick 3D Xr. Le module Qt Quick 3D Xr fait partie de QtQuick3D et sera installé avec lui. Les NDK, SDK et JDK Android doivent également être installés et configurés. Vous trouverez plus d'informations sur la configuration de Qt Creator pour le développement Android ici Getting Started with Qt for Android.

Configuration de Quest

Vous devez 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 de la vidéo depuis l'appareil, activer le débogage sans fil, et plus encore.

Déployer une application à faible immersion

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

Modifications du projet nécessaires pour que les applications XR soient prêtes pour Meta Quest

La préparation d'une application XR pour le Quest nécessite quelques étapes supplémentaires, car QtQuick3D le point d'entrée de l'application en QML est légèrement différent. Dans une application QtQuick3D normale, la vue de la scène 3D passe par le type View3D, mais dans une application XR, la vue passe par le type XrView. En outre, il existe des APIs in Qt Quick 3D Xr qui sont spécifiques à la mise en œuvre des applications XR, par exemple, le suivi des mains, les ancrages spatiaux et la transparence.

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

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

Voir les documents Meta's Manifest 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.