Compartilhar via


SpatialSurfaceObserver Classe

Definição

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

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.

Aplica-se a

Confira também