SpatialSurfaceObserver Classe

  • Riferimento

Definizione

Spazio dei nomi:
Windows.Perception.Spatial.Surfaces
Modifica

Fornisce metodi per osservare le superfici nell'ambiente dell'utente.

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
Ereditarietà
Object Platform::Object IInspectable SpatialSurfaceObserver
Attributi
ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisiti Windows

Famiglia di dispositivi
Windows 10 (è stato introdotto in 10.0.10586.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract
Windows.Foundation.UniversalApiContract (è stato introdotto in v2.0)
Funzionalità dell'app
spatialPerception

Commenti

Il mapping spaziale consente all'app di comprendere la forma e la posizione delle superfici nell'ambiente dell'utente.

Tramite i sensori in un dispositivo come HoloLens, Windows genera mesh triangoli 3D di superfici in volumi a forma di cubo di grandi dimensioni. Nel tempo, man mano che Windows migliora la comprensione dell'ambiente circostante, vengono generati nuovi volumi di superficie e i volumi esistenti vengono aggiornati con una nuova mesh. A volte, i volumi di superficie possono essere eliminati anche quando il sistema è in esecuzione in basso nell'archiviazione.

Si accede a queste superfici esprimendo interesse in un volume di spazio, un rettangolo di selezione, un limite frustum o una sfera di delimitazione. Gli aggiornamenti di Windows consentono di sapere quando il set di superfici in quel volume osservato è cambiato, con ogni volume di superficie identificato da un ID e l'ora dell'ultimo aggiornamento. Motivando le modifiche apportate a questo set di metadati di superficie osservati, è possibile rilevare nuove mesh, mesh aggiornate e rimosse nel tempo.

Cronologia delle versioni

Versione di Windows Versione dell'SDK Valore aggiunto
1703 15063 IsSupported

Costruttori

SpatialSurfaceObserver()

Inizializza una nuova istanza della classe SpatialSurfaceObserver .

Metodi

GetObservedSurfaces()

Ottiene i metadati per il set di superfici osservate all'interno del volume di delimitamento al momento.
IsSupported()

Ottiene se il mapping spaziale è supportato nel sistema corrente.
RequestAccessAsync()

Richiede l'accesso a un'app per usare il mapping spaziale. Ciò richiede la funzionalità spatialPerception.
SetBoundingVolume(SpatialBoundingVolume)

Imposta il volume a limite singolo che l'osservatore tiene traccia delle superfici nuove, aggiornate o rimosse.
SetBoundingVolumes(IIterable<SpatialBoundingVolume>)

Imposta l'elenco di volumi delimitati che l'osservatore tiene traccia delle superfici nuove, aggiornate o rimosse.

Eventi

ObservedSurfacesChanged

Si verifica quando il set di metadati di superficie osservati all'interno del volume di associazione è cambiato.

Si applica a

Vedi anche