Streetscape Geometry API 提供场景中地形、建筑物或其他结构的几何图形。该几何图形可用于通过命中测试 API 遮挡、渲染或放置 AR 内容。Streetscape Geometry 数据通过 Google 街景图像获取。
设置 Geospatial API
如需使用 Streetscape Geometry,您需要在项目中设置 Geospatial API。 请按照启用 Geospatial API 中的说明设置 Geospatial API。
启用街景几何图形
当 ArGeospatialMode
设置为 ArGeospatialModeEnabled
且 ArStreetscapeGeometryMode
设置为 ArStreetscapeGeometryModeEnabled
时,Geospatial API 会获取 Streetscape Geometry 数据。
// Create a session config. ArConfig* ar_config = NULL; ArConfig_create(ar_session, &ar_config); // Enable the Geospatial API. ArConfig_setGeospatialMode(ar_session, ar_config, AR_GEOSPATIAL_MODE_ENABLED); CHECK(ArSession_configure(ar_session, ar_config) == AR_SUCCESS); // Enable Streetscape Geometry. ArConfig_setStreetscapeGeometryMode(ar_session, ar_config, AR_STREETSCAPE_GEOMETRY_MODE_ENABLED); CHECK(ArSession_configure(ar_session, ar_config) == AR_SUCCESS); // Release config resources. ArConfig_destroy(ar_config);
在 ARCore 会话中获取 Streetscape Geometry
使用ArSession_getAllTrackables()
并使用 AR_TRACKABLE_STREETSCAPE_GEOMETRY
过滤结果。
ArTrackableList* trackable_list = NULL; ArTrackableList_create(ar_session, &trackable_list); ArSession_getAllTrackables(ar_session, AR_TRACKABLE_STREETSCAPE_GEOMETRY, trackable_list);
了解ArStreetscapeGeometry
ArStreetscapeGeometry
包含有关建筑物的信息:
-
ArStreetscapeGeometry_getType()
将 StreetscapeGeometry 标识为地形或建筑物。 -
ArStreetscapeGeometry_acquireMesh()
获取与此地形或建筑物对应的多边形ArMesh
。 -
ArStreetscapeGeometry_getMeshPose()
描述几何图形的原点。ArMesh
中的所有点都应通过ArStreetscapeGeometry_getMeshPose()
转换。 -
ArStreetscapeGeometry_getQuality()
提供网格数据的质量。详细级别在 CityGML 2.0 标准中进行了介绍。
建筑物 LOD 1
AR_STREETSCAPE_GEOMETRY_QUALITY_BUILDING_LOD_1
由向上凸出到平顶的建筑物底部组成。建筑物高度可能不准确。
建筑物 LOD 2
AR_STREETSCAPE_GEOMETRY_QUALITY_BUILDING_LOD_2
的几何图形具有较高的保真度。网格墙和屋顶将更贴近建筑物的形状。烟囱或屋顶通风口等小特征仍可能会戳到网格之外。
了解ArMesh
ArMesh
是一个多边形网格,表示街景几何图形的表面重建。
每个 ArMesh
都包含一个顶点缓冲区和索引缓冲区:
ArMesh_getVertexListSize()
检索此网格中的顶点数。ArMesh_getVertexList()
获取网格顶点的串联位置(在相对于ArStreetscapeGeometry_getMeshPose()
的坐标中)。ArMesh_getIndexListSize()
检索此网格中的索引数量。ArMesh_getIndexList()
获取构成面的顶点的索引。
将 AR 内容附加到 ArStreetscapeGeometry
您可以通过以下两种方式将 AR 内容附加到 Streetscape Geometry:
- 启用地理空间深度,并使用深度命中测试。这是更简单的推荐方法。
- 使用
ArTrackable_acquireNewAnchor()
在附加到ArStreetscapeGeometry
的给定姿势处创建锚点。此锚点将继承父级ArStreetscapeGeometry
的跟踪状态。
对 ArStreetscapeGeometry
执行点击测试
ArFrame_hitTest
可用于针对 Streetscape Geometry 进行点击测试。如果找到交叉路口,ArHitResult
将包含有关命中位置的姿势信息,以及对命中的 ArStreetscapeGeometry
的引用。可以将此街景几何图形传递给 ArTrackable_acquireNewAnchor()
,以创建附加到它的锚点。
ArHitResultList *hit_result_list = NULL; ArHitResult *hit_result = NULL; ArHitResultList_create(ar_session, &hit_result_list); ArHitResult_create(ar_session, &hit_result); ArFrame_hitTestRay(ar_session, ar_frame, origin, direction, hit_result_list); ArHitResultList_getItem(ar_session, hit_result_list, 0, hit_result); ArAnchor *out_anchor = NULL; ArStatus status = ArHitResult_acquireNewAnchor(ar_session, hit_result, &out_anchor); CHECK(status == AR_SUCCESS);
启用地理空间深度
地理空间深度可将街景几何图形与本地传感器输入相结合,从而增强深度数据。启用地理空间深度后,系统会修改输出深度和原始深度图像,以便除了本地观测的深度之外,还包含光栅化 Streetscape Geometry。这可以使用深度来提高姿势的准确性。