Información sobre el entorno del usuario en el NDK de Android (C)

Obtén información para usar la API de Scene Semantics en tus propias apps.

La API de Scene Semantics permite que los desarrolladores comprendan la escena que rodea al usuario, ya que proporciona información semántica en tiempo real basada en modelos de AA. Dada una imagen de una escena exterior, la API muestra una etiqueta para cada píxel en un conjunto de clases semánticas útiles, como cielo, edificio, árbol, carretera, acera, vehículo, persona, etc. Además de las etiquetas de píxeles, la API de Scene Semantics también ofrece valores de confianza para cada etiqueta de píxel y una forma fácil de consultar para consultar la prevalencia de una etiqueta determinada en una escena al aire libre.

De izquierda a derecha, ejemplos de una imagen de entrada, la imagen semántica de las etiquetas de píxeles y la imagen de confianza correspondiente:

Ejemplo de imagen de entrada, imagen semántica y imagen de confianza semántica.

Requisitos previos

Asegúrate de comprender los conceptos fundamentales de RA y cómo configurar una sesión de ARCore antes de continuar.

Habilita la semántica de escenas

En una nueva sesión de ARCore, verifica si el dispositivo de un usuario es compatible con la API de Scene Semantics. No todos los dispositivos compatibles con ARCore admiten la API de Scene Semantics debido a restricciones de capacidad de procesamiento.

Para ahorrar recursos, la semántica de escenas está inhabilitada de forma predeterminada en ARCore. Habilita el modo semántico para que tu app use la API de Scene Semantics.

// Check whether the user's device supports the Scene Semantics API.
int32_t is_scene_semantics_supported = 0;
ArSession_isSemanticModeSupported(ar_session, AR_SEMANTIC_MODE_ENABLED, &is_scene_semantics_supported);

// Configure the session for AR_SEMANTIC_MODEL_ENABLED.
ArConfig* ar_config = NULL;
ArConfig_create(ar_session, &ar_config);
if (is_scene_semantics_supported) {
  ArConfig_setSemanticMode(ar_session, ar_config, AR_SEMANTIC_MODE_ENABLED);
}
CHECK(ArSession_configure(ar_session, ar_config) == AR_SUCCESS);
ArConfig_destroy(ar_config);

Obtén la imagen semántica

Una vez que se habilita la semántica de escenas, se puede recuperar la imagen semántica. La imagen semántica es una imagen AR_IMAGE_FORMAT_Y8, en la que cada píxel corresponde a una etiqueta semántica definida por ArSemanticLabel.

Usa ArFrame_acquireSemanticImage() para adquirir la imagen semántica:

// Retrieve the semantic image for the current frame, if available.
ArImage* semantic_image = NULL;
if (ArFrame_acquireSemanticImage(ar_session, ar_frame, &semantic_image) != AR_SUCCESS) {
  // No semantic image retrieved for this frame.
  // The output image may be missing for the first couple frames before the model has had a chance to run yet.
  return;
}
// If a semantic image is available, use it here.

Las imágenes semánticas de salida deberían estar disponibles después de 1 a 3 fotogramas desde el inicio de la sesión, según el dispositivo.

Obtén la imagen de confianza

Además de la imagen semántica, que proporciona una etiqueta para cada píxel, la API también proporciona una imagen de confianza de los valores de confianza de píxeles correspondientes. La imagen de confianza es una imagen de AR_IMAGE_FORMAT_Y8, en la que cada píxel corresponde a un valor en el rango [0, 255], que corresponde a la probabilidad asociada con la etiqueta semántica para cada píxel.

Usa ArFrame_acquireSemanticConfidenceImage() para adquirir la imagen de confianza semántica:

// Retrieve the semantic confidence image for the current frame, if available.
ArImage* semantic_confidence_image = NULL;
if (ArFrame_acquireSemanticConfidenceImage(ar_session, ar_frame, &semantic_confidence_image) != AR_SUCCESS) {
  // No semantic confidence image retrieved for this frame.
  // The output image may be missing for the first couple frames before the model has had a chance to run yet.
  return;
}
// If a semantic confidence image is available, use it here.

Las imágenes de confianza de salida deberían estar disponibles después de 1 a 3 fotogramas desde el inicio de la sesión, según el dispositivo.

Consulta la fracción de píxeles de una etiqueta semántica

También puedes consultar la fracción de píxeles en el fotograma actual que pertenecen a una clase en particular, como el cielo. Esta consulta es más eficiente que mostrar la imagen semántica y realizar una búsqueda de píxeles para una etiqueta específica. La fracción que se muestra es un valor de número de punto flotante en el rango [0.0, 1.0].

Usa ArFrame_getSemanticLabelFraction() para adquirir la fracción de una etiqueta determinada:

// Retrieve the fraction of pixels for the semantic label sky in the current frame.
float out_fraction = 0.0f;
if (ArFrame_getSemanticLabelFraction(ar_session, ar_frame, AR_SEMANTIC_LABEL_SKY, &out_fraction) != AR_SUCCESS) {
  // No fraction of semantic labels was retrieved for this frame.
}