抖音开放平台Logo
开发者文档
小游戏
控制台
  • API 概览
  • 开放能力
  • 基础
  • 渲染
  • 设备
  • 文件
  • 位置
  • 媒体
  • 图片
  • 音频
  • 录屏
  • 麦克风
  • 相机
  • 录音
  • 视频
  • 人脸检测
  • 手势识别
  • tt.createHandDetector
  • Detector
  • HandInfo
  • 手势说明
  • 网络
  • 游戏转发分享
  • 实时语音
  • 数据缓存
  • 系统
  • 广告
  • 界面
  • 支付
  • Worker

    • 手势说明
    收藏
    我的收藏

    说明

    开发者通过 tt.createHandDetector 创建手势识别器后，调用 detect 方法返回的 HandInfo 结果中，acitons 属性表示当前识别到的手势种类。

    现有可识别的手势共 36 种，分为静态和动态手势。

    手势种类说明

    1. 静态手势
    取值手势名手势形态单双手
    unknown未知未定义的手势-
    heart_a比心 A定义： 手背朝画面，心尖向下，拇指指尖接触；
    重要形状特征：
    1. 双手拇指尖相触点可见
    2. 双手食指尖相触点可见
    3. 中间镂空区域为心形可见
    4. 可以左右旋转 45 度    		双手
    heart_b比心 B定义：手指第二关节接触，心尖向下，拇指指尖接触；
    重要形状特征：
    1. 双手拇指尖相触点可见
    2. 手指关节相触点可见
    3. 镂空区域为心形可见
    4. 可以左右旋转 45 度    		双手
    heart_c比心 c定义：手腕接触，心尖向下，剩下四指左右两手接触；
    重要形状特征：
    1. 手腕相触点可见
    2. 手指关节相触点可见
    3. 镂空区域为心形可见
    4. 可以左右旋转 45 度    		双手
    heart_d比心 d定义：食指大拇指交叉，食指朝上，其余手指折叠；
    重要形状特征：
    1. 拇指和食指交叉区域可见
    2. 可以左右旋转 45 度（见大图）
    3. 绿色箭头为方向定义，红色箭头为方向最大角度    		单手
    okOK定义：食指拇指尖接触，剩余手指摊开；
    重要形状特征：
    1. 拇指和食指相触点可见（绿色）
    2. 剩余的三根手指可见（红色）
    3. 拇指和食指中间的镂空区域可见（黄色）
    4. 手心朝外
    5. 可以左右旋转 45 度    		单手
    hand_open手张开定义：五指打开，手心面向画面；
    重要形状特征：
    1. 手掌可见
    2. 五只手指可见
    3. 手心朝内，朝外都可以
    4. 可以左右旋转 360 度    		单手
    thumb_up点赞定义：竖大拇指，方向向上， 手心向内；
    重要形状特征：
    1. 大拇指指尖可见（绿色）
    2. 大拇指指向上方（绿色）
    3. 手背和手指交接区域可见（红色）
    4. 手心朝内，朝外，朝左右都可以
    5. 可以左右旋转 45 度    		单手
    thumb_down差评定义：竖大拇指，方向向下，手心向外；
    重要形状特征：
    1. 大拇指指尖可见（绿色）
    2. 大拇指指向下方
    3. 除拇指之外的四指全区起来的区域可见（红色）
    4. 手心朝外
    5. 可以左右旋转 45 度
    6. 可以向前旋转 90 度    		单手
    rockROCK定义：小拇指、食指、大拇指伸直，无名指、中指折起，
    手心对外， 手心向外；
    重要形状特征：小拇指， 食指已经拇指指尖可见手心朝外，
    朝内， 朝外都可以可以左右旋转 90 度绿色箭头为方向定义，
    红色箭头为方向最大角度    		单手
    namaste合十定义：双手合十；
    重要形状特征：
    1. 双手连接处的缝隙可见（红色）
    2. 可以左右旋转 45 度    		双手
    palm_up手心向上定义：摊开手，手心朝上，不能有角度倾斜单手
    fist握拳定义：握拳，手心对外；
    重要形状特征：
    1. 手心朝外，朝内都可以
    2. 可以左右旋转 180 度（具体看视频连接）    		单手
    index_finger_up食指朝上定义：伸出食指，其余手指折起，手心对外；
    重要形状特征：
    1. 食指指尖可见（绿色）
    2. 手心朝外，朝内都可以
    3. 可以左右旋转 45 度    		单手
    double_finger_up双指朝上定义：伸出食指和中止，并拢，其余手指折起，手心对外；
    重要形状特征：
    1. 食指和中指并排，指尖可见（绿色）
    2. 手心朝外，朝内都可以
    3. 支持左右旋转 45 度    		单手
    victory胜利定义：伸出食指和中止，张开，其余手指折起；
    重要形状特征：
    1. 食指和中指形成的“V”区域可见（绿色）
    2. 食指和中指指尖可见（红色）
    3. 手心朝内， 朝外都可以，
    4. 支持左右旋转 75 度    		单手
    big_v大 V定义：伸出食指和大拇指，其余手指折起，手背朝外；
    重要形状特征：
    1. 拇指和中指形成的“V”区域可见（绿色）
    2. 拇指和中指指尖可见（红色）
    3. 手心朝内，朝外都可以
    4. 支持左右旋转 90 度
    5. 绿色箭头为方向定义，红色箭头为方向最大角度    		单手
    phonecall打电话定义：伸出大拇指和小指，其余手指折叠，手背对外；
    重要形状特征：
    1. 拇指和小拇指指尖可见（红色）
    2. "L"型区域可见（绿色）
    3. 手心朝内， 朝外都可以
    4. 支持左右旋转 90 度
    5. 绿色箭头为方向定义，红色箭头为方向最大角度    		单手
    beg作揖定义：一手握拳，另一手覆盖在其之上；
    重要形状特征：
    1. 双手交接区域可见（绿色）
    2. 上面的手伸直手的区域（红色）
    3. 可以左右旋转 45 度    		双手
    thanks感谢定义：一手握拳，另一手张开，手心覆盖在其之上；
    重要形状特征：
    1. 双手交接区域可见（绿色）
    2. 上面的手区域（红色）
    3. 可以左右旋转 45 度    		双手
    cabbage卷心菜定义：五指指尖并拢，向上竖起;
    支持方向：
    1. 手心向内向外皆可
    2. 可以左右旋转（roll）45 度    		单手
    three三定义：用中指、无名指、小指比数字 3；
    可能风险：手心朝摄像头时，为 OK，手背朝摄像头时，为三；
    支持方向：
    1. 手心只能向内
    2. 支持左右 15 度旋转    		单手
    four四定义：用大拇指外的四指比数字 4
    支持方向：
    1. 手心向内向外皆可    		单手
    pistol手枪定义：拇指和食指比手枪，枪口朝向屏幕；
    支持方向：
    1. 上下旋转（pitch）45 度
    2. 左右旋转（yaw）45 度    		单手
    rock2摇滚 2定义：另一种 rock 的手势，食指小拇指竖起，拇指与中指
    无名指交叠；
    支持方向：
    1. 手心向内向外皆可    		单手
    swear发誓定义：食指中指无名指竖起，大小拇指交叠，发誓的动作；
    混淆风险：在旋转角度大的情况下易与 three 和 victory 混淆；
    支持方向：
    1. 手心向内向外皆可
    2. 支持左右 15 度旋转    		单手
    holdface捧脸定义：双手腕并拢将脸从下方托起双手
    salute敬礼定义：手掌绷直做出敬礼动作单手
    spread讨红包定义：手掌向前摊开；
    支持方向：
    1. 上下旋转 45 度（pitch）    		单手
    pray祈祷定义：十指交叉握住（来自火影手势）；
    支持方向：
    1. 上下旋转（pitch）45 度
    2. 左右旋转（yaw）45 度    		双手
    qigong龟波气功定义：双手做出龟波气功的姿势，可正面可侧面；
    支持方向：
    1. pitch 角 ±30 度
    2. yaw 角 ±90 度
    3. roll 角 ±180（正面朝摄像头时）    		双手
    slide发红包定义：双手摊开，一手面向另一手放在其上方，掌心相对；
    支持方向：
    1. pitch 角 ±30 度
    2. yaw 角 ±30 度    		双手
    palm_down手掌朝下定义：单手手掌朝下，指尖朝摄像头；
    支持方向：
    1. pitch 角 ±30 度
    2. yaw 角 ±30 度    		单手
    pistol2双指比枪定义：大拇指食指中指伸出，无名指小指收回，做出
    手枪的形状；
    支持方向：
    1. 标准动作：手心朝向摄像头或者手背朝向摄像头，大
    拇指和食指水平
    2. roll 方向：手指水平到向上竖直 90 度范围
    3. pitch yaw 方向与标准动作相比 30 度范围内    		单手
    1. 动态手势
    取值手势名手势形态单双手
    punching击拳定义： 手握拳向屏幕快速击出；
    支持方向：
    1. roll 角度 ±90 度    		单手
    clapping鼓掌定义：双手做出鼓掌动作；
    支持方向：
    1. roll 角度 ±45 度
    2. pitch 角度 180 度
    3. yaw 角度 ±30 度
    4. 双手交错横向鼓掌    		双手

    使用提示

    注意事项

    1. 手势识别比较适合近距离下识别（0.3m-1.5m）
