Kurzanleitung für Google Cardboard für Unity

In dieser Anleitung erfährst du, wie du das Google Cardboard XR-Plug-in für Unity, damit Unity Ihr eigenes Virtual-Reality-Erlebnisse.

Hinweis: Lies dir unbedingt das Cardboard-Branding durch. vor der Veröffentlichung deiner App ein größeres Publikum erreichen.

Mit dem Cardboard SDK kannst du ein Smartphone in eine VR-Plattform verwandeln. A Smartphone kann 3D-Szenen mit stereoskopischer Wiedergabe anzeigen, verfolgen und auf Kopfbewegungen und die Interaktion mit Apps, indem erkannt wird, wenn Nutzende die Schaltfläche für die Wiedergabe.

Zum Einstieg verwenden Sie HelloCardboard, ein Demospiel, das die Hauptfunktionen des Cardboard SDK. In diesem Spiel sehen sich die Nutzer um Objekte zu finden und zu sammeln. Sie erfahren, wie Sie:

• Entwicklungsumgebung einrichten
• Demo-App herunterladen und erstellen
• QR-Code eines Cardboard scannen, um die Parameter zu speichern
• Die Kopfbewegungen der Nutzenden erfassen
• Stereoskopische Bilder rendern, indem die richtige Verzerrung für jedes Auge festgelegt wird
• VR-Modus aktivieren und deaktivieren

Entwicklungsumgebung einrichten

Softwareanforderungen:

• Unity 2021.3.32f1 oder höher
  • Achten Sie darauf, während der Installation die Android- und iOS-Build-Unterstützung hinzuzufügen.
• Git muss installiert sein und die ausführbare Datei git muss in der Umgebungsvariable PATH sein. Siehe Paketmanager-Git von Unity Support finden Sie weitere Details.

SDK importieren und ein 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. Gehen Sie in Unity zu Window > Paketmanager:
3. Klicken Sie auf + und wählen Sie Paket aus Git-URL hinzufügen aus.
4. https://github.com/googlevr/cardboard-xr-plugin.git in den Text einfügen Eingabefeld.
   Das Paket sollte den installierten Paketen hinzugefügt werden.
5. Rufe das Paket Google Cardboard XR-Plug-in für Unity auf. Im Samples die Option Import into Project (In Projekt importieren).
   Die Beispiel-Assets sollte in Assets/Samples/Google Cardboard/<version>/Hello Cardboard geladen werden.

Hinweis: <version> ist die semantische Versionsnummer von X.Y.Z des freigegebenen Pakets. (z. B. 1.1.0)

HelloCardboard-Szene wird konfiguriert

