qsh-webview-sdk 2.0.6 → 2.0.8

package/README.md

@@ -175,6 +175,12 @@ console.log('是否 APP:', env.isAppPlus);
 | `getLocationAsync` | 获取位置（Promise 版） | `{ type?: string; altitude?: boolean }` |
 | `openLocation` | 查看位置（打开地图） | `{ latitude: number; longitude: number; name?: string; address?: string; scale?: number; success?: Function; fail?: Function }` |
 | `openLocationAsync` | 查看位置（Promise 版） | `{ latitude: number; longitude: number; name?: string; address?: string; scale?: number }` |
+| `startLocationUpdate` | 开启前台持续定位（仅 APP） | `{ type?: string; needFullAccuracy?: boolean; success?: Function; fail?: Function }` |
+| `stopLocationUpdate` | 停止前台持续定位（仅 APP） | `{ success?: Function; fail?: Function }` |
+| `onLocationChange` | 监听实时位置变化（仅 APP） | `callback: Function` |
+| `offLocationChange` | 取消监听位置变化（仅 APP） | `callback?: Function` |
+| `onLocationChangeError` | 监听位置更新错误（仅 APP） | `callback: Function` |
+| `offLocationChangeError` | 取消监听位置更新错误（仅 APP） | `callback?: Function` |
 
 #### 实现原理
 
@@ -356,7 +362,7 @@ references/                 # 开发参考（如原版 uni.webview.1.5.6.js）
 - [x] 获取位置 ✅
 - [x] 查看位置 ✅
 - [x] 照片选择 ✅
-- [ ] 持续定位
+- [x] 持续定位 ✅
 - [ ] 相机
 - [ ] 蓝牙
 - [ ] WiFi
