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 属性会获取一个坐标系，你可以使用该系统相对于定位点来放置内容，并在设备调整定位点的确切位置时应用缓动。

使用 RawCoordinateSystem 属性和相应的 RawCoordinateSystemAdjusted 事件来自行管理这些调整。

坐标系是右手的，+y 向上，+x 向右，-z 向前。

版本历史记录

Windows 版本	SDK 版本	增值
1607	14393	RemovedByUser

属性

CoordinateSystem	获取应用缓动调整的定位点的坐标系。
RawCoordinateSystem	获取不应用缓动的定位点的坐标系。
RemovedByUser	获取一个值，该值指示用户是否删除了持久定位点。