SpatialSurfaceInfo 類別

定義

命名空間:

Windows.Perception.Spatial.Surfaces

代表使用者周圍觀察到之表面的中繼資料快照集。

public ref class SpatialSurfaceInfo sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 131072)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class SpatialSurfaceInfo final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 131072)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class SpatialSurfaceInfo

Public NotInheritable Class SpatialSurfaceInfo

繼承

Object Platform::Object IInspectable SpatialSurfaceInfo

屬性

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 需求

裝置系列	Windows 10 (已於 10.0.10586.0 - for Xbox, see UWP features that aren't yet supported on Xbox 引進)
API contract	Windows.Foundation.UniversalApiContract (已於 v2.0 引進)

備註

Mesh 物件包含大型頂點和索引緩衝區，因此，如果您沒有好的理由，它們會非常繁重。 為了有效率地使用轉譯或物理，應用程式應該快取網格，並緩衝它感興趣的物件，以及針對使用者不再運作的區域擲出網格。

您可以使用 SpatialSurfaceObserver 提供給您的 SpatialSurfaceInfo實例集，代表目標周框磁片區中存在的網格，以管理您的快取。

將 Id 和 UpdateTime 屬性相互關聯到多個觀察，可讓您識別新的網格、更新的網格和移除的網格：

• 如果您看到具有您之前未看到識別碼的 SpatialSurfaceInfo，請將它視為新的網格。
• 如果您看到具有已知識別碼的 SpatialSurfaceInfo，但使用新的 UpdateTime，請將它視為已更新的網格。
• 如果您不再看到具有已知識別碼的 SpatialSurfaceInfo，請將它視為已移除的網格。

因為這是快照集，所以 UpdateTime 屬性不會隨著時間而變更。 若要查看此表面的網格是否已更新，或表面是否已移除或移出周框磁片區，請返回 SpatialSurfaceObserver，並呼叫 GetObservedSurfaces 每個框架或處理 ObservedSurfacesChanged 事件。

屬性

Id	取得這個介面的永續性識別碼。
UpdateTime	取得這個介面中繼資料快照集所表示的上次更新時間。

方法

TryComputeLatestMeshAsync(Double)	產生網格物件及其頂點和這個表面的索引緩衝區。 這會選擇未超過指定三角形密度的最詳細網格，以每立方公尺的三角形為單位。
TryComputeLatestMeshAsync(Double, SpatialSurfaceMeshOptions)	使用指定的網格產生選項，產生網格物件及其頂點和索引緩衝區。 這會選擇未超過指定三角形密度的最詳細網格，以每立方公尺的三角形為單位。
TryGetBounds(SpatialCoordinateSystem)	取得這個表面的界限，以指定的座標系統表示。

另請參閱

• 全像攝影空間對應範例