Gebäude und Gelände in der Umgebung auf Android NDK (C) verwenden

Die Streetscape Geometry APIs liefern die Geometrie von Gelände, Gebäuden oder anderen Strukturen in einer Szene. Die Geometrie kann zum Verdecken, Rendern oder Platzieren von AR-Inhalten über Treffertest-APIs verwendet werden. Die Geometriedaten für Streetscape werden über Google Street View-Bilder abgerufen.

Geospatial API einrichten

Wenn Sie Streetscape-Geometrie verwenden möchten, müssen Sie die Geospatial API in Ihrem Projekt einrichten. Folgen Sie der Anleitung unter Geospatial API aktivieren, um sie einzurichten.

Streetscape-Geometrie aktivieren

Die Geospatial API ruft Streetscape-Geometriedaten ab, wenn ArGeospatialMode auf ArGeospatialModeEnabled und ArStreetscapeGeometryMode auf ArStreetscapeGeometryModeEnabled gesetzt ist.

// Create a session config.
ArConfig* ar_config = NULL;
ArConfig_create(ar_session, &ar_config);

// Enable the Geospatial API.
ArConfig_setGeospatialMode(ar_session, ar_config, AR_GEOSPATIAL_MODE_ENABLED);
CHECK(ArSession_configure(ar_session, ar_config) == AR_SUCCESS);

// Enable Streetscape Geometry.
ArConfig_setStreetscapeGeometryMode(ar_session, ar_config, AR_STREETSCAPE_GEOMETRY_MODE_ENABLED);
CHECK(ArSession_configure(ar_session, ar_config) == AR_SUCCESS);

// Release config resources.
ArConfig_destroy(ar_config);

Streetscape-Geometrie in einer ARCore-Sitzung abrufen

Verwenden Sie ArSession_getAllTrackables() und AR_TRACKABLE_STREETSCAPE_GEOMETRY, um Ergebnisse zu filtern.

ArTrackableList* trackable_list = NULL;
ArTrackableList_create(ar_session, &trackable_list);
ArSession_getAllTrackables(ar_session, AR_TRACKABLE_STREETSCAPE_GEOMETRY, trackable_list);

ArStreetscapeGeometry verstehen

ArStreetscapeGeometry enthält Informationen zu einem Gebäude:

• ArStreetscapeGeometry_getType()
  Identifiziert StreetscapeGeometry entweder als Gelände oder als Gebäude.
• ArStreetscapeGeometry_acquireMesh()
  Fordern Sie ein Polygon ArMesh an, das dem Gelände oder Gebäude entspricht.
• ArStreetscapeGeometry_getMeshPose()
  Beschreibt den Ursprung der Geometrie. Alle Punkte im ArMesh sollten durch ArStreetscapeGeometry_getMeshPose() umgewandelt werden.
• ArStreetscapeGeometry_getQuality()
  Stellt die Qualität der Mesh-Daten bereit. Die Detailebenen werden im CityGML 2.0-Standard beschrieben.

LOD 1 erstellen

AR_STREETSCAPE_GEOMETRY_QUALITY_BUILDING_LOD_1 besteht aus Gebäuden, die nach oben auf eine flache Oberfläche extrudiert werden. Gebäudehöhen können ungenau sein.

LOD 2 erstellen

AR_STREETSCAPE_GEOMETRY_QUALITY_BUILDING_LOD_2 weist eine höhere Geometrie auf. Gitterwände und Dächer passen sich besser an die Form des Gebäudes an. Auch kleinere Elemente wie Schornsteine oder Lüftungsöffnungen können aus dem Gitter herausragen.

ArMesh verstehen

ArMesh ist ein Polygonnetz, das eine Oberflächenrekonstruktion der Streetscape-Geometrie darstellt. Jedes ArMesh enthält einen Vertex-Zwischenspeicher und einen Indexzwischenspeicher:

• ArMesh_getVertexListSize()
  Ruft die Anzahl der Eckpunkte in diesem Mesh-Netzwerk ab.
• ArMesh_getVertexList()
  Rufen Sie die verketteten Positionen von Netzeckpunkten in Koordinaten relativ zu ArStreetscapeGeometry_getMeshPose() ab.
• ArMesh_getIndexListSize()
  Ruft die Anzahl der Indexe in diesem Mesh-Netzwerk ab.
• ArMesh_getIndexList()
  Indexe der Eckpunkte abrufen, aus denen ein Gesicht besteht.

AR-Inhalte an ArStreetscapeGeometry anhängen

Es gibt zwei Möglichkeiten, AR-Inhalte an Streetscape-Geometrie anzuhängen:

• Aktivieren Sie Raumbezogene Tiefe und führen Sie einen Tiefentest aus. Dies ist die empfohlene und einfachere Methode.
• Mit ArTrackable_acquireNewAnchor() können Sie einen Anker bei einer bestimmten Pose erstellen, der mit einem ArStreetscapeGeometry-Element verknüpft ist. Dieser Anker übernimmt den Tracking-Status vom übergeordneten ArStreetscapeGeometry.

Treffertest für ArStreetscapeGeometry durchführen

ArFrame_hitTest kann für Treffertests mit Streetscape-Geometriedaten verwendet werden. Wenn Kreuzungen gefunden werden, enthält ArHitResult Poseninformationen zur Trefferposition sowie einen Verweis auf das ArStreetscapeGeometry, für das der Treffer getroffen wurde. Diese Streetscape-Geometrie kann an ArTrackable_acquireNewAnchor() übergeben werden, um einen Anker hinzuzufügen.

ArHitResultList *hit_result_list = NULL;
ArHitResult *hit_result = NULL;
ArHitResultList_create(ar_session, &hit_result_list);
ArHitResult_create(ar_session, &hit_result);

ArFrame_hitTestRay(ar_session, ar_frame, origin, direction, hit_result_list);
ArHitResultList_getItem(ar_session, hit_result_list, 0, hit_result);

ArAnchor *out_anchor = NULL;
ArStatus status = ArHitResult_acquireNewAnchor(ar_session, hit_result, &out_anchor);
CHECK(status == AR_SUCCESS);

Raumbezogene Tiefe aktivieren

Bei der raumbezogenen Tiefe wird die Streetscape-Geometrie mit lokalen Sensoreingaben kombiniert, um Tiefendaten zu verbessern. Wenn die raumbezogene Tiefe aktiviert ist, werden die ausgegebenen Bilder mit Tiefentiefe und Rohtiefe so geändert, dass zusätzlich zur lokal beobachteten Tiefe auch die gerasterte Streetscape-Geometrie enthalten ist. Dadurch kann die Genauigkeit von Posen mithilfe der Tiefe verbessert werden.