En esta página

Primeros pasos con Meta Quest 3

Introducción

Este tema proporciona instrucciones sobre cómo ponerse en marcha con la aplicación Meta Quest y OpenXR. El despliegue de aplicaciones en el Meta Quest se puede hacer de dos maneras: Como una aplicación de "baja inmersión", donde la aplicación está contenida en una ventana en el entorno de RV por defecto del headset o como una aplicación de RV de "alta inmersión" donde la aplicación se hace cargo de todo el renderizado del entorno de RV.

Nota: Las instrucciones son principalmente para el Quest 3, pero muchos pasos también deberían aplicarse a otros cascos basados en Android que utilicen OpenXR.

Requisitos previos

Necesitarás Qt 6.8 o posterior y el módulo Qt Quick 3D Xr para empezar. El módulo Qt Quick 3D Xr es parte de QtQuick3D y se instalará con él. También necesitarás el Android NDK, SDK y JDK instalados y configurados. Puedes encontrar más información sobre cómo configurar Qt Creator para el desarrollo en Android aquí Getting Started with Qt for Android.

Configuración del Quest

Necesitarás habilitar el modo desarrollador en el dispositivo para desplegar aplicaciones en el Meta Quest. Descarga Meta Quest Developer Hub para transmitir vídeo desde el dispositivo, habilitar la depuración inalámbrica, y mucho más.

Desplegar una aplicación de baja inmersión

El despliegue de una aplicación de baja inmersión sigue los mismos pasos que cuando se desarrolla y despliega para Qt para Android. Ya puede desplegar ejemplos Qt en el Quest de esta forma sin modificaciones.

Cambios en el proyecto necesarios para que las aplicaciones XR estén preparadas para Meta Quest

Preparar una aplicación XR para la Quest requiere algunos pasos adicionales, ya que QtQuick3D el punto de entrada de la aplicación en QML es ligeramente diferente. En una aplicación normal QtQuick3D, la vista en la escena 3D se realiza a través del tipo View3D, pero en una aplicación XR, la vista se realiza a través del tipo XrView. Además, existen APIs in Qt Quick 3D Xr que son específicos para la implementación de aplicaciones XR, por ejemplo, handtracking, anclajes espaciales y passthrough.

El archivo AndroidManifest.xml también tendrá que ser modificado para incluir los permisos necesarios y las características especificadas por el OEM del dispositivo de destino. Para el Quest, lo siguiente:

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

Consulte los documentos Manifest de Meta para obtener más información.

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