qsh-webview-sdk 2.3.6 → 2.3.8

package/dist/index.d.ts

@@ -228,36 +228,49 @@ declare namespace UniWebView {
     type: "weixin" | "plus" | "nvue" | "uvue" | "UniApp" | "webview" | "h5" | "offline";
   }
 
-  /** 定向分享：去向 */
+  /** 定向分享：去向。chat=聊天框，timeline=朋友圈 */
   type ShareUniversalScene = "chat" | "timeline";
 
-  /** 各 kind 对应的 payload（按需传字段） */
+  /**
+   * 图文分享参数。
+   * - 微信小程序环境：target 必须是 /pages/... 页面路径
+   * - App 环境：优先使用 target；若 target 不合法，再使用 webTarget 兜底
+   */
   interface ShareUniversalPayloadWeb {
     title: string;
     description: string;
     imageUrl: string;
-    /** 分享点击后进入的最终业务页面路径 */
-    targetPath: string;
-    /** App 微信图文卡片点击使用的公网链接 */
-    shareLink: string;
+    /** 当前环境下的主目标：小程序传 /pages/...；App 传 https://... */
+    target: string;
+    /** 仅 App 环境使用：当 target 不存在或不合法时，使用该公网链接兜底 */
+    webTarget?: string;
   }
 
+  /**
+   * 文字分享参数。
+   * - App 环境下会自动降级为图文分享
+   * - target / webTarget 的校验规则与图文分享一致
+   */
   interface ShareUniversalPayloadText {
     title?: string;
     description: string;
     imageUrl?: string;
-    /** 分享点击后进入的最终业务页面路径 */
-    targetPath: string;
-    /** App 微信图文卡片点击使用的公网链接 */
-    shareLink: string;
+    /** 当前环境下的主目标：小程序传 /pages/...；App 传 https://... */
+    target: string;
+    /** 仅 App 环境使用：当 target 不存在或不合法时，使用该公网链接兜底 */
+    webTarget?: string;
   }
 
+  /**
+   * 图片分享参数。
+   * - target / webTarget 的校验规则与图文分享一致
+   */
   interface ShareUniversalPayloadImage {
     imageUrl: string;
-    /** 分享点击后进入的最终业务页面路径 */
-    targetPath: string;
-    /** App 微信图文卡片点击使用的公网链接 */
-    shareLink: string;
+    /** 当前环境下的主目标：小程序传 /pages/...；App 传 https://... */
+    target: string;
+    /** 仅 App 环境使用：当 target 不存在或不合法时，使用该公网链接兜底 */
+    webTarget?: string;
     title?: string;
   }
 
@@ -279,7 +292,11 @@ declare namespace UniWebView {
     [key: string]: any;
   }
 
-  /** 定向分享模块参数（仅 H5 嵌入宿主 WebView 场景） */
+  /**
+   * 定向分享模块参数（仅 H5 嵌入宿主 WebView 场景）。
+   * - 微信小程序环境：只校验 payload.target，且必须是 /pages/...
+   * - App 环境：优先校验 payload.target 是否为公网链接；若不合法，再校验 payload.webTarget
+   */
   interface ShareDirectedOptions {
     kind: "web" | "text" | "image";
     scene?: 0 | 1 | ShareUniversalScene;
@@ -289,6 +306,11 @@ declare namespace UniWebView {
     complete?: () => void;
   }
 
+  /**
+   * 小程序卡片分享参数。
+   * - targetPath 始终表示小程序落地页路径
+   * - webUrl 只在 App 环境下参与校验和配参，小程序环境不会使用该字段决定落地页
+   */
   interface ShareMiniProgramCardPayload {
     title: string;
     imageUrl: string;
@@ -298,12 +320,10 @@ declare namespace UniWebView {
     appid: string;
     /** 小程序环境版本 */
     envVersion?: "release" | "trial" | "develop";
-    /** 兜底网页链接，供 App 微信通道必要时使用 */
-    fallbackWebUrl?: string;
+    /** App 环境分享时使用的网页兜底链接，必须是公网 https/http 链接 */
+    webUrl?: string;
     /** 小程序卡片描述 */
     description?: string;
-    /** 预留：若宿主 App 通道需要，也可传 shareLink */
-    shareLink?: string;
   }
 
   interface ShareMiniProgramCardOptions {
@@ -377,8 +397,7 @@ declare namespace UniWebView {
   }
 
   /**
-   * 人脸识别选项（仅支持微信小程序环境）
-   * 只发送请求，不返回任何结果给调用者
+   * 人脸识别选项
    */
   interface FaceVerifyOptions {
     /** 姓名（必填） */
@@ -391,18 +410,20 @@ declare namespace UniWebView {
    * 人脸识别功能能力信息
    */
   interface FaceCapabilities {
-    /** 是否支持人脸识别（仅微信小程序环境返回 true） */
+    /** 是否支持人脸识别 */
     supported: boolean;
     /** 当前环境类型 */
     environment: string;
-    /** 底层实现类型，固定为 'weixin' */
-    implementation: "weixin";
+    /** 底层实现类型 */
+    implementation: "weixin" | "uniapp";
     /** 功能特性 */
     features: {
       /** 支持 Promise */
       asyncSupport: boolean;
       /** 通过宿主页跳转实现 */
       hostPageNavigation?: boolean;
+      /** 通过宿主桥接实现 */
+      hostBridge?: boolean;
     };
   }
 
@@ -501,8 +522,8 @@ declare namespace UniWebView {
     getPrintCapabilities(): PrintPdfCapabilities;
 
     /**
-    * 人脸识别（仅支持微信小程序环境）
-    * 通过 wx.miniProgram.navigateTo 跳转宿主 /pages/face/index，不返回任何结果给调用者
+    * 人脸识别（仅支持微信小程序和 UniApp 环境）
+    * 微信环境通过 wx.miniProgram.navigateTo 跳转宿主 /pages/face/index，UniApp 环境通过桥接调用宿主实现
      */
     faceVerify(options: FaceVerifyOptions): void;
     /** 获取人脸识别功能能力信息 */
@@ -520,21 +541,5 @@ declare namespace UniWebView {
  * 全局 qsh/uni 对象（默认导出为模块默认值）
  */
 declare const qsh: UniWebView.Uni;
-declare const uni: UniWebView.Uni;
-
-/**
- * 模块导出
- */
 export default qsh;
-
-/**
- * 全局声明
- */
-declare global {
-  interface Window {
-    qsh: UniWebView.Uni;
-    UniAppJSBridge?: boolean;
-  }
-}
-
 export as namespace qsh;