Condividi tramite


SpatialStageFrameOfReference Classe

Definizione

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 SpatialStageFrameOfReference
Public NotInheritable Class SpatialStageFrameOfReference
Ereditarietà
Object Platform::Object IInspectable SpatialStageFrameOfReference
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.

Si applica a

Vedi anche