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

package/dist/types/browser_utils.d.ts

@@ -2,10 +2,10 @@
  * 将绘制图片的canvas转换为mat
  * @param {any} cv OpenCV实例
  * @param {HTMLCanvasElement} canvas canvas元素
- * @param {boolean} gray 是否转换为灰度图像
- * @returns {any | null} - 转换后的Mat对象，如果转换失败则返回null
+ * @param {any} dstMat 目标Mat对象，将canvas数据写入此Mat
+ * @returns {any | null} - 返回传入的Mat对象，如果转换失败则返回null
  */
-export declare function drawCanvasToMat(cv: any, canvas: HTMLCanvasElement, gray: boolean): any | null;
+export declare function drawCanvasToMat(cv: any, canvas: HTMLCanvasElement, dstMat: any): any | null;
 export declare function matToGray(cv: any, mat: any): any | null;
 /**
  * Convert OpenCV Mat to Base64 JPEG image

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

@@ -1 +1 @@
-{"version":3,"file":"browser_utils.d.ts","sourceRoot":"","sources":["../../src/browser_utils.ts"],"names":[],"mappings":"AACA;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,iBAAiB,EAAE,IAAI,EAAE,OAAO,GAAG,GAAG,GAAG,IAAI,CAiB7F;AAED,wBAAgB,SAAS,CAAC,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,GAAG,GAAG,GAAG,IAAI,CAWvD;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,OAAO,GAAE,MAAY,GAAG,MAAM,GAAG,IAAI,CA6BvF"}
+{"version":3,"file":"browser_utils.d.ts","sourceRoot":"","sources":["../../src/browser_utils.ts"],"names":[],"mappings":"AACA;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,EAAE,GAAG,GAAG,GAAG,GAAG,IAAI,CAsB3F;AAED,wBAAgB,SAAS,CAAC,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,GAAG,GAAG,GAAG,IAAI,CAWvD;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,OAAO,GAAE,MAAY,GAAG,MAAM,GAAG,IAAI,CA6BvF"}

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

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,0BAA0B,EAAE,MAAM,SAAS,CAAA;AA8EhF;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,UAAU,CAAC,EAAE,OAAO,CAAC,0BAA0B,CAAC,GAC/C,qBAAqB,CAwBvB"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,0BAA0B,EAAE,MAAM,SAAS,CAAA;AAsDhF;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,UAAU,CAAC,EAAE,OAAO,CAAC,0BAA0B,CAAC,GAC/C,qBAAqB,CAwBvB"}

package/dist/types/dlp-color-wheel-detector.d.ts

@@ -0,0 +1,76 @@
+/**
+ * DLP色轮检测器 - 检测DLP投影仪的特有伪影
+ *
+ * 核心原理：
+ * - DLP投影仪使用单色DMD芯片 + RGB色轮
+ * - 色轮以高频率（120-144Hz）轮换RGB颜色
+ * - 摄像头如果不同步捕捉，会看到RGB分离现象
+ *
+ * 特征：
+ * 1. 高对比度边界处出现"彩虹纹"（R左/B右分离）
+ * 2. 快速移动物体边缘有明显的RGB分离
+ * 3. 静止物体通常正常（因为色轮平均后是白色）
+ *
+ * 检测方法：
+ * 1. 找高对比度边界区域
+ * 2. 分析边界处R、G、B通道的位置差异
+ * 3. 如果R领先，B延后 → DLP特征
+ */
+import { VideoFrameCollector } from "./video-frame-collector";
+export interface DLPColorWheelDetectorConfig {
+    bufferSize: number;
+    edgeThreshold: number;
+    minChannelSeparationPixels: number;
+    separationConfidenceThreshold: number;
+    samplingStride: number;
+}
+export interface DLPColorWheelDetectionResult {
+    isScreenCapture: boolean;
+    confidence: number;
+    hasColorSeparation: boolean;
+    colorSeparationPixels: number;
+    redLeadPixels?: number;
+    blueDelayPixels?: number;
+    sampledEdgePixelCount: number;
+    estimatedColorWheelFrequency?: number;
+    details?: {
+        edgeLocations: number[];
+        separationDistances: number[];
+    };
+}
+export declare class DLPColorWheelDetector {
+    private config;
+    private frameCollector;
+    constructor(frameCollector: VideoFrameCollector, config: DLPColorWheelDetectorConfig);
+    /**
+     * 获取当前缓冲区中的帧数
+     */
+    getBufferedFrameCount(): number;
+    /**
+     * 执行DLP色轮检测分析
+     */
+    analyze(): DLPColorWheelDetectionResult;
+    /**
+     * 重置检测器
+     * 注意：帧缓冲由 FrameCollector 管理
+     */
+    reset(): void;
+    /**
+     * 检测高对比度边界
+     * 返回边界的x坐标位置
+     */
+    private detectHighContrastEdges;
+    /**
+     * 分析单条边界的RGB分离
+     *
+     * DLP特征：
+     * - R通道的边界比G靠前（向左）
+     * - B通道的边界比G靠后（向右）
+     */
+    private analyzeRGBSeparation;
+    /**
+     * 找导数数组中的峰值位置
+     */
+    private findPeakPosition;
+}
+//# sourceMappingURL=dlp-color-wheel-detector.d.ts.map

