SpatialSurfaceObserver Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Fornece métodos para observar superfícies no ambiente do usuário.
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- Herança
- Atributos
Requisitos do Windows
| Família de dispositivos |
Windows 10 (introduzida na 10.0.10586.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
|
| API contract |
Windows.Foundation.UniversalApiContract (introduzida na v2.0)
|
| Funcionalidades do aplicativo |
spatialPerception
|
Comentários
O mapeamento espacial permite que seu aplicativo entenda a forma e a localização das superfícies nos arredores do usuário.
Por meio dos sensores em um dispositivo como o HoloLens, o Windows gera malhas de triângulo 3D de superfícies em grandes volumes em forma de cubo. Com o tempo, à medida que o Windows melhora sua compreensão do ambiente, novos volumes de superfície são gerados e os volumes existentes são atualizados com a nova malha. Às vezes, os volumes de superfície também podem ser destruídos quando o sistema está com pouco armazenamento.
Você acessa essas superfícies expressando interesse em um volume de espaço, uma caixa delimitadora, um frusto delimitador ou uma esfera delimitadora. O Windows atualiza você para informar quando o conjunto de superfícies nesse volume observado foi alterado, com cada volume de superfície identificado por uma ID e a hora de sua última atualização. Ao raciocinar sobre alterações nesse conjunto de metadados de superfície observados, você pode detectar nova malha, malha atualizada e malha removida ao longo do tempo.
Histórico de versão
| Versão do Windows | Versão do SDK | Valor adicionado |
|---|---|---|
| 1703 | 15063 | Issupported |
Construtores
| SpatialSurfaceObserver() |
Inicializa uma nova instância da classe SpatialSurfaceObserver . |
Métodos
| GetObservedSurfaces() |
Obtém metadados para o conjunto de superfícies observado no volume delimitador no momento. |
| IsSupported() |
Obtém se há suporte para mapeamento espacial no sistema atual. |
| RequestAccessAsync() |
Solicita acesso para um aplicativo usar o mapeamento espacial. Isso requer a funcionalidade spatialPerception. |
| SetBoundingVolume(SpatialBoundingVolume) |
Define o único volume delimitador que este observador rastreará para superfícies novas, atualizadas ou removidas. |
| SetBoundingVolumes(IIterable<SpatialBoundingVolume>) |
Define a lista de volumes delimitador que este observador rastreará para superfícies novas, atualizadas ou removidas. |
Eventos
| ObservedSurfacesChanged |
Ocorre quando o conjunto de metadados de superfície observado no volume delimitador é alterado. |