SpatialSurfaceObserver Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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 SpatialSurfaceObserverfunction SpatialSurfaceObserver()Public NotInheritable Class SpatialSurfaceObserver- Vererbung
- Attribute
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. |