HandMeshObserver Clase

Definición

Espacio de nombres:

Windows.Perception.People

Proporciona actualizaciones de malla de cada marco que realiza un seguimiento de la forma detectada de una mano.

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

Herencia

Object Platform::Object IInspectable HandMeshObserver

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute

Requisitos de Windows

Familia de dispositivos	Windows 10, version 1903 (se introdujo en la versión 10.0.18362.0)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v8.0)

Comentarios

La creación de un handMeshObserver le suscribe a las actualizaciones de malla de mano de un objeto SpatialInteractionSource determinado que realiza un seguimiento de la forma detectada de esa mano.

Cuando los usuarios interactúan directamente con objetos virtuales con sus manos, es posible que desee representar una visualización de las manos para aumentar la confianza del usuario en sus interacciones. Al crear un handMeshObserver, puede obtener un búfer de índice fijo para la mano por adelantado llamando a GetTriangleIndices y, a continuación, un búfer de vértices actualizado cada fotograma llamando a GetVertexStateForPose. Con estos búferes, puede representar una visualización dinámica de la mano del usuario.

El búfer de índice de la malla de mano no cambiará durante la vigencia del handMeshObserver. El contenido del búfer de vértices de la malla de mano se actualizará cada fotograma, mientras que el recuento de vértices no. Por lo tanto, puede rellenar el mismo búfer de vértices cada fotograma.

Para crear un handMeshObserver para un origen de interacción determinado, llame a SpatialInteractionSource.TryCreateHandMeshObserverAsync o SpatialInteractionSource.TryCreateHandMeshObserver. Puede tardar más que un marco en inicializar la suscripción de la aplicación para realizar actualizaciones de malla a mano. Solo debe llamar a la versión sincrónica del método desde un subproceso en segundo plano. Si va a llamar desde un subproceso de interfaz de usuario, representar subproceso o actualizar subproceso, debe llamar a la versión asincrónica en su lugar.

Propiedades

ModelId	Obtiene un identificador de modelo de malla de mano para identificar el mismo búfer de índice en varios eventos de detección y pérdida de origen.
NeutralPose	Obtiene el handPose neutro actual para esta mano.
NeutralPoseVersion	Obtiene la versión de NeutralPose para esta mano.
Source	SpatialInteractionSource cuya malla de mano realiza el seguimiento de este handMeshObserver.
TriangleIndexCount	Obtiene el número de elementos del búfer de índice para este modelo de malla de mano.
VertexCount	Obtiene el recuento de vértices para esta mano.

Métodos

GetTriangleIndices(UInt16[])	Rellena un búfer de índice para este modelo de malla de mano.
GetVertexStateForPose(HandPose)	Obtiene el búfer de vértices y otro estado necesario para representar la malla de mano para la posición de mano de un marco determinado o para la posición neutra de la malla de mano.