SpatialStageFrameOfReference Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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 SpatialStageFrameOfReferencePublic NotInheritable Class SpatialStageFrameOfReference- Herencia
- 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. |