#pragma once
// [T05] 人脸追踪模块 C 可见接口
// 三重保护：
//   1. Kconfig: XIAOZHI_ENABLE_FACE_TRACKING depends on IDF_TARGET_ESP32S3
//   2. 本模块 .cc 内 #if defined(CONFIG_...) && defined(CONFIG_IDF_TARGET_ESP32S3) 包裹实现
//   3. CMakeLists.txt 在非 S3 目标时从 SOURCES 中移除 face_tracker.cc

#ifdef __cplusplus
extern "C" {
#endif

// 启动人脸检测任务。Kconfig 未开启 / 非 S3 时本函数为空壳。
// 幂等：重复调用不会创建多个任务。
void face_tracker_start(void);

// 请求停止人脸检测任务（异步，任务会在下一帧自行退出）。
void face_tracker_stop(void);

// 供日志/诊断查询最近一次 10 秒统计窗口的实际 FPS（命中+未命中 / 间隔）。
float face_tracker_get_fps(void);

#ifdef __cplusplus
}
#endif