インスタンスベース API の現在の実装では、検出したスケルトンから、ユーザーの顔に関する情報を取得できます。

現在サポートしているプラットフォーム:

Ubuntu amd64
Windows x86/x86_64

注意: 顔モジュールは、デフォルトの設定で無効になっています。有効にするには、nuitrack.config ファイルを開き、 Faces.ToUse と DepthProvider.Depth2ColorRegistration を true に設定します。; Windows または Linux の Orbbec Astra PRO カメラに関して、AstraProPerseeDepthProvider.CameraID　を設定します(通常は 0 で問題ありませんが、問題が起きる場合は、1、2 等を試してください)。

インスタンスに関する情報の取得

Nuitrack では、カメラの前に立っている人の情報を、 JSON 形式で取得できます。情報を取得するには、Nuitrack::getInstancesJson (C++) または Nuitrack.GetInstancesJson (CSharp) 機能を呼び出します。結果は JSON 文字列で表示されます。
JSON 文字列に含まれるプロパティ:

Timestamp : マイクロ秒で表示されるタイムスタンプを組み込みます
Instances : Nuitrack がトラッキングを行うインスタンスの配列
- id : インスタンスの識別子。ユーザーセグメント ID に対応します。
- class : インスタンスのクラス
- face : 検出された人の顔の特長
  - rectangle : 画像内の顔の部分の長方形の正規化された座標
    - left : 長方形の左上角の X 座標
    - top : 長方形の左上角の Y 座標
    - width : 長方形の幅
    - height : 長方形の高さ
  - landmark : 顔の器官もしくはパーツsinglelbf セットの人体計測ポイント (31 ポイント) が使用されます。セットの各ポイントを正規化した座標としてフィードバックします。
    Singlelbf セットのポイント
  - left_eye : 正規化された左目の中心座標
  - right_eye : 正規化された右目の中心座標
  - angles : 顔の回転角度
    - yaw : ヨー角 (左右の回転)
    - pitch : ピッチ角 (前後の傾き)
    - roll : ロール角 (左右の傾き)
  - emotions : 人の顔の感情データに関する数値です。それぞれの感情に関する信頼度が[0; 1]の間の正の値がフィードバックされます。値:neutral | angry | happy | surprise
  - age : 検出された人の推定年齢
    - type : 年齢に応じた年齢のグループ値:kid | young | adult | senior
    - years : 推定年齢を正規化することなく実際の数値で表示します。
  - gender : 検出された人の性別値:male | female

JSON データの出力サンプルです。

{
    "Timestamp":"21510171",
    "Instances":
    [
        {
            "id":"1",
            "class":"human",
            "face":
            {
                "rectangle":
                {
                    "left":"0.328125",
                    "top":"0.008333334",
                    "width":"0.31875",
                    "height":"0.4208333333333333"
                },
                "landmark":
                [
                    {
                        "x":"0.4263304",
                        "y":"0.1120703"
                    },
                    ...
                    {
                        "x":"0.4574016",
                        "y":"0.1485224"
                    },
                    {
                        "x":"0.5318047",
                        "y":"0.1858454"
                    }
                ],
                "left_eye":
                {
                    "x":"0.4574016",
                    "y":"0.1485224"
                },
                "right_eye":
                {
                    "x":"0.5318047",
                    "y":"0.1858454"
                },
                "angles":
                {
                    "yaw":"10.45415",
                    "pitch":"-15.17794",
                    "roll":"21.27661"
                },
                "emotions":
                {
                    "angry":"0.5808502",
                    "neutral":"0.3572008",
                    "surprise":"0.05123258",
                    "happy":"0.01071637"
                },
                "age":
                {
                    "type":"young",
                    "years":"26.7231330871582"
                },
                "gender":"male"
            }
        }
    ]
}