Raumbezogene Haltung der Gerätekamera erfassen

Nachdem Sie Ihre App-Einstellungen für die Verwendung der Geospatial API konfiguriert haben, können Sie ArEarth_getCameraGeospatialPose aufrufen, um ein ArGeospatialPose-Objekt zu erhalten, das die raumbezogene Positionierung des Geräts für die Kamera im neuesten Frame beschreibt. Diese Haltung wird in einem ArEarth-Objekt verwaltet und enthält die folgenden Informationen:

  • Standort in Breiten- und Längengrad
  • Höhe
  • Eine Ausrichtung, die annähernd die Richtung des Nutzers im EUS-Koordinatensystem darstellt, mit X+ nach Osten, Y+ nach oben und Z+ nach Süden

Tracking-Status prüfen

Raumbezogene Werte sind nur gültig, wenn ArEarth.ArTrackingState den Wert ArTrackingState.AR_TRACKING_STATE_TRACKING und ArEarth.ArEarthState AR_EARTH_STATE_ENABLED hat. Alle Geospatial API-Aufrufe müssen in einem ArEarth.ArTrackingState-Steuerelementblock zusammengefasst sein.

if (ar_earth != NULL) {
  ArTrackingState earth_tracking_state = AR_TRACKING_STATE_STOPPED;
  ArTrackable_getTrackingState(ar_session, (ArTrackable*)ar_earth,
                               &earth_tracking_state);
  if (earth_tracking_state == AR_TRACKING_STATE_TRACKING) {
    ArGeospatialPose* camera_geospatial_pose = NULL;
    ArGeospatialPose_create(ar_session, &camera_geospatial_pose);
    ArEarth_getCameraGeospatialPose(ar_session, ar_earth,
                                    camera_geospatial_pose);
    // camera_geospatial_pose contains geodetic location, rotation, and
    // confidences values.
    ArGeospatialPose_destroy(camera_geospatial_pose);
  }
}

Wenn aus ArEarth.ArTrackingState nicht ArTrackingState.AR_TRACKING_STATE_TRACKING wird, kann ArEarth.ArTrackingState AR_TRACKING_STATE_PAUSED oder AR_TRACKING_STATE_STOPPED sein. Wenn keine dieser Bedingungen erfüllt ist, prüfen Sie ArEarth.ArEarthState. Dadurch werden andere Fehlerstatus angezeigt, die das Tracking des ArEarth-Objekts möglicherweise verhindern.

Für mehr Genauigkeit die Haltung anpassen

Wenn das Gerät in der Standardausrichtung aufrecht steht, sind die Neigungswinkel (X+) und Rollwinkel (Z+) aufgrund der natürlichen Ausrichtung mit dem AR-Tracking tendenziell präzise. Der Gierwinkel (Y+) kann jedoch je nach Verfügbarkeit der VPS-Daten und den zeitlichen Bedingungen am Standort variieren. Damit die App richtig funktioniert, müssen möglicherweise Anpassungen vorgenommen werden.

ArGeospatialPose_getOrientationYawAccuracy() liefert eine Genauigkeitsschätzung für die Gierwinkel (Y+) für einen bestimmten ArGeospatialPose. Die Giergenauigkeit der Ausrichtung ist eine Zahl, die den Radius des Konfidenzniveaus des 68. Perzentils um die von ArGeospatialPose_getEastUpSouthQuaternion() zurückgegebenen Gierwinkel in Grad angibt. Mit anderen Worten: Es besteht eine Wahrscheinlichkeit von 68 %, dass der tatsächliche Gierwinkel von ArGeospatialPose genau ist.

Größere Werte weisen auf eine geringere Genauigkeit hin. Wenn der geschätzte Gierwinkel beispielsweise 60 Grad und die Giergenauigkeit 10 Grad beträgt, besteht eine Wahrscheinlichkeit von 68 %, dass der tatsächliche Gierwinkel zwischen 50 und 70 Grad liegt.

Nächste Schritte