qsh-webview-sdk 2.0.6 → 2.0.7

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('定位服务已停止')
+});
 ```
 
 ### 相机功能