SpatialStageFrameOfReference Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Rappresenta una fase spaziale definita dall'utente per stabilire lo spazio fisico in cui intende usare un visore Realtà mista.
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- Ereditarietà
- Attributi
Requisiti Windows
| Famiglia di dispositivi |
Windows 10 Creators Update (è stato introdotto in 10.0.15063.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (è stato introdotto in v4.0)
|
Commenti
Una fase spaziale è costituita minimamente da un sistema di coordinate a livello di piano la cui origine viene scelta dall'utente, che rappresenta il centro logico dell'area in cui intende usare il visore visore Realtà mista. Questo sistema di coordinate a livello di piano consente alle app di presentare esperienze su larga scala.
Facoltativamente, l'utente può anche definire un limite di movimento, che rappresenta l'area aperta in cui intende camminare durante l'uso del visore. Questo limite di spostamento consente alle app di presentare esperienze su larga scala.
Se l'utente non ha definito una fase spaziale, un'app può chiamare il metodo RequestNewStageAsync per guidare l'utente tramite l'interfaccia utente di sistema che consentirà di definirne una.
In HoloLens un'app può anche creare esperienze su larga scala o su scala locale usando il mapping spaziale. Il mapping spaziale consente allo sviluppatore di analizzare l'ambiente dell'utente e determinare le posizioni delle pareti e dei piani dell'utente usando il tipo SpatialSurfaceObserver , anche se l'utente non ha definito manualmente una fase. Esaminare la proprietà SpatialSurfaceObserver.IsSupported per determinare se il dispositivo corrente supporta il mapping spaziale.
I sistemi di coordinate restituiti dalla fase sono a destra, con +y su, +x a destra e -z avanti.
Proprietà
| CoordinateSystem |
Ottiene un sistema di coordinate a livello di piano situato all'origine della fase definita dall'utente. |
| Current |
Ottiene la fase spaziale corrente, se è stata definita dall'utente. |
| LookDirectionRange |
Ottiene l'entità in cui l'utente può guardare intorno con il visore visore. |
| MovementRange |
Ottiene la misura in cui l'utente può spostarsi mentre indossa il visore. |
Metodi
| GetCoordinateSystemAtCurrentLocation(SpatialLocator) |
Ottiene un sistema di coordinate a livello di piano in corrispondenza della posizione e dell'orientamento corrente dell'utente. |
| RequestNewStageAsync() |
Mostra l'interfaccia utente di sistema per guidare l'utente nella definizione di una nuova fase per sostituire la fase corrente. |
| TryGetMovementBounds(SpatialCoordinateSystem) |
Ottiene i vertici limite dell'area aperta definita dall'utente in cui intende spostarsi durante l'uso del visore. |
Eventi
| CurrentChanged |
Si verifica quando l'utente cambia o ridefinisce la fase spaziale corrente. |