@authme/identity-verification 2.8.37 → 2.8.41

package/assets/locale/en_US.json

@@ -193,6 +193,7 @@
   "sdk.general.verify.error.getCloser": "Move closer",
   "sdk.general.verify.error.missmatch": "Align your ID within the frame",
   "sdk.general.verify.error.motion": "Please keep the ID card and the device still",
+  "sdk.liveness.detection.motion": "Please keep your face and device still",
   "sdk.general.verify.error.needCloseMouth": "Close your mouth",
   "sdk.general.verify.error.needDeformationFrontal": "Align the card with the designated shape",
   "sdk.general.verify.error.needFaceToCamera": "Look straight ahead",
@@ -209,7 +210,7 @@
   "sdk.general.verify.error.stagePass": "Starting next direction",
   "sdk.general.verify.error.switchCamera": "Blurry document? Tap to switch the camera",
   "sdk.general.verify.error.wrongCardType": "Wrong document",
-  "sdk.general.verify.success": "Detection successful, identifying...",
+  "sdk.general.verify.success": "Identifying...",
   "sdk.guard.verify.allowCamera": "Please allow camera access for identity verification",
   "sdk.guard.verify.content.step1": "Please hold the ID within the frame, ensure the edges are not obscured, and verify the document is clear and without glare.\n\n\n\n\n\n\n",
   "sdk.guard.verify.guide.fraudDescribe": "Please hold your ID, follow the animation prompts to flip it, and make sure each angle turns into a green frame before proceeding",
@@ -233,7 +234,7 @@
   "sdk.liveness.detection.header": "Liveness Detection",
   "sdk.liveness.detection.infopageHint.environment": "Detect in well-lit area",
   "sdk.liveness.detection.infopageHint.face": "Please ensure there are no obstructions on your face",
-  "sdk.liveness.detection.needMoreFrame": "Detection successful, identifying...",
+  "sdk.liveness.detection.needMoreFrame": "Identifying...",
   "sdk.liveness.detection.step": "Position your face within the frame",
   "sdk.liveness.detection.subtitle": "Ready to start capturing your face",
   "sdk.liveness.detection.title": "Face Verification",

package/assets/locale/ja_JP.json

@@ -193,6 +193,7 @@
   "sdk.general.verify.error.getCloser": "もっと近づけてください",
   "sdk.general.verify.error.missmatch": "書類を枠内に入れて撮影してください",
   "sdk.general.verify.error.motion": "身分証明書とデバイスを動かさずに静止させてください",
+  "sdk.liveness.detection.motion": "顔とデバイスを静止させてください",
   "sdk.general.verify.error.needCloseMouth": "口を閉じてください",
   "sdk.general.verify.error.needDeformationFrontal": "ガイド枠にカードを合わせてください。",
   "sdk.general.verify.error.needFaceToCamera": "カメラに向かって",
@@ -209,7 +210,7 @@
   "sdk.general.verify.error.stagePass": "次の方向へ進み始めます",
   "sdk.general.verify.error.switchCamera": "身分証がぼやけていませんか？\nクリックしてレンズを切り替えましょう",
   "sdk.general.verify.error.wrongCardType": "誤った書類です",
-  "sdk.general.verify.success": "検出に成功しました。識別中です...",
+  "sdk.general.verify.success": "識別中です...",
   "sdk.guard.verify.allowCamera": "カメラへのアクセスを許可して身分認証を行ってください",
   "sdk.guard.verify.content.step1": "書類を手に持ち枠内に置いてください。枠を覆わないようにし、証明書がはっきりして反射していないことを確認してください\"。",
   "sdk.guard.verify.guide.fraudDescribe": "身分証明書を手に持ち、アニメーションの指示に従って回転させてください。すべての角度が緑の枠になると通過できます",
@@ -233,7 +234,7 @@
   "sdk.liveness.detection.header": "顔認証",
   "sdk.liveness.detection.infopageHint.environment": "明るい場所で撮影してください",
   "sdk.liveness.detection.infopageHint.face": "顔には何も覆っていないことを確認してください",
-  "sdk.liveness.detection.needMoreFrame": "検出に成功しました。識別中です...",
+  "sdk.liveness.detection.needMoreFrame": "識別中です...",
   "sdk.liveness.detection.step": "顔を枠内に入れます",
   "sdk.liveness.detection.subtitle": "顔写真撮影を行います",
   "sdk.liveness.detection.title": "顔認識",

