SpatialStageFrameOfReference クラス

定義

名前空間:

Windows.Perception.Spatial

Mixed Reality ヘッドセットを使用する物理空間を確立するためにユーザーによって定義される空間ステージを表します。

public ref class SpatialStageFrameOfReference sealed

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

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

Public NotInheritable Class SpatialStageFrameOfReference

継承

Object Platform::Object IInspectable SpatialStageFrameOfReference

属性

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows の要件

デバイス ファミリ	Windows 10 Creators Update (10.0.15063.0 で導入)
API contract	Windows.Foundation.UniversalApiContract (v4.0 で導入)

注釈

空間ステージは、ユーザーが原点を選択するフロア レベルの座標系で最小限に構成され、Mixed Reality ヘッドセットを使用するエリアの論理中心を表します。 このフロア レベルの座標系により、アプリは立ち上がりスケールのエクスペリエンスを表示できます。

必要に応じて、ユーザーは、ヘッドセットの使用中に歩く予定の開いた領域を表す移動境界を定義することもできます。 この移動境界により、アプリは部屋規模のエクスペリエンスを表示できます。

ユーザーが空間ステージを定義していない場合、アプリは RequestNewStageAsync メソッドを呼び出して、ユーザーがシステム UI を通じてそれを定義できるようにする可能性があります。

HoloLens では、アプリで空間マッピングを使用して、永続的または部屋規模のエクスペリエンスを構築することもできます。 空間マッピングを使用すると、開発者は、ユーザーがステージを手動で定義していない場合でも、 SpatialSurfaceObserver 型を使用してユーザーの周囲を分析し、ユーザーの壁と床の場所を決定できます。 SpatialSurfaceObserver.IsSupported プロパティを調べて、現在のデバイスが空間マッピングをサポートしているかどうかを判断します。

ステージによって返される座標系は右利きで、+y は上、右に +x、-z は前方に表示されます。

プロパティ

CoordinateSystem	ユーザーによって定義されたステージの原点にあるフロア レベルの座標系を取得します。
Current	ユーザーによって定義されている場合は、現在の空間ステージを取得します。
LookDirectionRange	ユーザーがヘッドセットを使用して見回すことができる範囲を取得します。
MovementRange	ヘッドセットの装着中にユーザーが移動できる範囲を取得します。

メソッド

GetCoordinateSystemAtCurrentLocation(SpatialLocator)	ユーザーの現在の位置と向きのフロア レベルの座標系を取得します。
RequestNewStageAsync()	現在のステージを置き換える新しいステージを定義する際にユーザーをガイドするシステム UI を示します。
TryGetMovementBounds(SpatialCoordinateSystem)	ヘッドセットの使用中に移動するユーザーによって定義された、開いている領域の境界頂点を取得します。

イベント

CurrentChanged

ユーザーが現在の空間ステージを変更または再定義したときに発生します。

こちらもご覧ください

• ホログラフィック空間ステージのサンプル