.. _4.3.1 Hand Tracking Data:

手部跟踪数据
===============================

手部跟踪数据主要包括： **手势** （常用标准手势）， **手部关节数据** ， **状态信息** 等。
您可以根据项目需求，选择合适的数据使用，具体的调用方法，您可以参看API文档。


1. 手势
---------------------------

目前我们提供三种标准手势，如果此手势可以满足您的项目需求，您可以直接使用，后续我们会提供更丰富的标准手势交互方式。

准备手势
^^^^^^^^^^^^

.. image:: /_static/Hand.png


确认手势
^^^^^^^^^^^^

.. image:: /_static/Hand2.png

.. image:: /_static/Hand3.png


2. 手部关节数据
---------------------------

RhinoX Pro可以通过世界坐标跟踪手部，并注释了二十个（十九个指节点和一个掌节点）关键节点的位置，下面是各关节点对应的
API名称。

开发者可以根据关节数据自定义手势，从而实现更灵活的交互

手部关节点
^^^^^^^^^^^^^^^^

.. raw:: html

   <style>
   table th:first-of-type {
       width: 200px;
   }
   table th:nth-of-type(2) {
       width: 500px;
   }
   </style>

+---------+-------------------+
| Index   | API Name          |
+=========+===================+
| 0       | Palm              |
+---------+-------------------+
| 1       | ThumbProximal     |
+---------+-------------------+
| 2       | ThumbDistal       |
+---------+-------------------+
| 3       | ThumbTip          |
+---------+-------------------+
| 4       | IndexProximal     |
+---------+-------------------+
| 5       | IndexMiddle       |
+---------+-------------------+
| 6       | IndexDistal       |
+---------+-------------------+
| 7       | IndexTip          |
+---------+-------------------+
| 8       | MiddleProximal    |
+---------+-------------------+
| 9       | MiddleMiddle      |
+---------+-------------------+
| 10      | MiddleDistal      |
+---------+-------------------+
| 11      | MiddleTip         |
+---------+-------------------+
| 12      | RingProximal      |
+---------+-------------------+
| 12      | RingMiddle        |
+---------+-------------------+
| 14      | RingDistal        |
+---------+-------------------+
| 15      | RingTip           |
+---------+-------------------+
| 16      | PinkyProximal     |
+---------+-------------------+
| 17      | PinkyMiddle       |
+---------+-------------------+
| 18      | PinkyDistal       |
+---------+-------------------+
| 19      | PinkyTip          |
+---------+-------------------+


手部关节预制体 
^^^^^^^^^^^^^^^^^^^^^^^^^^^

.. image:: /_static/4_3_1image3.png

创建方式：Hierarchy面板鼠标右键 Ximmerse XR -> Virtual Hand Model。

.. image:: /_static/4_3_1image4.png

路径: Packages/com.ximmerse.xr/Resources/Gesture/Virtual Hand Model.prefab

使用此预制体，开发者可以在内容中渲染被跟踪手部的虚拟手对象。 

.. note:: 
  
  该预制体仅作为手部模型显示使用，并不会对交互功能产生影响。
  



3. 手指弯曲度
-----------------------------
.. code-block:: 

    //使用Finger.bendness 可以获取手指的弯曲度，使用弯曲度可以判断一些静态手势，例如下面的例子使用bendness判断静态手势:
    if (handTrackingInfo.IsValid == false)
    {

        float bendnessThumb = handTrackingInfo.ThumbFinger.bendness; //bendess 字段代表手指的伸直程度，当bendness=0代表手指完全伸直，当bendess=1代表手指弯曲
        float bendnessIndex = handTrackingInfo.IndexFinger.bendness; //食指的弯曲度
        float bendnessMiddle = handTrackingInfo.MiddleFinger.bendness; //中指的弯曲度
        float bendessRingFinger = handTrackingInfo.RingFinger.bendness; //无名指的弯曲度
        float bendessLittleFinger = handTrackingInfo.RingFinger.bendness; //小指的弯曲度
        //当食指和中指的弯曲度小于0.15，其他手指的弯曲度大于0.85的时候，判定用户静态手势
        if(bendnessIndex <= 0.15f && bendnessMiddle <= 0.15f && bendnessThumb >= 0.85f && bendessRingFinger >= 0.85f && bendessLittleFinger >= 0.85f) 
        {
           Debug.LogFormat("用户手势: 数字 2");
        }
    }



4. 常用 API
---------------------------

.. code-block:: 

    //Ximmerse.XR.InputSystems.HandTracking 类是处理手部跟踪的关键类

    HandTracking.EnableHandTracking (); //激活手部跟踪

    HandTracking.DisableHandTracking (); //停止手部跟踪

    var currentHandTrackInfo = HandTracking.LeftHandTrackingInfo; //LeftHandTrackingInfo 包含当前左手手部跟踪的详细数据：每个指关节的位置，手腕的位置，手掌的朝向。 使用 RightHandTrackInfo即可获取右手的跟踪数据

    if(currentHandTrackInfo.IsValid)  //如果当前帧，RGB相机跟踪到手部姿态
    {
        var palmPos = currentHandTrackInfo.PalmPosition;//手掌位置
        var palmNormal = currentHandTrackInfo.PalmNormal; //沿着手掌心向上的方向
        var gestureType = currentHandTrackInfo.NativeGestureType; //2 = Open Hand (手掌心张开), 3 = Close Hand (握拳),  4 = Pinch (食指拇指捏合)
    }