In diesem Leitfaden erfahren Sie, wie Sie mit dem Google Cardboard XR-Plug-in für Unity eigene Virtual-Reality-Inhalte (VR) erstellen.
Mit dem Cardboard SDK können Sie ein Smartphone in eine VR-Plattform verwandeln. Ein Smartphone kann 3D-Szenen mit stereoskopischem Rendering anzeigen, Kopfbewegungen erfassen und darauf reagieren sowie mit Apps interagieren, indem es erkennt, wenn der Nutzer die Wiedergabetaste drückt.
Zuerst verwenden Sie HelloCardboard, ein Demospiel, das die Hauptfunktionen des Cardboard SDK veranschaulicht. Im Spiel sehen sich Nutzer in einer virtuellen Welt um, um Objekte zu finden und zu sammeln. Sie erfahren dort, wie Sie
- Entwicklungsumgebung einrichten
- Demo-App herunterladen und erstellen
- QR-Code eines Cardboard-Viewers scannen, um seine Parameter zu speichern
- Kopfbewegungen des Nutzers verfolgen
- Stereoskopische Bilder rendern, indem für jedes Auge die richtige Verzerrung festgelegt wird
- VR-Modus aktivieren und deaktivieren
Entwicklungsumgebung einrichten
Softwareanforderungen:
- Unity 2021.3.44f1 oder höher
- Achten Sie darauf, bei der Installation den Android- und iOS-Build-Support hinzuzufügen.
- Sie müssen die Patchversion 44f1 oder höher installieren.
- Git muss installiert sein und die ausführbare Datei
git
muss in der UmgebungsvariablenPATH
enthalten sein. Weitere Informationen finden Sie in der Dokumentation zum Git-Support des Unity-Paketmanagers.
SDK importieren und neues Projekt erstellen
Führen Sie die folgenden Schritte aus, um das Unity SDK zu importieren und ein neues Projekt zu erstellen.
- Öffnen Sie Unity und erstellen Sie ein neues 3D-Projekt.
- Klicken Sie in Unity auf Fenster > Paketmanager.
- Klicken Sie auf + und wählen Sie Paket über Git-URL hinzufügen aus.
- Fügen Sie
https://github.com/googlevr/cardboard-xr-plugin.git
in das Textfeld ein.
Das Paket sollte den installierten Paketen hinzugefügt werden. - Rufen Sie das Paket Google Cardboard XR Plugin for Unity auf. Wählen Sie im Bereich Samples die Option In Projekt importieren aus.
Die Beispiel-Assets sollten inAssets/Samples/Google Cardboard/<version>/Hello Cardboard
geladen werden.
HelloCardboard-Szene konfigurieren
- Gehen Sie zu
Assets/Samples/Google Cardboard/<version>/Hello Cardboard/Scenes
, wählen Sie Offene Szenen hinzufügen und dann HelloCardboard aus, um die Beispielszene zu öffnen. - Öffnen Sie das Menü Ebenen und wählen Sie Ebenen bearbeiten… aus.
- Definieren Sie eine neue Ebene namens „Interaktiv“.
- Klicken Sie auf das Game-Objekt Schatz, um das Inspektorfenster zu öffnen. Legen Sie als Ebene „Interaktiv“ fest. Wenn ein Pop-up-Fenster angezeigt wird, in dem Sie gefragt werden, ob Sie die Ebene auch für alle untergeordneten Objekte auf „Interaktiv“ setzen möchten, klicken Sie auf „Ja, untergeordnete Objekte ändern“.
- Klicken Sie auf das Gameobject Player > Camera > CardboardReticlePointer, um das Inspector-Fenster zu öffnen. Wählen Sie im Script „Carboard-Absehen-Cursor“ als Reticle Interaction Layer Mask die Option „Interaktiv“ aus.
Android-Projekteinstellungen konfigurieren
Klicken Sie auf Datei > Build-Einstellungen.
- Wählen Sie Android und dann Plattform wechseln aus.
- Wählen Sie Open Scenes hinzufügen und dann HelloCardboard aus.
Playereinstellungen
Auflösung und Darstellung
Gehe zu Projekteinstellungen > Player > Auflösung und Präsentation.
- Legen Sie die Standardausrichtung auf Querformat links oder Querformat rechts fest.
- Deaktivieren Sie Optimiertes Frame-Pacing.
Weitere Einstellungen
Gehe zu Projekteinstellungen > Wiedergabe > Weitere Einstellungen.
- Wählen Sie unter Grafik-APIs
OpenGLES2
,OpenGLES3
oderVulkan
oder eine beliebige Kombination dieser Optionen aus. - Wählen Sie unter Mindest-API-Level die Option
Android 8.0 'Oreo' (API level 26)
oder höher aus. - Wählen Sie unter Ziel-API-Level
API level 33
oder höher aus. - Wählen Sie unter Scripting-Backend die Option
IL2CPP
aus. - Wählen Sie die gewünschten Architekturen aus, indem Sie unter Zielarchitekturen
ARMv7
,ARM64
oder beides auswählen. - Wählen Sie unter Internetzugriff die Option
Require
aus. - Wählen Sie unter Active Input Handling (Aktive Eingabeverwaltung) die Option
Input System Package (New)
aus. - Geben Sie unter Paketname die Domain Ihres Unternehmens an.
- Wenn
Vulkan
als Grafik-API ausgewählt wurde:- Entfernen Sie in den Vulkan-Einstellungen das Häkchen aus dem Kästchen Displayausrichtung beim Rendern anwenden.
- Wenn die Unity-Version 2021.2 oder höher ist, wählen Sie unter Texturenkomprimierungsformat die Option
ETC2
aus.
- Wenn die Unity-Version 2023.1 oder höher ist, wählen Sie
Activity
aus und löschen SieGameActivity
unter Application Entry Point.
Einstellungen für die Veröffentlichung
Gehe zu Projekteinstellungen > Player > Veröffentlichungseinstellungen.
- Wählen Sie im Abschnitt Build die Optionen
Custom Main Gradle Template
undCustom Gradle Properties Template
aus. Fügen Sie dem Abschnitt „dependencies“ von
Assets/Plugins/Android/mainTemplate.gradle
die folgenden Zeilen hinzu:implementation 'androidx.appcompat:appcompat:1.6.1' implementation 'com.google.android.gms:play-services-vision:20.1.3' implementation 'com.google.android.material:material:1.12.0' implementation 'com.google.protobuf:protobuf-javalite:3.19.4'
Fügen Sie
Assets/Plugins/Android/gradleTemplate.properties
die folgenden Zeilen hinzu:android.enableJetifier=true android.useAndroidX=true
Einstellungen für die Verwaltung von XR-Plug-ins
Gehen Sie zu Projekteinstellungen > XR-Plug-in-Verwaltung.
- Wählen Sie unter Plug-in-Anbieter die Option
Cardboard XR Plugin
aus.
Projekt erstellen
Klicken Sie auf Datei > Build-Einstellungen.
- Wählen Sie Build oder ein Gerät und dann Build and Run (Erstellen und ausführen) aus.
iOS-Projekteinstellungen konfigurieren
Klicken Sie auf Datei > Build-Einstellungen.
- Wählen Sie iOS und dann Plattform wechseln aus.
- Wählen Sie Open Scenes hinzufügen und dann HelloCardboard aus.
Playereinstellungen
Auflösung und Darstellung
Gehe zu Projekteinstellungen > Player > Auflösung und Präsentation.
- Legen Sie die Standardausrichtung auf Querformat links oder Querformat rechts fest.
Weitere Einstellungen
Gehe zu Projekteinstellungen > Wiedergabe > Weitere Einstellungen.
- Geben Sie unter Beschreibung der Kameranutzung den Text
Cardboard SDK requires camera permission to read the QR code (required to get the encoded device parameters).
ein. - Geben Sie unter Mindest-iOS-Version die Zahl
12.0
ein. - Geben Sie unter Paketname die Domain Ihres Unternehmens an.
Einstellungen für die Verwaltung von XR-Plug-ins
Gehen Sie zu Projekteinstellungen > XR-Plug-in-Verwaltung.
- Wählen Sie unter Plug-in-Anbieter die Option
Cardboard XR Plugin
aus.
Projekt erstellen
Klicken Sie auf Datei > Build-Einstellungen.
- Wählen Sie Erstellen oder Erstellen und ausführen aus.
Zentrieren
Mit dem Cardboard SDK können Sie den Head-Tracker mit Recenter()
neu ausrichten.
So testen Sie es mit der Beispielanwendung:
- Bewegen Sie das Gerät an die Position, an der Sie die Neuausrichtung vornehmen möchten (verwenden Sie als neue Kopfpose, die nach vorne gerichtet ist).
- Halten Sie den Auslöser Ihres Cardboard-Geräts mindestens drei Sekunden lang gedrückt.
- Lassen Sie den Auslöser los.
- Die ursprüngliche Pose ist jetzt in der Richtung, in die die Kamera zeigt.
VR-Modus aktivieren und deaktivieren
Mit der Unity XR Plugin Management API können Sie den VR-Modus für das Google Cardboard XR-Plug-in für Unity aktivieren oder deaktivieren. Dokumentation für Endnutzer und Nutzungsbeispiele finden Sie in der Dokumentation für Endnutzer von Unity.
Die Szene VrMode im HelloCardboard-Beispiel zeigt eine grundlegende Verwendung der oben genannten API. In dieser Szene kann der VR-Modus durch Tippen auf Beenden
deaktiviert und durch Tippen auf eine beliebige Stelle auf dem Display wieder aktiviert werden. Weitere Informationen dazu finden Sie unter VrModeController.cs.
Nächste Schritte
- Lesen Sie die Cardboard-Branding-Richtlinien.