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 IInspectable HandMeshObserver

특성

ContractVersionAttribute MarshalingBehaviorAttribute

Windows 요구 사항

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

설명

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

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

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

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

속성

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

메서드

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