qsh-webview-sdk 2.3.7 → 2.3.9

package/README.md

@@ -58,7 +58,7 @@ import qsh from 'qsh-webview-sdk';
 
 if(qsh.environment.isWeixinMiniProgram) {
   qsh.config({
-    clientId: 'your-client-id',
+    clientId: 'your-client-id',  // 注意区分生产和测试的clientId
     isProd: false
   })
 }
@@ -478,7 +478,7 @@ qsh.getLocation({
 // Promise 版本
 try {
   const location = await qsh.getLocationAsync({
-    type: 'gcj02',
+    type: 'wgs84',
     altitude: true
   });
   console.log('位置:', location.latitude, location.longitude);
@@ -511,7 +511,7 @@ await qsh.openLocationAsync({
 ```
 
 #### 坐标类型
-
+目前定位相关接口仅支持wgs84
 | 类型 | 说明 | 常量 |
 |------|------|------|
 | `wgs84` | GPS 坐标 | `qsh.CoordinateTypes.WGS84` |
@@ -665,6 +665,40 @@ qsh.printPdf({
 - NVUE 页面
 - UVUE 页面 (UniApp X)
 
+### 跳转其他微信小程序
+
+```javascript
+qsh.navigateToMiniProgram({
+  appid: ',
+  path: ',
+  // release/trial/develop
+  env: 'release',
+  success: (res) => console.log('跳转成功', res),
+  fail: (err) => console.error('跳转失败:', err),
+});
+```
+
+> `appid` 在微信小程序环境下传目标小程序 `AppID`，在 App-plus 环境下传微信小程序原始 ID。
+> `env` 为可选参数，取值 `release` / `trial` / `develop`，不传时由基座按默认逻辑处理。
+> 微信小程序 `web-view` 下，SDK 会先通过 `wx.miniProgram.postMessage` 把跳转请求投递给宿主，再调用 `wx.miniProgram.navigateBack` 触发宿主处理，因此当前 H5 页面会退出，且只能拿到“请求已投递”的结果，不能拿到宿主侧实时回调。
+
+### 在小程序中通过弹出层分享(仅小程序)
+
+```javascript
+qsh.manualShare({
+  title: '分享标题',
+  h5Url: 'https://example.com/activity?id=123', // 要通过分享打开的h5页面地址
+  clientId: 'your-client-id', // 注意区分生产和测试的clientId
+  isPublic: false, // 默认false 分享打开的h5页面如果不需要登录权限可直接打开则传true
+  imageUrl: 'https://example.com/share.png',
+  description: '分享描述',
+  success: (res) => console.log('分享成功', res),
+  fail: (err) => console.error('分享失败:', err)
+});
+```
+对于isPublic:true时 用户点击分享的内容后会直接从基座首页跳转到h5Url, 对于isPublic:false时,基座完成登录流程后会携带参数h5Url=encodeURIComponent${h5Url}跳转到配置的h5首页
+此方法会销毁当前H5页面并返回小程序基座，基座会将 h5Url 自动包装为小程序 webview 落地页
+
 ## License
 
 MIT
@@ -695,7 +729,7 @@ onMounted(async () => {
   // 小程序环境下要先进行签名
   if (qsh.environment.isWeixinMiniProgram) {
     qsh.config({
-      clientId: '',
+      clientId: '', // 注意区分生产和测试的clientId
       isProd: import.meta.env.MODE === 'production'
     })
   }

package/dist/index.d.ts

@@ -333,6 +333,22 @@ declare namespace UniWebView {
     complete?: () => void;
   }
 
+  interface ManualSharePayload {
+    title: string;
+    /** 分享后打开的 H5 地址，基座会自动包装为小程序 webview 页面 */
+    h5Url: string;
+    clientId: string;
+    isPublic?: boolean;
+    imageUrl?: string;
+    description?: string;
+  }
+
+  interface ManualShareOptions extends ManualSharePayload {
+    success?: (res: ShareResult) => void;
+    fail?: (error: any) => void;
+    complete?: (res?: ShareResult | any) => void;
+  }
+
   interface BluetoothOptions {
     success?: (res: any) => void;
     fail?: (error: any) => void;
@@ -397,8 +413,7 @@ declare namespace UniWebView {
   }
 
   /**
-   * 人脸识别选项（仅支持微信小程序环境）
-   * 只发送请求，不返回任何结果给调用者
+   * 人脸识别选项
    */
   interface FaceVerifyOptions {
     /** 姓名（必填） */
@@ -411,18 +426,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;
     };
   }
 
@@ -497,6 +514,12 @@ declare namespace UniWebView {
       options: Omit<ShareDirectedOptions, "success" | "fail" | "complete">,
     ): Promise<ShareResult>;
 
+     /** 手动分享预览：仅微信小程序 web-view，触发宿主分享弹窗 */
+    manualShare(options: ManualShareOptions): Promise<ShareResult> | void;
+    manualShareAsync(
+      options: Omit<ManualShareOptions, "success" | "fail" | "complete">,
+    ): Promise<ShareResult>;
+
     /** 蓝牙 API */
     openBluetoothAdapter(options?: BluetoothOptions): Promise<any> | void;
     openBluetoothAdapterAsync(options?: BluetoothOptions): Promise<any>;
@@ -521,8 +544,8 @@ declare namespace UniWebView {
     getPrintCapabilities(): PrintPdfCapabilities;
 
     /**
-    * 人脸识别（仅支持微信小程序环境）
-    * 通过 wx.miniProgram.navigateTo 跳转宿主 /pages/face/index，不返回任何结果给调用者
+    * 人脸识别（仅支持微信小程序和 UniApp 环境）
+    * 微信环境通过 wx.miniProgram.navigateTo 跳转宿主 /pages/face/index，UniApp 环境通过桥接调用宿主实现
      */
     faceVerify(options: FaceVerifyOptions): void;
     /** 获取人脸识别功能能力信息 */