package/assets/locale/zh_Hant_TW.json

@@ -193,6 +193,7 @@
   "sdk.general.verify.error.getCloser": "靠近一點",
   "sdk.general.verify.error.missmatch": "請將證件置於框內",
   "sdk.general.verify.error.motion": "請保持身分證與裝置靜止",
+  "sdk.liveness.detection.motion": "請保持人臉和裝置靜止",
   "sdk.general.verify.error.needCloseMouth": "緊閉嘴巴",
   "sdk.general.verify.error.needDeformationFrontal": "對齊卡片形狀",
   "sdk.general.verify.error.needFaceToCamera": "將臉正對相機",
@@ -209,7 +210,7 @@
   "sdk.general.verify.error.stagePass": "即將開始下個方向",
   "sdk.general.verify.error.switchCamera": "證件模糊？點擊切換鏡頭",
   "sdk.general.verify.error.wrongCardType": "錯誤證件",
-  "sdk.general.verify.success": "偵測成功，辨識中…",
+  "sdk.general.verify.success": "辨識中…",
   "sdk.guard.verify.allowCamera": "請允許相機存取，以進行身分驗證",
   "sdk.guard.verify.content.step1": "請手持身分證置於方框內，盡量不遮蔽邊框，並確認證件清晰無反光",
   "sdk.guard.verify.guide.fraudDescribe": "請手持證件，依動畫提示翻轉，每個角度皆須變為綠框才能通過",
@@ -233,7 +234,7 @@
   "sdk.liveness.detection.header": "人臉辨識",
   "sdk.liveness.detection.infopageHint.environment": "在環境光線充足的地方進行",
   "sdk.liveness.detection.infopageHint.face": "請確保臉上沒有任何遮蔽物",
-  "sdk.liveness.detection.needMoreFrame": "偵測成功，辨識中…",
+  "sdk.liveness.detection.needMoreFrame": "辨識中…",
   "sdk.liveness.detection.step": "請依指示拍攝人臉",
   "sdk.liveness.detection.subtitle": "即將進行人臉拍攝",
   "sdk.liveness.detection.title": "人臉辨識",

package/index.cjs

@@ -29087,18 +29087,22 @@ const fasRecognitionResultMapping = fasRecognitionResult => {
     [liveness.FasRecognitionResult.Pass]: core.StatusDescription.Pass,
     [liveness.FasRecognitionResult.Error]: core.StatusDescription.Error,
     [liveness.FasRecognitionResult.NeedMoreFrame]: core.StatusDescription.NeedMoreFrame,
+    [liveness.FasRecognitionResult.Motion]: core.StatusDescription.Motion,
     [liveness.FasRecognitionResult.NeedFaceToCamera]: core.StatusDescription.NeedFaceToCamera
   };
   return (_a = fasServiceStageMap[fasRecognitionResult]) !== null && _a !== void 0 ? _a : core.StatusDescription.Failed;
 };
 
+/**
+ * 對齊 Android SDK 的 ROI 參數
+ * @see /Users/leoliu/Git/Android/ekyc-sdk-android/AuthMeLiveness/src/main/java/com/authme/lib/liveness/LivenessUseCase.kt
+ */
 var MASK_STYLE;
 (function (MASK_STYLE) {
   MASK_STYLE[MASK_STYLE["DESKTOP_LIMIT"] = 1024] = "DESKTOP_LIMIT";
-  MASK_STYLE[MASK_STYLE["DESKTOP_RATIO"] = 1.2] = "DESKTOP_RATIO";
-  MASK_STYLE[MASK_STYLE["DEFAULT_RATIO"] = 0.72] = "DEFAULT_RATIO";
-  MASK_STYLE[MASK_STYLE["HEIGHT_RATIO"] = 0.48] = "HEIGHT_RATIO";
-  MASK_STYLE[MASK_STYLE["MASK_TOP_PERCENT"] = 25.5] = "MASK_TOP_PERCENT";
+  // Android SDK 參數: widthRatio = 0.7, ratio (height/width) = 1.3
+  MASK_STYLE[MASK_STYLE["WIDTH_RATIO"] = 0.7] = "WIDTH_RATIO";
+  MASK_STYLE[MASK_STYLE["HEIGHT_WIDTH_RATIO"] = 1.3] = "HEIGHT_WIDTH_RATIO";
   MASK_STYLE[MASK_STYLE["MASK_TITLE_MARGIN"] = 24] = "MASK_TITLE_MARGIN";
   MASK_STYLE[MASK_STYLE["TITLE_TEXT_FONT_SIZE"] = 18] = "TITLE_TEXT_FONT_SIZE";
 })(MASK_STYLE || (MASK_STYLE = {}));
