@sssxyd/face-liveness-detector 0.4.0-alpha.11 → 0.4.0-alpha.12

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;AAkFhF;;;;;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;AAmDhF;;;;;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,20 @@ export declare class FaceDetectionEngine extends SimpleEventEmitter {
     private cv;
     private human;
     private engineState;
+    private videoFPS;
     private videoElement;
     private stream;
     private frameCanvasElement;
     private frameCanvasContext;
-    private faceCanvasElement;
-    private faceCanvasContext;
-    private detectionFrameId;
+    private animationFrameId;
     private actualVideoWidth;
     private actualVideoHeight;
+    private isDetectingFrameActive;
+    private frameIndex;
+    private lastDetectionFrameIndex;
+    private lastScreenFeatureDetectionFrameIndex;
+    private matPool;
+    private shouldPreallocateMats;
     private detectionState;
     /**
      * Constructor
@@ -41,6 +46,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
@@ -68,23 +104,95 @@ export declare class FaceDetectionEngine extends SimpleEventEmitter {
      * @returns Current configuration
      */
     getOptions(): FaceDetectionEngineOptions;
+    private updateVideoFPS;
     /**
-     * Reset detection state
+     * 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 resetDetectionState;
+    private adjustDetectFrameDelay;
     /**
-     * Schedule next detection frame
+     * Get the frame interval for main face detection based on videoFPS and detect_frame_delay
+     * @returns Number of frames between detections
      */
-    private scheduleNextDetection;
+    private getDetectionFrameInterval;
+    /**
+     * Get the frame interval for screen detection
+     * Screen detection runs at 0.5x the main detection interval to interleave frames
+     * @returns Number of frames between screen detections
+     */
+    private getScreenDetectionFrameInterval;
+    /**
+     * Check if main face detection should be performed this frame
+     * @returns true if enough frames have passed since last detection
+     */
+    private shouldPerformMainDetection;
+    /**
+     * 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 shouldPerformScreenCornersDetection;
+    /**
+     * 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 shouldPerformScreenFeatureDetection;
     /**
      * Cancel pending detection frame
      */
     private cancelPendingDetection;
+    /**
+     * 预分配Mat对象以提高性能
+     * 避免每帧都创建新的Mat对象，而是复用同一对象
+     */
+    private preallocateMats;
+    /**
+     * 清理Mat对象池
+     */
+    private cleanupMatPool;
     /**
      * 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
+     */
+    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
      */
@@ -125,18 +233,5 @@ export declare class FaceDetectionEngine extends SimpleEventEmitter {
      */
     private drawVideoToCanvas;
     private clearFrameCanvas;
-    private clearFaceCanvas;
-    /**
-     * 将 canvas 转换为 Base64 JPEG 图片数据
-     * @param {HTMLCanvasElement} canvas - 输入的 canvas
-     * @returns {string | null} Base64 格式的 JPEG 图片数据
-     */
-    private canvasToBase64;
-    /**
-     * Capture current video frame (returns Base64)
-     * @param {Box} box - Face box
-     * @returns {string | null} Base64 encoded JPEG image data
-     */
-    private captureFrame;
 }
 //# 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;IAuOxB;;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;IAkBjB;;;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,EAAE,MAAM,2BAA2B,CAAA;AACjE,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,CA2BnF"}
+{"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/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;
     /**
      * 重置运动检测状态
@@ -183,6 +180,10 @@ export declare class MotionLivenessDetector {
     /**
      * 根据运动分析确定面部是否活跃
      * 修复：改进对真实面部运动的识别，减少误判
+     *
+     * 策略：
+     * - 数据不足（frameBuffer < bufferSize）时：采用保守策略，只有绝对确定是照片才判定为非活体
+     * - 数据充足（frameBuffer >= bufferSize）时：执行完整检查，较为严格
      */
     private determineLiveness;
     /**

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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"}

package/dist/types/optical-distortion-detector.d.ts

@@ -0,0 +1,116 @@
+/**
+ * 光学畸变检测器 - 检测投影仪和其他光学系统的特有伪影
+ *
+ * 核心原理：
+ * - 投影仪通过光学透镜将图像投射到屏幕上
+ * - 光学系统导致多种失真：梯形失真、桶形/枕形失真、模糊
+ * - 真实人脸直接摄像，无这些光学失真
+ *
+ * 检测特征：
+ * 1. 梯形失真（Keystone）- 图像上下边宽度不同
+ * 2. 桶形/枕形失真 - 直线边缘弯曲
+ * 3. 光学模糊 - 边界清晰度在视场中不均匀
+ * 4. 色差（Chromatic Aberration）- RGB通道空间分离
+ * 5. 暗角（Vignetting）- 四角暗化
+ */
+import { VideoFrameCollector } from "./video-frame-collector";
+export interface OpticalDistortionDetectorConfig {
+    bufferSize: number;
+    keystoneThreshold: number;
+    barrelDistortionThreshold: number;
+    chromaticAberrationThreshold: number;
+    vignetteThreshold: number;
+    samplingStride: number;
+    featureWeights: {
+        keystone: number;
+        barrelDistortion: number;
+        chromaticAberration: number;
+        vignette: number;
+    };
+}
+export interface OpticalDistortionDetectionResult {
+    isScreenCapture: boolean;
+    confidence: number;
+    distortionFeatures: {
+        keystoneDetected: boolean;
+        keystoneLevel: number;
+        barrelDistortionDetected: boolean;
+        barrelDistortionLevel: number;
+        chromaticAberrationDetected: boolean;
+        chromaticAberrationLevel: number;
+        vignetteDetected: boolean;
+        vignetteLevel: number;
+    };
+    overallOpticalDistortionScore: number;
+    estimatedProjectorType?: 'dlp' | 'lcd' | 'lcos' | 'unknown';
+    details?: any;
+}
+export declare class OpticalDistortionDetector {
+    private config;
+    private frameCollector;
+    constructor(frameCollector: VideoFrameCollector, config: OpticalDistortionDetectorConfig);
+    /**
+     * 获取当前缓冲区中的帧数
+     */
+    getBufferedFrameCount(): number;
+    /**
+     * 执行光学畸变检测分析
+     */
+    analyze(): OpticalDistortionDetectionResult;
+    /**
+     * 注意：重置由 FrameCollector 管理
+     * 此检测器不持有任何帧缓冲
+     */
+    reset(): void;
+    /**
+     * 检测梯形失真（Keystone）
+     *
+     * 原理：
+     * - 梯形失真导致图像上下边宽度不同
+     * - 计算上下边的宽度比
+     */
+    private detectKeystone;
+    /**
+     * 检测桶形/枕形失真
+     *
+     * 原理：
+     * - 提取图像边界
+     * - 拟合边界为曲线，计算曲率
+     * - 高曲率表示失真
+     */
+    private detectBarrelDistortion;
+    /**
+     * 检测色差（RGB通道分离）
+     */
+    private detectChromaticAberration;
+    /**
+     * 检测暗角（四角暗化）
+     *
+     * 原理：
+     * - 计算四个角区域的平均亮度
+     * - 与中心区域对比
+     * - 大幅下降表示暗角
+     */
+    private detectVignette;
+    /**
+     * 找水平边界的宽度
+     */
+    private findHorizontalEdgeWidth;
+    /**
+     * 测量边界的垂直直线度（曲率）
+     */
+    private measureBoundaryDeviation;
+    /**
+     * 找在特定y处的垂直边界
+     */
+    private findVerticalEdgeAtY;
+    /**
+     * 计算矩形区域的平均亮度
+     */
+    private getAverageBrightness;
+    /**
+     * 推断投影仪类型
+     */
+    private inferProjectorType;
+}
+//# sourceMappingURL=optical-distortion-detector.d.ts.map

package/dist/types/optical-distortion-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"optical-distortion-detector.d.ts","sourceRoot":"","sources":["../../src/optical-distortion-detector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAA;AAE7D,MAAM,WAAW,+BAA+B;IAE9C,UAAU,EAAE,MAAM,CAAA;IAGlB,iBAAiB,EAAE,MAAM,CAAA;IAGzB,yBAAyB,EAAE,MAAM,CAAA;IAGjC,4BAA4B,EAAE,MAAM,CAAA;IAGpC,iBAAiB,EAAE,MAAM,CAAA;IAGzB,cAAc,EAAE,MAAM,CAAA;IAGtB,cAAc,EAAE;QACd,QAAQ,EAAE,MAAM,CAAA;QAChB,gBAAgB,EAAE,MAAM,CAAA;QACxB,mBAAmB,EAAE,MAAM,CAAA;QAC3B,QAAQ,EAAE,MAAM,CAAA;KACjB,CAAA;CACF;AAED,MAAM,WAAW,gCAAgC;IAC/C,eAAe,EAAE,OAAO,CAAA;IACxB,UAAU,EAAE,MAAM,CAAA;IAGlB,kBAAkB,EAAE;QAClB,gBAAgB,EAAE,OAAO,CAAA;QACzB,aAAa,EAAE,MAAM,CAAA;QAErB,wBAAwB,EAAE,OAAO,CAAA;QACjC,qBAAqB,EAAE,MAAM,CAAA;QAE7B,2BAA2B,EAAE,OAAO,CAAA;QACpC,wBAAwB,EAAE,MAAM,CAAA;QAEhC,gBAAgB,EAAE,OAAO,CAAA;QACzB,aAAa,EAAE,MAAM,CAAA;KACtB,CAAA;IAGD,6BAA6B,EAAE,MAAM,CAAA;IAGrC,sBAAsB,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,SAAS,CAAA;IAE3D,OAAO,CAAC,EAAE,GAAG,CAAA;CACd;AAED,qBAAa,yBAAyB;IACpC,OAAO,CAAC,MAAM,CAAiC;IAC/C,OAAO,CAAC,cAAc,CAAqB;gBAE/B,cAAc,EAAE,mBAAmB,EAAE,MAAM,EAAE,+BAA+B;IAUxF;;OAEG;IACH,qBAAqB,IAAI,MAAM;IAI/B;;OAEG;IACH,OAAO,IAAI,gCAAgC;IA6F3C;;;OAGG;IACH,KAAK,IAAI,IAAI;IAKb;;;;;;OAMG;IACH,OAAO,CAAC,cAAc;IA8BtB;;;;;;;OAOG;IACH,OAAO,CAAC,sBAAsB;IA0B9B;;OAEG;IACH,OAAO,CAAC,yBAAyB;IAajC;;;;;;;OAOG;IACH,OAAO,CAAC,cAAc;IA0DtB;;OAEG;IACH,OAAO,CAAC,uBAAuB;IA8B/B;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAwBhC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAiC3B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAmB5B;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAgC3B"}

package/dist/types/screen-capture-detector.d.ts

@@ -1,10 +1,6 @@
 /**
- * 优化版屏幕采集检测器 - 快速检测策略
+ * 第三版屏幕采集检测器
  *
- * 核心思想：级联检测 (Cascade Detection)
- * - 按检测速度从快到慢排序：RGB发光 → 色彩特征 → 莫尔纹
- * - 尽早排除，减少不必要的计算
- * - 平衡精准度和速度
  */
 /**
  * 详细的级联检测过程日志
@@ -41,7 +37,6 @@ export declare class ScreenCaptureDetectionResult {
         confidence: number;
         details?: any;
     }>;
-    skippedMethods?: string[];
     riskLevel: 'low' | 'medium' | 'high';
     processingTimeMs: number;
     debug?: CascadeDetectionDebugInfo;
@@ -50,26 +45,44 @@ export declare class ScreenCaptureDetectionResult {
         isScreenCapture: boolean;
         confidence: number;
         details?: any;
-    }>, riskLevel: 'low' | 'medium' | 'high', processingTimeMs: number, skippedMethods?: string[], debug?: CascadeDetectionDebugInfo);
+    }>, riskLevel: 'low' | 'medium' | 'high', processingTimeMs: number, debug?: CascadeDetectionDebugInfo);
     getMessage(): string;
 }
 export interface ScreenCaptureDetectorOptions {
-    confidenceThreshold?: number;
-    moireThreshold?: number;
-    moireEnableDCT?: boolean;
-    moireEnableEdgeDetection?: boolean;
-    colorSaturationThreshold?: number;
-    colorRgbCorrelationThreshold?: number;
-    colorPixelEntropyThreshold?: number;
-    colorConfidenceThreshold?: number;
-    rgbLowFreqStartPercent?: number;
-    rgbLowFreqEndPercent?: number;
-    rgbEnergyRatioNormalizationFactor?: number;
-    rgbChannelDifferenceNormalizationFactor?: number;
-    rgbEnergyScoreWeight?: number;
-    rgbAsymmetryScoreWeight?: number;
-    rgbDifferenceFactorWeight?: number;
-    rgbConfidenceThreshold?: number;
+    flickerBufferSize?: number;
+    flickerMinPeriod?: number;
+    flickerMaxPeriod?: number;
+    flickerCorrelationThreshold?: number;
+    flickerPassingPixelRatio?: number;
+    flickerSamplingStride?: number;
+    responseTimeBufferSize?: number;
+    responseTimeMinPixelDelta?: number;
+    responseTimeThreshold?: number;
+    responseTimePassingPixelRatio?: number;
+    responseTimeSamplingStride?: number;
+    dlpColorWheelBufferSize?: number;
+    dlpEdgeThreshold?: number;
+    dlpChannelSeparationThreshold?: number;
+    dlpConfidenceThreshold?: number;
+    dlpSamplingStride?: number;
+    opticalDistortionBufferSize?: number;
+    opticalKeystoneThreshold?: number;
+    opticalBarrelThreshold?: number;
+    opticalChromaticThreshold?: number;
+    opticalVignetteThreshold?: number;
+    opticalSamplingStride?: number;
+    opticalFeatureKeystone?: number;
+    opticalFeatureBarrel?: number;
+    opticalFeatureChromatic?: number;
+    opticalFeatureVignette?: number;
+    frameDropRate?: number;
+    flickerConfidenceThreshold?: number;
+    responseTimeConfidenceThreshold?: number;
+    dlpConfidenceThresholdResult?: number;
+    opticalConfidenceThresholdResult?: number;
+    compositeConfidenceThresholdScreenCapture?: number;
+    compositeConfidenceThresholdHighRisk?: number;
+    compositeConfidenceThresholdMediumRisk?: number;
 }
 /**
  * 优化版屏幕采集检测引擎
@@ -78,12 +91,35 @@ export interface ScreenCaptureDetectorOptions {
  */
 export declare class ScreenCaptureDetector {
     private cv;
-    private confidenceThreshold;
-    private moirePatternConfig;
-    private screenColorConfig;
-    private rgbEmissionConfig;
-    constructor(options?: Partial<ScreenCaptureDetectorOptions>);
+    private fps;
+    private config;
+    private frameCollector;
+    private flickerDetector;
+    private responseTimeDetector;
+    private dlpColorWheelDetector;
+    private opticalDistortionDetector;
+    private droppedFramesCount;
+    constructor(fps?: number);
     setCVInstance(cvInstance: any): void;
+    getFPS(): number;
+    /**
+     * 向视频检测器添加一帧（用于实时视频处理）
+     * 建议每收到一帧就调用此方法
+     *
+     * @param grayMat 灰度图像矩阵
+     * @param bgrMat 彩色图像矩阵
+     * @returns 帧是否被接受（true表示被处理，false表示被随机丢弃）
+     */
+    addVideoFrame(grayMat: any, bgrMat: any): boolean;
+    isReady(): boolean;
+    /**
+     * 获取丢帧统计信息
+     */
+    getFrameDropStats(): {
+        droppedFramesCount: number;
+        dropRate: number;
+    };
+    reset(): void;
     /**
      * 检测屏幕捕捉
      * 使用三层判定逻辑：
@@ -91,19 +127,19 @@ export declare class ScreenCaptureDetector {
      * 2. 都不能明确判定时，计算加权置信度
      * 3. 用加权置信度判定最终结果
      *
-     * @param bgrMat - BGR格式图像
-     * @param grayMat - 灰度图像（用于莫尔纹检测）
      * @param debugMode - 是否启用调试模式，返回详细日志
+     * @param useVideoAnalysis - 是否使用已积累的视频帧进行闪烁检测
      * @returns 检测结果
      */
-    detect(bgrMat: any, grayMat: any, debugMode?: boolean): ScreenCaptureDetectionResult;
+    detect(debugMode?: boolean, useVideoAnalysis?: boolean): ScreenCaptureDetectionResult;
     /**
-     * 核心检测方法：三层判定逻辑
-     * 1. 任意方法能明确判定为屏幕捕捉时，直接返回
-     * 2. 都不能明确判定时，计算加权置信度
-     * 3. 用加权置信度判定最终结果
+     * 核心检测方法：多屏幕类型级联检测
      *
-     * 检测顺序：RGB 发光 → 颜色异常 → 莫尔纹
+     * 检测顺序（按可靠性排序）：
+     * 1. 视频闪烁（LCD/OLED）- 最可靠的物理特性
+     * 2. 响应时间（墨水屏）- 像素变化速度特征
+     * 3. DLP色轮（DLP投影）- 色轮干涉的独特特征
+     * 4. 光学畸变（其他投影）- 投影光学系统的失真
      */
     private detectWithLogic;
 }

package/dist/types/screen-capture-detector.d.ts.map

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