SpatialStageFrameOfReference 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
代表由使用者定義的空間階段，以建立他們想要使用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 SpatialStageFrameOfReferencePublic NotInheritable Class SpatialStageFrameOfReference- 繼承
- 屬性
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 |
發生于使用者變更或重新定義目前空間階段時。 |