Qt Quick 3D Xr

Introduction

La réalité étendue (Extended Reality, XR) est un terme qui englobe la réalité virtuelle (VR), la réalité augmentée (AR) et la réalité mixte (MR). Ces technologies créent des expériences immersives qui peuvent modifier la perception qu'a l'utilisateur du monde qui l'entoure. Le module Qt Quick 3D Xr fournit des API pour le développement d'applications XR avec Qt Quick 3D sur une variété d'appareils et de plateformes.

Différence entre les applications Qt Quick 3D et Qt Quick 3D Xr

Le point d'entrée

La principale différence entre une application Qt Quick 3D et une application Qt Quick 3D Xr, du point de vue du développeur, est le point d'entrée de la scène, et il est essentiel de connaître les unités et les données de suivi du monde réel.

Dans Qt Quick 3D, une application minimale se compose d'une caméra, d'une lumière et d'un modèle 3D. Le positionnement et la taille de ces éléments sont définis dans le système de coordonnées de la scène, qui est arbitraire et peut être défini par le développeur pour répondre aux besoins de l'application.

View3D {
    width: 1280
    height: 720

    PerspectiveCamera {
        position: Qt.vector3d(0, 200, 300)
    }

    DirectionalLight {
    }

    Node {
        id: sceneRoot
        Model {
            id: model
            position: Qt.vector3d(0, -200, 0)
            source: "#Cylinder"
            materials: [ PrincipledMaterial {
                    baseColor: "red"
            }]
        }
    }
}

Dans une application XR, il faut tenir compte des unités du monde réel et des données de suivi lors de la définition de la scène. La position et l'orientation de la caméra sont définies par la position et l'orientation de la tête de l'appareil ou, dans le cas d'un affichage monté sur la tête (HMD), de l'utilisateur. Les unités de la scène doivent correspondre aux unités du monde réel. Par exemple, une porte ou un bureau doivent avoir la même taille dans le monde réel que dans le monde virtuel.

XrView {
    DirectionalLight {
    }

    xrOrigin: XrOrigin {
        XrController {
            id: rightController
            controller: XrController.ControllerRight
        }
        XrController {
            id: leftController
            controller: XrController.ControllerLeft
        }
    }

    Node {
        id: sceneRoot
        Model {
            id: floor
            source: ":meshes/floor.mesh"
            materials: [ PrincipledMaterial {
                    baseColor: "green"
                }]
        }

        Model {
            id: table
            property real height: 0.7
            position: Qt.vector3d(0, height - 2.5, 0)
            source: ":meshes/table.mesh"
            materials: PrincipledMaterial {
                baseColor: "white"
            }
        }

        Model {
            id: monitor
            source: ":meshes/monitor.mesh"
            y: table.height
            XrItem {
                id: theScreen
                y: monitor.yOffset + height
                x: -width / 2
                width: monitor.width
                height: monitor.height
                contentItem: ScreenContent {}
            }
        }
    }
}

Fonctions CMake supplémentaires

Comme le montre le fichier CmakeLists.txt pour tous les exemplesQt Quick 3D Xr, vous devez ajouter certaines fonctions au fichier CMakeLists de premier niveau de votre projet.

Pour spécifier une AndroidManifest.xml personnalisée et vous assurer qu'elle sera utilisée, ajoutez cette ligne au fichier CMakeLists de votre projet :

if(ANDROID)
    set_property(TARGET xr_simple APPEND PROPERTY QT_ANDROID_PACKAGE_SOURCE_DIR ${CMAKE_CURRENT_SOURCE_DIR}/android)
endif()

Pour plus de détails sur la configuration de votre AndroidManifest.xml, consultez la section correspondante de la page Démarrer avec Meta Quest 3.

Les changements dans CMakeLists.txt s'appliquent également à visionOS, où nous incluons le fichier MacOSXBundleInfo.plist.in:

if (APPLE AND CMAKE_SYSTEM_NAME STREQUAL "visionOS")
    set_target_properties(xr_simple PROPERTIES
        MACOSX_BUNDLE_GUI_IDENTIFIER io.qt.xr_simple
        MACOSX_BUNDLE_INFO_PLIST ${CMAKE_CURRENT_SOURCE_DIR}/visionos/MacOSXBundleInfo.plist.in
    )
endif()

Que faire maintenant ?

Jetez un coup d'œil à la page Getting Started With Meta Quest 3 ou Getting Started With Apple Vision Pro pour plus d'informations sur la façon de démarrer avec votre appareil spécifique. Consultez la page Plates-formes supportées pour plus d'informations sur les plates-formes et les appareils supportés.

Si vous recherchez une API Qt Quick 3D Xr spécifique, consultez le site API Reference ou essayez l'un des exemplesQt Quick 3D Xr, qui démontrent comment les API Qt Quick 3D Xr peuvent être utilisées.

Liens rapides

• Casques pris en charge
• Extensions OpenXR prises en charge