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

package/dist/index.esm.js

@@ -173,9 +173,7 @@ function mergeOptions(userConfig) {
  * Provides on, off, once, and emit methods for event-driven architecture
  */
 class SimpleEventEmitter {
-    constructor() {
-        this.listeners = new Map();
-    }
+    listeners = new Map();
     /**
      * Register an event listener
      * @param event - Event name
@@ -1680,6 +1678,22 @@ function matToGray(cv, mat) {
  * 运动检测结果
  */
 class MotionDetectionResult {
+    // 总体运动评分 (0-1)
+    motionScore;
+    // 人脸区域的光流幅度
+    opticalFlowMagnitude;
+    // 关键点稳定性评分 (0 = 像照片一样稳定, 1 = 自然运动)
+    keypointVariance;
+    // 眼睛区域运动强度
+    eyeMotionScore;
+    // 嘴巴区域运动强度
+    mouthMotionScore;
+    // 检测到的运动类型 ('none' | 'rotation' | 'translation' | 'breathing' | 'micro_expression')
+    motionType;
+    // 基于运动的总体活体性判断
+    isLively;
+    // 详细调试信息
+    details;
     constructor(motionScore, opticalFlowMagnitude, keypointVariance, eyeMotionScore, mouthMotionScore, motionType, isLively, details) {
         this.motionScore = motionScore;
         this.opticalFlowMagnitude = opticalFlowMagnitude;
@@ -1723,17 +1737,25 @@ class MotionDetectionResult {
  * 使用光流、关键点跟踪和面部特征分析
  */
 class MotionLivenessDetector {
+    // 配置及默认值
+    minMotionThreshold;
+    minKeypointVariance;
+    frameBufferSize;
+    eyeAspectRatioThreshold;
+    motionConsistencyThreshold;
+    minOpticalFlowThreshold;
+    strictPhotoDetection;
+    // 状态
+    frameBuffer = []; // 存储 cv.Mat (gray)
+    keypointHistory = [];
+    faceAreaHistory = [];
+    eyeAspectRatioHistory = [];
+    mouthAspectRatioHistory = [];
+    opticalFlowHistory = [];
+    pupilSizeHistory = [];
+    // OpenCV 实例
+    cv = null;
     constructor(options = {}) {
-        // 状态
-        this.frameBuffer = []; // 存储 cv.Mat (gray)
-        this.keypointHistory = [];
-        this.faceAreaHistory = [];
-        this.eyeAspectRatioHistory = [];
-        this.mouthAspectRatioHistory = [];
-        this.opticalFlowHistory = [];
-        this.pupilSizeHistory = [];
-        // OpenCV 实例
-        this.cv = null;
         // 用提供的选项或默认值设置配置
         this.minMotionThreshold = options.minMotionThreshold ?? 0.15;
         this.minKeypointVariance = options.minKeypointVariance ?? 0.02;
@@ -3668,6 +3690,16 @@ function stringToDetectionStrategy(value, defaultValue) {
  * 优化版屏幕采集检测结果
  */
 class ScreenCaptureDetectionResult {
+    isScreenCapture;
+    confidenceScore;
+    // 实际执行的检测方法结果
+    executedMethods;
+    // 未执行的方法（因为已经有结论）
+    skippedMethods;
+    riskLevel;
+    processingTimeMs;
+    strategy;
+    debug;
     constructor(isScreenCapture, confidenceScore, executedMethods, riskLevel, processingTimeMs, strategy, skippedMethods, debug) {
         this.isScreenCapture = isScreenCapture;
         this.confidenceScore = confidenceScore;
@@ -3696,10 +3728,13 @@ class ScreenCaptureDetectionResult {
  * 使用级联检测策略，支持多种模式以平衡速度和精准度
  */
 class ScreenCaptureDetector {
+    cv = null;
+    confidenceThreshold = 0.6;
+    detectionStrategy = DetectionStrategy.ADAPTIVE;
+    moirePatternConfig;
+    screenColorConfig;
+    rgbEmissionConfig;
     constructor(options = {}) {
-        this.cv = null;
-        this.confidenceThreshold = 0.6;
-        this.detectionStrategy = DetectionStrategy.ADAPTIVE;
         this.confidenceThreshold = options.confidenceThreshold ?? 0.6;
         this.detectionStrategy = options.detectionStrategy
             ? stringToDetectionStrategy(options.detectionStrategy, DetectionStrategy.ADAPTIVE)
@@ -3995,21 +4030,21 @@ class ScreenCaptureDetector {
  * Internal detection state interface
  */
 class DetectionState {
+    period = DetectionPeriod.DETECT;
+    startTime = performance.now();
+    collectCount = 0;
+    suspectedFraudsCount = 0;
+    bestQualityScore = 0;
+    bestFrameImage = null;
+    bestFaceImage = null;
+    completedActions = new Set();
+    currentAction = null;
+    actionVerifyTimeout = null;
+    lastFrontalScore = 1;
+    motionDetector = null;
+    liveness = false;
+    screenDetector = null;
     constructor(options) {
-        this.period = DetectionPeriod.DETECT;
-        this.startTime = performance.now();
-        this.collectCount = 0;
-        this.suspectedFraudsCount = 0;
-        this.bestQualityScore = 0;
-        this.bestFrameImage = null;
-        this.bestFaceImage = null;
-        this.completedActions = new Set();
-        this.currentAction = null;
-        this.actionVerifyTimeout = null;
-        this.lastFrontalScore = 1;
-        this.motionDetector = null;
-        this.liveness = false;
-        this.screenDetector = null;
         Object.assign(this, options);
     }
     reset() {
@@ -4050,6 +4085,10 @@ class DetectionState {
         this.completedActions.add(this.currentAction);
         this.currentAction = null;
     }
+    setCVInstance(cvInstance) {
+        this.motionDetector?.setCVInstance(cvInstance);
+        this.screenDetector?.setCVInstance(cvInstance);
+    }
     /**
      * Clear action verify timeout
      */
@@ -4100,35 +4139,95 @@ function createDetectionState(options) {
  * Provides core detection logic without UI dependencies
  */
 class FaceDetectionEngine extends SimpleEventEmitter {
+    options;
+    // OpenCV instance
+    cv = null;
+    human = null;
+    engineState = EngineState.IDLE;
+    // 视频及保存当前帧图片的Canvas元素
+    videoElement = null;
+    stream = null;
+    frameCanvasElement = null;
+    frameCanvasContext = null;
+    faceCanvasElement = null;
+    faceCanvasContext = null;
+    detectionFrameId = null;
+    actualVideoWidth = 0;
+    actualVideoHeight = 0;
+    detectionState;
     /**
      * Constructor
      * @param config - Configuration object
      */
     constructor(options) {
         super();
-        // OpenCV instance
-        this.cv = null;
-        this.human = null;
-        this.engineState = EngineState.IDLE;
-        // 视频及保存当前帧图片的Canvas元素
-        this.videoElement = null;
-        this.stream = null;
-        this.frameCanvasElement = null;
-        this.frameCanvasContext = null;
-        this.faceCanvasElement = null;
-        this.faceCanvasContext = null;
-        this.detectionFrameId = null;
-        this.actualVideoWidth = 0;
-        this.actualVideoHeight = 0;
         this.options = mergeOptions(options);
         this.detectionState = createDetectionState(this.options);
     }
+    /**
+     * 提取错误信息的辅助方法 - 处理各种错误类型
+     * @param error - 任意类型的错误对象
+     * @returns 包含错误消息和堆栈的对象
+     */
+    extractErrorInfo(error) {
+        // 处理 Error 实例
+        if (error instanceof Error) {
+            let causeStr;
+            if (error.cause) {
+                causeStr = error.cause instanceof Error ? error.cause.message : String(error.cause);
+            }
+            return {
+                message: error.message || 'Unknown error',
+                stack: error.stack || this.getStackTrace(),
+                name: error.name,
+                cause: causeStr
+            };
+        }
+        // 处理其他对象类型
+        if (typeof error === 'object' && error !== null) {
+            let causeStr;
+            if ('cause' in error) {
+                const cause = error.cause;
+                causeStr = cause instanceof Error ? cause.message : String(cause);
+            }
+            return {
+                message: error.message || JSON.stringify(error),
+                stack: error.stack || this.getStackTrace(),
+                name: error.name,
+                cause: causeStr
+            };
+        }
+        // 处理基本类型（string, number 等）
+        return {
+            message: String(error),
+            stack: this.getStackTrace()
+        };
+    }
+    /**
+     * 获取当前调用栈信息
+     */
+    getStackTrace() {
+        try {
+            // 创建一个Error对象来获取堆栈
+            const err = new Error();
+            if (err.stack) {
+                // 移除前两行（Error 和 getStackTrace 本身）
+                const lines = err.stack.split('\n');
+                return lines.slice(2).join('\n') || 'Stack trace unavailable';
+            }
+            return 'Stack trace unavailable';
+        }
+        catch {
+            return 'Stack trace unavailable';
+        }
+    }
     updateOptions(options) {
         if (this.engineState == EngineState.DETECTING) {
             this.stopDetection(false);
         }
         this.options = mergeOptions(options);
         this.detectionState = createDetectionState(this.options);
+        this.detectionState.setCVInstance(this.cv);
     }
     getEngineState() {
         return this.engineState;
@@ -4167,10 +4266,8 @@ class FaceDetectionEngine extends SimpleEventEmitter {
             console.log('[FaceDetectionEngine] OpenCV loaded successfully', {
                 version: cv_version
             });
-            // Inject OpenCV instance into motion detector
-            if (this.detectionState.motionDetector) {
-                this.detectionState.motionDetector.cv = cv;
-            }
+            // Inject OpenCV instance into motion detector and screen detector
+            this.detectionState.setCVInstance(this.cv);
             // Load Human.js
             console.log('[FaceDetectionEngine] Loading Human.js models...');
             this.emitDebug('initialization', 'Loading Human.js...');
@@ -4179,12 +4276,14 @@ class FaceDetectionEngine extends SimpleEventEmitter {
                 this.human = await loadHuman(this.options.human_model_path, this.options.tensorflow_wasm_path, this.options.tensorflow_backend);
             }
             catch (humanError) {
-                const errorMsg = humanError instanceof Error ? humanError.message : 'Unknown error';
-                const stack = humanError instanceof Error ? humanError.stack : 'N/A';
+                const errorInfo = this.extractErrorInfo(humanError);
+                const errorMsg = errorInfo.message;
                 // 分析错误类型，提供针对性的建议
                 let errorContext = {
                     error: errorMsg,
-                    stack,
+                    stack: errorInfo.stack,
+                    name: errorInfo.name,
+                    cause: errorInfo.cause,
                     userAgent: navigator.userAgent,
                     platform: navigator.userAgentData?.platform || 'unknown',
                     browser: detectBrowserEngine(navigator.userAgent),
@@ -4288,7 +4387,8 @@ class FaceDetectionEngine extends SimpleEventEmitter {
             this.emitDebug('initialization', 'Engine initialized and ready', loadedData);
         }
         catch (error) {
-            const errorMsg = error instanceof Error ? error.message : 'Unknown error';
+            const errorInfo = this.extractErrorInfo(error);
+            const errorMsg = errorInfo.message;
             this.emit('detector-loaded', {
                 success: false,
                 error: errorMsg
@@ -4299,7 +4399,9 @@ class FaceDetectionEngine extends SimpleEventEmitter {
             });
             this.emitDebug('initialization', 'Failed to load libraries', {
                 error: errorMsg,
-                stack: error instanceof Error ? error.stack : 'N/A'
+                stack: errorInfo.stack,
+                name: errorInfo.name,
+                cause: errorInfo.cause
             }, 'error');
         }
         finally {
@@ -4426,10 +4528,13 @@ class FaceDetectionEngine extends SimpleEventEmitter {
             this.emitDebug('video-setup', 'Detection started');
         }
         catch (error) {
-            const errorMsg = error instanceof Error ? error.message : 'Unknown error';
+            const errorInfo = this.extractErrorInfo(error);
+            const errorMsg = errorInfo.message;
             this.emitDebug('video-setup', 'Failed to start detection', {
                 error: errorMsg,
-                stack: error instanceof Error ? error.stack : 'N/A'
+                stack: errorInfo.stack,
+                name: errorInfo.name,
+                cause: errorInfo.cause
             }, 'error');
             this.emit('detector-error', {
                 code: ErrorCode.STREAM_ACQUISITION_FAILED,
@@ -4527,10 +4632,12 @@ class FaceDetectionEngine extends SimpleEventEmitter {
                 result = await this.human.detect(this.videoElement);
             }
             catch (detectError) {
-                const errorMsg = detectError instanceof Error ? detectError.message : 'Unknown error';
+                const errorInfo = this.extractErrorInfo(detectError);
+                const errorMsg = errorInfo.message;
                 this.emitDebug('detection', 'Human.detect() call failed', {
                     error: errorMsg,
-                    stack: detectError instanceof Error ? detectError.stack : 'N/A',
+                    stack: errorInfo.stack,
+                    name: errorInfo.name,
                     hasHuman: !!this.human,
                     humanVersion: this.human?.version,
                     videoReadyState: this.videoElement?.readyState,
@@ -4555,10 +4662,13 @@ class FaceDetectionEngine extends SimpleEventEmitter {
             }
         }
         catch (error) {
-            const errorMsg = error instanceof Error ? error.message : 'Unknown error';
+            const errorInfo = this.extractErrorInfo(error);
+            const errorMsg = errorInfo.message;
             this.emitDebug('detection', 'Unexpected error in detection loop', {
                 error: errorMsg,
-                stack: error instanceof Error ? error.stack : 'N/A'
+                stack: errorInfo.stack,
+                name: errorInfo.name,
+                cause: errorInfo.cause
             }, 'error');
             this.scheduleNextDetection(this.options.detect_error_retry_delay);
         }
@@ -4747,10 +4857,13 @@ class FaceDetectionEngine extends SimpleEventEmitter {
             }
         }
         catch (error) {
-            const errorMsg = error instanceof Error ? error.message : 'Unknown error';
+            const errorInfo = this.extractErrorInfo(error);
+            const errorMsg = errorInfo.message;
             this.emitDebug('detection', 'Unexpected error in single face handling', {
                 error: errorMsg,
-                stack: error instanceof Error ? error.stack : 'N/A'
+                stack: errorInfo.stack,
+                name: errorInfo.name,
+                cause: errorInfo.cause
             }, 'error');
             this.scheduleNextDetection(this.options.detect_error_retry_delay);
         }
@@ -5380,6 +5493,8 @@ async function preloadResources() {
  * Wrapper around FaceDetectionEngine optimized for UniApp
  */
 class UniAppFaceDetectionEngine extends FaceDetectionEngine {
+    resourcesInitialized = false;
+    resourcesPreloaded = false;
     /**
      * Constructor
      * @param config - Configuration object
@@ -5393,8 +5508,6 @@ class UniAppFaceDetectionEngine extends FaceDetectionEngine {
             tensorflow_wasm_path: config?.tensorflow_wasm_path || getWasmPath()
         };
         super(finalConfig);
-        this.resourcesInitialized = false;
-        this.resourcesPreloaded = false;
         // Initialize UniApp resources
         if (uniAppConfig.isUniApp) {
             initializeUniAppResources();