将应用设置配置为使用 Geospatial API 后,可以调用 ArEarth_getCameraGeospatialPose
来获取 ArGeospatialPose
,用于描述设备在最新一帧中的相机地理空间定位。该姿势在 ArEarth
对象中管理,包含以下信息:
- 位置,以纬度和经度表示
- 海拔高度
- 在 EUS 坐标系中近似用户所面向的方向,其中 X+ 指向东,Y+ 指向上,Z+ 指向南
检查跟踪状态
仅当 ArEarth.ArTrackingState
为 ArTrackingState.AR_TRACKING_STATE_TRACKING
且 ArEarth.ArEarthState
为 AR_EARTH_STATE_ENABLED
时,地理空间值才有效。请确保将所有 Geospatial API 调用封装在 ArEarth.ArTrackingState
控件块中。
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); } }
如果 ArEarth.ArTrackingState
未变为 ArTrackingState.AR_TRACKING_STATE_TRACKING
,则 ArEarth.ArTrackingState
可以是 AR_TRACKING_STATE_PAUSED
或 AR_TRACKING_STATE_STOPPED
。如果这两个条件均不满足,请检查 ArEarth.ArEarthState
,其中会显示可能会阻止跟踪 ArEarth
对象的其他错误状态。
调整姿势准确性
当设备在默认屏幕方向时竖直时,由于与 AR 跟踪自然对齐,因此俯仰角 (X+) 和侧倾角 (Z+) 往往非常精确。但是,偏摆 (Y+) 角度可能会因 VPS 数据可用性和该位置的时间条件而异。您的应用可能必须进行调整以确保准确性。
ArGeospatialPose_getOrientationYawAccuracy()
提供特定 ArGeospatialPose
的偏摆 (Y+) 角的准确度估算值。方向偏航精确度是一个数字,用于描述围绕从 ArGeospatialPose_getEastUpSouthQuaternion()
返回的偏航角的第 68 个百分位置信水平的半径(以度为单位)。也就是说,ArGeospatialPose
的真实偏摆角有 68% 的可能性是准确的。
值越大,表示准确率越低。例如,如果估算偏航角为 60 度,偏航精确度为 10 度,则真实偏航角介于 50 度和 70 度之间的概率为 68%。
后续步骤
- 通过获取锚点的地理空间姿势来放置地理空间锚点。