SpatialStageFrameOfReference クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
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 SpatialStageFrameOfReferencePublic NotInheritable Class SpatialStageFrameOfReference- 継承
- 属性
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 |
ユーザーが現在の空間ステージを変更または再定義したときに発生します。 |