在 Android NDK (C) 上使用您周遭的建築物和地形

Streetscape Geometry API 提供場景中地形、建築物或其他結構結構的幾何圖形。幾何圖形可用於透過點擊測試 API 進行遮蔽、算繪，或放置 AR 內容。街景服務幾何圖形資料是透過 Google 街景服務圖像取得。

設定地理空間 API

如要使用 Streetscape 幾何圖形，您必須在專案中設定 Geospatial API。 請按照啟用地理空間 API 的操作說明設定 Geospatial API。

啟用街景幾何圖形

當 ArGeospatialMode 設為 ArGeospatialModeEnabled 且 ArStreetscapeGeometryMode 設為 ArStreetscapeGeometryModeEnabled 時，Geospatial API 會取得街景幾何圖形資料。

// 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 幾何圖形

使用 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 幾何圖形的方法有兩種：

• 啟用「地理空間深度」並使用 Depth 命中測試。這是建議操作更簡單的方法。
• 使用 ArTrackable_acquireNewAnchor() 為附加至 ArStreetscapeGeometry 的特定姿勢建立錨點。這個錨定標記會沿用父項 ArStreetscapeGeometry 的追蹤狀態。

對 ArStreetscapeGeometry 執行命中測試

ArFrame_hitTest 可用於對 Streetscape 幾何圖形進行測試。如果有交集，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);

啟用地理空間深度

地理空間深度結合街景幾何圖形與本機感應器輸入資料，有效提升深度資料。啟用地理空間深度後，系統會修改輸出深度和原始深度圖片，藉此納入光柵化的街景幾何圖形，以及當地的觀測深度。這有助於提高姿勢使用深度。