@sssxyd/face-liveness-detector 0.2.22 → 0.2.24

package/dist/index.js

@@ -346,6 +346,11 @@
      * @param timeout - Maximum wait time in milliseconds (default: 30000)
      */
     async function preloadOpenCV(timeout = 30000) {
+        // 如果已经初始化完成，直接返回
+        if (opencvInitialized) {
+            console.log('[OpenCV] Already initialized, skipping preload');
+            return;
+        }
         // 如果已经在初始化中，返回现有的 Promise
         if (opencvInitPromise) {
             console.log('[OpenCV] Already initializing, reusing existing promise');
@@ -356,16 +361,16 @@
         opencvInitPromise = _initializeOpenCV(timeout);
         try {
             const initTime = await opencvInitPromise;
-            console.log('[OpenCV] Preload completed successfully, cost:', initTime.toFixed(0), 'ms');
+            console.log('[OpenCV] Preload completed successfully ', {
+                initTime: `${initTime.toFixed(2)}ms`,
+                version: getOpenCVVersion()
+            });
         }
         catch (error) {
             console.error('[OpenCV] Preload failed:', error);
+            opencvInitPromise = null; // 失败时清除 Promise，允许重试
             throw error;
         }
-        finally {
-            // 完成后清除 Promise 标记，但保留已初始化的 cv 对象
-            opencvInitPromise = null;
-        }
     }
     /**
      * Internal helper to initialize OpenCV
@@ -373,16 +378,16 @@
      */
     async function _initializeOpenCV(timeout) {
         const initStartTime = performance.now();
-        console.log('[FaceDetectionEngine] Waiting for OpenCV WASM initialization...');
+        console.log('Waiting for OpenCV WASM initialization...');
         // 快速路径：检查是否已经初始化
         if (cvModule.Mat) {
             const initTime = performance.now() - initStartTime;
-            console.log(`[FaceDetectionEngine] OpenCV.js already initialized, took ${initTime.toFixed(2)}ms`);
+            console.log(`OpenCV.js already initialized, took ${initTime.toFixed(2)}ms`);
             return cvModule;
         }
         if (typeof globalThis !== 'undefined' && globalThis.cv && globalThis.cv.Mat) {
             const initTime = performance.now() - initStartTime;
-            console.log(`[FaceDetectionEngine] OpenCV.js already initialized (from global), took ${initTime.toFixed(2)}ms`);
+            console.log(`OpenCV.js already initialized (from global), took ${initTime.toFixed(2)}ms`);
             cvModule = globalThis.cv;
             return cvModule;
         }
@@ -390,10 +395,10 @@
         if (typeof globalThis !== 'undefined' && !globalThis.cv) {
             if (cvModule && Object.isExtensible(cvModule)) {
                 globalThis.cv = cvModule;
-                console.log('[FaceDetectionEngine] cvModule assigned to globalThis.cv');
+                console.log('cvModule assigned to globalThis.cv');
             }
             else {
-                console.log('[FaceDetectionEngine] cvModule is not extensible or globalThis already has cv');
+                console.log('cvModule is not extensible or globalThis already has cv');
             }
         }
         return new Promise((resolve, reject) => {
@@ -402,7 +407,7 @@
             // 防止多次调用 resolve/reject
             let finished = false;
             const timeoutId = setTimeout(() => {
-                console.error('[FaceDetectionEngine] OpenCV.js initialization timeout after ' + timeout + 'ms');
+                console.error('OpenCV.js initialization timeout after ' + timeout + 'ms');
                 finished = true;
                 if (pollInterval) {
                     clearInterval(pollInterval);
@@ -411,65 +416,63 @@
             }, timeout);
             const resolveOnce = (source) => {
                 if (finished) {
-                    console.log('[FaceDetectionEngine] [resolveOnce] Already finished, ignoring call from:', source);
+                    console.log('[resolveOnce] Already finished, ignoring call from:', source);
                     return;
                 }
                 finished = true;
-                console.log('[FaceDetectionEngine] [resolveOnce] Marking as finished');
+                console.log('[resolveOnce] Marking as finished');
                 // 立即停止所有定时器和轮询
                 clearTimeout(timeoutId);
                 if (pollInterval !== null) {
                     clearInterval(pollInterval);
                     pollInterval = null;
-                    console.log('[FaceDetectionEngine] [resolveOnce] Poll interval cleared');
+                    console.log('[resolveOnce] Poll interval cleared');
                 }
                 const initTime = performance.now() - initStartTime;
-                console.log(`[FaceDetectionEngine] OpenCV.js initialized (${source}), took ${initTime.toFixed(2)}ms`);
+                console.log(`OpenCV.js initialized (${source}), took ${initTime.toFixed(2)}ms`);
                 // 标记初始化完成
                 opencvInitialized = true;
                 // 返回简单的标记，实际的 cv 对象已经在 globalThis.cv 上了
-                // 通过 getCvSync() 获取
                 resolve(initTime);
-                console.log('[FaceDetectionEngine] [resolveOnce] Promise resolved with true');
             };
             // 尝试设置回调（只有在 cvModule 可扩展时才尝试）
             const canSetCallback = cvModule && Object.isExtensible(cvModule);
             if (canSetCallback) {
                 try {
                     const originalOnRuntimeInitialized = cvModule.onRuntimeInitialized(cvModule).onRuntimeInitialized = () => {
-                        console.log('[FaceDetectionEngine] onRuntimeInitialized callback triggered');
+                        console.log('[onRuntimeInitialized] callback triggered');
                         // 调用原始回调（如果存在）
                         if (originalOnRuntimeInitialized && typeof originalOnRuntimeInitialized === 'function') {
                             try {
                                 originalOnRuntimeInitialized();
                             }
                             catch (e) {
-                                console.warn('[FaceDetectionEngine] Original onRuntimeInitialized callback failed:', e);
+                                console.warn('[onRuntimeInitialized] callback failed:', e);
                             }
                         }
                         resolveOnce('callback');
                     };
-                    console.log('[FaceDetectionEngine] onRuntimeInitialized callback set successfully');
+                    console.log('[onRuntimeInitialized] callback set successfully');
                 }
                 catch (e) {
-                    console.warn('[FaceDetectionEngine] Failed to set onRuntimeInitialized callback, will use polling:', e);
+                    console.warn('[onRuntimeInitialized] Failed to set callback, will use polling:', e);
                 }
             }
             else {
-                console.log('[FaceDetectionEngine] cvModule is not extensible, using polling mode');
+                console.log('[polling] cvModule is not extensible, using polling mode');
             }
             // 启动轮询作为备用方案或主要方案
             pollInterval = setInterval(() => {
-                console.log('[FaceDetectionEngine] [polling] Checking for Mat class...');
+                console.log('[polling] Checking for Mat class...');
                 // 优先检查 cvModule 中是否有 Mat
                 if (cvModule.Mat) {
-                    console.log('[FaceDetectionEngine] [polling] Found Mat in cvModule');
+                    console.log('[polling] Found Mat in cvModule');
                     resolveOnce('cvModule polling');
                     return;
                 }
                 // 其次检查 globalThis.cv 中是否有 Mat
                 if (typeof globalThis !== 'undefined' && globalThis.cv && globalThis.cv.Mat) {
-                    console.log('[FaceDetectionEngine] [polling] Found Mat in globalThis.cv');
+                    console.log('[polling] Found Mat in globalThis.cv');
                     cvModule = globalThis.cv;
                     resolveOnce('globalThis.cv polling');
                     return;
@@ -483,39 +486,38 @@
      * @returns Promise that resolves with cv module
      */
     async function loadOpenCV(timeout = 30000) {
-        console.log('[FaceDetectionEngine] loadOpenCV: START');
         try {
             // 快速检查是否已经初始化完成
             if (opencvInitialized) {
-                console.log('[FaceDetectionEngine] loadOpenCV: Already initialized, returning immediately');
+                console.log('[loadOpenCV] Already initialized, returning immediately');
                 const cv = getCvSync();
                 if (cv) {
                     return { cv };
                 }
             }
             // 等待初始化
-            console.log('[FaceDetectionEngine] loadOpenCV: Waiting for initialization...');
+            console.log('[loadOpenCV] Waiting for initialization...');
             if (!opencvInitPromise) {
-                console.log('[FaceDetectionEngine] loadOpenCV: Starting new initialization');
+                console.log('[loadOpenCV] Starting new initialization');
                 opencvInitPromise = _initializeOpenCV(timeout);
             }
-            console.log('[FaceDetectionEngine] loadOpenCV: Awaiting opencvInitPromise');
+            console.log('[loadOpenCV] Awaiting opencvInitPromise');
             const initTime = await opencvInitPromise;
-            console.log('[FaceDetectionEngine] loadOpenCV: After await, Promise resolved, cost :', initTime.toFixed(0), 'ms');
-            // 清除 Promise 缓存
-            opencvInitPromise = null;
             // 获取初始化后的 cv 对象
             const cv = getCvSync();
             if (!cv) {
-                console.error('[FaceDetectionEngine] loadOpenCV: getCvSync returned null');
+                console.error('[loadOpenCV] getCvSync returned null');
                 throw new Error('OpenCV module is invalid');
             }
-            console.log('[FaceDetectionEngine] loadOpenCV: SUCCESS');
-            return { cv };
+            console.log('[loadOpenCV] OpenCV.js load successfully', {
+                initTime: `${initTime.toFixed(2)}ms`,
+                version: getOpenCVVersion()
+            });
+            return cv;
         }
         catch (error) {
-            console.error('[FaceDetectionEngine] loadOpenCV: ERROR', error);
-            opencvInitPromise = null;
+            console.error('[loadOpenCV] OpenCV.js load failed', error);
+            opencvInitPromise = null; // 失败时清除 Promise，允许重试
             throw error;
         }
     }
@@ -534,6 +536,35 @@
         }
         return null;
     }
+    /**
+     * Extract OpenCV version from getBuildInformation
+     * @returns version string like "4.12.0"
+     */
+    function getOpenCVVersion() {
+        try {
+            const cv = getCvSync();
+            if (!cv || !cv.getBuildInformation) {
+                return 'unknown';
+            }
+            const buildInfo = cv.getBuildInformation();
+            // 查找 "Version control:" 或 "OpenCV" 开头的行
+            // 格式: "Version control:               4.12.0"
+            const versionMatch = buildInfo.match(/Version\s+control:\s+(\d+\.\d+\.\d+)/i);
+            if (versionMatch && versionMatch[1]) {
+                return versionMatch[1];
+            }
+            // 备用方案：查找 "OpenCV X.X.X" 格式
+            const opencvMatch = buildInfo.match(/OpenCV\s+(\d+\.\d+\.\d+)/i);
+            if (opencvMatch && opencvMatch[1]) {
+                return opencvMatch[1];
+            }
+            return 'unknown';
+        }
+        catch (error) {
+            console.error('[getOpenCVVersion] Failed to get version:', error);
+            return 'unknown';
+        }
+    }
     /**
      * Load Human.js
      * @param modelPath - Path to model files (optional)
@@ -541,6 +572,7 @@
      * @returns Promise that resolves with Human instance
      */
     async function loadHuman(modelPath, wasmPath) {
+        const initStartTime = performance.now();
         const config = {
             backend: _detectOptimalBackend(),
             face: {
@@ -563,24 +595,16 @@
         if (wasmPath) {
             config.wasmPath = wasmPath;
         }
-        console.log('[FaceDetectionEngine] Human.js config:', {
+        console.log('[loadHuman] Config:', {
             backend: config.backend,
             modelBasePath: config.modelBasePath || '(using default)',
             wasmPath: config.wasmPath || '(using default)'
         });
-        const initStartTime = performance.now();
-        console.log('[FaceDetectionEngine] Creating Human instance...');
         const human = new Human(config);
-        const instanceCreateTime = performance.now() - initStartTime;
-        console.log(`[FaceDetectionEngine] Human instance created, took ${instanceCreateTime.toFixed(2)}ms`);
-        console.log('[FaceDetectionEngine] Loading Human.js models...');
-        const modelLoadStartTime = performance.now();
         try {
             await human.load();
-            const loadTime = performance.now() - modelLoadStartTime;
             const totalTime = performance.now() - initStartTime;
-            console.log('[FaceDetectionEngine] Human.js loaded successfully', {
-                modelLoadTime: `${loadTime.toFixed(2)}ms`,
+            console.log('[loadHuman] Loaded successfully', {
                 totalInitTime: `${totalTime.toFixed(2)}ms`,
                 version: human.version
             });
@@ -588,7 +612,32 @@
         }
         catch (error) {
             const errorMsg = error instanceof Error ? error.message : 'Unknown error';
-            console.error('[FaceDetectionEngine] Human.js load failed:', errorMsg);
+            console.error('[loadHuman] Load failed:', errorMsg);
+            throw error;
+        }
+    }
+    async function loadLibraries(modelPath, wasmPath, timeout) {
+        console.log('[loadLibraries] Starting parallel load of OpenCV and Human...');
+        const startTime = performance.now();
+        if (timeout == undefined) {
+            timeout = 30000;
+        }
+        try {
+            // 并行加载 OpenCV 和 Human
+            const [cv, human] = await Promise.all([
+                loadOpenCV(timeout),
+                loadHuman(modelPath, wasmPath)
+            ]);
+            const totalTime = performance.now() - startTime;
+            console.log('[loadLibraries] Both libraries loaded successfully in', totalTime.toFixed(2), 'ms');
+            return {
+                cv,
+                human
+            };
+        }
+        catch (error) {
+            const errorMsg = error instanceof Error ? error.message : 'Unknown error';
+            console.error('[loadLibraries] Failed to load libraries:', errorMsg);
             throw error;
         }
     }
@@ -1570,12 +1619,13 @@
             this.isInitializing = true;
             this.emitDebug('initialization', 'Starting to load detection libraries...');
             try {
-                // Load OpenCV
-                this.emitDebug('initialization', 'Loading OpenCV...');
-                const { cv } = await loadOpenCV(300000); // 5 minute timeout
+                // Load Libraries
+                this.emitDebug('initialization', 'Loading Libraries...');
+                const startLoadTime = performance.now();
+                const { cv, human } = await loadLibraries(this.config.human_model_path, this.config.tensorflow_wasm_path, 30000);
                 if (!cv || !cv.Mat) {
                     console.log('[FaceDetectionEngine] Failed to load OpenCV.js: module is null or invalid');
-                    this.emit('detector-error', {
+                    this.emit('detector-loaded', {
                         success: false,
                         error: 'Failed to load OpenCV.js: module is null or invalid'
                     });
@@ -1585,22 +1635,9 @@
                     });
                     return;
                 }
-                this.emitDebug('initialization', 'OpenCV loaded successfully', {
-                    version: cv?.getBuildInformation?.() || 'unknown'
-                });
-                console.log('[FaceDetectionEngine] OpenCV loaded successfully', {
-                    version: cv?.getBuildInformation?.() || 'unknown'
-                });
-                // Load Human.js
-                console.log('[FaceDetectionEngine] Loading Human.js models...');
-                this.emitDebug('initialization', 'Loading Human.js...');
-                const humanStartTime = performance.now();
-                this.human = await loadHuman(this.config.human_model_path, this.config.tensorflow_wasm_path);
-                const humanLoadTime = performance.now() - humanStartTime;
-                if (!this.human) {
+                if (!human) {
                     const errorMsg = 'Failed to load Human.js: instance is null';
                     console.log('[FaceDetectionEngine] ' + errorMsg);
-                    this.emitDebug('initialization', errorMsg, { loadTime: humanLoadTime }, 'error');
                     this.emit('detector-loaded', {
                         success: false,
                         error: errorMsg
@@ -1611,21 +1648,16 @@
                     });
                     return;
                 }
-                this.emitDebug('initialization', 'Human.js loaded successfully', {
-                    loadTime: `${humanLoadTime.toFixed(2)}ms`,
-                    version: this.human.version
-                });
-                console.log('[FaceDetectionEngine] Human.js loaded successfully', {
-                    loadTime: `${humanLoadTime.toFixed(2)}ms`,
-                    version: this.human.version
-                });
+                // Store human instance
+                this.human = human;
                 this.isReady = true;
                 const loadedData = {
                     success: true,
-                    opencv_version: cv?.getBuildInformation?.() || 'unknown',
+                    opencv_version: getOpenCVVersion(),
                     human_version: this.human.version
                 };
                 console.log('[FaceDetectionEngine] Engine initialized and ready', {
+                    initCostTime: (performance.now() - startLoadTime).toFixed(2),
                     opencv_version: loadedData.opencv_version,
                     human_version: loadedData.human_version
                 });
@@ -2398,6 +2430,7 @@
     exports.FaceDetectionEngine = FaceDetectionEngine;
     exports.default = FaceDetectionEngine;
     exports.getCvSync = getCvSync;
+    exports.getOpenCVVersion = getOpenCVVersion;
     exports.loadOpenCV = loadOpenCV;
     exports.preloadOpenCV = preloadOpenCV;