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 が周囲の理解を深めるにつれて、新しいサーフェス ボリュームが生成され、既存のボリュームが新しいメッシュで更新されます。 場合によっては、ストレージでシステムの実行が少ない場合にも、サーフェス ボリュームが破棄される可能性があります。

これらのサーフェスにアクセスするには、境界ボックス、境界錐台、または境界球のいずれかの空間のボリュームに関心を表します。 Windows では、観察されたボリューム内のサーフェスのセットが変更され、各サーフェス ボリュームが ID で識別され、最後の更新時刻がいつ変わったかが通知されます。 この一連の観察されたサーフェス メタデータの変更を推論することで、新しいメッシュ、更新されたメッシュ、および削除されたメッシュを経時的に検出できます。

バージョン履歴

Windows のバージョン	SDK バージョン	追加された値
1703	15063	Issupported

コンストラクター

SpatialSurfaceObserver()

SpatialSurfaceObserver クラスの新しいインスタンスを初期化します。

メソッド

GetObservedSurfaces()	現在の境界ボリューム内で観察されるサーフェスのセットのメタデータを取得します。
IsSupported()	現在のシステムで空間マッピングがサポートされているかどうかを取得します。
RequestAccessAsync()	空間マッピングを使用するようにアプリのアクセスを要求します。 これには spatialPerception 機能が必要です。
SetBoundingVolume(SpatialBoundingVolume)	このオブザーバーが新規、更新、または削除されたサーフェスに対して追跡する単一境界ボリュームを設定します。
SetBoundingVolumes(IIterable<SpatialBoundingVolume>)	このオブザーバーが新規、更新、または削除されたサーフェスについて追跡する境界ボリュームの一覧を設定します。

イベント

ObservedSurfacesChanged

境界ボリューム内で観察されるサーフェス メタデータのセットが変更されたときに発生します。

こちらもご覧ください

• ホログラフィック空間マッピングのサンプル