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)	特定のフレームのハンド ポーズ、またはハンド メッシュのニュートラル ポーズに対してハンド メッシュをレンダリングするために必要な頂点バッファーとその他の状態を取得します。