Das Oculus Integration SDK wurde nach der Veröffentlichung der Version 57 als veraltet markiert. Version 59 sowie neuere Meta XR SDKs sind über den Unity Package Manager verfügbar.
Das Oculus Integration SDK OculusIntegration.unitypackage (Version v57 und früher) ist eine All-in-one-Lösung für wichtige VR-Funktionen, -Komponenten, -Skripte und -Plugins. Hiermit lässt sich die App-Entwicklung in Unity vereinfachen und verbessern. Das Oculus Integration SDK umfasst mehrere SDKs, unter anderem das Utilities-Paket, das Interaction SDK, das Voice SDK und das Platform SDK. Außerdem bietet es viele andere Funktionen für das erweiterte Rendern, den Aufbau von sozialen Communitys und die Entwicklung immersiver Erlebnisse.
Du kannst das aktuelle All-in-one-SDK über die Download-Seite in ein Unity-Projekt importieren. Falls du eine ältere Version des Oculus Integration SDK in deinem vorhandenen Projekt verwendest und ein Upgrade auf das neueste SDK durchführen möchtest, ohne ein neues Projekt zu erstellen, gehe zum Abschnitt Upgrade auf das neueste SDK.
SDK aus dem Unity Asset Store importieren
Der Unity Asset Store bietet eine Reihe verschiedener Assets, unter anderem SDKs und Frameworks. Das Unity Integration SDK besteht aus einer Datei mit der Erweiterung .unitypackage und ist im Unity Asset Store verfügbar.
Erstelle ein neues 3D-Projekt in Unity.
Öffne den Unity Asset Store, melde dich mit deinen Unity-Anmeldedaten an und klicke auf Open in Unity. Unity öffnet das Fenster Package Manager im Unity-Editor.
Gib deine Unity-Anmeldedaten ein, wenn du dazu aufgefordert wirst.
Erweitere im Package Manager-Fenster den Bereich Oculus Integration, wähle die neueste Version aus und klicke dann unten rechts im Fenster auf Download.
Klicke nach Abschluss des Downloads auf Import, um das aktuelle SDK in dein Projekt zu importieren.
Lasse im Fenster Import Unity Package alle Dateien und Ordner ausgewählt und klicke auf Import.
Wenn du aufgefordert wirst, das Oculus Utilities-Plugin zu aktualisieren, klicke auf Yes (Ja).
So wird sichergestellt, dass du das Oculus Utilities-Plugin verwendest, das im zu installierenden Paket enthalten ist. Wenn du das Plugin zu diesem Zeitpunkt nicht aktualisieren möchtest, musst du es später manuell aktualisieren.
Wenn du aufgefordert wirst, OpenXR als Backend zu verwenden, klicke auf Use OpenXR (OpenXR verwenden), um das Backend auf die Verwendung von OpenXR einzustellen. Wenn du weiterhin das ältere VRAPI-Backend verwenden möchtest, klicke auf Cancel. Weitere Informationen dazu, wie das Oculus XR-Plugin mit dem OVRPlugin interagiert, findest du unter XR-Plugin installieren, deinstallieren und aktualisieren.
Wenn du aufgefordert wirst, alte Interaction SDK-Assets zu bereinigen, klicke auf Show Assets und dann auf Delete Assets.
Wenn du aufgefordert wirst, Spatializer-Plugins zu aktualisieren, klicke auf Upgrade und dann auf Restart.
SDK über die Downloadseite (Developer Center) importieren
Die Downloadseite ist die zentrale Anlaufstelle für verschiedenste hilfreiche SDKs und Tools für die App-Entwicklung.
Gehe im Menü zu Assets > Import Package (Paket importieren) > Custom Package (Personalisiertes Paket).
Gehe zur heruntergeladenen .unitypackage-Datei und klicke auf Import (Importieren).
Lasse im Fenster Import Unity Package alle Dateien und Ordner ausgewählt und klicke auf Import.
Wenn du aufgefordert wirst, das Oculus Utilities-Plugin zu aktualisieren, klicke auf Yes (Ja).
So wird sichergestellt, dass du das Oculus Utilities-Plugin verwendest, das im zu installierenden Paket enthalten ist. Wenn du das Plugin zu diesem Zeitpunkt nicht aktualisieren möchtest, musst du es später manuell aktualisieren.
Wenn du aufgefordert wirst, OpenXR als Backend zu verwenden, klicke auf Use OpenXR (OpenXR verwenden), um das Backend auf die Verwendung von OpenXR einzustellen. Wenn du weiterhin das ältere VRAPI-Backend verwenden möchtest, klicke auf Cancel. Weitere Informationen dazu, wie das Oculus XR-Plugin mit dem OVRPlugin interagiert, findest du unter Oculus Utilities-Plugin auf OpenXR einstellen.
Wenn du aufgefordert wirst, alte Interaction SDK-Assets zu bereinigen, klicke auf Show Assets und dann auf Delete Assets.
Wenn du aufgefordert wirst, Spatializer-Plugins zu aktualisieren, klicke auf Upgrade und dann auf Restart.
Auf das aktuelle SDK aktualisieren
Dieser Abschnitt beschreibt, wie du eine ältere Version des Oculus Integration SDK in deinem bestehenden Projekt auf die neueste Version aktualisierst.
Schließe Unity, falls die App geöffnet ist.
Öffne auf deinem Computer den Ordner, in dem du das Projekt gespeichert hast. Beispiel: /username/sample-project/.
Öffne den Ordner Assets in deinem Projekt und lösche den Ordner Oculus.
Suche in deinem Projekt nach Dateien, die mit dem folgenden Text beginnen, und entferne sie manuell: Oculus und OVR. Falls du eine Android-App erstellst, suche außerdem nach Dateinamen, die mit AndroidManifest, vrapi, vrlib oder vrplatlib beginnen oder übereinstimmen. Diese Dateien befinden sich normalerweise in unterschiedlichen Ordnern in deinem Projekt. Suche sie daher am besten anhand des Dateinamens und entferne sie dann.
Öffne das Projekt, in dem du das Paket aktualisieren möchtest.
Das manuelle Entfernen der alten Versionsdateien verhindert das Überschreiben bestimmter Dateien und vermeidet, dass mehrere Plugin-Versionen vorhanden sind.
Zu einer älteren SDK-Version zurückwechseln
Im Unity Asset Store findest du immer die aktuelle Version des Oculus Integration SDK. Um zu einer vorherigen Version zurückzuwechseln, gehe folgendermaßen vor:
Öffne die Seite Meta Horizon Developer Center, wähle eine der vorherigen Versionen aus der Liste aus und klicke dann auf Herunterladen.
Entferne die bestehenden Oculus Integration-Dateien, indem du den Schritten 1 bis 4 im Abschnitt Auf das aktuelle SDK aktualisieren folgst.
Anmerkung: Du kannst diesen Schritt überspringen, wenn du eine ältere Version in ein neues Projekt importierst.
Öffne das Projekt, in das du das SDK importieren möchtest. Wenn du es in ein neues Projekt importieren möchtest, erstelle ein neues 3D-Projekt.
Gehe im Menü zu Assets > Import Package > Custom Package.
Suche die vorherige Version auf deinem Computer und klicke auf Open. Der Paketname wird auf OculusIntegration.unitypackage festgelegt. Du solltest den Namen aber basierend auf der jeweiligen Versionsnummer anpassen. Wenn du beispielsweise Oculus Integration-Version 14.0 importierst, benenne das Paket in OculusIntegration_v14.0.unitypackage um.
Das Oculus Integration SDK enthält das Utilities-Plugin OVRPlugin, das eine integrierte Editorunterstützung und mehrere zusätzliche Funktionen bietet. Es ist versioniert, um Kompatibilität mit dem Paket zu gewährleisten. Mit jeder Neuerscheinung des Pakets, wird auch die Version aktualisiert. Wir empfehlen ausdrücklich, immer das OVRPlugin zu verwenden, das im Paket enthalten ist.
Während der Paketinstallation wirst du von Unity aufgefordert, das OVRPlugin zu aktualisieren. Wenn du hierbei auf Yes geklickt und Unity neu gestartet hast, bist du fertig und musst nichts weiter tun. Wenn du auf No geklickt hast, kannst du es manuell aktualisieren.
Rufe in Unity Meta > Tools > OVR Utilities Plugin > Manual Update OVR Plugin auf.
Vom Oculus Integration SDK zu den Meta XR SDKs migrieren
Das Oculus Integration SDK ist seit Version 57 als veraltet markiert. Du solltest deine Projekte so bald wie möglich zu den Meta XR SDKs migrieren. Hierdurch erhältst du Zugriff auf die neuesten Funktionen, Verbesserungen und SDKs, z. B. das Mixed Reality Utility Kit.
Anmerkung: Bei der Migration des Oculus Integration SDK zu den Meta XR SDKs müssen vorhandene Inhalte entfernt werden. Wir empfehlen, vor dem Upgrade ein Backup deines vorhandenen Unity-Projekts zu erstellen.
So funktioniert die Migration zu den Meta XR SDKs:
Schließe Unity, falls die App geöffnet ist.
Öffne auf deinem Computer den Ordner, in dem du das Projekt gespeichert hast. Beispiel: /username/sample-project/.
Öffne den Ordner Assets in deinem Projekt und lösche dann die Oculus-Ordner.
Öffne den Ordner Library in deinem Projekt, und lösche dann den Ordner /Library/PackageCache/.
Öffne das Projekt erneut. Öffne es im abgesicherten Modus, wenn du dazu aufgefordert wirst, da das Projekt vermutlich Kompilierungsfehler enthält.
Folge diesen Schritten, um Meta XR SDKs als UPM-Pakete zu installieren. Für den Einstieg empfehlen wir das Meta XR All-in-One-SDK, da dieses Paket einen ähnlichen Funktionsumfang wie das ältere Oculus Integration SDK bietet.
Falls dein Projekt Fehler oder fehlende Assets enthält, liegt dies vermutlich daran, dass größere Beispiel-Assets (z. B. SampleFrameworks) als Unity StarterSamples nach GitHub verschoben wurden. Folge diesen Anweisungen, um die Assets in dein Projekt zu importieren.
Gängige Probleme bei der Migration
Wenn nach dem Ausführen der Migrationsschritte weiterhin Probleme auftreten, kannst du folgendes ausprobieren:
Falls selbstdefinierte Änderungen an vorhandenen Meta XR SDK-Dateien vorgenommen wurden, müssen diese Änderungen manuell in die neu über UPM verteilten Meta XR SDK-Dateien zusammengeführt werden. Weitere Informationen findest du unter Meta XR-Pakete importieren.
Möglicherweise bestehen Verweise auf veraltete Oculus-Dateien außerhalb des Ordners Assets/Oculus. Um diese Verweise zu bereinigen, suche nach Dateien, die mit dem folgenden Text beginnen, und entferne sie manuell: Oculus und OVR. Falls du eine Android-App erstellst, suche außerdem nach Dateinamen, die mit AndroidManifest, vrapi, vrlib oder vrplatlib beginnen oder übereinstimmen. Diese Dateien befinden sich normalerweise in unterschiedlichen Ordnern in deinem Projekt. Suche sie daher am besten anhand des Dateinamens und entferne sie dann.
Von Meta XR SDKs zum Oculus Integration SDK zurückwechseln
Anmerkung: Um zum Oculus Integration SDK zurückwechseln, musst du mit dem Unity Paket Manager Meta XR SDK-Pakete aus deinem Projekt entfernen.
So wechselst du zum Oculus Integration SDK zurück:
Navigiere zu Window > Package Manager.
Wähle das installierte Meta XR SDK aus.
Klicke auf den Remove-Button, um das Meta XR SDK zu deinstallieren.
Wiederhole diese Schritte für alle installierten Meta XR SDKs.