顔の表情や動きでマウスカーソルを動かしたりクリックをすることができるproject gameface

2025年2月20日

project_gameface

GitHub – google/project-gameface

Project Gamefaceは、ゲーマーが頭の動きと顔のジェスチャーを使用してマウスカーソルを制御

start /min C:\app\project_gameface\run_app.exe

カーソルのスピードとマウス制御の表情を設定すれば使用することはできますがjsonを編集して設定することで細かな動きを制御可能です

基本設定

cursor.json

camera_idマシンのデフォルトのカメラインデックス。
tracking_vert_idxsカーソルを制御するためのトラッキングポイント ()
spd_up上方向のカーソル速度
spd_downカーソル速度が下向き
spd_left左方向のカーソル速度
spd_right右方向のカーソル速度
pointer_smoothカーソルの滑らかさの量
shape_smoothアクションのちらつきを減らします
hold_trigger_msホールド アクション トリガー遅延 (ミリ秒単位)
auto_playプログラムを起動すると自動的に再生が開始されます
mouse_acceleration頭が速く動くとカーソルの動きが速くなります
use_transformation_matrixヘッド方向を使用してカーソルを制御します(tracking_vert_idxsは無視されます)

“C:\app\project_gameface\configs\profile_1\cursor.json"

{
    "fix_width": 640, 
    "fix_height": 480, 
    "camera_id": 0, 
    "tracking_vert_idxs": [
        8
    ], 
    "spd_up": 40, 
    "spd_down": 38, 
    "spd_left": 22, 
    "spd_right": 23, 
    "pointer_smooth": 15, 
    "shape_smooth": 10, 
    "tick_interval_ms": 16, 
    "hold_trigger_ms": 500, 
    "auto_play": false, 
    "mouse_acceleration": false, 
    "use_transformation_matrix": false
}

キーバインド設定


mouse_bindings.json keyboard_bindings.json

キーバインド設定の設定パラメータは、この構造体にあります。

gesture_name: [device_name, action_name, threshold, trigger_type]
gesture_name顔の表情の名前は、一覧を参照してください
device_name「マウス」または「キーボード」"mouse" or “keyboard"
action_nameマウスの「左」、「右」、「中央」。キーボードの場合は「」、たとえば W キーの場合は「w」。"left", “right" and “middle" for mouse. “" for keyboard, for instance, “w" for the W key.
thresholdアクション トリガーのしきい値には、0.0 から 1.0 の範囲の値があります。
trigger_typeアクション トリガーの種類: 1 つのトリガーには “single" を使用し、進行中のアクションには “hold" を使用します。

gesture_name

IndexBlendshape Name日本語訳
0Noneなし
1Lower right eyebrow右眉毛下げ
2Lower left eyebrow左眉毛下げ
3browInnerUp眉内上げ
4Raise right eyebrow右眉毛上げ
5Raise left eyebrow左眉毛上げ
6cheekPuff頬を膨らます
7cheekSquintRight右頬すぼめ
8cheekSquintLeft左頬すぼめ
9eyeBlinkRight右目瞬き
10eyeBlinkLeft左目瞬き
11eyeLookDownRight右目下を見る
12eyeLookDownLeft左目下を見る
13eyeLookInRight右目内を見る
14eyeLookInLeft左目内を見る
15eyeLookOutRight右目外を見る
16eyeLookOutLeft左目外を見る
17eyeLookUpRight右目上を見る
18eyeLookUpLeft左目上を見る
19eyeSquintRight右目細め
20eyeSquintLeft左目細め
21eyeWideRight右目見開く
22eyeWideLeft左目見開く
23jawForward下顎前に
24jawRight下顎右に
25Open mouth口を開ける
26jawLeft下顎左に
27mouthClose口を閉じる
28mouthDimpleRight右口のえくぼ
29mouthDimpleLeft左口のえくぼ
30mouthFrownRight右口下げ
31mouthFrownLeft左口下げ
32mouthFunnel口をすぼめる
33Mouth right口右
34mouthLowerDownRight右口下げ
35mouthLowerDownLeft左口下げ
36mouthPressRight右口を押す
37mouthPressLeft左口を押す
38mouthPucker口を尖らせる
39Mouth left口左
40Roll lower mouth下唇を転がす
41Roll upper mouth上唇を転がす
42mouthShrugLower下唇すくめ
43mouthShrugUpper上唇すくめ
44mouthSmileRight右口笑顔
45mouthSmileLeft左口笑顔
46mouthStretchRight右口を伸ばす
47mouthStretchLeft左口を伸ばす
48mouthUpperUpRight右口上げ
49mouthUpperUpLeft左口上げ
50noseSneerRight右鼻唇上げ
51noseSneerLeft左鼻唇上げ

“C:\app\project_gameface\configs\profile_1\mouse_bindings.json"

{
    "Open mouth": [
        "mouse", 
        "pause", 
        0.41590000000000005, 
        "single"
    ], 
    "mouthPucker": [
        "mouse", 
        "left", 
        0.505, 
        "single"
    ]
}

“C:\app\project_gameface\configs\profile_1\keyboard_bindings.json"

{
    "mouthFunnel": [
        "keyboard", 
        "enter", 
        0.4951, 
        "hold"
    ]
}

画面