SpatialSurfaceObserver 클래스

정의

네임스페이스:

Windows.Perception.Spatial.Surfaces

사용자 환경에서 표면을 관찰하는 메서드를 제공합니다.

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

상속

Object Platform::Object IInspectable SpatialSurfaceObserver

특성

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 요구 사항

디바이스 패밀리	Windows 10 (10.0.10586.0 - for Xbox, see UWP features that aren't yet supported on Xbox에서 도입되었습니다.)
API contract	Windows.Foundation.UniversalApiContract (v2.0에서 도입되었습니다.)
앱 기능	spatialPerception

설명

공간 매핑을 통해 앱은 사용자 주변의 표면 모양과 위치를 이해할 수 있습니다.

HoloLens와 같은 디바이스의 센서를 통해 Windows는 큰 큐브 모양의 볼륨에서 표면의 3D 삼각형 메시를 생성합니다. 시간이 지남에 따라 Windows가 주변 환경을 이해하게 됨에 따라 새로운 표면 볼륨이 생성되고 기존 볼륨이 새 메시로 업데이트됩니다. 시스템이 스토리지에서 부족할 때 표면 볼륨도 제거될 수 있습니다.

경계 상자, 경계 frustum 또는 경계 구체 중 하나의 공간 볼륨에 관심을 표시하여 이러한 표면에 액세스합니다. Windows는 관찰된 볼륨의 표면 집합이 변경된 시점을 알리도록 업데이트하며, 각 표면 볼륨은 ID로 식별되고 마지막 업데이트 시간은 표시됩니다. 관찰된 이 표면 메타데이터 집합의 변경 내용을 추론하여 시간이 지남에 따라 새 메시, 업데이트된 메시 및 제거된 메시를 검색할 수 있습니다.

버전 기록

Windows 버전	SDK 버전	추가된 값
1703	15063	Issupported

생성자

SpatialSurfaceObserver()

SpatialSurfaceObserver 클래스의 새 instance 초기화합니다.

메서드

GetObservedSurfaces()	현재 경계 볼륨 내에서 관찰되는 표면 집합에 대한 메타데이터를 가져옵니다.
IsSupported()	현재 시스템에서 공간 매핑이 지원되는지 여부를 가져옵니다.
RequestAccessAsync()	공간 매핑을 사용하도록 앱에 대한 액세스를 요청합니다. 이를 위해서는 spatialPerception 기능이 필요합니다.
SetBoundingVolume(SpatialBoundingVolume)	이 관찰자가 새 표면, 업데이트 또는 제거된 표면에 대해 추적할 단일 경계 볼륨을 설정합니다.
SetBoundingVolumes(IIterable<SpatialBoundingVolume>)	이 관찰자가 새 표면, 업데이트 또는 제거된 표면에 대해 추적할 경계 볼륨 목록을 설정합니다.

이벤트

ObservedSurfacesChanged

경계 볼륨 내에서 관찰된 표면 메타데이터 집합이 변경되었을 때 발생합니다.

추가 정보

• 홀로그램 공간 매핑 샘플