Dowiedz się, jak używać interfejsu Instant Placement API w swoich aplikacjach.
Wymagania wstępne
Zanim przejdziesz dalej, upewnij się, że znasz podstawowe pojęcia związane z AR i wiesz, jak skonfigurować sesję ARCore.
Konfigurowanie nowej sesji z błyskawicznym miejscem docelowym
W nowej sesji ARCore włącz tryb błyskawicznego miejsca docelowego.
// Create a session config.
ArConfig* ar_config = NULL;
ArConfig_create(ar_session, &ar_config);
// Enable Instant Placement mode.
ArConfig_setInstantPlacementMode(ar_session, ar_config,
AR_INSTANT_PLACEMENT_MODE_LOCAL_Y_UP);
CHECK(ArSession_configure(ar_session, ar_config) == AR_SUCCESS);
// Release config resources.
ArConfig_destroy(ar_config);
Umieść obiekt
W nowej sesji ARCore przeprowadź test trafień w dynamicznym miejscu docelowym, używając ArFrame_hitTestInstantPlacement.
Następnie utwórz nowy element ArAnchor, używając pozycji ArInstantPlacementPoint z pozycji ARTrackable wyniku działania.
ArFrame* ar_frame = NULL;
if (ArSession_update(ar_session, ar_frame) != AR_SUCCESS) {
// Get the latest frame.
LOGE("ArSession_update error");
return;
}
// Place an object on tap.
// Use the estimated distance from the user's device to the closest
// available surface, based on expected user interaction and behavior.
float approximate_distance_meters = 2.0f;
ArHitResultList* hit_result_list = NULL;
ArHitResultList_create(ar_session, &hit_result_list);
CHECK(hit_result_list);
// Returns a single result if the hit test was successful.
ArFrame_hitTestInstantPlacement(ar_session, ar_frame, x, y,
approximate_distance_meters, hit_result_list);
int32_t hit_result_list_size = 0;
ArHitResultList_getSize(ar_session, hit_result_list, &hit_result_list_size);
if (hit_result_list_size > 0) {
ArHitResult* ar_hit_result = NULL;
ArHitResult_create(ar_session, &ar_hit_result);
CHECK(ar_hit_result);
ArHitResultList_getItem(ar_session, hit_result_list, 0, ar_hit_result);
if (ar_hit_result == NULL) {
LOGE("ArHitResultList_getItem error");
return;
}
ArTrackable* ar_trackable = NULL;
ArHitResult_acquireTrackable(ar_session, ar_hit_result, &ar_trackable);
if (ar_trackable == NULL) {
LOGE("ArHitResultList_acquireTrackable error");
return;
}
ArTrackableType ar_trackable_type = AR_TRACKABLE_NOT_VALID;
ArTrackable_getType(ar_session, ar_trackable, &ar_trackable_type);
if (ar_trackable_type == AR_TRACKABLE_INSTANT_PLACEMENT_POINT) {
ArInstantPlacementPoint* point = (ArInstantPlacementPoint*)ar_trackable;
// Gets the pose of the Instant Placement point.
ArPose* ar_pose = NULL;
ArPose_create(ar_session, NULL, &ar_pose);
CHECK(ar_pose);
ArInstantPlacementPoint_getPose(ar_session, point, ar_pose);
// Attaches an anchor to the Instant Placement point.
ArAnchor* anchor = NULL;
ArStatus status = ArTrackable_acquireNewAnchor(ar_session, ar_trackable,
ar_pose, &anchor);
ArPose_destroy(ar_pose);
// Render content at the anchor.
// ...
}
ArTrackable_release(ar_trackable);
}
Szybkie miejsce docelowe obsługuje śledzenie przestrzeni ekranu z przybliżoną odległością i automatycznie przełącza się na śledzenie pełnego, gdy punkt w tym miejscu docelowym zostanie zakotwiczony w świecie rzeczywistym. Pobierz bieżącą pozycję za pomocą ArInstantPlacementPoint_getPose().
Pobierz aktualną metodę śledzenia w ArInstantPlacementPoint_getTrackingMethod().
ARCore może przeprowadzać testy w przypadku miejsca docelowego w wyszukiwarce na powierzchniach o dowolnej orientacji, jednak wyniki trafień zawsze zwracają pozycję z +Y u góry, wbrew kierunku grawitacji. Na powierzchniach poziomych testy trafień zwracają dokładne pozycje znacznie szybciej.
Monitorowanie metody śledzenia punktów w błyskawicznym miejscu docelowym
Jeśli ARCore ma dokładną pozę w 3D dla obiektu ArInstantPlacementPoint zwróconego przez ArFrame_hitTestInstantPlacement, zaczyna od metody śledzenia AR_INSTANT_PLACEMENT_POINT_TRACKING_METHOD_FULL_TRACKING. W przeciwnym razie rozpocznie się od metody śledzenia AR_INSTANT_PLACEMENT_POINT_TRACKING_METHOD_SCREENSPACE_WITH_APPROXIMATE_DISTANCE, a potem przejdzie do AR_INSTANT_PLACEMENT_POINT_TRACKING_METHOD_FULL_TRACKING, gdy ARCore wykona odpowiednią pozycję w 3D. Gdy metoda śledzenia zmieni się na AR_INSTANT_PLACEMENT_POINT_TRACKING_METHOD_FULL_TRACKING, nie zostanie przywrócona metoda AR_INSTANT_PLACEMENT_POINT_TRACKING_METHOD_SCREENSPACE_WITH_APPROXIMATE_DISTANCE.
Upraszczanie zmiany metody śledzenia
Gdy metoda śledzenia zmieni się z AR_INSTANT_PLACEMENT_POINT_TRACKING_METHOD_SCREENSPACE_WITH_APPROXIMATE_DISTANCE w jednej klatce na AR_INSTANT_PLACEMENT_POINT_TRACKING_METHOD_FULL_TRACKING w następnej, ujęcie przeskakuje ze swojego początkowego położenia na podstawie podanej przybliżonej odległości do nowej lokalizacji z dokładną odległością. Ta chwilowa zmiana pozycji zmienia pozorną skalę wszystkich obiektów zakotwiczonych w punkcie Ar Instant PlacementPoint. To znaczy, że obiekt nagle wydawał się większy lub mniejszy niż w poprzedniej klatce.
Aby uniknąć skoku wizualnego w wyniku nagłej zmiany skali pozornej obiektu, wykonaj te czynności:
- Śledź pozycję elementu
ArInstantPlacementPointi metodę śledzenia w każdej klatce. - Poczekaj, aż metoda śledzenia zmieni się na
AR_INSTANT_PLACEMENT_POINT_TRACKING_METHOD_FULL_TRACKING. - Użyj pozycji z poprzedniej klatki i pozycji w bieżącej, aby określić odległość obiektu od urządzenia w obu klatkach.
- Oblicz pozorną zmianę skali z powodu zmiany odległości od kamery.
- Dostosuj skalę obiektu, aby przeciwdziałać zauważonej zmianie skali.
- Opcjonalnie możesz płynnie dostosować skalę obiektu do pierwotnej wartości na kilku klatkach.
class WrappedInstantPlacement {
ArInstantPlacementPoint* point;
ArInstantPlacementPointTrackingMethod previous_tracking_method;
float previous_distance_to_camera;
float scale_factor = 1.0f;
public:
WrappedInstantPlacement(ArInstantPlacementPoint* point,
TrackingMethod previous_tracking_method,
float previous_distance_to_camera) {
this.point = point;
this.previous_tracking_method = previous_tracking_method;
this.previous_distance_to_camera = previous_distance_to_camera;
}
};
std::vector<WrappedInstantPlacement> wrapped_points_;
Po utworzeniu punktu dynamicznego miejsca docelowego zmodyfikuj tag OnTouched(), aby go spakować.
if (ar_trackable_type == AR_TRACKABLE_INSTANT_PLACEMENT_POINT) {
ArInstantPlacementPoint* point = (ArInstantPlacementPoint*)ar_trackable;
ArInstantPlacementPointTrackingMethod tracking_method;
ArInstantPlacementPoint_getTrackingMethod(ar_session, point,
&tracking_method);
ArCamera* ar_camera = nullptr;
ArFrame_acquireCamera(ar_session, ar_frame, &ar_camera);
CHECK(ar_camera);
wrapped_points_.push_back(WrappedInstantPlacement(
point, tracking_method, Distance(point, ar_camera)));
}
Gdy metoda śledzenia punktu w błyskawicznym miejscu docelowym zmieni się z AR_INSTANT_PLACEMENT_POINT_TRACKING_METHOD_SCREENSPACE_WITH_APPROXIMATE_DISTANCE na AR_INSTANT_PLACEMENT_POINT_TRACKING_METHOD_FULL_TRACKING, użyj zapisanej odległości, aby przeciwdziałać pozornej zmianie skali.
void OnUpdate() {
for (auto& wrapped_point : wrapped_points_) {
ArInstantPlacementPoint* point = wrapped_point.point;
ArTrackingState tracking_state = AR_TRACKING_STATE_STOPPED;
ArTrackable_getTrackingState(ar_session, (ArTrackable)point,
&tracking_state);
if (tracking_state == AR_TRACKING_STATE_STOPPED) {
wrapped_points_.remove(wrapped_point);
continue;
}
if (tracking_state == AR_TRACKING_STATE_PAUSED) {
continue;
}
ArInstantPlacementPointTrackingMethod tracking_method;
ArInstantPlacementPoint_getTrackingMethod(ar_session, point,
&tracking_method);
ArCamera* ar_camera = nullptr;
ArFrame_acquireCamera(ar_session, ar_frame, &ar_camera);
CHECK(ar_camera);
const float distance_to_camera = Distance(point, ar_camera);
if (tracking_method ==
AR_INSTANT_PLACEMENT_POINT_TRACKING_METHOD_SCREENSPACE_WITH_APPROXIMATE_DISTANCE) {
// Continue to use the estimated depth and pose. Record the distance to
// the camera for use in the next frame if the transition to full
// tracking happens.
wrapped_point.previous_distance_to_camera = distance_to_camera;
} else if (
tracking_method ==
AR_INSTANT_PLACEMENT_POINT_TRACKING_METHOD_FULL_TRACKING &&
wrapped_point.previous_tracking_method ==
AR_INSTANT_PLACEMENT_POINT_TRACKING_METHOD_SCREENSPACE_WITH_APPROXIMATE_DISTANCE) {
// Change from the estimated pose to the accurate pose. Adjust the
// object scale to counteract the apparent change due to pose jump.
wrapped_point.scale_factor =
distance_to_camera / wrapped_point.previous_distance_to_camera;
// Apply the scale factor to the model.
// ...
previous_tracking_method =
AR_INSTANT_PLACEMENT_POINT_TRACKING_METHOD_FULL_TRACKING;
}
}
}
Możliwe spowolnienie działania witryny
Gdy włączone jest wyszukiwanie dynamiczne, ARCore wykorzystuje dodatkowe cykle procesora. Jeśli obawiasz się o skuteczność, rozważ wyłączenie błyskawicznego miejsca docelowego po umieszczeniu przez użytkownika obiektu i zmianie metody śledzenia wszystkich punktów tego typu na AR_INSTANT_PLACEMENT_POINT_TRACKING_METHOD_FULL_TRACKING.
Jeśli błyskawiczne miejsce docelowe jest wyłączone, użyj właściwości ArFrame_hitTest zamiast ArFrame_hitTestInstantPlacement.
ArConfig* ar_config = NULL;
ArConfig_create(ar_session, &ar_config);
// Disable Instant Placement.
ArConfig_setInstantPlacementMode(ar_session, ar_config,
AR_INSTANT_PLACEMENT_MODE_DISABLED);
CHECK(ArSession_configure(ar_session, ar_config) == AR_SUCCESS);
ArConfig_destroy(ar_config);