SpatialStageFrameOfReference Clase

Definición

Representa una fase espacial definida por el usuario para establecer el espacio físico en el que piensa usar un casco de 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
Herencia
Object Platform::Object IInspectable SpatialStageFrameOfReference
Atributos

Requisitos de Windows

Familia de dispositivos
Windows 10 Creators Update (se introdujo en la versión 10.0.15063.0)
API contract
Windows.Foundation.UniversalApiContract (se introdujo en la versión v4.0)

Comentarios

Una fase espacial consta mínimamente de un sistema de coordenadas de nivel de piso cuyo origen lo elige el usuario, que representa el centro lógico del área en la que piensan usar sus cascos de Mixed Reality. Este sistema de coordenadas de nivel de planta permite a las aplicaciones presentar experiencias de escala permanente.

Opcionalmente, el usuario también puede definir un límite de movimiento, que representa el área abierta en la que piensa caminar mientras usa el casco. Este límite de movimiento permite a las aplicaciones presentar experiencias de escalado de salas.

Si el usuario no ha definido una fase espacial, una aplicación puede llamar al método RequestNewStageAsync para guiar al usuario a través de la interfaz de usuario del sistema que les permitirá definir una.

En HoloLens, una aplicación también puede crear experiencias de escalado permanente o de escala de sala mediante la asignación espacial. La asignación espacial permite al desarrollador analizar el entorno del usuario y determinar las ubicaciones de las paredes y pisos del usuario mediante el tipo SpatialSurfaceObserver , incluso si el usuario no ha definido manualmente una fase. Inspeccione la propiedad SpatialSurfaceObserver.IsSupported para determinar si el dispositivo actual admite la asignación espacial.

Los sistemas de coordenadas devueltos por la fase son a la derecha, con +y arriba, +x a la derecha y -z hacia delante.

Propiedades

CoordinateSystem

Obtiene un sistema de coordenadas de nivel de planta ubicado en el origen de fase definido por el usuario.

Current

Obtiene la fase espacial actual, si el usuario ha definido una.

LookDirectionRange

Obtiene la medida en la que el usuario puede buscar con sus auriculares.

MovementRange

Obtiene la medida en que el usuario puede moverse mientras lleva sus auriculares.

Métodos

GetCoordinateSystemAtCurrentLocation(SpatialLocator)

Obtiene un sistema de coordenadas de nivel de piso en la posición y orientación actuales del usuario.

RequestNewStageAsync()

Muestra la interfaz de usuario del sistema para guiar al usuario en la definición de una nueva fase para reemplazar la fase actual.

TryGetMovementBounds(SpatialCoordinateSystem)

Obtiene los vértices de límite del área abierta definida por el usuario donde piensa moverse mientras usa sus auriculares.

Eventos

CurrentChanged

Se produce cuando el usuario cambia o vuelve a definir la fase espacial actual.

Se aplica a

Consulte también