SpatialSurfaceObserver Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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 SpatialSurfaceObserverfunction SpatialSurfaceObserver()Public NotInheritable Class SpatialSurfaceObserver- Ereditarietà
- Attributi
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. |