Cómo realizar pruebas de posicionamiento en tu app de NDK de Android

Realiza una prueba de posicionamiento para determinar la ubicación correcta de un objeto 3D en tu escena. La posición correcta garantiza que el contenido de RA se renderice en el tamaño adecuado (aparente).

Tipos de resultados de hits

Una prueba de posicionamiento puede producir cuatro tipos diferentes de resultados de hit, como se muestra en la siguiente tabla.

Tipo de resultado de hit	Descripción	Orientación	Caso de uso	de llamadas a métodos
Profundidad (AR_TRACKABLE_DEPTH_POINT)	Usa información de profundidad de toda la escena para determinar la profundidad y la orientación correctas de un punto	Perpendicular a la superficie 3D	Coloca un objeto virtual en una superficie arbitraria (no solo en pisos y paredes).	ArDepthMode debe estar habilitado para que esto funcione. ArFrame_hitTest, busca ArDepthPoint en la lista que se muestra
Avión (AR_TRACKABLE_PLANE)	Golpea superficies horizontales o verticales para determinar la profundidad y la orientación correctas del punto	Perpendicular a la superficie 3D	Coloca un objeto en un plano (suelo o pared) con la geometría completa del plano. Se necesita la báscula correcta de inmediato. Resguardo para la prueba de posicionamiento de profundidad	ArFrame_hitTest, busca ArPlane en la lista de devolución
Punto de componente (AR_TRACKABLE_POINT)	Se basa en las características visuales del punto en que el usuario presiona para determinar la posición y la orientación correctas de un punto.	Perpendicular a la superficie 3D	Colocar un objeto sobre una superficie arbitraria (no solo en pisos y paredes)	ArFrame_hitTest, busca ArPoint en la lista de devolución
Posición instantánea (AR_TRACKABLE_INSTANT_PLACEMENT_POINT)	Usa espacio de la pantalla para colocar contenido. Inicialmente, se usa la profundidad estimada que proporciona la app. Funciona al instante, pero la posición y la profundidad real cambiarán una vez que ARCore pueda determinar la geometría real de la escena.	+Y apuntando hacia arriba, opuesto a la gravedad	Coloca un objeto en un plano (suelo o pared) con la geometría completa del plano donde la ubicación rápida es fundamental y la experiencia pueda tolerar una profundidad y una escala iniciales desconocidas.	ArFrame_hitTestInstantPlacement

Realiza una prueba de posicionamiento estándar

Llama a ArFrame_hitTest para realizar una prueba de posicionamiento.

ArHitResultList* hit_result_list = NULL;
ArHitResultList_create(ar_session, &hit_result_list);
CHECK(hit_result_list);
if (is_instant_placement_enabled) {
  ArFrame_hitTestInstantPlacement(ar_session, ar_frame, x, y,
                                  k_approximate_distance_meters,
                                  hit_result_list);
} else {
  ArFrame_hitTest(ar_session, ar_frame, x, y, hit_result_list);
}

Filtra los resultados de hits según el tipo que te interese. Por ejemplo, si deseas enfocarte en los elementos ArPlane, haz lo siguiente:

int32_t hit_result_list_size = 0;
ArHitResultList_getSize(ar_session, hit_result_list, &hit_result_list_size);

// Returned hit-test results are sorted by increasing distance from the camera
// or virtual ray's origin. The first hit result is often the most relevant
// when responding to user input.
ArHitResult* ar_hit_result = NULL;
for (int32_t i = 0; i < hit_result_list_size; ++i) {
  ArHitResult* ar_hit = NULL;
  ArHitResult_create(ar_session, &ar_hit);
  ArHitResultList_getItem(ar_session, hit_result_list, i, ar_hit);

  if (ar_hit == NULL) {
    LOGE("No item was hit.");
    return;
  }

  ArTrackable* ar_trackable = NULL;
  ArHitResult_acquireTrackable(ar_session, ar_hit, &ar_trackable);
  ArTrackableType ar_trackable_type = AR_TRACKABLE_NOT_VALID;
  ArTrackable_getType(ar_session, ar_trackable, &ar_trackable_type);
  // Creates an anchor if a plane was hit.
  if (ar_trackable_type == AR_TRACKABLE_PLANE) {
    // Do something with this hit result. For example, create an anchor at
    // this point of interest.
    ArAnchor* anchor = NULL;
    ArHitResult_acquireNewAnchor(ar_session, ar_hit, &anchor);

    // TODO: Use this anchor in your AR experience.

    ArAnchor_release(anchor);
    ArHitResult_destroy(ar_hit);
    ArTrackable_release(ar_trackable);
    break;
  }
  ArHitResult_destroy(ar_hit);
  ArTrackable_release(ar_trackable);
}
ArHitResultList_destroy(hit_result_list);

Realiza una prueba de posicionamiento con un rayo y una dirección arbitrarios

Las pruebas de posicionamiento se suelen tratar como rayos procedentes de la cámara del dispositivo o del dispositivo, pero puedes usar ArFrame_hitTestRay para llevarla a cabo con un rayo arbitrario en coordenadas del espacio mundial en lugar de un punto en el espacio en pantalla.

Cómo adjuntar un ancla a un HitResult

Una vez que tengas un resultado de hit, puedes usar su pose como entrada para colocar contenido de RA en tu escena. Usa ArHitResult_acquireNewAnchor para crear una nueva fija en la ubicación de la visita.

¿Qué sigue?

• Consulta la app de ejemplo de hello_ar_c en GitHub.