SpatialSurfaceObserver 類別

定義

命名空間:

Windows.Perception.Spatial.Surfaces

提供在使用者周圍觀察表面的方法。

public ref class SpatialSurfaceObserver sealed

/// [Windows.Foundation.Metadata.Activatable(131072, "Windows.Foundation.UniversalApiContract")]
/// [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 SpatialSurfaceObserver final

[Windows.Foundation.Metadata.Activatable(131072, "Windows.Foundation.UniversalApiContract")]
[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 SpatialSurfaceObserver

function SpatialSurfaceObserver()

Public NotInheritable Class SpatialSurfaceObserver

繼承

Object Platform::Object IInspectable SpatialSurfaceObserver

屬性

ActivatableAttribute 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 引進)
應用程式功能	spatialPerception

備註

空間對應可讓您的應用程式瞭解使用者周圍表面的形狀和位置。

透過 HoloLens 之類的裝置上的感應器，Windows 會在大型立方體形狀的磁片區中產生 3D 三角形網格。 隨著時間，Windows 可改善您對周圍環境的瞭解，因此會產生新的表面磁片區，並使用新的網格來更新現有的磁片區。 有時候，當系統在儲存體不足時，也可以終結表面磁片區。

您可以透過表示對空間量、周框方塊、周框 Frustum 或周框球區感興趣來存取這些表面。 Windows 會更新，讓您知道觀察到的磁片區中的一組表面已變更，每個表面磁片區都會由識別碼識別，以及其上次更新的時間。 藉由推論此一組觀察到表面中繼資料的變更，您可以偵測新的網格、更新的網格，以及隨著時間移除的網格。

版本歷程記錄

Windows 版本	SDK 版本	新增值
1703	15063	IsSupported

建構函式

SpatialSurfaceObserver()

初始化 SpatialSurfaceObserver 類別的新實例。

方法

GetObservedSurfaces()	取得目前在周框磁片區內觀察到之一組表面的中繼資料。
IsSupported()	取得目前系統上是否支援空間對應。
RequestAccessAsync()	要求應用程式存取權以使用空間對應。 這需要 spatialPerception 功能。
SetBoundingVolume(SpatialBoundingVolume)	設定這個觀察者會追蹤新、更新或移除表面的單一周框磁片區。
SetBoundingVolumes(IIterable<SpatialBoundingVolume>)	設定此觀察者會追蹤新、更新或移除表面的周框磁片區清單。

事件

ObservedSurfacesChanged

發生于周框磁片區內觀察到的介面元資料集已變更時。

另請參閱

• 全像攝影空間對應範例