qsh-webview-sdk 2.2.2 → 2.3.1

package/README.md

@@ -460,7 +460,7 @@ qsh.scanCode({
 ```javascript
 // 回调方式
 qsh.getLocation({
-  type: 'wgs84',  // 坐标类型：wgs84（GPS）, gcj02（国测局）, bd09（百度）
+  type: 'wgs84',  // 坐标类型：wgs84（GPS) 目前仅支持wgs84
   altitude: false, // 是否返回高度信息
   success: (res) => {
     console.log('纬度:', res.latitude);
@@ -558,19 +558,6 @@ qsh.stopLocationUpdate({
 });
 ```
 
-### 相机功能
-
-```javascript
-// 相机拍照（小程序/APP）
-qsh.takePhoto({
-  quality: 'high', // 图片质量：low, normal, high
-  sizeType: 'compressed', // 图片尺寸：original, compressed
-  success: (res) => {
-    console.log('照片路径:', res.tempImagePath);
-  },
-  fail: (err) => console.error(err)
-});
-```
 
 ### 蓝牙功能（仅 APP）
 
@@ -601,26 +588,6 @@ qsh.createBLEConnection({
 });
 ```
 
-### WiFi 功能（仅 APP）
-
-```javascript
-// 获取 WiFi 信息
-qsh.getWifiInfo({
-  success: (res) => {
-    console.log('WiFi SSID:', res.wifi.SSID);
-    console.log('WiFi BSSID:', res.wifi.BSSID);
-  },
-  fail: (err) => console.error(err)
-});
-
-// 连接 WiFi
-qsh.connectWifi({
-  SSID: 'wifi-name',
-  password: 'wifi-password',
-  success: () => console.log('连接成功'),
-  fail: (err) => console.error('连接失败:', err)
-});
-```
 
 ### 微信分享（仅 APP）
 
@@ -652,10 +619,10 @@ qsh.chooseFile({
 });
 ```
 
-### 地图选择位置
+### 地图选择位置（仅 APP）
 
 ```javascript
-// 打开地图选择位置（小程序/APP）
+// 打开地图选择位置（APP）
 qsh.chooseLocation({
   latitude: 39.908823, // 初始纬度
   longitude: 116.397470, // 初始经度
@@ -682,18 +649,9 @@ qsh.faceVerify({
 ### 打印服务（仅 APP）
 
 ```javascript
-// 打印文本
-qsh.printText({
-  content: '打印内容',
-  printerName: '打印机名称',
-  success: () => console.log('打印成功'),
-  fail: (err) => console.error('打印失败:', err)
-});
-
-// 打印图片
-qsh.printImage({
-  imagePath: '/path/to/image.jpg',
-  printerName: '打印机名称',
+// 调用打印服务
+qsh.printPdf({
+  url: '', // pdf文件地址
   success: () => console.log('打印成功'),
   fail: (err) => console.error('打印失败:', err)
 });
@@ -734,7 +692,18 @@ import { onMounted } from 'vue';
 import qsh from 'qsh-webview-sdk';
 
 onMounted(async () => {
-  await qsh.ready();
+  // 小程序环境下要先进行签名
+  if (qsh.environment.isWeixinMiniProgram) {
+    qsh.config({
+      clientId: '',
+      isProd: import.meta.env.MODE === 'production'
+    })
+  }
+
+  qsh.ready().catch((err) => {
+    console.error('qsh ready failed', err)
+  })
+
   qsh.navigateTo({ url: '/pages/demo/index' });
 });
 </script>

package/dist/index.d.ts

@@ -43,6 +43,8 @@ declare namespace UniWebView {
     nvue?: boolean;
     /** 是否 UVUE 环境 */
     uvue?: boolean;
+    /** 是否离线包 WebView 环境 */
+    offline?: boolean;
     /** 是否 H5 环境 */
     h5?: boolean;
   }
@@ -199,23 +201,74 @@ declare namespace UniWebView {
     isUniApp: boolean;
     /** 是否 Html5Plus 环境 */
     isHtml5Plus: boolean;
+    /** 是否离线包 WebView 环境 */
+    isOfflineWebview: boolean;
     /** 环境类型 */
-    type: "weixin" | "plus" | "nvue" | "uvue" | "UniApp" | "webview" | "h5";
+    type: "weixin" | "plus" | "nvue" | "uvue" | "UniApp" | "webview" | "h5" | "offline";
   }
 
+  /** 高阶 toShare：内容类型（与 type 二选一） */
+  type ShareUniversalKind = "web" | "text" | "image" | "miniProgram";
+
+  /** 高阶 toShare：去向 */
+  type ShareUniversalScene = "chat" | "timeline";
+
+  /** 各 kind 对应的 payload（按需传字段） */
+  interface ShareUniversalPayloadWeb {
+    title: string;
+    summary: string;
+    imageUrl: string;
+    /** 图文链接，与 href 二选一 */
+    path?: string;
+    href?: string;
+  }
+
+  interface ShareUniversalPayloadText {
+    /** 与 text 二选一 */
+    summary?: string;
+    text?: string;
+  }
+
+  interface ShareUniversalPayloadImage {
+    imageUrl: string;
+  }
+
+  interface ShareUniversalPayloadMiniProgram {
+    title: string;
+    summary: string;
+    imageUrl: string;
+    miniProgram: {
+      /** 小程序原始 ID（gh_ 开头），uni.share type=5 要求 */
+      id: string;
+      path: string;
+      webUrl: string;
+      type?: 0 | 1 | 2;
+    };
+  }
+
+  type ShareUniversalPayload =
+    | ShareUniversalPayloadWeb
+    | ShareUniversalPayloadText
+    | ShareUniversalPayloadImage
+    | ShareUniversalPayloadMiniProgram;
+
   /**
-   * 微信分享选项
+   * 微信分享选项（toShare 仅支持高阶入参）
    */
   interface ShareOptions {
-    /** 分享去向：0 聊天，1 朋友圈 */
-    scene?: 0 | 1;
-    /** 分享内容类型：0 图文，1 文字，2 图片，3 音乐，4 视频，5 小程序 */
-    type: 0 | 1 | 2 | 3 | 4 | 5;
-    title?: string;
-    summary?: string;
-    imageUrl?: string;
-    path?: string;
-    miniProgram?: Record<string, any>;
+    kind: ShareUniversalKind;
+    /** 各 kind 对应字段见 ShareUniversalPayload */
+    payload?: ShareUniversalPayload;
+    /** 为 true 时不打印 hint 日志 */
+    silent?: boolean;
+    /**
+     * 为 true 且当前为微信 JS-SDK 环境时，走宿主 WebView 桥 toShareData（兼容原 toShareCallBack）
+     */
+    viaWebViewBridge?: boolean;
+    /** @deprecated 等同于 viaWebViewBridge */
+    isCallBack?: boolean;
+    /** 分享去向：0 / chat 聊天，1 / timeline 朋友圈 */
+    scene?: 0 | 1 | ShareUniversalScene;
     success?: (res: ShareResult) => void;
     fail?: (error: any) => void;
     complete?: () => void;
@@ -223,6 +276,14 @@ declare namespace UniWebView {
 
   interface ShareResult {
     errMsg?: string;
+    /** 使用 kind 高阶参数时，成功回调会附带 hint / environment / raw */
+    hint?: string;
+    environment?: {
+      type: Environment["type"];
+      isWeixinMiniProgram: boolean;
+    };
+    raw?: ShareResult;
+    error?: any;
     [key: string]: any;
   }
 
@@ -381,6 +442,13 @@ declare namespace UniWebView {
       options: Omit<ShareOptions, "success" | "fail" | "complete">,
     ): Promise<ShareResult>;
 
+    /** toShare 参数说明（结构化，可 JSON 展示） */
+    readonly TO_SHARE_PARAM_HELP: Readonly<Record<string, unknown>>;
+    /** 返回 toShare 参数说明对象 */
+    getToShareParamHelp(): Readonly<Record<string, unknown>>;
+    /** 在控制台打印 toShare 参数说明，并返回文本 */
+    printToShareParamHelp(): string;
+
     /** 蓝牙 API */
     openBluetoothAdapter(options?: BluetoothOptions): Promise<any> | void;
     openBluetoothAdapterAsync(options?: BluetoothOptions): Promise<any>;