package/dist/types/dlp-color-wheel-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dlp-color-wheel-detector.d.ts","sourceRoot":"","sources":["../../src/dlp-color-wheel-detector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAA;AAE7D,MAAM,WAAW,2BAA2B;IAE1C,UAAU,EAAE,MAAM,CAAA;IAGlB,aAAa,EAAE,MAAM,CAAA;IAGrB,0BAA0B,EAAE,MAAM,CAAA;IAGlC,6BAA6B,EAAE,MAAM,CAAA;IAGrC,cAAc,EAAE,MAAM,CAAA;CACvB;AAED,MAAM,WAAW,4BAA4B;IAC3C,eAAe,EAAE,OAAO,CAAA;IACxB,UAAU,EAAE,MAAM,CAAA;IAGlB,kBAAkB,EAAE,OAAO,CAAA;IAC3B,qBAAqB,EAAE,MAAM,CAAA;IAC7B,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,eAAe,CAAC,EAAE,MAAM,CAAA;IAGxB,qBAAqB,EAAE,MAAM,CAAA;IAG7B,4BAA4B,CAAC,EAAE,MAAM,CAAA;IAErC,OAAO,CAAC,EAAE;QACR,aAAa,EAAE,MAAM,EAAE,CAAA;QACvB,mBAAmB,EAAE,MAAM,EAAE,CAAA;KAC9B,CAAA;CACF;AAED,qBAAa,qBAAqB;IAChC,OAAO,CAAC,MAAM,CAA6B;IAC3C,OAAO,CAAC,cAAc,CAAqB;gBAE/B,cAAc,EAAE,mBAAmB,EAAE,MAAM,EAAE,2BAA2B;IAKpF;;OAEG;IACH,qBAAqB,IAAI,MAAM;IAI/B;;OAEG;IACH,OAAO,IAAI,4BAA4B;IA8HvC;;;OAGG;IACH,KAAK,IAAI,IAAI;IAKb;;;OAGG;IACH,OAAO,CAAC,uBAAuB;IAyC/B;;;;;;OAMG;IACH,OAAO,CAAC,oBAAoB;IAgE5B;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAgBzB"}

package/dist/types/face-detection-engine.d.ts

