Kurzanleitung für Google Cardboard für Unity

In diesem Leitfaden erfahren Sie, wie Sie mit dem Google Cardboard XR-Plug-in für Unity eigene Virtual-Reality-Inhalte (VR) erstellen.

Hinweis :Lesen Sie die Richtlinien für das Branding von Cardboard-Apps, bevor Sie Ihre App einem breiteren Publikum zugänglich machen.

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 Umgebungsvariablen PATH 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.

1. Öffnen Sie Unity und erstellen Sie ein neues 3D-Projekt.
2. Klicken Sie in Unity auf Fenster > Paketmanager.
3. Klicken Sie auf + und wählen Sie Paket über Git-URL hinzufügen aus.
4. Fügen Sie https://github.com/googlevr/cardboard-xr-plugin.git in das Textfeld ein.
   Das Paket sollte den installierten Paketen hinzugefügt werden.
5. 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 in Assets/Samples/Google Cardboard/<version>/Hello Cardboard geladen werden.

Hinweis: <version> ist die semantische X.Y.Z-Versionsnummer des veröffentlichten Pakets (z. B. 1.1.0).

HelloCardboard-Szene konfigurieren

1. 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.
2. Öffnen Sie das Menü Ebenen und wählen Sie Ebenen bearbeiten… aus.
3. Definieren Sie eine neue Ebene namens „Interaktiv“.
4. 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“.
5. 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.

1. Wählen Sie Android und dann Plattform wechseln aus.
2. 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.

1. Legen Sie die Standardausrichtung auf Querformat links oder Querformat rechts fest.
2. Deaktivieren Sie Optimiertes Frame-Pacing.

Hinweis: Die Ausrichtungen Porträt und Porträt auf dem Kopf werden zwar vom Cardboard XR-Plug-in unterstützt, bieten aber möglicherweise nicht genügend Platz für das Rendern von Augen auf Geräten.

Weitere Einstellungen

Gehe zu Projekteinstellungen > Wiedergabe > Weitere Einstellungen.

1. Wählen Sie unter Grafik-APIs OpenGLES2, OpenGLES3 oder Vulkan oder eine beliebige Kombination dieser Optionen aus.
2. Wählen Sie unter Mindest-API-Level die Option Android 8.0 'Oreo' (API level 26) oder höher aus.
3. Wählen Sie unter Ziel-API-Level API level 33 oder höher aus.
4. Wählen Sie unter Scripting-Backend die Option IL2CPP aus.
5. Wählen Sie die gewünschten Architekturen aus, indem Sie unter Zielarchitekturen ARMv7, ARM64 oder beides auswählen.
6. Wählen Sie unter Internetzugriff die Option Require aus.
7. Wählen Sie unter Active Input Handling (Aktive Eingabeverwaltung) die Option Input System Package (New) aus.
8. Geben Sie unter Paketname die Domain Ihres Unternehmens an.
9. 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.
10. Wenn die Unity-Version 2023.1 oder höher ist, wählen Sie Activity aus und löschen Sie GameActivity unter Application Entry Point.

Hinweis :Sie können eine niedrigere Mindest-API-Ebene verwenden, indem Sie die Kompatibilität der Rendering-API ändern. Weitere Informationen finden Sie in der build.gradle des SDKs.

Hinweis: Wenn bei der Auswahl von Vulkan als Grafik-API Probleme auftreten, setzen Sie ein Häkchen in das Kästchen Development Build in Build Settings und suchen Sie in den Laufzeitprotokollen nach Fehlern bei der Treiberkompatibilität.

Hinweis: OpenGL ES 2.0 wird in Unity 2023.1 und höher nicht mehr unterstützt. Verwenden Sie stattdessen OpenGL ES 3.0 oder Vulkan. Weitere Informationen finden Sie im Unity-Handbuch auf der Seite Android-Anforderungen und -Kompatibilität.

Einstellungen für die Veröffentlichung

Gehe zu Projekteinstellungen > Player > Veröffentlichungseinstellungen.

1. Wählen Sie im Abschnitt Build die Optionen Custom Main Gradle Template und Custom Gradle Properties Template aus.

2. 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'
   

3. Fügen Sie Assets/Plugins/Android/gradleTemplate.properties die folgenden Zeilen hinzu:

     android.enableJetifier=true
     android.useAndroidX=true
   

Hinweis: Die erforderlichen Abhängigkeiten können sich zwischen den Versionen ändern. Wenn Sie eine andere Version als die neueste Version verwenden möchten, sehen Sie sich den Verlauf des Abschnitts „Dependencies“ (Abhängigkeiten) in sdk/build.gradle im Cardboard SDK-Repository an.

Einstellungen für die Verwaltung von XR-Plug-ins

Gehen Sie zu Projekteinstellungen > XR-Plug-in-Verwaltung.

1. Wählen Sie unter Plug-in-Anbieter die Option Cardboard XR Plugin aus.

Projekt erstellen

Klicken Sie auf Datei > Build-Einstellungen.

1. 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.

1. Wählen Sie iOS und dann Plattform wechseln aus.
2. 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.

1. Legen Sie die Standardausrichtung auf Querformat links oder Querformat rechts fest.

Hinweis: Die Ausrichtungen Porträt und Porträt auf dem Kopf werden zwar vom Cardboard XR-Plug-in unterstützt, bieten aber möglicherweise nicht genügend Platz für das Rendern von Augen auf Geräten.

Weitere Einstellungen

Gehe zu Projekteinstellungen > Wiedergabe > Weitere Einstellungen.

1. 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.
2. Geben Sie unter Mindest-iOS-Version die Zahl 12.0 ein.
3. Geben Sie unter Paketname die Domain Ihres Unternehmens an.

Hinweis :Wenn Sie ein iPhone X verwenden, wählen Sie die Option Startbildschirmtaste auf dem iPhone X ausblenden aus.

Einstellungen für die Verwaltung von XR-Plug-ins

Gehen Sie zu Projekteinstellungen > XR-Plug-in-Verwaltung.

1. Wählen Sie unter Plug-in-Anbieter die Option Cardboard XR Plugin aus.

Projekt erstellen

Klicken Sie auf Datei > Build-Einstellungen.

1. 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:

1. 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).
2. Halten Sie den Auslöser Ihres Cardboard-Geräts mindestens drei Sekunden lang gedrückt.
3. Lassen Sie den Auslöser los.
4. 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.