HandMeshObserver 클래스

정의

네임스페이스:

Windows.Perception.People

검색된 손 모양을 추적하는 각 프레임에 메시 업데이트를 제공합니다.

public ref class HandMeshObserver sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 524288)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class HandMeshObserver final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 524288)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class HandMeshObserver

Public NotInheritable Class HandMeshObserver

상속

Object Platform::Object IInspectable HandMeshObserver

특성

ContractVersionAttribute MarshalingBehaviorAttribute

Windows 요구 사항

디바이스 패밀리	Windows 10, version 1903 (10.0.18362.0에서 도입되었습니다.)
API contract	Windows.Foundation.UniversalApiContract (v8.0에서 도입되었습니다.)

설명

HandMeshObserver를 만들면 해당 손의 감지된 모양을 추적하는 지정된 SpatialInteractionSource에 대한 손 메시 업데이트를 구독합니다.

사용자가 자신의 손으로 가상 개체와 직접 상호 작용하는 경우 손의 시각화를 렌더링하여 상호 작용에 대한 사용자의 신뢰를 높일 수 있습니다. HandMeshObserver를 만들면 GetTriangleIndices를 호출한 다음 GetVertexStateForPose를 호출하여 각 프레임마다 업데이트된 꼭짓점 버퍼를 호출하여 손의 고정 인덱스 버퍼를 미리 가져올 수 있습니다. 이러한 버퍼를 사용하면 사용자의 손의 라이브 시각화를 렌더링할 수 있습니다.

HandMeshObserver의 수명 동안 손 메시의 인덱스 버퍼는 변경되지 않습니다. 손 메시의 꼭짓점 버퍼 콘텐츠는 각 프레임에 업데이트되지만 꼭짓점 수는 업데이트되지 않습니다. 따라서 모든 프레임마다 동일한 꼭짓점 버퍼를 다시 채울 수 있습니다.

SpatialInteractionSource.TryCreateHandMeshObserverAsync 또는 SpatialInteractionSource.TryCreateHandMeshObserver를 호출하여 지정된 상호 작용 원본에 대한 HandMeshObserver를 만듭니다. 손 메시 업데이트에 대한 앱의 구독을 초기화하는 데 프레임 이상이 걸릴 수 있습니다. 백그라운드 스레드에서 메서드의 동기 버전만 호출해야 합니다. UI 스레드, 렌더링 스레드 또는 업데이트 스레드에서 를 호출하는 경우 대신 비동기 버전을 호출해야 합니다.

속성

ModelId	여러 원본 검색 및 손실 이벤트에서 동일한 인덱스 버퍼를 식별하는 손 메시 모델 ID를 가져옵니다.
NeutralPose	이 손의 현재 중립 HandPose 를 가져옵니다.
NeutralPoseVersion	이 손의 NeutralPose 버전을 가져옵니다.
Source	이 HandMeshObserver에서 손 메시를 추적하는 SpatialInteractionSource입니다.
TriangleIndexCount	이 손 메시 모델에 대한 인덱스 버퍼의 요소 수를 가져옵니다.
VertexCount	이 손의 꼭짓점 수를 가져옵니다.

메서드

GetTriangleIndices(UInt16[])	이 손 메시 모델의 인덱스 버퍼를 채웁니다.
GetVertexStateForPose(HandPose)	지정된 프레임의 손 포즈 또는 손 메시의 중립 포즈에 대한 손 메시를 렌더링하는 데 필요한 꼭짓점 버퍼 및 기타 상태를 가져옵니다.