SpatialAnchor クラス

定義

名前空間:

Windows.Perception.Spatial

ユーザーの周囲のポイントに厳密に固定されている座標系を表します。

public ref class SpatialAnchor 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 SpatialAnchor 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 SpatialAnchor

Public NotInheritable Class SpatialAnchor

継承

Object Platform::Object IInspectable SpatialAnchor

属性

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

注釈

SpatialAnchor は、選択した SpatialCoordinateSystem 内の任意の位置と向きで作成できます。 デバイスは、その時点のその座標系を特定できる機能を持っている必要があり、システムは、空間アンカーの制限に達していない必要があります。

定義すると、SpatialAnchor の座標系は、最初の位置の正確な位置と向きを維持するように継続的に調整されます。 その後、この SpatialAnchor を使用してホログラムをレンダリングすると、ホログラムは、ユーザーの周囲で、まさしくその場所に固定されているかのように現れます。

この調整には、アンカーを所定の場所に維持する効果があり、アンカーから離れれば離れるほど、その効果は増大します。 アンカーの原点から 3 メートルを超えるアンカーに対する相対的なコンテンツのレンダリングは避ける必要があります。

SpatialAnchorStore クラスを使用して SpatialAnchor を永続化し、後でアプリ セッションに戻すことができます。

CoordinateSystem プロパティでは、アンカーを基準としてコンテンツを配置できる座標系を取得します。デバイスでアンカーの正確な場所を調整する場合は、イージングが適用されます。

RawCoordinateSystem プロパティと、それに対応するRawCoordinateSystemAdjusted イベントを使用して、これらの調整を自分で管理します。

座標系は右利きで、+y を上に、+x を右に、-z を前方に指定します。

バージョン履歴

Windows のバージョン	SDK バージョン	追加された値
1607	14393	RemovedByUser

プロパティ

CoordinateSystem	イージング調整が適用されたアンカーの座標系を取得します。
RawCoordinateSystem	イージングを適用せずにアンカーの座標系を取得します。
RemovedByUser	永続化されたアンカーがユーザーによって削除されたかどうかを示す値を取得します。

メソッド

TryCreateRelativeTo(SpatialCoordinateSystem)	指定した座標系の原点にアンカーを作成します。
TryCreateRelativeTo(SpatialCoordinateSystem, Vector3)	指定した座標系内の特定の位置にアンカーを作成します。
TryCreateRelativeTo(SpatialCoordinateSystem, Vector3, Quaternion)	指定した座標系内の特定の位置と向きにアンカーを作成します。 システムが空間アンカーの制限に達した場合、null を返すことができます。 指定した座標系をこのフレームに配置できない場合は、null を返す場合もあります。

イベント

RawCoordinateSystemAdjusted

デバイスがアンカーの正確な位置を調整したときに発生し、 RawCoordinateSystem が更新されます。