SpatialAnchor クラス

リファレンス

定義

名前空間:: Windows.Perception.Spatial

重要

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

編集

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

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	永続化されたアンカーがユーザーによって削除されたかどうかを示す値を取得します。