SpatialAnchor 类

定义

表示一个坐标系,该坐标系强定位到用户周围环境中的某个点。

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
属性

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

获取一个值,该值指示用户是否删除了持久定位点。

方法

TryCreateRelativeTo(SpatialCoordinateSystem)

在指定坐标系的原点处创建定位点。

TryCreateRelativeTo(SpatialCoordinateSystem, Vector3)

在指定坐标系中的特定位置创建定位点。

TryCreateRelativeTo(SpatialCoordinateSystem, Vector3, Quaternion)

在指定坐标系内的特定位置和方向创建定位点。

如果系统已达到空间定位点的限制,则返回 null。 如果指定的坐标系无法定位到此帧,也可能返回 null。

事件

RawCoordinateSystemAdjusted

当设备调整定位点的精确位置时发生,这会更新 RawCoordinateSystem

适用于