HandMeshObserver Kelas

Definisi

Ruang nama:

Windows.Perception.People

Menyediakan pembaruan jala setiap bingkai yang melacak bentuk tangan yang terdeteksi.

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

Warisan

Object Platform::Object IInspectable HandMeshObserver

Atribut

ContractVersionAttribute MarshalingBehaviorAttribute

Persyaratan Windows

Rangkaian perangkat	Windows 10, version 1903 (diperkenalkan dalam 10.0.18362.0)
API contract	Windows.Foundation.UniversalApiContract (diperkenalkan dalam v8.0)

Keterangan

Membuat HandMeshObserver membuat Anda berlangganan pembaruan jala tangan untuk SpatialInteractionSource tertentu yang melacak bentuk tangan yang terdeteksi.

Ketika pengguna berinteraksi langsung dengan objek virtual dengan tangan mereka, Anda mungkin ingin merender visualisasi tangan untuk meningkatkan kepercayaan pengguna terhadap interaksi mereka. Dengan membuat HandMeshObserver, Anda bisa mendapatkan buffer indeks tetap untuk tangan di depan dengan memanggil GetTriangleIndices, lalu buffer vertex yang diperbarui setiap bingkai dengan memanggil GetVertexStateForPose. Dengan buffer ini, Anda dapat merender visualisasi langsung tangan pengguna.

Buffer indeks jala tangan tidak akan berubah selama masa pakai HandMeshObserver. Konten buffer vertex jala tangan akan diperbarui setiap bingkai, sementara jumlah puncak tidak akan diperbarui. Oleh karena itu, Anda dapat mengisi ulang buffer vertex yang sama setiap bingkai.

Anda membuat HandMeshObserver untuk sumber interaksi tertentu dengan memanggil SpatialInteractionSource.TryCreateHandMeshObserverAsync atau SpatialInteractionSource.TryCreateHandMeshObserver. Dibutuhkan lebih dari satu bingkai untuk menginisialisasi langganan aplikasi untuk pembaruan jala tangan. Anda hanya boleh memanggil versi sinkron metode dari utas latar belakang. Jika Anda memanggil dari utas UI, merender utas atau memperbarui utas, Anda harus memanggil versi asinkron sebagai gantinya.

Properti

ModelId	Mendapatkan ID model jala tangan untuk mengidentifikasi buffer indeks yang sama di beberapa peristiwa deteksi dan kehilangan sumber.
NeutralPose	Mendapatkan HandPose netral saat ini untuk tangan ini.
NeutralPoseVersion	Mendapatkan versi NeutralPose untuk tangan ini.
Source	SpatialInteractionSource yang jala tangannya dilacak oleh HandMeshObserver ini.
TriangleIndexCount	Mendapatkan jumlah elemen dalam buffer indeks untuk model jala tangan ini.
VertexCount	Mendapatkan hitungan simpul untuk tangan ini.

Metode

GetTriangleIndices(UInt16[])	Mengisi buffer indeks untuk model jala tangan ini.
GetVertexStateForPose(HandPose)	Mendapatkan buffer vertex dan status lain yang diperlukan untuk merender jala tangan untuk pose tangan bingkai tertentu, atau untuk pose netral jala tangan.