Kurzanleitung für Android NDK

Entwicklungsumgebung einrichten

  • Installieren Sie Android Studio Version 3.1 oder höher mit Android SDK Platform Version 7.0 (API-Level 24) oder höher.

  • Bereiten Sie Android Studio für die native Entwicklung vor. Installieren Sie dazu das Android Native Development Kit (NDK) und CMake mit dem SDK Manager. Weitere Informationen findest du unter Erste Schritte mit dem NDK.

  • Du benötigst das ARCore SDK for Android. Sie haben dann folgende Möglichkeiten:

    • Laden Sie das ARCore SDK for Android herunter und extrahieren Sie es.

      Oder:

    • Klonen Sie das Repository mit dem folgenden Befehl:

      git clone https://github.com/google-ar/arcore-android-sdk.git

Gerät oder Emulator vorbereiten

Sie können AR-Apps auf einem unterstützten Gerät oder im Android-Emulator ausführen. Sie müssen Google Play-Dienste für AR auf dem Emulator aktualisieren, bevor Sie die App ausführen. Weitere Informationen finden Sie unter AR-Apps im Android-Emulator ausführen .

Beispielprojekt öffnen

Öffnen Sie in Android Studio das Beispielprojekt hello_ar_c in <ARCore SDK Folder>/samples/hello_ar_c.

Das Beispielprojekt weist Build-Abhängigkeiten von bestimmten Softwareversionen wie Gradle und dem Android SDK auf. Wenn die erforderlichen Abhängigkeiten nicht installiert sind, werden Sie von Android Studio um die Berechtigung zum Herunterladen und Installieren auf Ihrem Computer gebeten.

Beispiel ausführen

Prüfe, ob dein Android-Gerät mit dem Entwicklungscomputer verbunden ist, und klicke in Android Studio auf Run .

Android Studio erstellt aus deinem Projekt ein Debug-fähiges APK, installiert das APK und führt dann die App auf deinem Gerät aus. Weitere Informationen finden Sie unter Anwendung erstellen und ausführen.

Wenn Sie Ihr Gerät bewegen, erkennt die App automatisch flache Oberflächen und zeichnet ein Rautenraster. Tippe auf das Raster, um einen dreidimensionalen ARCore-Bauern auf der Oberfläche zu platzieren.

Instant-Placement verwenden

Mit der Instant Placement API können Nutzer ein AR-Objekt auf dem Bildschirm platzieren, ohne warten zu müssen, bis ARCore die Oberflächengeometrie erkannt hat. Die Objektplatzierung wird in Echtzeit optimiert, wenn sich der Nutzer in der Umgebung weiterbewegt. Sobald ARCore die richtige Haltung in der Region erkennt, in der sich das AR-Objekt befindet, wird das Objekt automatisch auf die Position aktualisiert.

Tippe auf den Bildschirm, um ein Objekt zu platzieren. Bewegen Sie das Gerät weiter, nachdem das holografische Objekt auf dem Bildschirm angezeigt wurde, damit ARCore genügend Daten über Ihre Umgebung erhält, um das virtuelle Objekt genau zu verankern.

Sofortiges Placement

In Abbildung 1 ist die sofortige Platzierung deaktiviert und die Oberflächengeometrie ist nicht definiert. Objekte, die sich auf dem Boden rechts neben dem Billardtisch befinden (vier kleine blaue Punkte), wirken umgeklappt und ihre Posen sind nicht definiert.

In Abbildung 2 wird Instant Placement im Menü unter dem Zahnradsymbol aktiviert.

In Abbildung 3 wird bei aktivierter Instant-Platzierung ein neues Objekt in der Szene platziert. Es wird in Graustufen und nicht in Farbe angezeigt, um anzuzeigen, dass es noch nicht für eine genaue Pose korrigiert wurde.

In Abbildung 4 wird das neue Objekt eingefärbt und seine Position ist korrekt, wenn die durch die verfolgbare Rasterlinien beschriebene Oberflächengeometrie erkannt wird.

Tiefe verwenden

Wenn Tiefe aktiviert ist, berücksichtigt ARCore die Geometrie und die Position von Objekten in der Szene und berechnet die Position von Objekten in der Szene im Verhältnis zu anderen Objekten in der Szene. Sie können platzierte Objekte durch Objekte in der Szene verdecken und Ihre App dadurch realistischer gestalten.

Sofortiges Placement

In Abbildung 1 ist die Tiefe deaktiviert. Ein Objekt wird unter dem Billardtisch platziert.

Wenn sich das Gerät in Abbildung 2 um den Billardtisch bewegt, scheint das Objekt dem Gerät zu folgen, unabhängig von den Objekten in der Szene.

In Abbildung 3 ist „Tiefe“ aktiviert.

In Abbildung 4 wird das Objekt jetzt vom Billardtisch verdeckt, wenn sich das Gerät um die Szene bewegt.

Nächste Schritte