SpatialSurfaceObserver クラス

リファレンス

定義

名前空間:: Windows.Perception.Spatial.Surfaces

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

編集

ユーザーの周囲のサーフェスを観察するためのメソッドを提供します。

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

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

適用対象

こちらもご覧ください

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

次の方法で共有