手势识别(Hand)--智能美化特效-火山引擎

文档中心

导航

手势识别(Hand)

最近更新时间：2025.03.14 10:08:02首次发布时间：2025.03.14 10:08:02

手势识别SDK提供多达45种手势分类及关键点跟踪、分割能力,具有跟踪稳定、性能开销小等特点，可应用于手势交互场景中。
手势检测关键点索引图:

1.创建手势检测句柄

int HeidiHandCreateHandle(unsigned long long config, HeidiHandle *handle);

参数说明

参数名	参数类型	参数说明
handle	HeidiHandle	创建的手势检测句柄
config	unsigned long long	手势检测算法的配置，目前无用

返回值
成功返回 HEIDI_CODE_SUC, 失败返回相应错误码, 具体请参考 HeidiPublicDefines.h

2.手势检测授权

int HeidiHandCheckLicense(
        HeidiHandle  handle, 
        const char *licensePath
        );

参数说明

参数名	参数类型	参数说明
handle	HeidiHandle	创建的手势检测句柄
licensePath	const char *	授权文件字符串

返回值
成功返回 HEIDI_CODE_SUC, 失败返回相应错误码, 具体请参考 HeidiPublicDefines.h

3.设置模型文件

int
HeidiHandSetModel(
        HeidiHandle handle,
        HeidiHandModelType type,
        const char * strModelPath);

参数说明

参数名	参数类型	参数说明
handle	HeidiHandle	创建的手势检测句柄
type	HeidiHandModelType	模型文件类型，见HeidiHandModelType
strModelPath	const char *	模型文件路径

返回值
成功返回 HEIDI_CODE_SUC, 失败返回相应错误码, 具体请参考 HeidiPublicDefines.h

4.设置参数

int
HeidiHandSetParam(
        HeidiHandle handle,
        HeidiHandParamType type,
        float value
        );

参数说明

参数名	参数类型	参数说明
handle	HeidiHandle	创建的手势检测句柄
type	HeidiHandParamType	参数类型，见HeidiHandParamType
value	float	模型文件路径

返回值
成功返回 HEIDI_CODE_SUC, 失败返回相应错误码, 具体请参考 HeidiPublicDefines.h

5.手势检测

int
HeidiHandDetect(
        HeidiHandle handle,
        const unsigned char *image,
        ColorSpaceType pixel_format,
        int image_width,
        int image_height,
        int image_stride,
        ClockwiseRotateType orientation,
        unsigned long long detection_config,
        HeidiHandInfo *p_hand_info,
        int delayframecount
        );

参数说明

参数名	参数类型	参数说明
handle	HeidiHandle	创建的手势检测句柄
image	const unsigned char *	输入图片的数据指针
pixel_format	ColorSpaceType	输入图片的格式
image_width	int	输入图像的宽度（单位，像素）
image_height	int	输入图像的高度（单位，像素）
image_stride	int	输入图像的每一行步长（单位，字节）
orientation	ClockwiseRotateType	输入图像的转向，见备注
detection_config	unsigned long long	请求检测的模块，见备注
p_hand_info	HeidiHandInfo	存放结果信息，外部分配内存
delayframecount	int	输出结果的延迟，见备注

备注
1.detection_config
请求检测的模块，为 HeidiHandModelType 的按位与操作，目前只有HEIDI_HAND_MODEL_GESTURE_CLS 和 HEIDI_HAND_MODEL_KEY_POINT 是可选的
2.delayframecount
输出结果的延迟，算法会在 delayframecount 帧之后返回检测的结果，值越大检测结果越稳定，默认值为 4
返回值
成功返回 HEIDI_CODE_SUC, 失败返回相应错误码, 具体请参考 HeidiPublicDefines.h

6.销毁手势检测句柄

int
HeidiHandReleaseHandle(HeidiHandle handle);

参数说明

参数名	参数类型	参数说明
handle	HeidiHandle	创建的手势检测句柄