@@ -14,15 +14,22 @@ export declare class FaceDetectionEngine extends SimpleEventEmitter {
     private cv;
     private human;
     private engineState;
+    private videoFPS;
+    private lastDebugLogTime;
+    private debugLogLevelPriority;
     private videoElement;
     private stream;
     private frameCanvasElement;
     private frameCanvasContext;
-    private faceCanvasElement;
-    private faceCanvasContext;
-    private detectionFrameId;
+    private animationFrameId;
     private actualVideoWidth;
     private actualVideoHeight;
+    private preallocatedBgrFrame;
+    private preallocatedGrayFrame;
+    private isDetectingFrameActive;
+    private frameIndex;
+    private lastDetectionFrameIndex;
+    private lastScreenFeatureDetectionFrameIndex;
     private detectionState;
     /**
      * Constructor
@@ -41,6 +48,37 @@ export declare class FaceDetectionEngine extends SimpleEventEmitter {
     private getStackTrace;
     updateOptions(options?: Partial<FaceDetectionEngineOptions>): void;
     getEngineState(): EngineState;
+    /**
+     * Atomically transition engine state with validation
+     * Ensures state transitions follow the valid state machine
+     * @param newState - Target engine state
+     * @param context - Debug context for logging
+     * @returns true if transition succeeded, false otherwise
+     */
+    private transitionEngineState;
+    /**
+     * Check if state transition is valid according to state machine rules
+     * Valid transitions:
+     * - IDLE -> INITIALIZING, INITIALIZING -> READY, READY -> DETECTING, DETECTING -> READY
+     * - Any -> IDLE (error recovery)
+     */
+    private isValidStateTransition;
+    /**
+     * Transition detection period state
+     * @param newPeriod - Target detection period
+     * @returns true if transition succeeded
+     */
+    private transitionDetectionPeriod;
+    /**
+     * Partially reset detection state (keeps engine initialized)
+     * Used when detection fails but engine should remain ready
+     */
+    private partialResetDetectionState;
+    /**
+     * Fully reset detection state and resources
+     * Used when stopping detection or reinitializing
+     */
+    private fullResetDetectionState;
     /**
      * Initialize the detection engine
      * Loads Human.js and OpenCV.js libraries
@@ -60,6 +98,7 @@ export declare class FaceDetectionEngine extends SimpleEventEmitter {
     startDetection(videoElement: HTMLVideoElement): Promise<void>;
     /**
      * Stop face detection
+     * Performs comprehensive cleanup to prevent memory leaks and UI freezing
      * @param success - Whether to display the best collected image
      */
     stopDetection(success: boolean): void;
@@ -68,23 +107,83 @@ export declare class FaceDetectionEngine extends SimpleEventEmitter {
      * @returns Current configuration
      */
     getOptions(): FaceDetectionEngineOptions;
+    private updateVideoFPS;
+    /**
+     * Adjust detect_frame_delay to ensure main detection interval is at least 3 frames
+     * This is important for proper spacing of corner detection, feature detection, and main detection
+     */
+    private adjustDetectFrameDelay;
+    /**
+     * Get the frame interval for main face detection based on videoFPS and detect_frame_delay
+     * Uses Math.ceil to ensure actual interval >= configured delay
+     * @returns Number of frames between detections
+     */
+    private getDetectionFrameInterval;
+    /**
+     * Check if main face detection should be performed this frame
+     * @returns true if enough frames have passed since last detection
+     */
+    private shouldPerformMainDetection;
     /**
-     * Reset detection state
+     * Check if screen corner detection should be performed this frame
+     * Executes once per main detection interval
+     * Logic:
+     * - If mainInterval <= 2: disabled (insufficient frames)
+     * - If mainInterval > 2: executes at calculated point, unless it's the last frame
+     * @returns true if conditions are met
      */
-    private resetDetectionState;
+    private shouldPerformScreenCornersDetection;
     /**
-     * Schedule next detection frame
+     * Check if screen feature detection (multi-frame) should be performed this frame
+     * Logic:
+     * - Executes at calculated point in the cycle (40% position)
+     * - If missed, can execute at last frame of cycle (fallback)
+     * @returns true if conditions are met
      */
-    private scheduleNextDetection;
+    private shouldPerformScreenFeatureDetection;
     /**
      * Cancel pending detection frame
      */
     private cancelPendingDetection;
     /**
      * Main detection loop
+     * Called every frame via requestAnimationFrame
+     * Orchestrates the detection pipeline with clear separation of concerns
      */
     private detect;
+    /**
+     * Check if current frame should be captured based on detection scheduling
+     */
+    private shouldCaptureFrame;
+    /**
+     * Capture video frame and convert to BGR and Grayscale Mat objects
+     * @returns {Object | null} Object with bgrFrame and grayFrame, or null if failed
+     */
+    private captureAndPrepareFrames;
+    /**
+     * Perform screen detection (corners and multi-frame features)
+     * @returns true if screen is detected, false otherwise
+     */
+    private performScreenDetection;
+    /**
+     * Perform main face detection and handle results
+     */
+    private performFaceDetection;
+    /**
+     * Clean up frame Mat objects
+     * Note: Both BGR and Gray Mats are preallocated and reused
+     * They are only deleted in clearPreallocatedMats()
+     */
+    private cleanupFrames;
     private getPerformActionCount;
+    /**
+     * Detect screen by corners and contours analysis (fast detection)
+     */
+    private detectScreenCorners;
+    /**
+     * Detect screen by multi-frame feature analysis
+     */
+    private detectScreenFeatures;
     /**
      * Handle single face detection
      */
@@ -121,22 +220,20 @@ export declare class FaceDetectionEngine extends SimpleEventEmitter {
     private emitDebug;
     /**
      * Draw video frame to canvas (internal use, not converted to Base64)
+     * Handles potential runtime resolution changes from camera stream
      * @returns {HTMLCanvasElement | null} Canvas after drawing, returns null if failed
      */
     private drawVideoToCanvas;
     private clearFrameCanvas;
-    private clearFaceCanvas;
     /**
-     * 将 canvas 转换为 Base64 JPEG 图片数据
-     * @param {HTMLCanvasElement} canvas - 输入的 canvas
-     * @returns {string | null} Base64 格式的 JPEG 图片数据
+     * Ensure preallocated Mat objects exist with correct dimensions
+     * Creates both BGR and Gray Mat for reuse
      */
-    private canvasToBase64;
+    private ensurePreallocatedMats;
     /**
-     * Capture current video frame (returns Base64)
-     * @param {Box} box - Face box
-     * @returns {string | null} Base64 encoded JPEG image data
+     * Clear preallocated Mat objects
+     * Called when resolution changes or detection stops
      */
-    private captureFrame;
+    private clearPreallocatedMats;
 }
 //# sourceMappingURL=face-detection-engine.d.ts.map

package/dist/types/face-detection-engine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"face-detection-engine.d.ts","sourceRoot":"","sources":["../../src/face-detection-engine.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EACV,0BAA0B,EAQ3B,MAAM,SAAS,CAAA;AAChB,OAAO,EAAmF,WAAW,EAAE,MAAM,SAAS,CAAA;AAEtH,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AAwBpD;;;GAGG;AACH,qBAAa,mBAAoB,SAAQ,kBAAkB;IACzD,OAAO,CAAC,OAAO,CAAuB;IAEtC,OAAO,CAAC,EAAE,CAAY;IACtB,OAAO,CAAC,KAAK,CAAqB;IAElC,OAAO,CAAC,WAAW,CAAgC;IAGnD,OAAO,CAAC,YAAY,CAAgC;IACpD,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,kBAAkB,CAAiC;IAC3D,OAAO,CAAC,kBAAkB,CAAwC;IAClE,OAAO,CAAC,iBAAiB,CAAiC;IAC1D,OAAO,CAAC,iBAAiB,CAAwC;IAEjE,OAAO,CAAC,gBAAgB,CAAsB;IAE9C,OAAO,CAAC,gBAAgB,CAAY;IACpC,OAAO,CAAC,iBAAiB,CAAY;IAErC,OAAO,CAAC,cAAc,CAAgB;IAEtC;;;OAGG;gBACS,OAAO,CAAC,EAAE,OAAO,CAAC,0BAA0B,CAAC;IAMzD;;;;OAIG;IACH,OAAO,CAAC,gBAAgB;IAqCxB;;OAEG;IACH,OAAO,CAAC,aAAa;IAerB,aAAa,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,0BAA0B,CAAC,GAAG,IAAI;IASlE,cAAc,IAAI,WAAW;IAI7B;;;;;;OAMG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAkLjC;;;;;;;OAOG;IACG,cAAc,CAAC,YAAY,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAoJnE;;;OAGG;IACH,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IA8BrC;;;OAGG;IACH,UAAU,IAAI,0BAA0B;IAMxC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAS3B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAc7B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAO9B;;OAEG;YACW,MAAM;IA6DpB,OAAO,CAAC,qBAAqB;IAY7B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAqPxB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAKzB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAI1B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAkDzB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAe3B,OAAO,CAAC,uBAAuB;IA6B/B,OAAO,CAAC,gBAAgB;IAgBxB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAuCxB;;OAEG;IACH,OAAO,CAAC,YAAY;IAuCpB;;OAEG;IACH,OAAO,CAAC,SAAS;IAgBjB;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAwDzB,OAAO,CAAC,gBAAgB;IAWxB,OAAO,CAAC,eAAe;IAWvB;;;;OAIG;IACH,OAAO,CAAC,cAAc;IAWtB;;;;OAIG;IACH,OAAO,CAAC,YAAY;CA+BrB"}
+{"version":3,"file":"face-detection-engine.d.ts","sourceRoot":"","sources":["../../src/face-detection-engine.ts"],"names":[],"mappings":"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"}

package/dist/types/face-detection-state.d.ts

@@ -1,7 +1,7 @@
 import { DetectionPeriod, LivenessAction } from "./enums";
 import { MotionLivenessDetector } from "./motion-liveness-detector";
 import { ScreenCaptureDetector } from './screen-capture-detector';
-import { ResolvedEngineOptions } from "./types";
+import { ScreenCornersContourDetector } from './screen-corners-contour-detector';
 /**
  * Internal detection state interface
  */
@@ -19,9 +19,12 @@ export declare class DetectionState {
     lastFrontalScore: number;
     motionDetector: MotionLivenessDetector | null;
     liveness: boolean;
+    realness: boolean;
     screenDetector: ScreenCaptureDetector | null;
+    cornersContourDetector: ScreenCornersContourDetector | null;
     constructor(options: Partial<DetectionState>);
     reset(): void;
+    updateVideoFPS(fps: number): void;
     needFrontalFace(): boolean;
     isReadyToVerify(minCollectCount: number): boolean;
     onActionStarted(nextAction: LivenessAction, timeoutMills: number, timeoutCallback: () => void): void;
@@ -32,5 +35,5 @@ export declare class DetectionState {
      */
     private clearActionVerifyTimeout;
 }
-export declare function createDetectionState(options: ResolvedEngineOptions): DetectionState;
+export declare function createDetectionState(fps: number, strictPhotoDetection: boolean): DetectionState;
 //# sourceMappingURL=face-detection-state.d.ts.map

package/dist/types/face-detection-state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"face-detection-state.d.ts","sourceRoot":"","sources":["../../src/face-detection-state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,cAAc,EAAwB,MAAM,SAAS,CAAA;AAC/E,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAA;AACnE,OAAO,EAAE,qBAAqB,EAA6B,MAAM,2BAA2B,CAAA;AAC5F,OAAO,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAA;AAE/C;;GAEG;AACH,qBAAa,cAAc;IACvB,MAAM,EAAE,eAAe,CAAyB;IAChD,SAAS,EAAE,MAAM,CAAoB;IACrC,YAAY,EAAE,MAAM,CAAI;IACxB,oBAAoB,EAAE,MAAM,CAAI;IAChC,gBAAgB,EAAE,MAAM,CAAI;IAC5B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAO;IACpC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAO;IACnC,gBAAgB,EAAE,GAAG,CAAC,cAAc,CAAC,CAAY;IACjD,aAAa,EAAE,cAAc,GAAG,IAAI,CAAO;IAC3C,mBAAmB,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,GAAG,IAAI,CAAO;IAChE,gBAAgB,EAAE,MAAM,CAAI;IAC5B,cAAc,EAAE,sBAAsB,GAAG,IAAI,CAAO;IACpD,QAAQ,EAAE,OAAO,CAAQ;IACzB,cAAc,EAAE,qBAAqB,GAAG,IAAI,CAAO;gBAEvC,OAAO,EAAE,OAAO,CAAC,cAAc,CAAC;IAI5C,KAAK,IAAI,IAAI;IAeb,eAAe,IAAI,OAAO;IAK1B,eAAe,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO;IAUjD,eAAe,CAAC,UAAU,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,IAAI,GAAG,IAAI;IASpG,iBAAiB,IAAI,IAAI;IASzB,aAAa,CAAC,UAAU,EAAE,GAAG,GAAG,IAAI;IAKpC;;OAEG;IACH,OAAO,CAAC,wBAAwB;CAMnC;AAID,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,qBAAqB,GAAG,cAAc,CA4BnF"}
+{"version":3,"file":"face-detection-state.d.ts","sourceRoot":"","sources":["../../src/face-detection-state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,cAAc,EAAwB,MAAM,SAAS,CAAA;AAC/E,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAA;AACnE,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAA;AACjE,OAAO,EAAE,4BAA4B,EAAE,MAAM,mCAAmC,CAAA;AAGhF;;GAEG;AACH,qBAAa,cAAc;IACvB,MAAM,EAAE,eAAe,CAAyB;IAChD,SAAS,EAAE,MAAM,CAAoB;IACrC,YAAY,EAAE,MAAM,CAAI;IACxB,oBAAoB,EAAE,MAAM,CAAI;IAChC,gBAAgB,EAAE,MAAM,CAAI;IAC5B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAO;IACpC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAO;IACnC,gBAAgB,EAAE,GAAG,CAAC,cAAc,CAAC,CAAY;IACjD,aAAa,EAAE,cAAc,GAAG,IAAI,CAAO;IAC3C,mBAAmB,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,GAAG,IAAI,CAAO;IAChE,gBAAgB,EAAE,MAAM,CAAI;IAC5B,cAAc,EAAE,sBAAsB,GAAG,IAAI,CAAO;IACpD,QAAQ,EAAE,OAAO,CAAQ;IACzB,QAAQ,EAAE,OAAO,CAAQ;IACzB,cAAc,EAAE,qBAAqB,GAAG,IAAI,CAAO;IACnD,sBAAsB,EAAE,4BAA4B,GAAG,IAAI,CAAO;gBAEtD,OAAO,EAAE,OAAO,CAAC,cAAc,CAAC;IAI5C,KAAK,IAAI,IAAI;IAgBb,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAYjC,eAAe,IAAI,OAAO;IAK1B,eAAe,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO;IAUjD,eAAe,CAAC,UAAU,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,IAAI,GAAG,IAAI;IASpG,iBAAiB,IAAI,IAAI;IASzB,aAAa,CAAC,UAAU,EAAE,GAAG,GAAG,IAAI;IAMpC;;OAEG;IACH,OAAO,CAAC,wBAAwB;CAMnC;AAID,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,oBAAoB,EAAE,OAAO,GAAG,cAAc,CAM/F"}

package/dist/types/face-frontal-calculator.d.ts

@@ -32,7 +32,7 @@ export interface AngleAnalysisResult {
  * @param {any} cv - OpenCV 实例（用于轮廓对称性检测）
  * @param {FaceResult} face - 人脸检测结果（包含 rotation 和 annotations 信息）
  * @param {Array<GestureResult>} gestures - 检测到的手势/表情数组（可选）
- * @param {any} matImage - OpenCV Mat 对象（图像数据，用于轮廓检测）
+ * @param {any} grayFrame - OpenCV Mat 对象（图像数据，用于轮廓检测）
  * @param {FaceFrontalFeatures} config - 正对度配置参数（包含角度阈值）
  * @returns {number} 正对度评分 (0-1)，1 表示完全正对
  *
@@ -42,9 +42,9 @@ export interface AngleAnalysisResult {
  * if (score > 0.9) {
  *   console.log('人脸足够正对')
  * }
- * mat.delete()
+ * grayFrame.delete()
  */
-export declare function calcFaceFrontal(cv: any, face: FaceResult, gestures: Array<GestureResult>, matImage: any, config: FaceFrontalFeatures): number;
+export declare function calcFaceFrontal(cv: any, face: FaceResult, gestures: Array<GestureResult>, grayFrame: any, config: FaceFrontalFeatures): number;
 /**
  * 使用手势识别方法检查人脸正对度
  *

package/dist/types/face-frontal-calculator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"face-frontal-calculator.d.ts","sourceRoot":"","sources":["../../src/face-frontal-calculator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAA;AAG7C;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;CACd;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,eAAe,CAC7B,EAAE,EAAE,GAAG,EACP,IAAI,EAAE,UAAU,EAChB,QAAQ,EAAE,KAAK,CAAC,aAAa,CAAC,EAC9B,QAAQ,EAAE,GAAG,EACb,MAAM,EAAE,mBAAmB,GAC1B,MAAM,CAgCR;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,KAAK,CAAC,aAAa,CAAC,GAAG,OAAO,CAUpF;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,mBAAmB,GAAG,MAAM,CA8BhG;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,UAAU,GAAG,mBAAmB,CAUvE;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,mBAAmB,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAiD1G;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAO3D;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,mBAAmB,GAAG,MAAM,EAAE,CAwChG"}
+{"version":3,"file":"face-frontal-calculator.d.ts","sourceRoot":"","sources":["../../src/face-frontal-calculator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAA;AAG7C;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;CACd;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,eAAe,CAC7B,EAAE,EAAE,GAAG,EACP,IAAI,EAAE,UAAU,EAChB,QAAQ,EAAE,KAAK,CAAC,aAAa,CAAC,EAC9B,SAAS,EAAE,GAAG,EACd,MAAM,EAAE,mBAAmB,GAC1B,MAAM,CAgCR;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,KAAK,CAAC,aAAa,CAAC,GAAG,OAAO,CAUpF;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,mBAAmB,GAAG,MAAM,CA8BhG;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,UAAU,GAAG,mBAAmB,CAUvE;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,mBAAmB,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAiD1G;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAO3D;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,mBAAmB,GAAG,MAAM,EAAE,CAwChG"}

package/dist/types/image-quality-calculator.d.ts

@@ -1,14 +1,7 @@
 /**
- * 人脸图像质量检测模块 (统一版)
+ * 图像质量检测模块
  *
- * 综合检测人脸图像的：
- * 1. 完整度检测 - 人脸是否完整在框内
- * 2. 模糊度检测 - 图像是否清晰
- * 3. 轮廓清晰度 - 轮廓的连通性和完整度
- *
- * 使用混合检测策略，结合 Human.js 和 OpenCV.js 优势
  */
-import { FaceResult } from '@vladmandic/human';
 import { ImageQualityFeatures } from './types';
 /**
  * 单个检测指标的结果
@@ -37,30 +30,24 @@ export interface ImageQualityResult {
     suggestions?: string[];
 }
 /**
- * 计算图像质量（完整度 + 清晰度）
+ * 计算图像清晰度评分
  *
- * 综合检测：
- * - 人脸完整度（Human.js边界 + OpenCV轮廓）
- * - 图像清晰度（拉普拉斯方差 + Sobel梯度）
+ * 综合检测图像的清晰度，使用两个指标：
+ * - 拉普拉斯方差 (60%)：检测边缘清晰程度
+ * - Sobel 梯度清晰度 (40%)：检测纹理梯度强度
  *
  * @param cv - OpenCV.js 对象，用于执行图像处理操作
- * @param matImage - OpenCV Mat 对象，包含灰度图像数据
- * @param face - 人脸检测结果，包含人脸框位置和其他检测信息
- * @param imageWidth - 图片宽度（像素），用于边界检查和完整度计算
- * @param imageHeight - 图片高度（像素），用于边界检查和完整度计算
+ * @param grayFrame - OpenCV Mat 对象，包含灰度图像数据（已ROI裁剪）
  * @param config - 检测配置对象，包含：
- *   - require_full_face_in_bounds: 是否要求人脸完全在边界内
- *   - use_opencv_enhancement: 是否使用 OpenCV 增强检测
- *   - min_laplacian_variance: 拉普拉斯方差最小阈值
- *   - min_gradient_sharpness: 梯度清晰度最小阈值
+ *   - min_laplacian_variance: 拉普拉斯方差最小阈值（默认 40）
+ *   - min_gradient_sharpness: 梯度清晰度最小阈值（默认 0.15）
  * @param threshold - 综合质量评分阈值 (0-1)，大于等于此值判定为通过
  * @returns 综合质量检测结果，包含：
  *   - passed: 是否通过质量检测
  *   - score: 综合质量评分 (0-1)
- *   - completenessReasons: 完整度不通过原因列表
+ *   - metrics: 各维度详细指标（拉普拉斯方差、梯度清晰度、综合质量）
  *   - blurReasons: 清晰度不通过原因列表
- *   - metrics: 各维度详细指标（完整度、拉普拉斯方差、梯度清晰度、综合质量）
  *   - suggestions: 改进建议列表
  */
-export declare function calcImageQuality(cv: any, matImage: any, face: FaceResult, imageWidth: number, imageHeight: number, config: ImageQualityFeatures, threshold: number): ImageQualityResult;
+export declare function calcImageQuality(cv: any, grayFrame: any, config: ImageQualityFeatures, threshold: number): ImageQualityResult;
 //# sourceMappingURL=image-quality-calculator.d.ts.map

package/dist/types/image-quality-calculator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"image-quality-calculator.d.ts","sourceRoot":"","sources":["../../src/image-quality-calculator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAC9C,OAAO,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAA;AAI9C;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,OAAO,CAAA;IACf,WAAW,EAAE,MAAM,CAAA;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAEjC,MAAM,EAAE,OAAO,CAAA;IAEf,KAAK,EAAE,MAAM,CAAA;IAEb,mBAAmB,EAAE,MAAM,EAAE,CAAA;IAC7B,WAAW,EAAE,MAAM,EAAE,CAAA;IAErB,OAAO,EAAE;QACP,YAAY,EAAE,mBAAmB,CAAA;QACjC,iBAAiB,EAAE,mBAAmB,CAAA;QACtC,iBAAiB,EAAE,mBAAmB,CAAA;QACtC,cAAc,EAAE,mBAAmB,CAAA;KACpC,CAAA;IAED,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;CACvB;AAID;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,gBAAgB,CAC9B,EAAE,EAAE,GAAG,EACP,QAAQ,EAAE,GAAG,EACb,IAAI,EAAE,UAAU,EAChB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,oBAAoB,EAC5B,SAAS,EAAE,MAAM,GAChB,kBAAkB,CAoEpB"}
+{"version":3,"file":"image-quality-calculator.d.ts","sourceRoot":"","sources":["../../src/image-quality-calculator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAA;AAoC9C;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,OAAO,CAAA;IACf,WAAW,EAAE,MAAM,CAAA;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAEjC,MAAM,EAAE,OAAO,CAAA;IAEf,KAAK,EAAE,MAAM,CAAA;IAEb,mBAAmB,EAAE,MAAM,EAAE,CAAA;IAC7B,WAAW,EAAE,MAAM,EAAE,CAAA;IAErB,OAAO,EAAE;QACP,YAAY,EAAE,mBAAmB,CAAA;QACjC,iBAAiB,EAAE,mBAAmB,CAAA;QACtC,iBAAiB,EAAE,mBAAmB,CAAA;QACtC,cAAc,EAAE,mBAAmB,CAAA;KACpC,CAAA;IAED,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;CACvB;AAID;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,gBAAgB,CAC9B,EAAE,EAAE,GAAG,EACP,SAAS,EAAE,GAAG,EACd,MAAM,EAAE,oBAAoB,EAC5B,SAAS,EAAE,MAAM,GAChB,kBAAkB,CAkFpB"}

package/dist/types/motion-liveness-detector.d.ts

@@ -55,14 +55,10 @@ export interface MotionLivenessDetectorOptions {
  * 使用光流、关键点跟踪和面部特征分析
  */
 export declare class MotionLivenessDetector {
-    private readonly minMotionThreshold;
-    private readonly minKeypointVariance;
-    private readonly frameBufferSize;
-    private readonly eyeAspectRatioThreshold;
-    private readonly motionConsistencyThreshold;
-    private readonly minOpticalFlowThreshold;
-    private readonly strictPhotoDetection;
+    private config;
     private frameBuffer;
+    private frameWidth;
+    private frameHeight;
     private keypointHistory;
     private faceAreaHistory;
     private eyeAspectRatioHistory;
@@ -70,8 +66,9 @@ export declare class MotionLivenessDetector {
     private opticalFlowHistory;
     private pupilSizeHistory;
     private cv;
-    constructor(options?: Partial<MotionLivenessDetectorOptions>);
+    constructor(strictPhotoDetection?: boolean);
     setCVInstance(cvInstance: any): void;
+    getOptions(): Required<MotionLivenessDetectorOptions>;
     isReady(): boolean;
     /**
      * 重置运动检测状态
@@ -113,14 +110,16 @@ export declare class MotionLivenessDetector {
     /**
      * 计算光流幅度（需要 OpenCV）
      * 检测帧之间的像素运动
+     *
+     * 针对5帧短视频优化的参数：
+     * - pyr_scale: 0.8（更陡峭的金字塔，保留细节）
+     * - levels: 2（减少层级数，适合小尺寸视频）
+     * - winsize: 7（更小的窗口，捕捉微小运动）
      */
     private analyzeOpticalFlow;
-    /**
-     * 将 canvas 转换为 OpenCV Mat，支持可选的灰度转换
-     */
-    private canvasToMat;
     /**
      * 计算光流的平均幅度
+     * 包含诊断日志用于调试
      */
     private calculateFlowMagnitude;
     /**
@@ -151,6 +150,10 @@ export declare class MotionLivenessDetector {
      * 用于检测嘴巴张开的变化
      */
     private calculateMouthAspectRatio;
+    /**
+     * 计算面部中心（所有关键点的平均位置）
+     */
+    private calculateFaceCenter;
     /**
      * 计算两个点之间的距离
      */
@@ -167,6 +170,12 @@ export declare class MotionLivenessDetector {
      * 计算人脸区域方差
      */
     private calculateFaceAreaVariance;
+    /**
+     * 计算人脸区域的变化率 - 用于检测呼吸或其他微妙运动
+     * 活体在呼吸或说话时，面部区域会有微小的周期性变化
+     * 照片：变化很小或波动随机
+     */
+    private calculateFaceAreaChangeRate;
     /**
      * 计算数字数组的方差
      */
@@ -182,19 +191,25 @@ export declare class MotionLivenessDetector {
     private calculateOverallMotionScore;
     /**
      * 根据运动分析确定面部是否活跃
-     * 修复：改进对真实面部运动的识别，减少误判
+     * 【针对5帧场景优化】：改为"多数票"制，使用6个独立指标
+     *
+     * 6个检测指标（互相独立）：
+     * 1. 关键点变化 - 照片无法改变关键点位置
+     * 2. 光流幅度 - 照片产生的光流极低
+     * 3. 运动类型 - 照片只能是'none'
+     * 4. 眼睛运动（眨眼）- 照片眼睛无法眨动
+     * 5. 嘴巴运动 - 照片嘴巴完全静止
+     * 6. 面部区域变化 - 照片无法产生呼吸迹象
+     *
+     * 判决规则：
+     * - 数据充足（>= 5帧）：需要至少2个指标支持才判定为活体
+     * - 数据不足（< 5帧）：需要至少3个指标支持
      */
     private determineLiveness;
     /**
      * 分析失败时创建空结果
      */
     private createEmptyResult;
-    /**
-     * 验证运动的物理约束
-     * 照片微动的运动往往会违反物理约束（如速度跳跃）
-     * 真实面部运动应该表现出光滑的加速度和速度变化
-     */
-    private validatePhysicalConstraints;
     /**
      * 获取运动检测结果（用于调试）
      */

package/dist/types/motion-liveness-detector.d.ts.map

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