qsh-webview-sdk 2.1.0 → 2.2.1

package/README.md

@@ -672,16 +672,10 @@ qsh.chooseLocation({
 ### 人脸核身
 
 ```javascript
-// 人脸核身（小程序/APP）
+// 人脸核身：跳转宿主小程序 /pages/face/index，并将参数拼到 query 上
 qsh.faceVerify({
-  verifyType: 'idcard', // 核身类型：idcard, bankcard, driver
-  idCard: '身份证号',
   name: '姓名',
-  success: (res) => {
-    console.log('核身结果:', res.verifyResult);
-    console.log('核身分数:', res.score);
-  },
-  fail: (err) => console.error(err)
+  idCardNumber: '身份证号'
 });
 ```
 

package/dist/index.d.ts

@@ -289,6 +289,36 @@ declare namespace UniWebView {
     isProd?: boolean;
   }
 
+  /**
+   * 人脸识别选项（仅支持微信小程序环境）
+   * 只发送请求，不返回任何结果给调用者
+   */
+  interface FaceVerifyOptions {
+    /** 姓名（必填） */
+    name: string;
+    /** 身份证号（必填） */
+    idCardNumber: string;
+  }
+
+  /**
+   * 人脸识别功能能力信息
+   */
+  interface FaceCapabilities {
+    /** 是否支持人脸识别（仅微信小程序环境返回 true） */
+    supported: boolean;
+    /** 当前环境类型 */
+    environment: string;
+    /** 底层实现类型，固定为 'weixin' */
+    implementation: "weixin";
+    /** 功能特性 */
+    features: {
+      /** 支持 Promise */
+      asyncSupport: boolean;
+      /** 通过宿主页跳转实现 */
+      hostPageNavigation?: boolean;
+    };
+  }
+
   interface WeixinNamespace {
     config(options: QshConfigOptions): QshConfigOptions;
     waitForConfig(): Promise<void>;
@@ -297,7 +327,6 @@ declare namespace UniWebView {
     retryConfig(): Promise<void>;
   }
 
-
   /**
    * WebView 对象接口
    */
@@ -326,7 +355,7 @@ declare namespace UniWebView {
     webView: WebView | null;
 
     weixin: WeixinNamespace;
-    
+
     /** 图片选择（Promise版本） */
     chooseImageAsync(
       options?: Omit<ChooseImageOptions, "success" | "fail" | "complete">,
@@ -375,6 +404,14 @@ declare namespace UniWebView {
     /** 获取打印PDF功能能力信息 */
     getPrintCapabilities(): PrintPdfCapabilities;
 
+    /**
+    * 人脸识别（仅支持微信小程序环境）
+    * 通过 wx.miniProgram.navigateTo 跳转宿主 /pages/face/index，不返回任何结果给调用者
+     */
+    faceVerify(options: FaceVerifyOptions): void;
+    /** 获取人脸识别功能能力信息 */
+    getFaceCapabilities(): FaceCapabilities;
+
     /** 观测指标 */
     metrics: {
       getPerformanceReport(): Record<string, any>;