Upgrade von Projekten in Unreal

Bei Updates auf eine neue Unreal-Version werden veraltete Funktionen beim Kompilieren von Blaupausen oder beim Verpacken des Projekts in Form von Warnungen angezeigt. Funktionen werden als veraltet deklariert, wenn eine neue Funktion hinzugefügt wurde, die an ihrer Stelle verwendet werden soll.

Änderungen in 5.0

In 5.0 wird das WRM-Plug-In (Windows Mixed Reality), das Im Lieferumfang von Unreal Engine enthalten ist, durch das OpenXR-Plug-In (verfügbar im Unreal Marketplace oder auf GitHub) ersetzt. Das WMR-Plug-In wird in zukünftigen Engine-Releases entfernt. Entwickler sollten daher zu OpenXR wechseln.

OpenXR und Microsoft OpenXR

Das OpenXR-Plug-In, das im Lieferumfang der Engine enthalten ist, kann zur Erstellung einer Anwendung verwendet werden. Alle MSFT-spezifischen OpenXR-Funktionen (einschließlich Holographic App Remoting) sind jedoch nur im Microsoft OpenXR-Plug-In enthalten, daher muss dieses heruntergeladen werden, damit Sie eine Umgebung mit vollem Funktionsumfang erstellen können.

Updates

Das Microsoft OpenXR-Plug-In ist nicht im Lieferumfang von Unreal Engine enthalten, sodass das Plug-In auf neue Features überwacht werden sollte. Updates stehen zur Verfügung, wenn sie entwickelt wurden. Dies ist eine Umstellung vom WMR-Plug-In, bei dem in jedem Engine-Release alle neuen Funktionen integriert waren.

HoloLensAR

Das HoloLens AR-Plug-In wurde entfernt und sollte nicht mehr als Plug-In-Abhängigkeit in Unreal Engine 5.0 enthalten sein.

Warnungen in 5.0

In den aktualisierten Unreal Engine 5.0-Projekten werden unter Umständen neue Compilerfehler für FVectors und Shader angezeigt. Diese sind auf Large World Coordinates von UE5 zurückzuführen, durch die die Genauigkeit von float auf double erhöht wurde.

Änderungen in 4.26

Die maßgebliche Änderung besteht darin, dass In VR starten aus Bearbeiten > Projekteinstellungen > Projekt > Beschreibung > Einstellungen beim Starten des Windows Mixed Reality-Plug-Ins obligatorisch ist. Ohne diesen Parameter werden Ihre Hologramme nicht auf dem Gerät angezeigt.

Warnungen in 4.26

In Version 4.26 wurden alle AR- und VR-Plattformen umgestaltet, um allgemeine Schnittstellen hinzuzufügen und den Anwendungscode plattformneutral zu halten, weshalb eventuell mehr Warnungen als gewöhnlich angezeigt werden. Es wird empfohlen, auf die neuen APIs zu aktualisieren, damit das Projekt leichter auf andere Plattformen portiert werden kann.

Aus Warnmeldungen ist zu ersehen, welche Funktion als veraltet deklariert wurde und welche Funktion stattdessen verwendet werden soll. Alle veralteten Funktionen funktionieren in dieser Version weiterhin, tun dies in zukünftigen Versionen aber möglicherweise nicht mehr. Ferner werden als veraltet deklarierte Versionen bei der Suche nach Funktionen in einer Blaupause nicht mehr aufgelistet.

Blaupause der Funktion „Create Named ARPin“

Veraltete Funktionen aus 4.25

Veraltete Funktionen Neue Funktion
CreateNamedARPin Blaupause der Funktion „Pin Component“
LoadWMRAnchorStoreARPins Blaupause der Funktion „Load ARPins from Local Store“
LoadWMRAnchorSaveARPinToWMRAnchorStoreStoreARPins Blaupause der Funktion „Save ARPin to Local Store“
RemoveARPinFromWMRAnchorStore Blaupause der Funktion „Remove ARPin from Local Store“
SetEnabledMixedRealityCamera Blaupause der Funktion „Set Enabled XRCamera“
ResizeMixedRealityCamera Blaupause der Funktion „Resize XRCamera“
StartCameraCapture Blaupause der Funktion „Toggle ARCapture“ zum Starten der Erfassung des Kamerabilds
StopCameraCapture Blaupause der Funktion „Toggle ARCapture“ zum Beenden der Erfassung des Kamerabilds
StartQRCodeCapture Blaupause der Funktion „Toggle ARCapture“ zum Starten der Erfassung von QR-Codes
StopQRCodeCapture Blaupause der Funktion „Toggle ARCapture“ zum Beenden der Erfassung von QR-Codes
Die räumliche Abbildung startete in Version 4.25 bisher automatisch, muss in Version 4.26 jedoch eingeschaltet werden. Blaupause der Funktion „Toggle ARCapture“ zum Aktivieren der räumlichen Abbildung
ShowKeyboard Wurde in 4.26 entfernt, da die Tastatur automatisch angezeigt wird, wenn der Fokus auf einem Textwidget liegt.
HideKeyboard Wurde in 4.26 entfernt, da die Tastatur automatisch ausgeblendet wird, wenn ein Textwidget den Fokus verliert.
SupportsHandTracking Blaupause der Eigenschaft „Supports Hand Tracking“
IsDisplayOpaque Blaupause der Eigenschaft „IsDisplayOpaque“
GetHandJointTransform, GetPointerPoseInfo, GetControllerTrackingStatus Blaupause der Funktion „Get Motion Controller Data“
GetVersionString Blaupause der Funktion“Get Version String“
IsTrackingAvailable Blaupause der Eigenschaft „IsTrackingAvailable“
IsButtonClicked, IsButtonDown, IsGrasped, IsSelectPressed Verwenden Sie das Eingabeaktionssystem von Unreal.
SetFocusPointForFrame In 4.26 entfernt. Bisher für die Neuprojektion beim Remoting verwendet, das jetzt tiefenbasierte Neuprojektion unterstützt.