@@ -503,18 +509,35 @@ await qsh.openLocationAsync({
 参考文档：[UniApp getLocation](https://uniapp.dcloud.net.cn/api/location/location.html)
 
 #### 持续定位（仅 APP）
+
 ```javascript
-// 开始持续定位
+// 1. 开启前台持续定位服务
 qsh.startLocationUpdate({
-  type: 'wgs84',
-  altitude: false,
-  success: (res) => {
-    console.log('位置更新:', res);
-  }
+  type: 'wgs84',           // 坐标类型
+  needFullAccuracy: true,  // 是否需要高精度
+  success: () => console.log('定位服务已开启'),
+  fail: (err) => console.error('开启失败:', err)
+});
+
+// 2. 监听位置变化
+qsh.onLocationChange((res) => {
+  console.log('位置:', res.latitude, res.longitude);
+  console.log('精度:', res.accuracy, '米');
 });
 
-// 停止持续定位
-qsh.stopLocationUpdate();
+// 3. 监听定位错误（可选）
+qsh.onLocationChangeError((err) => {
+  console.error('定位出错:', err);
+});
+
+// 4. 停止监听
+qsh.offLocationChange();
+qsh.offLocationChangeError();
+
+// 5. 停止定位服务
+qsh.stopLocationUpdate({
+  success: () => console.log('定位服务已停止')
+});
 ```
 
 ### 相机功能

package/dist/index.d.ts

@@ -54,9 +54,9 @@ declare namespace UniWebView {
     /** 最多选择的图片数量，默认9 */
     count?: number;
     /** 图片质量类型 */
-    sizeType?: ('original' | 'compressed')[];
+    sizeType?: ("original" | "compressed")[];
     /** 图片来源类型 */
-    sourceType?: ('album' | 'camera')[];
+    sourceType?: ("album" | "camera")[];
     /** 成功回调 */
     success?: (res: ChooseImageResult) => void;
     /** 失败回调 */
@@ -99,16 +99,16 @@ declare namespace UniWebView {
    * 图片来源类型枚举
    */
   interface ImageSourceTypesEnum {
-    readonly ALBUM: 'album';
-    readonly CAMERA: 'camera';
+    readonly ALBUM: "album";
+    readonly CAMERA: "camera";
   }
 
   /**
    * 图片大小类型枚举
    */
   interface ImageSizeTypesEnum {
-    readonly ORIGINAL: 'original';
-    readonly COMPRESSED: 'compressed';
+    readonly ORIGINAL: "original";
+    readonly COMPRESSED: "compressed";
   }
 
   /**
@@ -200,7 +200,7 @@ declare namespace UniWebView {
     /** 是否 Html5Plus 环境 */
     isHtml5Plus: boolean;
     /** 环境类型 */
-    type: 'weixin' | 'plus' | 'nvue' | 'uvue' | 'UniApp' | 'webview' | 'h5';
+    type: "weixin" | "plus" | "nvue" | "uvue" | "UniApp" | "webview" | "h5";
   }
 
   /**
@@ -233,6 +233,57 @@ declare namespace UniWebView {
     [key: string]: any;
   }
 
+  /**
+   * 打印PDF选项
+   */
+  interface PrintPdfOptions {
+    /** 要打印的文件 */
+    url: string;
+    /** HTTP 请求 Header，header 中不能设置 Referer 类型 UTSJSONObject */
+    header?: Record<string, string>;
+    /** 超时时间，单位 ms 默认 120000ms*/
+    timeout?: number;
+  }
+
+  /**
+   * 打印PDF结果
+   */
+  interface PrintPdfResult {
+    data: {
+      jobId: string;
+    };
+    message: string;
+    /** 0 成功，非0 失败 */
+    code: 0 | number;
+  }
+
+  /**
+   * 打印PDF结果
+   */
+  interface PrintPdfResult {
+    /** 错误信息 */
+    errMsg?: string;
+    [key: string]: any;
+  }
+
+  /**
+   * 打印PDF功能能力信息
+   */
+  interface PrintPdfCapabilities {
+    /** 是否支持打印PDF功能 */
+    supported: boolean;
+    /** 当前环境类型 */
+    environment: string;
+    /** 底层实现类型 */
+    implementation: string;
+    /** 功能特性 */
+    features: {
+      /** 支持 Promise */
+      asyncSupport: boolean;
+      [key: string]: any;
+    };
+  }
+
   /**
    * WebView 对象接口
    */
@@ -258,17 +309,21 @@ declare namespace UniWebView {
     ready(): Promise<void>;
     /** WebView 对象（兼容旧版本） */
     webView: WebView | null;
-    
+
     /** 图片选择（Promise版本） */
-    chooseImageAsync(options?: Omit<ChooseImageOptions, 'success' | 'fail' | 'complete'>): Promise<ChooseImageResult>;
+    chooseImageAsync(
+      options?: Omit<ChooseImageOptions, "success" | "fail" | "complete">,
+    ): Promise<ChooseImageResult>;
     /** 获取图片功能能力信息 */
     getImageCapabilities(): ImageCapabilities;
-    
+
     /** 位置选择（Promise版本） */
-    chooseLocationAsync(options?: Omit<ChooseLocationOptions, 'success' | 'fail' | 'complete'>): Promise<ChooseLocationResult>;
+    chooseLocationAsync(
+      options?: Omit<ChooseLocationOptions, "success" | "fail" | "complete">,
+    ): Promise<ChooseLocationResult>;
     /** 获取位置选择功能能力信息 */
     getChooseLocationCapabilities(): ChooseLocationCapabilities;
-    
+
     /** 图片来源类型枚举 */
     ImageSourceTypes: ImageSourceTypesEnum;
     /** 图片大小类型枚举 */
@@ -276,25 +331,39 @@ declare namespace UniWebView {
 
     /** 微信分享 */
     toShare(options: ShareOptions): Promise<ShareResult> | void;
-    toShareAsync(options: Omit<ShareOptions, 'success' | 'fail' | 'complete'>): Promise<ShareResult>;
+    toShareAsync(
+      options: Omit<ShareOptions, "success" | "fail" | "complete">,
+    ): Promise<ShareResult>;
 
     /** 蓝牙 API */
     openBluetoothAdapter(options?: BluetoothOptions): Promise<any> | void;
     openBluetoothAdapterAsync(options?: BluetoothOptions): Promise<any>;
-    startBluetoothDevicesDiscovery(options?: BluetoothOptions): Promise<any> | void;
-    startBluetoothDevicesDiscoveryAsync(options?: BluetoothOptions): Promise<any>;
+    startBluetoothDevicesDiscovery(
+      options?: BluetoothOptions,
+    ): Promise<any> | void;
+    startBluetoothDevicesDiscoveryAsync(
+      options?: BluetoothOptions,
+    ): Promise<any>;
     onBluetoothDeviceFound(options?: BluetoothOptions): Promise<any> | void;
     onBluetoothDeviceFoundAsync(options?: BluetoothOptions): Promise<any>;
     createBLEConnection(options?: BluetoothOptions): Promise<any> | void;
     createBLEConnectionAsync(options?: BluetoothOptions): Promise<any>;
 
+    /** 打印PDF API */
+    printPdf(
+      options: PrintPdfOptions,
+      callback: (result: PrintPdfResult) => void,
+    ): void;
+    printPdfAsync(options: PrintPdfOptions): Promise<PrintPdfResult>;
+    /** 获取打印PDF功能能力信息 */
+    getPrintCapabilities(): PrintPdfCapabilities;
+
     /** 观测指标 */
     metrics: {
       getPerformanceReport(): Record<string, any>;
       clearPerformanceMetrics(): void;
     };
   }
-  }
 }
 
 /**
@@ -318,4 +387,4 @@ declare global {
   }
 }
 
-export as namespace qsh;
+export as namespace qsh;