SpatialLocator クラス

リファレンス

定義

名前空間:: Windows.Perception.Spatial

重要

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

編集

HoloLens やその他のMixed Reality ヘッドセットなど、ユーザーの周囲を基準にして追跡されるデバイスの場所へのアクセスを提供します。

public ref class SpatialLocator sealed

/// [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 SpatialLocator final

[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 SpatialLocator

Public NotInheritable Class SpatialLocator

継承: Object Platform::Object IInspectable SpatialLocator

属性: 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 で導入)

注釈

SpatialLocator クラスは、ユーザーの周囲に対する相対的な位置と向きを Windows で追跡できるデバイスを表します。 SpatialLocator インスタンスは、ロケーターにアタッチされた、静止した参照フレームのソースです。 HoloLens などのMixed Reality ヘッドセットでは、これらの参照フレームをホログラフィックレンダリングや、デバイスの周りの世界の表面を推論するために使用できます。

プロパティ

Locatability

デバイスの空間位置情報システムの現在の状態を取得します。

メソッド

CreateAttachedFrameOfReferenceAtCurrentHeading()	現在の向きを固定見出しとして、この SpatialLocator に位置的にアタッチされた参照フレームを作成します。
CreateAttachedFrameOfReferenceAtCurrentHeading(Vector3)	現在の方向を固定の見出しとして、原点オフセットを指定した相対位置で、この SpatialLocator に位置的にアタッチされる参照フレームを作成します。
CreateAttachedFrameOfReferenceAtCurrentHeading(Vector3, Quaternion)	現在の向きを固定の見出しとして、原点オフセットを使用して、指定された相対位置と方向で回転して、この SpatialLocator に位置的にアタッチされる参照フレームを作成します。
CreateAttachedFrameOfReferenceAtCurrentHeading(Vector3, Quaternion, Double)	現在の方向に対して指定された見出しをラジアンで指定し、指定された相対位置と方向による原点オフセットを使用して、この SpatialLocator に位置的にアタッチされる参照フレームを作成します。
CreateStationaryFrameOfReferenceAtCurrentLocation()	SpatialLocator の現在の位置に最初の原点を持つ、ユーザーの周囲を基準にして静止したままの参照フレームを作成します。
CreateStationaryFrameOfReferenceAtCurrentLocation(Vector3)	SpatialLocator の現在の位置から指定したオフセットに最初の原点を持つ、ユーザーの周囲を基準にして静止した状態を維持する参照フレームを作成します。
CreateStationaryFrameOfReferenceAtCurrentLocation(Vector3, Quaternion)	SpatialLocator の現在の位置から指定したオフセットで最初の原点を持ち、ユーザーの周囲を基準にして静止したままの参照フレームを作成し、指定した回転位置で回転します。
CreateStationaryFrameOfReferenceAtCurrentLocation(Vector3, Quaternion, Double)	指定した相対見出しに沿って SpatialLocator の現在の位置からの指定したオフセットに基づいて、ユーザーの周囲を基準にして静止した状態で、その最初の原点をラジアン単位で作成し、指定した回転位置で回転する参照フレームを作成します。
GetDefault()	ユーザーの周囲を基準にして、HoloLens などの現在のデバイスの場所を追跡する SpatialLocator インスタンスを取得します。
TryLocateAtTimestamp(PerceptionTimestamp, SpatialCoordinateSystem)	指定したタイムスタンプでのデバイスの場所を表す SpatialLocation を返します。内の座標は、指定された座標系を基準にして表されます。指定したタイムスタンプでその座標系にデバイスを配置できない場合、戻り値は null になります。これは、たとえば、デバイスが追跡を失ったときに発生する可能性があります。

イベント

LocatabilityChanged	空間ロケーションシステムの状態が変化したときに発生します。
PositionalTrackingDeactivating	非アクティブが原因でデバイスの空間位置情報システムが非アクティブ化されているときに発生します。

適用対象

こちらもご覧ください

タグに沿ったホログラムのサンプル

次の方法で共有