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 引進)

備註

您可以在您選擇的 SpatialCoordinateSystem 內的任何位置和方向建立 SpatialAnchor。裝置目前必須能夠找出該座標系統，而且系統不得達到空間錨點的限制。

定義之後，SpatialAnchor 的座標系統會持續調整，以保留其初始位置的精確位置和方向。然後，您可以使用這個 SpatialAnchor 來轉譯全像投影，這些全像投影會出現在該確切位置的使用者周圍。

調整讓錨點就地調整的效果會隨著錨點的距離增加而放大。您應該避免呈現相對於該錨點來源超過 3 公尺的錨點內容。

您可以使用 SpatialAnchorStore 類別來保存 SpatialAnchor ，然後在未來的應用程式會話中恢復它。

CoordinateSystem屬性會取得座標系統，可讓您在裝置調整錨點的精確位置時，放置相對於錨點的內容，並套用 easing。

使用 RawCoordinateSystem 屬性和對應的 RawCoordinateSystemAdjusted 事件自行管理這些調整。

座標系統是右手的，右邊是 +y 向上、+x，以及 -z 向前。

版本歷程記錄

Windows 版本	SDK 版本	已新增值
1607	14393	RemovedByUser

屬性

CoordinateSystem	取得錨點的座標系統，並套用 easing 調整。
RawCoordinateSystem	取得錨點的座標系統，而不套用 easing。
RemovedByUser	取得值，指出使用者是否已移除保存的錨點。