@sssxyd/face-liveness-detector 0.4.0-alpha.4 → 0.4.0-alpha.6

package/dist/index.esm.js

@@ -115,16 +115,16 @@ const DEFAULT_OPTIONS = {
     motion_liveness_motion_consistency_threshold: 0.3,
     motion_liveness_strict_photo_detection: false,
     // Screen Capture Detection Settings
-    screen_capture_confidence_threshold: 0.6,
+    screen_capture_confidence_threshold: 0.7,
     screen_capture_detection_strategy: 'adaptive',
     screen_moire_pattern_threshold: 0.65,
     screen_moire_pattern_enable_dct: true,
     screen_moire_pattern_enable_edge_detection: true,
     screen_color_saturation_threshold: 40,
-    screen_color_rgb_correlation_threshold: 0.85,
+    screen_color_rgb_correlation_threshold: 0.75,
     screen_color_pixel_entropy_threshold: 6.5,
     screen_color_gradient_smoothness_threshold: 0.7,
-    screen_color_confidence_threshold: 0.6,
+    screen_color_confidence_threshold: 0.65,
     screen_rgb_low_freq_start_percent: 0.15,
     screen_rgb_low_freq_end_percent: 0.35,
     screen_rgb_energy_ratio_normalization_factor: 10,
@@ -132,7 +132,7 @@ const DEFAULT_OPTIONS = {
     screen_rgb_energy_score_weight: 0.40,
     screen_rgb_asymmetry_score_weight: 0.40,
     screen_rgb_difference_factor_weight: 0.20,
-    screen_rgb_confidence_threshold: 0.60,
+    screen_rgb_confidence_threshold: 0.65,
 };
 /**
  * Merge user configuration with defaults
@@ -4516,9 +4516,16 @@ class FaceDetectionEngine extends SimpleEventEmitter {
                 };
                 if (this.videoElement) {
                     this.videoElement.addEventListener('canplay', onCanPlay, { once: true });
-                    this.videoElement.play().catch(err => {
+                    this.videoElement.play().catch((err) => {
                         clearTimeout(timeout);
                         cleanup();
+                        const errorInfo = this.extractErrorInfo(err);
+                        this.emitDebug('video-setup', 'Failed to play video', {
+                            error: errorInfo.message,
+                            stack: errorInfo.stack,
+                            name: errorInfo.name,
+                            cause: errorInfo.cause
+                        }, 'error');
                         reject(err);
                     });
                 }
@@ -4582,6 +4589,7 @@ class FaceDetectionEngine extends SimpleEventEmitter {
      * Reset detection state
      */
     resetDetectionState() {
+        this.emitDebug('detection', 'Resetting detection state...');
         this.detectionState.reset();
         this.actualVideoWidth = 0;
         this.actualVideoHeight = 0;
@@ -4702,34 +4710,34 @@ class FaceDetectionEngine extends SimpleEventEmitter {
             this.scheduleNextDetection(this.options.detect_error_retry_delay);
             return;
         }
-        // 当前帧图片
-        const bgrFrame = drawCanvasToMat(this.cv, frameCanvas, false);
-        if (!bgrFrame) {
-            this.emitDebug('detection', 'Failed to convert canvas to OpenCV Mat', {}, 'warn');
-            this.scheduleNextDetection(this.options.detect_error_retry_delay);
-            return;
-        }
-        // 当前帧灰度图片
-        const grayFrame = matToGray(this.cv, bgrFrame);
-        if (!grayFrame) {
-            bgrFrame.delete();
-            this.emitDebug('detection', 'Failed to convert frame Mat to grayscale', {}, 'warn');
-            this.scheduleNextDetection(this.options.detect_error_retry_delay);
-            return;
-        }
-        // 提取人脸区域图片及灰度图片
-        const bgrFace = bgrFrame.roi(new this.cv.Rect(faceBox[0], faceBox[1], faceBox[2], faceBox[3]));
-        const grayFace = matToGray(this.cv, bgrFace);
-        if (!grayFace) {
-            bgrFrame.delete();
-            bgrFace.delete();
-            this.emitDebug('detection', 'Failed to convert face Mat to grayscale', {}, 'warn');
-            this.scheduleNextDetection(this.options.detect_error_retry_delay);
-            return;
-        }
-        // 释放不再需要的Mat
-        bgrFrame.delete();
+        // 所有需要删除的 Mat 对象
+        let bgrFrame = null;
+        let grayFrame = null;
+        let bgrFace = null;
+        let grayFace = null;
         try {
+            // 当前帧图片
+            bgrFrame = drawCanvasToMat(this.cv, frameCanvas, false);
+            if (!bgrFrame) {
+                this.emitDebug('detection', 'Failed to convert canvas to OpenCV Mat', {}, 'warn');
+                this.scheduleNextDetection(this.options.detect_error_retry_delay);
+                return;
+            }
+            // 当前帧灰度图片
+            grayFrame = matToGray(this.cv, bgrFrame);
+            if (!grayFrame) {
+                this.emitDebug('detection', 'Failed to convert frame Mat to grayscale', {}, 'warn');
+                this.scheduleNextDetection(this.options.detect_error_retry_delay);
+                return;
+            }
+            // 提取人脸区域图片及灰度图片
+            bgrFace = bgrFrame.roi(new this.cv.Rect(faceBox[0], faceBox[1], faceBox[2], faceBox[3]));
+            grayFace = matToGray(this.cv, bgrFace);
+            if (!grayFace) {
+                this.emitDebug('detection', 'Failed to convert face Mat to grayscale', {}, 'warn');
+                this.scheduleNextDetection(this.options.detect_error_retry_delay);
+                return;
+            }
             if (!this.detectionState.screenDetector) {
                 this.emit('detector-error', {
                     code: ErrorCode.INTERNAL_ERROR,
@@ -4748,15 +4756,37 @@ class FaceDetectionEngine extends SimpleEventEmitter {
             }
             // 屏幕捕获检测, 只关心脸部区域
             const screenResult = this.detectionState.screenDetector.detectAuto(bgrFace, grayFace);
-            bgrFace.delete();
-            grayFace.delete();
             // 屏幕捕获检测器已经准备就绪，其验证结果可信
             if (screenResult.isScreenCapture) {
-                grayFrame.delete();
+                // 从 executedMethods 提取各检测器的置信度
+                const methodConfidences = screenResult.executedMethods.reduce((acc, method) => {
+                    if (method.method.includes('Moiré')) {
+                        acc.moireConfidence = method.confidence;
+                    }
+                    else if (method.method.includes('Color')) {
+                        acc.colorConfidence = method.confidence;
+                    }
+                    else if (method.method.includes('RGB')) {
+                        acc.rgbConfidence = method.confidence;
+                    }
+                    return acc;
+                }, {});
                 this.emitDetectorInfo({ code: DetectionCode.FACE_NOT_REAL, message: screenResult.getMessage(), screenConfidence: screenResult.confidenceScore });
                 this.emitDebug('screen-capture-detection', 'Screen capture detected - possible video replay attack', {
-                    confidence: screenResult.confidenceScore,
-                    minConfidence: this.options.screen_capture_confidence_threshold
+                    overallConfidence: screenResult.confidenceScore,
+                    minConfidenceThreshold: this.options.screen_capture_confidence_threshold,
+                    moireConfidence: methodConfidences.moireConfidence ?? 'N/A',
+                    colorConfidence: methodConfidences.colorConfidence ?? 'N/A',
+                    rgbConfidence: methodConfidences.rgbConfidence ?? 'N/A',
+                    detectionStrategy: screenResult.strategy,
+                    riskLevel: screenResult.riskLevel,
+                    processingTimeMs: screenResult.processingTimeMs,
+                    executedMethods: screenResult.executedMethods.map((m) => ({
+                        method: m.method,
+                        isScreenCapture: m.isScreenCapture,
+                        confidence: m.confidence
+                    })),
+                    skippedMethods: screenResult.skippedMethods
                 }, 'warn');
                 this.resetDetectionState();
                 this.scheduleNextDetection(this.options.detect_error_retry_delay);
@@ -4767,13 +4797,18 @@ class FaceDetectionEngine extends SimpleEventEmitter {
             if (this.detectionState.motionDetector.isReady()) {
                 // 运动检测器已经准备就绪，其验证结果可信
                 if (!motionResult.isLively) {
-                    grayFrame.delete();
                     this.emitDebug('motion-detection', 'Motion liveness check failed - possible photo attack', {
                         motionScore: motionResult.motionScore,
                         keypointVariance: motionResult.keypointVariance,
+                        opticalFlowMagnitude: motionResult.opticalFlowMagnitude,
+                        eyeMotionScore: motionResult.eyeMotionScore,
+                        mouthMotionScore: motionResult.mouthMotionScore,
                         motionType: motionResult.motionType,
                         minMotionScore: this.options.motion_liveness_min_motion_score,
-                        minKeypointVariance: this.options.motion_liveness_min_keypoint_variance
+                        minKeypointVariance: this.options.motion_liveness_min_keypoint_variance,
+                        minOpticalFlowThreshold: this.options.motion_liveness_min_optical_flow_threshold,
+                        minMotionConsistencyThreshold: this.options.motion_liveness_motion_consistency_threshold,
+                        details: motionResult.details
                     }, 'warn');
                     this.emitDetectorInfo({
                         code: DetectionCode.FACE_NOT_LIVE,
@@ -4822,7 +4857,6 @@ class FaceDetectionEngine extends SimpleEventEmitter {
                 this.scheduleNextDetection(this.options.detect_error_retry_delay);
                 return;
             }
-            grayFrame.delete();
             // 当前帧通过常规检查
             this.emitDetectorInfo({ passed: true, code: DetectionCode.FACE_CHECK_PASS, faceRatio: faceRatio, faceFrontal: frontal, imageQuality: qualityResult.score });
             // 处理不同检测阶段的逻辑
@@ -4868,18 +4902,15 @@ class FaceDetectionEngine extends SimpleEventEmitter {
             this.scheduleNextDetection(this.options.detect_error_retry_delay);
         }
         finally {
-            if (grayFrame) {
+            // 统一在 finally 块中删除所有 Mat 对象
+            if (grayFrame)
                 grayFrame.delete();
-            }
-            if (bgrFrame) {
+            if (bgrFrame)
                 bgrFrame.delete();
-            }
-            if (bgrFace) {
+            if (bgrFace)
                 bgrFace.delete();
-            }
-            if (grayFace) {
+            if (grayFace)
                 grayFace.delete();
-            }
         }
     }
     /**
@@ -5139,7 +5170,7 @@ class FaceDetectionEngine extends SimpleEventEmitter {
                 return null;
             }
             this.frameCanvasContext.drawImage(this.videoElement, 0, 0, videoWidth_actual, videoHeight_actual);
-            this.emitDebug('capture', 'Frame drawn to canvas');
+            this.emitDebug('capture', 'Frame drawn to canvas as ' + videoHeight_actual + 'x' + videoWidth_actual);
             return this.frameCanvasElement;
         }
         catch (e) {