Qt Quick 3D Xr

Einführung

Extended Reality (XR) ist ein Begriff, der Virtual Reality (VR), Augmented Reality (AR) und Mixed Reality (MR) umfasst. Diese Technologien schaffen immersive Erlebnisse, die die Wahrnehmung der umgebenden Welt durch den Nutzer verändern können. Das Qt Quick 3D -Xr-Modul stellt APIs für die Entwicklung von XR-Anwendungen mit Qt Quick 3D auf einer Vielzahl von Geräten und Plattformen bereit.

Unterschied zwischen „ Qt Quick 3D “- und „ Qt Quick 3D “-XR-Anwendungen

Der Einstieg

Der Hauptunterschied zwischen einer „ Qt Quick 3D “- und einer „ Qt Quick 3D XR“-Anwendung besteht aus Entwicklersicht im Einstiegspunkt der Szene, wobei es unerlässlich ist, reale Maßeinheiten und Tracking-Daten zu berücksichtigen.

In „ Qt Quick 3D “ würde eine minimale Anwendung aus einer Kamera, einer Lichtquelle und einem 3D-Modell bestehen. Die Position und Größe dieser Elemente werden im Koordinatensystem der Szene definiert, das beliebig ist und vom Entwickler entsprechend den Anforderungen der Anwendung festgelegt werden kann.

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"
            }]
        }
    }
}

Berücksichtigen Sie bei der Definition der Szene in einer XR-Anwendung reale Maßeinheiten und Tracking-Daten. Die Position und Ausrichtung der Kamera werden durch die des Geräts bestimmt oder – im Falle von Head-Mounted-Displays (HMD) – durch die Position und Ausrichtung des Kopfes des Nutzers. Die Einheiten der Szene sollten mit den Einheiten der realen Welt übereinstimmen. Beispielsweise soll eine Tür oder ein Schreibtisch in der realen Welt dieselbe Größe haben wie in der virtuellen Welt.

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 {}
            }
        }
    }
}

Zusätzliche CMake-Funktionen

Wie in der Datei „ CmakeLists.txt “ aller „Qt Quick 3D Xr“-Beispiele zu sehen ist, müssen Sie einige Funktionen zur obersten „CMakeLists“-Datei Ihres Projekts hinzufügen.

Um eine benutzerdefinierte „ AndroidManifest.xml “ anzugeben und sicherzustellen, dass sie verwendet wird, fügen Sie folgende Zeile in die „CMakeLists“-Datei Ihres Projekts ein:

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

Weitere Informationen zum Einrichten Ihrer „ AndroidManifest.xml “ finden Sie im entsprechenden Abschnitt der Seite „Erste Schritte mit Meta Quest 3 “.

Änderungen an der „CMakeLists.txt“ gelten auch für visionOS, wo wir die Datei „ MacOSXBundleInfo.plist.in “ einbinden:

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()

Wie geht es nun weiter?

Weitere Informationen zu den ersten Schritten mit Ihrem jeweiligen Gerät finden Sie unter „Erste Schritte mit Meta Quest 3“ oder „Erste Schritte mit Apple Vision Pro “. Weitere Informationen zu den unterstützten Plattformen und Geräten finden Sie auf der Seite „Unterstützte Plattformen “.

Wenn Sie nach einer bestimmten „ Qt Quick 3D Xr“-API suchen, werfen Sie einen Blick auf die „ API Reference “ oder probieren Sie eines der „Qt Quick 3D Xr“-Beispiele aus, die veranschaulichen, wie die „ Qt Quick 3D Xr“-APIs verwendet werden können.

Schnellzugriff

• Unterstützte Headsets
• Unterstützte OpenXR-Erweiterungen