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-Ebene 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 finden Sie unter Erste Schritte mit dem NDK.

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

    • Laden Sie das ARCore SDK für 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

Du kannst AR-Apps auf einem unterstützten Gerät oder im Android-Emulator ausführen. Sie müssen die Google Play-Dienste für AR im 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 hat Build-Abhängigkeiten für bestimmte Softwareversionen, z. B. Gradle und das Android SDK. Wenn die erforderlichen Abhängigkeiten nicht installiert sind, werden Sie von Android Studio um Erlaubnis gebeten, diese auf Ihren Computer herunterzuladen und zu installieren.

Beispiel ausführen

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

Android Studio erstellt dein Projekt in einem debugfähigen APK, installiert das APK und führt die App dann auf deinem Gerät aus. Weitere Informationen finden Sie unter Anwendung erstellen und ausführen.

Während du dein Gerät bewegst, erkennt die App automatisch flache Oberflächen und zeichnet ein Rautenraster. Tippen Sie auf das Raster, um eine dreidimensionale Verpflegung auf der Oberfläche zu platzieren.

Sofort-Placement verwenden

Mit der Instant Placement API kann der 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 der Nutzer sich weiter in der Umgebung bewegt. Sobald ARCore die korrekte Pose in der Region erkennt, in der sich das AR-Objekt befindet, wird das Objekt automatisch auf die Pose-Position aktualisiert.

Tippen Sie auf das Display, um ein Objekt zu platzieren. Bewegen Sie das Gerät weiter, bis das holografische Objekt auf dem Bildschirm zu sehen ist, damit ARCore genügend Daten zu Ihrer Umgebung erhält, um das virtuelle Objekt korrekt zu verankern.

Sofortige Platzierung

In Abbildung 1 ist die sofortige Platzierung deaktiviert und die Oberflächengeometrie ist nicht definiert. Objekte, die auf dem Boden rechts neben dem Billardtisch (vier kleine blaue Punkte) platziert sind, werden umgedreht. Ihre Positionen sind nicht definiert.

Abbildung 2 zeigt, wie die unmittelbare Platzierung über das Menü unter dem Zahnradsymbol aktiviert wird.

In Abbildung 3 mit aktivierter Sofortplatzierung wird ein neues Objekt in die Szene gesetzt. Es wird in Graustufen angezeigt und ist nicht farbig, um anzuzeigen, dass es nicht korrigiert wurde.

In Abbildung 4 wird das neue Objekt farbig, und die Pose ist genau, wenn die Oberflächengeometrie, die durch die beobachtbaren Rasterlinien beschrieben wird, 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 in der Szene platzierten Objekten relativ zu anderen Objekten in der Szene. Damit können platzierte Objekte von Objekten in der Szene verdeckt werden und Ihre Anwendung wird realistisch.

Sofortige Platzierung

In Abbildung 1 ist die Tiefe deaktiviert. Ein Objekt wird unter der Billardtisch-Tabelle platziert.

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

In Abbildung 3 ist die Tiefe aktiviert.

In Abbildung 4 ist das Objekt jetzt vom Billardtisch verdeckt, wenn sich das Gerät im Raum bewegt.

Nächste Schritte