@@ -29123,10 +29127,20 @@ const renderLivenessUI = config => {
   const faceMask = document.createElement('div');
   faceMask.classList.add('face-mask');
   config.videoContainer.appendChild(faceMask);
-  //TODO: setup mask width/height
-  const maskHeight = window.outerHeight * MASK_STYLE.HEIGHT_RATIO;
-  const maskRatio = window.innerWidth > MASK_STYLE.DESKTOP_LIMIT ? MASK_STYLE.DESKTOP_RATIO : MASK_STYLE.DEFAULT_RATIO;
-  const maskWidth = Math.round(maskHeight * maskRatio);
+  // 對齊 Android SDK: 橢圓寬度 = 螢幕寬度 × 0.7, 高度 = 寬度 × 1.3
+  // 橫式螢幕：以高度為基準反推寬度，確保橢圓不會超出螢幕
+  const isLandscape = window.innerWidth > window.innerHeight;
+  let maskWidth;
+  let maskHeight;
+  if (isLandscape) {
+    // 橫式螢幕：以高度為基準
+    maskHeight = window.innerHeight * MASK_STYLE.WIDTH_RATIO;
+    maskWidth = maskHeight / MASK_STYLE.HEIGHT_WIDTH_RATIO;
+  } else {
+    // 直式螢幕：以寬度為基準
+    maskWidth = window.innerWidth * MASK_STYLE.WIDTH_RATIO;
+    maskHeight = maskWidth * MASK_STYLE.HEIGHT_WIDTH_RATIO;
+  }
   faceMask.style.width = `${maskWidth}px`;
   faceMask.style.height = `${maskHeight}px`;
   faceMask.style.setProperty('--authme-liveness-scanner-pass-color', uiThemeConfig.livenessSuccessScanFrame.color);
@@ -29151,8 +29165,11 @@ const renderLivenessUI = config => {
   if (uiThemeConfig.isStatementEnabled) {
     config.videoContainer.appendChild(statementContainer);
   }
-  util.uiThemeText(titleText, uiThemeConfig.titleThree, '8vh');
-  util.uiThemeHint(statusText, uiThemeConfig.hint, '15vh');
+  // 根據橢圓大小動態計算文字位置，避免壓到橢圓
+  // titleThree (direction: bottom) - 值越小越靠近底部
+  // hint (direction: top) - 值越大越往下
+  util.uiThemeText(titleText, uiThemeConfig.titleThree, '-2vh');
+  util.uiThemeHint(statusText, uiThemeConfig.hint, '7vh');
   // Set init text
   titleText.textContent = translateService.translate('sdk.liveness.detection.step');
   statusText.textContent = translateService.translate('sdk.general.verify.error.noFace');
@@ -29610,6 +29627,7 @@ function startLiveness(config) {
     })));
     const applyTextByResult = result => {
       // debugLog('fas-response', result);
+      console.log('🔍 FAS Status:', result.eStatus, result);
       sendStatusDescription$2(fasRecognitionResultMapping(result.eStatus));
       switch (result.eStatus) {
         case liveness.FasRecognitionResult.NoFace:
@@ -29667,6 +29685,10 @@ function startLiveness(config) {
           uiComponentLiveness.statusText.textContent = translateService.translate('sdk.general.verify.success');
           setBorderStatus('pass');
           break;
+        case liveness.FasRecognitionResult.Motion:
+          uiComponentLiveness.statusText.textContent = translateService.translate('sdk.liveness.detection.motion');
+          setBorderStatus('pass');
+          break;
         case liveness.FasRecognitionResult.Pass:
           if (result.eStage === liveness.EAuthMeFASServiceStage.Scale) {
             setBorderStatus(null);
@@ -32420,6 +32442,7 @@ function startOCR(config) {
       fraudRetryTimes: 1,
       fraudTimeout: 52,
       fraudMaxFps: 2,
+      ocrMaxFps: 2,
       captureTimeout: config.ocrConfig.captureTimeout
     };
     let cardSizeInfo = {
@@ -33074,7 +33097,7 @@ function startOCR(config) {
         })), rxjs.tap(() => received = true))))));
       };
       const autoCapture = canvasSizeInfo => {
-        return rxjs.of(canvasSizeInfo).pipe(handleOcrSendFrame(canvasSizeInfo, uiComponentOCR.image, uiComponentBasic.video, config.recognition, 30, false, config.ocrConfig.resultImageFormat, cardType, type), rxjs.tap(x => applyTextByResult(x.result)), rxjs.filter(({
+        return rxjs.of(canvasSizeInfo).pipe(handleOcrSendFrame(canvasSizeInfo, uiComponentOCR.image, uiComponentBasic.video, config.recognition, ocrEngineConfig.ocrMaxFps, false, config.ocrConfig.resultImageFormat, cardType, type), rxjs.tap(x => applyTextByResult(x.result)), rxjs.filter(({
           result
         }) => result.eStatus === idRecognition.EAuthMeCardOCRStatus.Pass || result.eStatus === idRecognition.EAuthMeMRZServiceStatus.Success), rxjs.take(1), rxjs.tap(() => {
           if (countdownCaptureTimer && countdownCaptureTimer.end && !countdownCaptureTimer.end()) {
@@ -34604,40 +34627,39 @@ class LivenessModule {
             frameWidth = canvasSizeInfoCan.canvasWidth;
             frameHeight = canvasSizeInfoCan.canvasHeight;
             const params = yield this.fasService.getParams();
-            const oldROI = params.faceROI;
-            const actualHeight = frameHeight * (oldROI.fBottom - oldROI.fTop);
-            const actualWidth = frameWidth * (oldROI.fRight - oldROI.fLeft);
-            let targetWidth = actualWidth;
-            // //we change the ROI when horizontal view for desktop camera.
-            // if (actualWidth > actualHeight) {
-            //   targetWidth = actualHeight;
-            //   const widthPercent = targetWidth / frameWidth;
-            //   params.faceROI.fLeft = (1 - widthPercent) / 2;
-            //   params.faceROI.fRight = 1 - (1 - widthPercent) / 2;
-            // }
-            // 如果是橫向模式 (寬度大於高度)
-            if (actualWidth > actualHeight) {
-              // 計算目標寬度，使得高度與寬度的比例為 9:16
-              // 即 actualHeight : targetWidth = 9 : 16
-              // 所以 targetWidth = (16 / 9) * actualHeight
-              targetWidth = 3 / 4 * actualHeight;
-              // 計算寬度比例
-              const widthPercent = targetWidth / frameWidth;
-              // 如果計算出的寬度比例小於1，表示需要在兩側留白
-              if (widthPercent < 1) {
-                // 調整左右邊界，使ROI在中間
-                params.faceROI.fLeft = (1 - widthPercent) / 2;
-                params.faceROI.fRight = 1 - (1 - widthPercent) / 2;
-              }
-              // 如果計算出的寬度比例大於1，表示需要裁剪寬度
-              else {
-                // 維持完整的寬度，但可能需要調整其他參數以保持9:16的比例
-                params.faceROI.fLeft = 0;
-                params.faceROI.fRight = 1;
-                // 這裡可能需要調整垂直方向的ROI，根據實際需求添加
-              }
+            /**
+             * 對齊 Android SDK 的 ROI 參數
+             * @see /Users/leoliu/Git/Android/ekyc-sdk-android/AuthMeLiveness/src/main/java/com/authme/lib/liveness/LivenessUseCase.kt
+             *
+             * Android SDK 參數:
+             * - widthRatio = 0.7 (ROI 寬度 = 螢幕寬度 × 0.7)
+             * - ratio = 1.3 (ROI 高度 = ROI 寬度 × 1.3)
+             *
+             * 橫式螢幕處理：以高度為基準反推寬度，確保橢圓不會超出螢幕
+             */
+            const WIDTH_RATIO = 0.7;
+            const HEIGHT_WIDTH_RATIO = 1.3;
+            const isLandscape = frameWidth > frameHeight;
+            let ellipseWidth;
+            let ellipseHeight;
+            if (isLandscape) {
+              // 橫式螢幕：以高度為基準，反推寬度
+              // 橢圓高度最多佔螢幕高度的 70%，然後反推寬度
+              ellipseHeight = frameHeight * WIDTH_RATIO;
+              ellipseWidth = ellipseHeight / HEIGHT_WIDTH_RATIO;
+            } else {
+              // 直式螢幕：以寬度為基準（對齊 Android SDK）
+              ellipseWidth = frameWidth * WIDTH_RATIO;
+              ellipseHeight = ellipseWidth * HEIGHT_WIDTH_RATIO;
             }
-
+            // 計算正規化 ROI (0-1 範圍)
+            const widthPercent = ellipseWidth / frameWidth;
+            const heightPercent = ellipseHeight / frameHeight;
+            // 置中計算
+            params.faceROI.fLeft = (1 - widthPercent) / 2;
+            params.faceROI.fRight = 1 - (1 - widthPercent) / 2;
+            params.faceROI.fTop = (1 - heightPercent) / 2;
+            params.faceROI.fBottom = 1 - (1 - heightPercent) / 2;
             yield this.fasService.setParams(params);
             yield this.fasService.setFrameSize(frameWidth, frameHeight);
             yield this.fasService.startSession();
@@ -35107,7 +35129,8 @@ class MRZModule {
             yield this.mrzService.init();
             yield util.waitTime(100);
             return Object.assign(Object.assign({}, resp.parameters), {
-              expiredIn: resp.expiredIn
+              expiredIn: resp.expiredIn,
+              ocrMaxFps: 2
             });
           }),
           ocrStart: (points, type, setBorderType, setCardBorderColor, setBorderSuccess, scanAnimationContainer, successAnimationContainer, frameImage, frameText, faceMode, cardType, retry = false) => __awaiter(this, void 0, void 0, function* () {
@@ -35744,7 +35767,8 @@ class OCRModule {
             yield util.waitTime(100);
             return Object.assign(Object.assign({}, resp.parameters), {
               expiredIn: resp.expiredIn,
-              captureTimeout: config.captureTimeout
+              captureTimeout: config.captureTimeout,
+              ocrMaxFps: 2
             });
           }),
           ocrStart: (points, type, setBorderType, setCardBorderColor, setBorderSuccess, scanAnimationContainer, successAnimationContainer, frameImage, frameText, faceMode, cardType, retry = false) => __awaiter(this, void 0, void 0, function* () {
@@ -37328,8 +37352,8 @@ class AuthmeIdentityVerification extends engine.AuthmeFunctionModule {
 }
 
 var name = "authme/sdk";
-var version$1 = "2.8.37";
-var date = "2025-12-11T09:36:46+0800";
+var version$1 = "2.8.41";
+var date = "2026-01-30T10:27:23+0000";
 var packageInfo = {
 	name: name,
 	version: version$1,

package/index.js

@@ -29079,18 +29079,22 @@ const fasRecognitionResultMapping = fasRecognitionResult => {
     [FasRecognitionResult.Pass]: StatusDescription.Pass,
     [FasRecognitionResult.Error]: StatusDescription.Error,
     [FasRecognitionResult.NeedMoreFrame]: StatusDescription.NeedMoreFrame,
+    [FasRecognitionResult.Motion]: StatusDescription.Motion,
     [FasRecognitionResult.NeedFaceToCamera]: StatusDescription.NeedFaceToCamera
   };
   return (_a = fasServiceStageMap[fasRecognitionResult]) !== null && _a !== void 0 ? _a : StatusDescription.Failed;
 };
 
+/**
+ * 對齊 Android SDK 的 ROI 參數
+ * @see /Users/leoliu/Git/Android/ekyc-sdk-android/AuthMeLiveness/src/main/java/com/authme/lib/liveness/LivenessUseCase.kt
+ */
 var MASK_STYLE;
 (function (MASK_STYLE) {
   MASK_STYLE[MASK_STYLE["DESKTOP_LIMIT"] = 1024] = "DESKTOP_LIMIT";
-  MASK_STYLE[MASK_STYLE["DESKTOP_RATIO"] = 1.2] = "DESKTOP_RATIO";
-  MASK_STYLE[MASK_STYLE["DEFAULT_RATIO"] = 0.72] = "DEFAULT_RATIO";
-  MASK_STYLE[MASK_STYLE["HEIGHT_RATIO"] = 0.48] = "HEIGHT_RATIO";
-  MASK_STYLE[MASK_STYLE["MASK_TOP_PERCENT"] = 25.5] = "MASK_TOP_PERCENT";
+  // Android SDK 參數: widthRatio = 0.7, ratio (height/width) = 1.3
+  MASK_STYLE[MASK_STYLE["WIDTH_RATIO"] = 0.7] = "WIDTH_RATIO";
+  MASK_STYLE[MASK_STYLE["HEIGHT_WIDTH_RATIO"] = 1.3] = "HEIGHT_WIDTH_RATIO";
   MASK_STYLE[MASK_STYLE["MASK_TITLE_MARGIN"] = 24] = "MASK_TITLE_MARGIN";
   MASK_STYLE[MASK_STYLE["TITLE_TEXT_FONT_SIZE"] = 18] = "TITLE_TEXT_FONT_SIZE";
 })(MASK_STYLE || (MASK_STYLE = {}));
@@ -29115,10 +29119,20 @@ const renderLivenessUI = config => {
   const faceMask = document.createElement('div');
   faceMask.classList.add('face-mask');
   config.videoContainer.appendChild(faceMask);
-  //TODO: setup mask width/height
-  const maskHeight = window.outerHeight * MASK_STYLE.HEIGHT_RATIO;
-  const maskRatio = window.innerWidth > MASK_STYLE.DESKTOP_LIMIT ? MASK_STYLE.DESKTOP_RATIO : MASK_STYLE.DEFAULT_RATIO;
-  const maskWidth = Math.round(maskHeight * maskRatio);
+  // 對齊 Android SDK: 橢圓寬度 = 螢幕寬度 × 0.7, 高度 = 寬度 × 1.3
+  // 橫式螢幕：以高度為基準反推寬度，確保橢圓不會超出螢幕
+  const isLandscape = window.innerWidth > window.innerHeight;
+  let maskWidth;
+  let maskHeight;
+  if (isLandscape) {
+    // 橫式螢幕：以高度為基準
+    maskHeight = window.innerHeight * MASK_STYLE.WIDTH_RATIO;
+    maskWidth = maskHeight / MASK_STYLE.HEIGHT_WIDTH_RATIO;
+  } else {
+    // 直式螢幕：以寬度為基準
+    maskWidth = window.innerWidth * MASK_STYLE.WIDTH_RATIO;
+    maskHeight = maskWidth * MASK_STYLE.HEIGHT_WIDTH_RATIO;
+  }
   faceMask.style.width = `${maskWidth}px`;
   faceMask.style.height = `${maskHeight}px`;
   faceMask.style.setProperty('--authme-liveness-scanner-pass-color', uiThemeConfig.livenessSuccessScanFrame.color);
@@ -29143,8 +29157,11 @@ const renderLivenessUI = config => {
   if (uiThemeConfig.isStatementEnabled) {
     config.videoContainer.appendChild(statementContainer);
   }
-  uiThemeText(titleText, uiThemeConfig.titleThree, '8vh');
-  uiThemeHint(statusText, uiThemeConfig.hint, '15vh');
+  // 根據橢圓大小動態計算文字位置，避免壓到橢圓
+  // titleThree (direction: bottom) - 值越小越靠近底部
+  // hint (direction: top) - 值越大越往下
+  uiThemeText(titleText, uiThemeConfig.titleThree, '-2vh');
+  uiThemeHint(statusText, uiThemeConfig.hint, '7vh');
   // Set init text
   titleText.textContent = translateService.translate('sdk.liveness.detection.step');
   statusText.textContent = translateService.translate('sdk.general.verify.error.noFace');
@@ -29602,6 +29619,7 @@ function startLiveness(config) {
     })));
     const applyTextByResult = result => {
       // debugLog('fas-response', result);
+      console.log('🔍 FAS Status:', result.eStatus, result);
       sendStatusDescription$2(fasRecognitionResultMapping(result.eStatus));
       switch (result.eStatus) {
         case FasRecognitionResult.NoFace:
@@ -29659,6 +29677,10 @@ function startLiveness(config) {
           uiComponentLiveness.statusText.textContent = translateService.translate('sdk.general.verify.success');
           setBorderStatus('pass');
           break;
+        case FasRecognitionResult.Motion:
+          uiComponentLiveness.statusText.textContent = translateService.translate('sdk.liveness.detection.motion');
+          setBorderStatus('pass');
+          break;
         case FasRecognitionResult.Pass:
           if (result.eStage === EAuthMeFASServiceStage.Scale) {
             setBorderStatus(null);
@@ -32412,6 +32434,7 @@ function startOCR(config) {
       fraudRetryTimes: 1,
       fraudTimeout: 52,
       fraudMaxFps: 2,
+      ocrMaxFps: 2,
       captureTimeout: config.ocrConfig.captureTimeout
     };
     let cardSizeInfo = {
@@ -33066,7 +33089,7 @@ function startOCR(config) {
         })), tap(() => received = true))))));
       };
       const autoCapture = canvasSizeInfo => {
-        return of(canvasSizeInfo).pipe(handleOcrSendFrame(canvasSizeInfo, uiComponentOCR.image, uiComponentBasic.video, config.recognition, 30, false, config.ocrConfig.resultImageFormat, cardType, type), tap(x => applyTextByResult(x.result)), filter(({
+        return of(canvasSizeInfo).pipe(handleOcrSendFrame(canvasSizeInfo, uiComponentOCR.image, uiComponentBasic.video, config.recognition, ocrEngineConfig.ocrMaxFps, false, config.ocrConfig.resultImageFormat, cardType, type), tap(x => applyTextByResult(x.result)), filter(({
           result
         }) => result.eStatus === EAuthMeCardOCRStatus.Pass || result.eStatus === EAuthMeMRZServiceStatus.Success), take(1), tap(() => {
           if (countdownCaptureTimer && countdownCaptureTimer.end && !countdownCaptureTimer.end()) {
@@ -34596,40 +34619,39 @@ class LivenessModule {
             frameWidth = canvasSizeInfoCan.canvasWidth;
             frameHeight = canvasSizeInfoCan.canvasHeight;
             const params = yield this.fasService.getParams();
-            const oldROI = params.faceROI;
-            const actualHeight = frameHeight * (oldROI.fBottom - oldROI.fTop);
-            const actualWidth = frameWidth * (oldROI.fRight - oldROI.fLeft);
-            let targetWidth = actualWidth;
-            // //we change the ROI when horizontal view for desktop camera.
-            // if (actualWidth > actualHeight) {
-            //   targetWidth = actualHeight;
-            //   const widthPercent = targetWidth / frameWidth;
-            //   params.faceROI.fLeft = (1 - widthPercent) / 2;
-            //   params.faceROI.fRight = 1 - (1 - widthPercent) / 2;
-            // }
-            // 如果是橫向模式 (寬度大於高度)
-            if (actualWidth > actualHeight) {
-              // 計算目標寬度，使得高度與寬度的比例為 9:16
-              // 即 actualHeight : targetWidth = 9 : 16
-              // 所以 targetWidth = (16 / 9) * actualHeight
-              targetWidth = 3 / 4 * actualHeight;
-              // 計算寬度比例
-              const widthPercent = targetWidth / frameWidth;
-              // 如果計算出的寬度比例小於1，表示需要在兩側留白
-              if (widthPercent < 1) {
-                // 調整左右邊界，使ROI在中間
-                params.faceROI.fLeft = (1 - widthPercent) / 2;
-                params.faceROI.fRight = 1 - (1 - widthPercent) / 2;
-              }
-              // 如果計算出的寬度比例大於1，表示需要裁剪寬度
-              else {
-                // 維持完整的寬度，但可能需要調整其他參數以保持9:16的比例
-                params.faceROI.fLeft = 0;
-                params.faceROI.fRight = 1;
-                // 這裡可能需要調整垂直方向的ROI，根據實際需求添加
-              }
+            /**
+             * 對齊 Android SDK 的 ROI 參數
+             * @see /Users/leoliu/Git/Android/ekyc-sdk-android/AuthMeLiveness/src/main/java/com/authme/lib/liveness/LivenessUseCase.kt
+             *
+             * Android SDK 參數:
+             * - widthRatio = 0.7 (ROI 寬度 = 螢幕寬度 × 0.7)
+             * - ratio = 1.3 (ROI 高度 = ROI 寬度 × 1.3)
+             *
+             * 橫式螢幕處理：以高度為基準反推寬度，確保橢圓不會超出螢幕
+             */
+            const WIDTH_RATIO = 0.7;
+            const HEIGHT_WIDTH_RATIO = 1.3;
+            const isLandscape = frameWidth > frameHeight;
+            let ellipseWidth;
+            let ellipseHeight;
+            if (isLandscape) {
+              // 橫式螢幕：以高度為基準，反推寬度
+              // 橢圓高度最多佔螢幕高度的 70%，然後反推寬度
+              ellipseHeight = frameHeight * WIDTH_RATIO;
+              ellipseWidth = ellipseHeight / HEIGHT_WIDTH_RATIO;
+            } else {
+              // 直式螢幕：以寬度為基準（對齊 Android SDK）
+              ellipseWidth = frameWidth * WIDTH_RATIO;
+              ellipseHeight = ellipseWidth * HEIGHT_WIDTH_RATIO;
             }
-
+            // 計算正規化 ROI (0-1 範圍)
+            const widthPercent = ellipseWidth / frameWidth;
+            const heightPercent = ellipseHeight / frameHeight;
+            // 置中計算
+            params.faceROI.fLeft = (1 - widthPercent) / 2;
+            params.faceROI.fRight = 1 - (1 - widthPercent) / 2;
+            params.faceROI.fTop = (1 - heightPercent) / 2;
+            params.faceROI.fBottom = 1 - (1 - heightPercent) / 2;
             yield this.fasService.setParams(params);
             yield this.fasService.setFrameSize(frameWidth, frameHeight);
             yield this.fasService.startSession();
@@ -35099,7 +35121,8 @@ class MRZModule {
             yield this.mrzService.init();
             yield waitTime(100);
             return Object.assign(Object.assign({}, resp.parameters), {
-              expiredIn: resp.expiredIn
+              expiredIn: resp.expiredIn,
+              ocrMaxFps: 2
             });
           }),
           ocrStart: (points, type, setBorderType, setCardBorderColor, setBorderSuccess, scanAnimationContainer, successAnimationContainer, frameImage, frameText, faceMode, cardType, retry = false) => __awaiter(this, void 0, void 0, function* () {
@@ -35736,7 +35759,8 @@ class OCRModule {
             yield waitTime(100);
             return Object.assign(Object.assign({}, resp.parameters), {
               expiredIn: resp.expiredIn,
-              captureTimeout: config.captureTimeout
+              captureTimeout: config.captureTimeout,
+              ocrMaxFps: 2
             });
           }),
           ocrStart: (points, type, setBorderType, setCardBorderColor, setBorderSuccess, scanAnimationContainer, successAnimationContainer, frameImage, frameText, faceMode, cardType, retry = false) => __awaiter(this, void 0, void 0, function* () {
@@ -37320,8 +37344,8 @@ class AuthmeIdentityVerification extends AuthmeFunctionModule {
 }
 
 var name = "authme/sdk";
-var version$1 = "2.8.37";
-var date = "2025-12-11T09:36:46+0800";
+var version$1 = "2.8.41";
+var date = "2026-01-30T10:27:23+0000";
 var packageInfo = {
 	name: name,
 	version: version$1,

package/package.json

@@ -1,15 +1,15 @@
 {
   "name": "@authme/identity-verification",
-  "version": "2.8.37",
+  "version": "2.8.41",
   "peerDependencies": {
     "core-js": "^3.6.0",
     "lottie-web": "^5.9.2",
     "rxjs": "^7.4.0",
-    "@authme/core": "2.8.37",
-    "@authme/engine": "2.8.37",
-    "@authme/id-recognition": "2.8.37",
-    "@authme/liveness": "2.8.37",
-    "@authme/util": "2.8.37"
+    "@authme/core": "2.8.41",
+    "@authme/engine": "2.8.41",
+    "@authme/id-recognition": "2.8.41",
+    "@authme/liveness": "2.8.41",
+    "@authme/util": "2.8.41"
   },
   "module": "./index.js",
   "main": "./index.cjs",

package/src/lib/interface/config.interface.d.ts

@@ -81,6 +81,7 @@ export interface OcrEngineConfig {
     fraudRetryTimes: number;
     fraudTimeout: number;
     fraudMaxFps: number;
+    ocrMaxFps: number;
     expiredIn?: number;
     captureTimeout?: number;
 }