1. Gehe zu Assets/Samples/Google Cardboard/<version>/Hello Cardboard/Scenes, wähle Open Scenes (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 GameObject Treasure, um das Fenster „Inspector“ zu öffnen. Richte seine um "interaktiv" zu sein. Falls ein Pop-up-Fenster erscheint, in dem Sie gefragt werden, setzen Sie die Ebene auch für alle untergeordneten Objekte auf Interaktiv, klicken Sie auf "Ja, Kinder ändern“.
5. Klicke auf den Player > Kamera > CardboardReticlePointer-GameObject in öffnen Sie das Inspector-Fenster. Im „Carboard Fadenkreuzzeiger“ Script, wählen Sie „Interaktiv“ als Maske für Retikelinteraktionsschicht.

Android-Projekteinstellungen konfigurieren

Gehen Sie zu Datei > Build-Einstellungen.

1. Wählen Sie Android und dann Plattform wechseln aus.
2. Wähle Add Open Scenes (Offene Szenen hinzufügen) und dann HelloCardboard aus.

Player-Einstellungen

Auflösung und Präsentation

Gehen Sie zu Project Settings > Player > Auflösung und Präsentation.

1. Lege für die Standardausrichtung Querformat links oder Querformat fest. Nach rechts.
2. Deaktivieren Sie Optimierte Frame-Pacing.

Hinweis: Obwohl diese Funktion vom Cardboard XR-Plug-in unterstützt wird, können die Funktionen Portrait und Bei Verwendung der Option Hochformat (auf dem Kopf stehend) ist möglicherweise nicht genügend Platz für das Auge. auf Geräten rendern.

Weitere Einstellungen

Gehen Sie zu Project Settings > Player > Weitere Einstellungen:

1. Wählen Sie OpenGLES2, OpenGLES3, Vulkan oder eine beliebige Kombination davon in Grafik-APIs.
2. Wählen Sie unter Minimum API API (Mindest-API-Wert) Android 8.0 'Oreo' (API level 26) oder höher aus Level:
3. Wähle unter Ziel-API-Level mindestens API level 33 aus.
4. Wählen Sie IL2CPP in Scripting Backend (Skript-Back-End) aus.
5. Wählen Sie die gewünschten Architekturen aus, indem Sie ARMv7, ARM64 oder beide in Zielarchitekturen.
6. Wähle Require unter Internet Access (Internetzugriff) aus.
7. Geben Sie unter Paketname Ihre Unternehmensdomain an.
8. Wenn Vulkan als Graphics API ausgewählt wurde:
   • Entfernen Sie in Vulkan das Häkchen für die Option Displaydrehung während des Renderings anwenden. Einstellungen.
   • Wenn die Unity-Version 2021.2 oder höher ist, wählen Sie unter Texture ETC2 Komprimierungsformat.
9. Wenn die Unity-Version 2023.1 oder höher ist, wählen Sie Activity aus und löschen Sie GameActivity unter Anwendungseinstiegspunkt.

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

Hinweis :Falls bei der Auswahl von Vulkan als Grafiken Probleme auftreten API aktivieren, aktivieren Sie das Kästchen Development Build in Build Settings und analysieren Sie die Laufzeitprotokolle, die nach Treiberkompatibilitätsfehlern suchen.

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

Veröffentlichungseinstellungen

Gehen Sie zu Project Settings > Player > Veröffentlichungseinstellungen:

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

2. Fügen Sie die folgenden Zeilen in den Assets/Plugins/Android/mainTemplate.gradle:

     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.6.1'
     implementation 'com.google.protobuf:protobuf-javalite:3.19.4'
   

3. Fügen Sie folgende Zeilen zu Assets/Plugins/Android/gradleTemplate.properties:

     android.enableJetifier=true
     android.useAndroidX=true
   

Hinweis: Die erforderlichen Abhängigkeiten können sich von Version zu Version ändern. Wenn Sie eine Version unterscheidet, sehen Sie sich den Verlauf im Abschnitt „Abhängigkeiten“ sdk/build.gradle des Cardboard SDK-Repositorys.

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

Gehen Sie zu Project Settings > XR-Plug-in-Verwaltung.

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

Projekt erstellen

Gehen Sie zu Datei > Build-Einstellungen.

1. Wählen Sie Erstellen oder ein Gerät und dann Erstellen und ausführen aus.

iOS-Projekteinstellungen konfigurieren

Gehen Sie zu Datei > Build-Einstellungen.

1. Wählen Sie iOS und dann Plattform wechseln aus.
2. Wähle Add Open Scenes (Offene Szenen hinzufügen) und dann HelloCardboard aus.

Player-Einstellungen

Auflösung und Präsentation

Gehen Sie zu Project Settings > Player > Auflösung und Präsentation.

1. Lege für die Standardausrichtung Querformat links oder Querformat fest. Nach rechts.

Hinweis: Obwohl diese Funktion vom Cardboard XR-Plug-in unterstützt wird, können die Funktionen Portrait und Bei Verwendung der Option Hochformat (auf dem Kopf stehend) ist möglicherweise nicht genügend Platz für das Auge. auf Geräten rendern.

Weitere Einstellungen

Gehen Sie zu Project Settings > Player > Weitere Einstellungen:

1. Geben Sie unter Camera Usage Description (Beschreibung der Kameranutzung) den Wert Cardboard SDK requires camera permission to read the QR code (required to get the encoded device parameters). ein.
2. Schreiben Sie unter Ziel-iOS-Mindestversion den Wert 12.0.
3. Geben Sie unter Paketname Ihre Unternehmensdomain 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 des XR-Plug-ins

Gehen Sie zu Project Settings > XR-Plug-in-Verwaltung.

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

Projekt erstellen

Gehen Sie zu Datei > Build-Einstellungen.

1. Wählen Sie Erstellen oder Erstellen und ausführen aus.

Neu zentrieren

Mit dem Cardboard SDK kannst du den Kopf-Tracker neu zentrieren Recenter()

Führen Sie die folgenden Schritte aus, um es mit der Beispielanwendung auszuprobieren:

1. Bewege das Gerät an die Position, die du zentrieren möchtest (als neues Gerät verwenden) nach vorne gerichtete Kopfposition).
2. Halte den Auslöser deines Cardboard-Geräts mindestens drei Sekunden lang aktiv.
3. Lassen Sie den Auslöser los.
4. Die Ausgangsposition ist jetzt in die Richtung, in die die Kamera zeigt.

VR-Modus aktivieren und deaktivieren

Unity XR Plugin Management API können Sie VR-Modus für das Google Cardboard XR-Plug-in für Unity Endnutzerdokumentation und Anwendungsbeispiele finden Sie im Unity-Tool Endnutzer Dokumentation.

Die Szene VrMode aus dem HelloCardboard-Beispiel zeigt eine grundlegende Verwendung des oben erwähnten API. In dieser Szene kann der VR-Modus durch Tippen auf Beenden deaktiviert werden. und kann durch einfaches irgendwo auf den Bildschirm tippen. Prüfen VrModeController.cs .

Nächste Schritte

• Lies dir die Branding-Richtlinien für Cardboard durch.