Usa edificios y terrenos a tu alrededor en el NDK de Android (C)

Las APIs de geometría del paisaje urbano proporcionan la geometría del terreno, los edificios y otras estructuras de una escena. La geometría se puede usar para la oclusión, la renderización o la colocación de contenido de RA mediante las APIs de pruebas de posicionamiento. Los datos de geometría del paisaje urbano se obtienen a través de las imágenes de Google Street View.

Configura la API de Geospatial

Para usar Streetscape Geometry, deberás configurar la API de Geospatial en tu proyecto. Sigue las instrucciones que se indican en Cómo habilitar la API de Geospatial para configurarla.

Habilitar la geometría del paisaje urbano

La API de Geospatial obtiene datos de Streetscape Geometry cuando ArGeospatialMode se establece en ArGeospatialModeEnabled y ArStreetscapeGeometryMode se establece en ArStreetscapeGeometryModeEnabled.

// 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);

Obtén la geometría del paisaje urbano en una sesión de ARCore

Usa ArSession_getAllTrackables() y AR_TRACKABLE_STREETSCAPE_GEOMETRY para filtrar los resultados.

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

Información sobre ArStreetscapeGeometry

ArStreetscapeGeometry: Contiene información sobre un edificio:

• ArStreetscapeGeometry_getType()
  Identifica la geometría del paisaje urbano como terreno o un edificio.
• ArStreetscapeGeometry_acquireMesh()
  Obtén un polígono ArMesh que corresponda a este terreno o edificio.
• ArStreetscapeGeometry_getMeshPose()
  Describe el origen de la geometría. ArStreetscapeGeometry_getMeshPose() debe transformar todos los puntos de ArMesh.
• ArStreetscapeGeometry_getQuality()
  Proporciona la calidad de los datos de la malla. Los niveles de detalle se describen en el estándar CityGML 2.0.

Nivel de detalle de edificio 1

El objeto AR_STREETSCAPE_GEOMETRY_QUALITY_BUILDING_LOD_1 consiste en huellas de edificios extruidas hacia arriba hasta una parte superior plana. Las alturas de los edificios pueden ser imprecisas.

Nivel de detalle de construcción 2

AR_STREETSCAPE_GEOMETRY_QUALITY_BUILDING_LOD_2 tendrá una geometría de mayor fidelidad. Las paredes y los techos de malla se ajustarán mejor a la forma del edificio. Las características más pequeñas, como las chimeneas o los conductos de ventilación del techo, podrían salir de la malla.

Información sobre ArMesh

ArMesh es una malla de polígonos que representa una reconstrucción de superficie de la geometría del paisaje urbano. Cada ArMesh incluye un búfer de vértice y un búfer de índice:

• ArMesh_getVertexListSize()
  Recupera la cantidad de vértices de esta malla.
• ArMesh_getVertexList()
  Obtén las posiciones concatenadas de los vértices de la malla, en coordenadas relacionadas con ArStreetscapeGeometry_getMeshPose().
• ArMesh_getIndexListSize()
  Recupera la cantidad de índices de esta malla.
• ArMesh_getIndexList()
  Obtén los índices de los vértices que conforman un rostro.

Adjuntar contenido de RA a un ArStreetscapeGeometry

Existen dos maneras de adjuntar contenido de RA a la geometría del paisaje urbano:

• Habilita la profundidad geoespacial y usa una prueba de posicionamiento de profundidad. Este es el método recomendado y más sencillo.
• Usa ArTrackable_acquireNewAnchor() para crear un ancla en una posición determinada adjunta a un ArStreetscapeGeometry. Este ancla heredará su estado de seguimiento del elemento superior ArStreetscapeGeometry.

Realiza una prueba de posicionamiento contra ArStreetscapeGeometry

Se puede usar ArFrame_hitTest para realizar pruebas de posicionamiento con la geometría del paisaje urbano. Si se encuentran intersecciones, ArHitResult contiene información de la pose sobre la ubicación del hit, así como una referencia a ArStreetscapeGeometry que se alcanzó. Esta geometría del paisaje urbano se puede pasar a ArTrackable_acquireNewAnchor() para crear un ancla adjunta.

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);

Habilita la profundidad geoespacial

La profundidad geoespacial combina la geometría del paisaje urbano con la entrada del sensor local para mejorar los datos de profundidad. Cuando se habilita la profundidad geoespacial, la profundidad de salida y las imágenes de profundidad sin procesar se modifican para incluir la geometría del paisaje urbano rasterizada, además de la profundidad observada a nivel local. Esto podría mejorar la precisión de las poses usando Depth.