@sssxyd/face-liveness-detector 0.4.1-beta.1 → 0.4.1-beta.3

package/dist/index.esm.js

@@ -1562,8 +1562,10 @@ class MotionDetectionResult {
     // 是否为活体
     isLively;
     details;
-    constructor(isLively, details) {
+    debug;
+    constructor(isLively, details, debug = {}) {
         this.isLively = isLively;
+        this.debug = debug;
         this.details = details;
     }
     getMessage() {
@@ -1629,7 +1631,7 @@ class MotionLivenessDetector {
         return this.config;
     }
     isReady() {
-        return this.eyeAspectRatioHistory.length >= 5; // 只需要5帧就能检测
+        return this.normalizedLandmarksHistory.length >= 5; // 只需要5帧就能检测
     }
     reset() {
         this.eyeAspectRatioHistory = [];
@@ -1661,10 +1663,17 @@ class MotionLivenessDetector {
                     this.normalizedLandmarksHistory.shift();
                 }
             }
+            else {
+                return this.createEmptyResult({
+                    reason: '缺少面部关键点，无法进行活体检测',
+                    landmarks: currentKeypoints.landmarks
+                });
+            }
             // 数据不足时，继续收集
-            if (this.eyeAspectRatioHistory.length < 5) {
-                return new MotionDetectionResult(true, {
-                    frameCount: Math.max(this.eyeAspectRatioHistory.length, this.mouthAspectRatioHistory.length)
+            if (!this.isReady()) {
+                return this.createEmptyResult({
+                    reason: '数据收集中，帧数不足',
+                    collectedFrames: this.normalizedLandmarksHistory.length
                 });
             }
             // 【检测1】眼睛微妙波动 - 任何EAR变化都是活体
@@ -1700,7 +1709,10 @@ class MotionLivenessDetector {
         }
         catch (error) {
             console.warn('[MotionLivenessDetector]', error);
-            return this.createEmptyResult();
+            return this.createEmptyResult({
+                reason: '活体检测异常',
+                error: error.message
+            });
         }
     }
     /**
@@ -3009,7 +3021,7 @@ class MotionLivenessDetector {
         }
         return normalized;
     }
-    createEmptyResult() {
+    createEmptyResult(debug = {}) {
         return new MotionDetectionResult(true, {
             frameCount: 0,
             eyeAspectRatioStdDev: 0,
@@ -3020,7 +3032,7 @@ class MotionLivenessDetector {
             hasEyeMovement: false,
             hasMouthMovement: false,
             hasMuscleMovement: false
-        });
+        }, debug);
     }
     getStatistics() {
         return {
@@ -3952,7 +3964,8 @@ class FaceDetectionEngine extends SimpleEventEmitter {
                 if (!motionResult.isLively) {
                     this.emitDebug('motion-detection', 'Motion liveness check failed - possible photo attack', {
                         details: motionResult.details,
-                        message: motionResult.getMessage()
+                        debug: motionResult.debug,
+                        message: motionResult.getMessage(),
                     }, 'warn');
                     this.emitDetectorInfo({
                         code: DetectionCode.FACE_NOT_LIVE,
@@ -3962,10 +3975,17 @@ class FaceDetectionEngine extends SimpleEventEmitter {
                     return;
                 }
                 this.emitDebug('motion-detection', 'Motion liveness check passed', {
-                    details: motionResult.details
+                    debug: motionResult.debug,
+                    details: motionResult.details,
                 }, 'warn');
                 this.detectionState.liveness = true;
             }
+            else {
+                this.emitDebug('motion-detection', 'Motion liveness detector not ready yet', {
+                    debug: motionResult.debug,
+                    details: motionResult.details,
+                }, 'warn');
+            }
             // 计算面部大小比例，不达标则跳过当前帧
             const faceRatio = (faceBox[2] * faceBox[3]) / (this.actualVideoWidth * this.actualVideoHeight);
             if (faceRatio <= this.options.collect_min_face_ratio) {