SpatialSurfaceObserver 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í.
Proporciona métodos para observar superficies en el entorno del usuario.
public ref class SpatialSurfaceObserver sealed/// [Windows.Foundation.Metadata.Activatable(131072, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 131072)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class SpatialSurfaceObserver final[Windows.Foundation.Metadata.Activatable(131072, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 131072)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class SpatialSurfaceObserverfunction SpatialSurfaceObserver()Public NotInheritable Class SpatialSurfaceObserver- Herencia
- Atributos
Requisitos de Windows
| Familia de dispositivos |
Windows 10 (se introdujo en la versión 10.0.10586.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
|
| API contract |
Windows.Foundation.UniversalApiContract (se introdujo en la versión v2.0)
|
| Características de aplicaciones |
spatialPerception
|
Comentarios
La asignación espacial permite a la aplicación comprender la forma y la ubicación de las superficies en el entorno del usuario.
A través de los sensores de un dispositivo como HoloLens, Windows genera mallas de triángulo 3D de superficies en grandes volúmenes en forma de cubo. Con el tiempo, a medida que Windows mejora su comprensión de sus alrededores, se generan nuevos volúmenes de superficie y los volúmenes existentes se actualizan con una nueva malla. A veces, los volúmenes de superficie también se pueden destruir cuando el sistema se está ejecutando poco en el almacenamiento.
Para acceder a estas superficies, se expresa interés en un volumen de espacio, ya sea un rectángulo delimitador, un frustum delimitador o una esfera delimitador. Windows le actualiza para que sepa cuándo ha cambiado el conjunto de superficies de ese volumen observado, con cada volumen de superficie identificado por un identificador y la hora de su última actualización. Al razonar sobre los cambios en este conjunto de metadatos de superficie observados, puede detectar una nueva malla, una malla actualizada y una malla eliminada a lo largo del tiempo.
Historial de versiones
| Versión de Windows | Versión del SDK | Valor agregado |
|---|---|---|
| 1703 | 15063 | IsSupported |
Constructores
| SpatialSurfaceObserver() |
Inicializa una nueva instancia de la clase SpatialSurfaceObserver . |
Métodos
| GetObservedSurfaces() |
Obtiene los metadatos del conjunto de superficies observadas en el volumen delimitador en este momento. |
| IsSupported() |
Obtiene si se admite la asignación espacial en el sistema actual. |
| RequestAccessAsync() |
Solicita acceso a una aplicación para usar la asignación espacial. Esto requiere la funcionalidad spatialPerception. |
| SetBoundingVolume(SpatialBoundingVolume) |
Establece el único volumen delimitador que realizará este observador para detectar superficies nuevas, actualizadas o eliminadas. |
| SetBoundingVolumes(IIterable<SpatialBoundingVolume>) |
Establece la lista de volúmenes delimitador de los que este observador realizará el seguimiento de superficies nuevas, actualizadas o eliminadas. |
Eventos
| ObservedSurfacesChanged |
Se produce cuando el conjunto de metadatos de superficie observados dentro del volumen delimitador ha cambiado. |