SpatialStageFrameOfReference 類別

定義

命名空間:

Windows.Perception.Spatial

代表由使用者定義的空間階段，以建立他們想要使用Mixed Reality頭戴式裝置的實體空間。

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

備註

空間階段是由使用者選擇其原點的樓層層級座標系統所組成，代表他們想要使用其Mixed Reality頭戴式裝置的區域邏輯中心。 此樓層層級座標系統可讓應用程式呈現常設規模體驗。

或者，使用者也可以定義移動界限，代表他們想要在使用頭戴式裝置時逐步執行所在的開啟區域。 此移動界限可讓應用程式呈現會議室規模體驗。

如果使用者尚未定義空間階段，應用程式可能會呼叫 RequestNewStageAsync 方法來引導使用者完成系統 UI，以允許他們定義一個。

在 HoloLens 上，應用程式也可以使用空間對應來建置常設規模或會議室規模體驗。 空間對應可讓開發人員分析使用者的環境，並使用 SpatialSurfaceObserver 類型判斷使用者牆和樓層的位置，即使使用者尚未手動定義階段也一樣。 檢查 SpatialSurfaceObserver.IsSupported 屬性，以判斷目前裝置是否支援空間對應。

階段傳回的座標系統是右手，右邊為 +y up、+x，以及 -z 向前。

屬性

CoordinateSystem	取得位於使用者所定義階段原點的樓層層級座標系統。
Current	如果使用者已定義目前的空間階段，則取得目前的空間階段。
LookDirectionRange	取得使用者可以使用頭戴式裝置查看的範圍。
MovementRange	取得使用者可以在戴上頭戴式裝置時移動的範圍。

方法

GetCoordinateSystemAtCurrentLocation(SpatialLocator)	取得位於使用者目前位置和方向的樓層層級座標系統。
RequestNewStageAsync()	顯示系統 UI，以引導使用者定義新階段來取代目前的階段。
TryGetMovementBounds(SpatialCoordinateSystem)	取得使用者想要在使用頭戴式裝置時移動之開啟區域的界限頂點。

事件

CurrentChanged

發生于使用者變更或重新定義目前空間階段時。

另請參閱

• 全像攝影空間階段範例