tencent cloud

Tencent Effect SDK

Release Notes and Announcements
Release Notes
Tencent Effect SDK V3.5 Version Released
Tencent Effects SDK V3.0 Version Related API and Material Changes
Product Introduction
Overview
Features
Basic Concepts
Strengths
Use Cases
Purchase Guide
Pricing Overview
Purchase Guide
Payment Overdue and Refund
Tutorial
Demos
Free Trial License
Licenses
Adding and Renewing a License (Mobile)
Adding and Renewing a License (Desktop)
Adding and Renewing a License (Web)
FAQs
SDK Download
Features
SDK Download
Version History
SDK Integration Guide(No UI)
General Integration of Tencent Effect
Integrating Capabilities
SDK Integration Guide(Including UI)
General Integration of Tencent Effect
Integrating Tencent Effect into MLVB SDK
Integrating Tencent Effect into TRTC SDK
Integrating Tencent Effect into UGSV SDK
Virtual Avatars
API Documentation
iOS
Android
Flutter
Web
Feature Guide
Reducing SDK Size
SDK Integration Issue Troubleshooting
Performance Fine-Tuning
Effect Fine-Tuning
Material Usage
Effect Parameters
Recommended Parameters in Beautification Scenarios
UGSV Enterprise Edition Migration Guide
Integrating Tencent Effect for Third-Party Publishers (Flutter)
Integrating Beauty AR Web into Mini Programs
Tencent Effect Studio Usage
Beauty AR Web
Overview
Quick Start
SDK Integration
Parameters and APIs
Console Guide
Demos
Preset Effect List
Practical Tutorial
FAQs
FAQs
General
Technical
License
Legacy Documentation
Recommended Parameters in Beautification Scenarios
Beauty Parameters Table
One-Minute Integration of TRTC
One-Minute Integration of Live Streaming
TE SDK Policy
Privacy Policy
Data Processing And Security Agreement
Contact Us

Using Gesture Recognition

PDF
Focus Mode
Font Size
Last updated: 2025-04-18 15:07:23
The Tencent Effect SDK supports Hand Gesture Recognize starting from v1.0.23.

Enable Hand Gesture Module

Enable the hand gesture module when initializing the SDK.
import { ArSdk } from 'tencentcloud-webar';
const sdk = new ArSdk(
{
module: {
beautify: true, // Beauty, Makeup, Face Effects module
handGesture: true // Hand gesture recognition module
},
auth: { // The authentication information
licenseKey: 'xxxxxxxxx',
appId: 'xxx',
authFunc: authFunc
},
camera: { // Pass in the camera parameters
width: 1280,
height: 720
},
beautify: {
whiten: 0.1,
dermabrasion: 0.3,
eye: 0.2,
chin: 0,
lift: 0.1,
shave: 0.2
},
…… // For more config settings, please refer to the「API Documentation」
}
)

Listen for Gesture Changes.

After enabling gesture recognition, trigger handGesture when a gesture change occurs.
// After enabling gesture recognition, it will trigger when a gesture change is detected.
sdk.on('handGesture',(hands)=>{
console.log('handGesture', hands) // Refer to the following "Hand Object Structure" for hands.
…… // Other business code, such as setting effects through the SDK's setEffect interface, etc.
})

Hand Object Structure


Hand: {
gesture: string // Gesture names, optional values include: None, Thumb_Up, Thumb_Down, Victory, Pointing_Up, Open_Palm, ILoveYou, Closed_Fist.
handedness: string // Recognized as left hand or right hand, values are Left, Right.
}
Hands: Array<Hand>

List of supported Gestures.

Hand gesture value
Detail
None
No valid gesture recognized
Thumb_Up
Thumbs up


Thumb_Down
Thumb down


Victory
victory


Pointing_Up
pointing up


Open_Palm
open palm


ILoveYou
i love you


Closed_Fist
close fist



Help and Support

Was this page helpful?

Help us improve! Rate your documentation experience in 5 mins.

Feedback