@sssxyd/face-liveness-detector 0.4.0-alpha.9 → 0.4.0

package/dist/types/types.d.ts

@@ -32,6 +32,14 @@ export interface FaceDetectionEngineOptions {
     tensorflow_wasm_path?: string;
     /** TensorFlow 后端选择 */
     tensorflow_backend?: 'auto' | 'webgl' | 'wasm';
+    /** 调试模式 */
+    debug_mode?: boolean;
+    /** 调试日志最低级别（默认 'info'） */
+    debug_log_level?: 'info' | 'warn' | 'error';
+    /** 调试日志阶段过滤（默认全部）- 可选择特定阶段 */
+    debug_log_stages?: string[];
+    /** 调试日志节流间隔（毫秒，默认 0 表示不节流） */
+    debug_log_throttle?: number;
     /** 视频流建议分辨率宽度（默认 1920） */
     detect_video_ideal_width?: number;
     /** 视频流建议分辨率高度（默认 1080） */
@@ -40,10 +48,8 @@ export interface FaceDetectionEngineOptions {
     detect_video_mirror?: boolean;
     /** 加载视频流的超时时间（毫秒，默认 5000） */
     detect_video_load_timeout?: number;
-    /** 检测帧之间的延迟（毫秒，默认 100） */
+    /** 检测帧之间的延迟（毫秒，默认 150） */
     detect_frame_delay?: number;
-    /** 错误后重试前的延迟（毫秒，默认 200） */
-    detect_error_retry_delay?: number;
     /** 要采集的静默检测次数（默认 3） */
     collect_min_collect_count?: number;
     /** 最小人脸尺寸比例（默认 0.5） */
@@ -68,56 +74,8 @@ export interface FaceDetectionEngineOptions {
     action_liveness_verify_timeout?: number;
     /** 最小嘴部张开百分比（默认 0.2） */
     action_liveness_min_mouth_open_percent?: number;
-    /** 通过活体检查的最小运动分数（0-1，默认 0.15） */
-    motion_liveness_min_motion_score?: number;
-    /** 自然运动的最小关键点方差（0-1，默认 0.02） */
-    motion_liveness_min_keypoint_variance?: number;
-    /** 用于运动分析的帧缓冲区数量（默认 5） */
-    motion_liveness_frame_buffer_size?: number;
-    /** 眨眼检测的眼睛长宽比阈值（默认 0.15） */
-    motion_liveness_eye_aspect_ratio_threshold?: number;
-    /** 光流和关键点方差一致性阈值 (0-1，默认 0.3) - 防止照片微动 */
-    motion_liveness_motion_consistency_threshold?: number;
-    /** 最小光流幅度阈值 - 照片几乎无光流 (0-1，默认 0.02) */
-    motion_liveness_min_optical_flow_threshold?: number;
     /** 是否启用严格照片检测模式（默认 false） */
     motion_liveness_strict_photo_detection?: boolean;
-    /** 屏幕采集的置信度阈值（0-1，默认 0.7） */
-    screen_capture_confidence_threshold?: number;
-    /** 屏幕采集检测策略（默认 'adaptive'） */
-    screen_capture_detection_strategy?: 'fastest' | 'fast' | 'accurate' | 'adaptive';
-    /** 综合莫尔纹置信度阈值（0-1，默认 0.65） */
-    screen_moire_pattern_threshold?: number;
-    /** 是否启用 DCT 分析（默认 true） */
-    screen_moire_pattern_enable_dct?: boolean;
-    /** 是否启用边缘检测（默认 true） */
-    screen_moire_pattern_enable_edge_detection?: boolean;
-    /** 色彩饱和度阈值（0-100%，屏幕图像通常 < 40%，默认 40） */
-    screen_color_saturation_threshold?: number;
-    /** RGB通道相关性阈值（0-1，屏幕通常 > 0.85，默认 0.75） */
-    screen_color_rgb_correlation_threshold?: number;
-    /** 像素值熵阈值（0-8，屏幕通常 < 6.5，默认 6.5） */
-    screen_color_pixel_entropy_threshold?: number;
-    /** 梯度平滑性阈值（0-1，屏幕通常 > 0.7，默认 0.7） */
-    screen_color_gradient_smoothness_threshold?: number;
-    /** 综合置信度阈值（0-1，用于判定是否为屏幕拍摄，默认 0.65） */
-    screen_color_confidence_threshold?: number;
-    /** 低频段开始位置（相对于频谱长度的百分比，默认 0.15） */
-    screen_rgb_low_freq_start_percent?: number;
-    /** 低频段结束位置（相对于频谱长度的百分比，默认 0.35） */
-    screen_rgb_low_freq_end_percent?: number;
-    /** 能量比归一化因子（默认 10） */
-    screen_rgb_energy_ratio_normalization_factor?: number;
-    /** 通道均值差异的归一化因子（默认 50） */
-    screen_rgb_channel_difference_normalization_factor?: number;
-    /** RGB 周期性能量权重（默认 0.40） */
-    screen_rgb_energy_score_weight?: number;
-    /** RGB 通道不同步程度权重（默认 0.40） */
-    screen_rgb_asymmetry_score_weight?: number;
-    /** 通道均值差异权重（默认 0.20） */
-    screen_rgb_difference_factor_weight?: number;
-    /** RGB 屏幕拍摄的置信度阈值（默认 0.65） */
-    screen_rgb_confidence_threshold?: number;
 }
 /**
  * 与默认值合并后的已解析配置

package/dist/types/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types/video-frame-collector.d.ts

@@ -0,0 +1,111 @@
+/**
+ * 公共帧采集器 - 统一管理多帧图像
+ *
+ * 核心功能：
+ * - 采集灰度和彩色帧
+ * - 计算视频FPS
+ * - 为多个检测器提供帧缓冲
+ * - 支持时间戳记录
+ */
+export interface FrameCollectorConfig {
+    bufferSize: number;
+}
+/**
+ * 公共帧采集器
+ *
+ * 多个检测器可以共用一个 VideoFrameCollector 实例，减少内存占用和代码重复
+ */
+export declare class VideoFrameCollector {
+    private config;
+    private grayFrames;
+    private bgrFrames;
+    private frameTimestamps;
+    private frameWidth;
+    private frameHeight;
+    private averageFps;
+    private fpsHistory;
+    constructor(config?: Partial<FrameCollectorConfig>);
+    /**
+     * 添加一帧（灰度 + 可选的彩色）
+     *
+     * @param grayMat 灰度图像矩阵（必需）
+     * @param bgrMat 彩色图像矩阵，BGR格式（可选）
+     * @param frameTimestamp 帧时间戳，毫秒（可选，默认使用当前时间）
+     */
+    addFrame(grayMat: any, bgrMat?: any, frameTimestamp?: number): void;
+    /**
+     * 获取灰度帧缓冲区（直接引用，不复制）
+     * @param n 返回最后n个帧，<=0或不提供则返回全部
+     */
+    getGrayFrames(n?: number): Uint8Array[];
+    /**
+     * 获取彩色帧缓冲区（可能包含null值）
+     * @param n 返回最后n个帧，<=0或不提供则返回全部
+     */
+    getBgrFrames(n?: number): (Uint8Array | null)[];
+    /**
+     * 获取指定索引的灰度帧
+     */
+    getGrayFrame(index: number): Uint8Array | null;
+    /**
+     * 获取指定索引的彩色帧
+     */
+    getBgrFrame(index: number): Uint8Array | null;
+    /**
+     * 获取当前缓冲区中的帧数
+     */
+    getBufferedFrameCount(): number;
+    /**
+     * 获取帧时间戳
+     */
+    getFrameTimestamp(index: number): number | null;
+    /**
+     * 获取所有帧的时间戳
+     */
+    getFrameTimestamps(): number[];
+    /**
+     * 获取帧尺寸
+     */
+    getFrameSize(): {
+        width: number;
+        height: number;
+    };
+    getFrameWidth(): number;
+    getFrameHeight(): number;
+    /**
+     * 获取平均FPS
+     */
+    getAverageFps(): number;
+    /**
+     * 重置收集器，清空所有缓冲区
+     */
+    reset(): void;
+    /**
+     * 清空帧缓冲区，但保留配置和FPS统计
+     */
+    clearFrames(): void;
+    /**
+     * 获取统计信息
+     */
+    getStats(): {
+        bufferedFrames: number;
+        bufferSize: number;
+        frameWidth: number;
+        frameHeight: number;
+        averageFps: number;
+        fpsHistory: number[];
+    };
+    /**
+     * 获取最近N帧（用于批量处理）
+     */
+    getLastNFrames(n: number): {
+        grayFrames: Uint8Array[];
+        bgrFrames: (Uint8Array | null)[];
+        timestamps: number[];
+    };
+    /**
+     * 更新FPS统计
+     */
+    private updateFpsStats;
+}
+//# sourceMappingURL=video-frame-collector.d.ts.map

package/dist/types/video-frame-collector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"video-frame-collector.d.ts","sourceRoot":"","sources":["../../src/video-frame-collector.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,WAAW,oBAAoB;IAEnC,UAAU,EAAE,MAAM,CAAA;CACnB;AAED;;;;GAIG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,MAAM,CAAsB;IAGpC,OAAO,CAAC,UAAU,CAAmB;IACrC,OAAO,CAAC,SAAS,CAAmB;IACpC,OAAO,CAAC,eAAe,CAAe;IAGtC,OAAO,CAAC,UAAU,CAAY;IAC9B,OAAO,CAAC,WAAW,CAAY;IAG/B,OAAO,CAAC,UAAU,CAAY;IAC9B,OAAO,CAAC,UAAU,CAAe;gBAErB,MAAM,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC;IAMlD;;;;;;OAMG;IACH,QAAQ,CAAC,OAAO,EAAE,GAAG,EAAE,MAAM,CAAC,EAAE,GAAG,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI;IAyCnE;;;OAGG;IACH,aAAa,CAAC,CAAC,CAAC,EAAE,MAAM,GAAG,UAAU,EAAE;IAOvC;;;OAGG;IACH,YAAY,CAAC,CAAC,CAAC,EAAE,MAAM,GAAG,CAAC,UAAU,GAAG,IAAI,CAAC,EAAE;IAO/C;;OAEG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAO9C;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAO7C;;OAEG;IACH,qBAAqB,IAAI,MAAM;IAI/B;;OAEG;IACH,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAO/C;;OAEG;IACH,kBAAkB,IAAI,MAAM,EAAE;IAI9B;;OAEG;IACH,YAAY,IAAI;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;IAOjD,aAAa,IAAI,MAAM;IAIvB,cAAc,IAAI,MAAM;IAIxB;;OAEG;IACH,aAAa,IAAI,MAAM;IAIvB;;OAEG;IACH,KAAK,IAAI,IAAI;IASb;;OAEG;IACH,WAAW,IAAI,IAAI;IAOnB;;OAEG;IACH,QAAQ,IAAI;QACV,cAAc,EAAE,MAAM,CAAA;QACtB,UAAU,EAAE,MAAM,CAAA;QAClB,UAAU,EAAE,MAAM,CAAA;QAClB,WAAW,EAAE,MAAM,CAAA;QACnB,UAAU,EAAE,MAAM,CAAA;QAClB,UAAU,EAAE,MAAM,EAAE,CAAA;KACrB;IAWD;;OAEG;IACH,cAAc,CAAC,CAAC,EAAE,MAAM,GAAG;QACzB,UAAU,EAAE,UAAU,EAAE,CAAA;QACxB,SAAS,EAAE,CAAC,UAAU,GAAG,IAAI,CAAC,EAAE,CAAA;QAChC,UAAU,EAAE,MAAM,EAAE,CAAA;KACrB;IASD;;OAEG;IACH,OAAO,CAAC,cAAc;CAiCvB"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "type": "module",
   "name": "@sssxyd/face-liveness-detector",
-  "version": "0.4.0-alpha.9",
+  "version": "0.4.0",
   "description": "Pure JS/TS implementation of liveness face detection based on human.js and opencv.js",
   "main": "dist/index.js",
   "module": "dist/index.esm.js",
@@ -26,6 +26,7 @@
   "files": [
     "dist",
     "README.md",
+    "README.en.md",
     "LICENSE"
   ],
   "scripts": {