SpatialSurfaceObserver Klasse

  • Referenz

Definition

Namespace:
Windows.Perception.Spatial.Surfaces
Bearbeiten

Stellt Methoden zum Beobachten von Oberflächen in der Umgebung des Benutzers bereit.

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
Vererbung
Object Platform::Object IInspectable SpatialSurfaceObserver
Attribute
ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows-Anforderungen

Gerätefamilie
Windows 10 (eingeführt in 10.0.10586.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract
Windows.Foundation.UniversalApiContract (eingeführt in v2.0)
App-Funktionen
spatialPerception

Hinweise

Mit räumlicher Zuordnung kann Ihre App die Form und Position der Oberflächen in der Umgebung des Benutzers verstehen.

Über die Sensoren auf einem Gerät wie HoloLens generiert Windows 3D-Dreieckgitter von Oberflächen in großen würfelförmigen Volumen. Da Windows im Laufe der Zeit das Verständnis Ihrer Umgebung verbessert, werden neue Oberflächenvolumes generiert und vorhandene Volumes mit einem neuen Gitter aktualisiert. Manchmal können Oberflächenvolumes auch zerstört werden, wenn das System nicht genügend Speicherplatz hat.

Sie greifen auf diese Oberflächen zu, indem Sie interesse an einem Raumvolumen, entweder einem Begrenzungsrahmen, einem begrenzungsgebundenen Frustum oder einer begrenzungsenden Kugel, ausdrücken. Windows aktualisiert Sie, um Sie darüber zu informieren, wann sich der Satz von Oberflächen in diesem beobachteten Volumen geändert hat, wobei jedes Oberflächenvolume durch eine ID und den Zeitpunkt der letzten Aktualisierung identifiziert wird. Durch Überlegungen zu Änderungen an diesem Satz beobachteter Oberflächenmetadaten können Sie im Laufe der Zeit ein neues Gitter, ein aktualisiertes Gitter und ein entferntes Gitter erkennen.

Versionsverlauf

Windows-Version SDK-Version Mehrwert
1703 15063 Issupported

Konstruktoren

SpatialSurfaceObserver()

Initialisiert eine neue instance der SpatialSurfaceObserver-Klasse.

Methoden

GetObservedSurfaces()

Ruft Metadaten für den Satz von Oberflächen ab, die derzeit innerhalb des umgebenden Volumes beobachtet werden.
IsSupported()

Ruft ab, ob die räumliche Zuordnung im aktuellen System unterstützt wird.
RequestAccessAsync()

Fordert den Zugriff für eine App zur Verwendung räumlicher Zuordnungen an. Hierfür ist die funktion spatialPerception erforderlich.
SetBoundingVolume(SpatialBoundingVolume)

Legt das einzelne umgebende Volume fest, das dieser Beobachter für neue, aktualisierte oder entfernte Oberflächen nachverfolgt.
SetBoundingVolumes(IIterable<SpatialBoundingVolume>)

Legt die Liste der umgebenden Volumes fest, die dieser Beobachter für neue, aktualisierte oder entfernte Oberflächen nachverfolgt.

Ereignisse

ObservedSurfacesChanged

Tritt auf, wenn sich der Satz von Oberflächenmetadaten, die innerhalb des umgebenden Volumes beobachtet werden, geändert hat.

Gilt für:

Weitere Informationen