SpatialStageFrameOfReference 类

定义

命名空间:

Windows.Perception.Spatial

表示一个空间阶段，由用户定义，用于建立他们打算在其中使用混合现实头戴显示设备的物理空间。

public ref class SpatialStageFrameOfReference sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 262144)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class SpatialStageFrameOfReference final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 262144)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class SpatialStageFrameOfReference

Public NotInheritable Class SpatialStageFrameOfReference

继承

Object Platform::Object IInspectable SpatialStageFrameOfReference

属性

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 要求

设备系列	Windows 10 Creators Update (在 10.0.15063.0 中引入)
API contract	Windows.Foundation.UniversalApiContract (在 v4.0 中引入)

注解

空间阶段至少由用户选择的底层坐标系组成，表示他们打算在其中使用其混合现实头戴显示设备的区域的逻辑中心。 此地面坐标系统使应用能够呈现站立缩放体验。

（可选）用户还可以定义移动边界，表示他们打算在使用头戴显示设备时在其中行走的开放区域。 此移动边界使应用能够呈现房间规模体验。

如果用户尚未定义空间阶段，应用可能会调用 RequestNewStageAsync 方法，引导用户通过系统 UI 来定义空间阶段。

在 HoloLens 上，应用还可以使用空间映射构建站立缩放或房间缩放体验。 空间映射使开发人员能够使用 SpatialSurfaceObserver 类型分析用户的环境并确定用户墙壁和楼层的位置，即使用户尚未手动定义阶段也是如此。 检查 SpatialSurfaceObserver.IsSupported 属性以确定当前设备是否支持空间映射。

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

属性

CoordinateSystem	获取位于用户定义的阶段原点处的底层坐标系。
Current	获取当前空间阶段（如果已由用户定义）。
LookDirectionRange	获取用户可以使用头戴显示设备环顾四周的程度。
MovementRange	获取用户在戴上头戴显示设备时可移动的程度。

方法

GetCoordinateSystemAtCurrentLocation(SpatialLocator)	获取位于用户当前位置和方向的底层坐标系。
RequestNewStageAsync()	显示系统 UI，指导用户定义新阶段以替换当前阶段。
TryGetMovementBounds(SpatialCoordinateSystem)	获取用户在使用头戴显示设备时要移动的位置定义的开放区域的边界顶点。

事件

CurrentChanged

当用户更改或重新定义当前空间阶段时发生。

另请参阅

• 全息空间阶段示例