2. 手势识别在速度较快的情况下会跟踪丢失
3. 在接近肤色的背景下，如人脸背景、橙色、粉色衣服等情况下，手势的识别准确率会下降，建议尽量避免或引导用户不在这种场景下使用。这些场景下的效果在持续优化中
4. 目前的识别是只针对单手识别
5. 发红包、手掌向下手势，因为暂时没有强烈需求，没有做过专门优化，不推荐使用,鼓掌手势经过多次优化，可用性强.

    手势种类兼容和互斥

    说明：注意手势是否支持手心、手背朝向摄像头，注意易混淆手势

    手势名可表示数字 3支持手心朝摄像头支持手背朝摄像头支持 45 度平面内旋转易混淆手势
    OK✔️✔️❌✔️three（手背朝摄像头）
    three✔️❌✔️✔️OK（手心朝摄像头）
    swear✔️✔️✔️✔️unknown，hand_open，victory

    数字手势的配置

    说明：需要识别数字 1-5 时，可按照下表对相应的手势名称进行拦截，包含易混淆手势，可以提高识别的准确率。

    表示数字手势名
    1index_finger_up
    2victory
    3OK，three，swear
    4four
    5hand_open

    Bug & Tip

    • Tip：部分手势图示。
    • Tip：贴纸使用时，如需识别 OK 手势，可同时配置【OK，three】，如需识别比三手势，可同时配置【OK，three，swear】
    上一篇：HandInfo
    下一篇：tt.request
    该文档是否有帮助？