SpatialSurfaceObserver Classe

Definição

Namespace:

Windows.Perception.Spatial.Surfaces

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 SpatialSurfaceObserver

function SpatialSurfaceObserver()

Public NotInheritable Class SpatialSurfaceObserver

Herança

Object Platform::Object IInspectable SpatialSurfaceObserver

Atributos

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

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.

Confira também

• Exemplo de mapeamento espacial holográfico