web-step-counter-pro 1.0.0 → 1.0.3

package/package.json

@@ -1,6 +1,6 @@
 {
-  "name": "web-step-counter-pro", 
-  "version": "1.0.0",
+  "name": "web-step-counter-pro",
+  "version": "1.0.3",
   "description": "A professional-grade web step counting library with advanced anti-cheat mechanisms (GPS, Gyroscope, Rhythm Analysis).",
   "main": "step-counter.js",
   "type": "module",
@@ -16,11 +16,12 @@
     "fitness",
     "web-api"
   ],
-  "author": "Your Name",
+  "author": "S·MirrorSpace",
   "license": "MIT",
   "files": [
     "step-counter.js",
     "README.md",
     "package.json"
-  ]
-}
+  ],
+  "dependencies": {}
+}

package/step-counter.js

@@ -49,6 +49,7 @@ export class WebStepCounter {
             gpsAccuracyLimit: 20,
             maxSpeed: 2.8,
             debug: false,
+            autoPauseOnBackground: true, // 新增: Capacitor 环境下切后台自动暂停传感器
             onStep: null,
             onStatus: null,
             onSensorData: null,
@@ -58,6 +59,7 @@ export class WebStepCounter {
         // 内部状态
         this.stepCount = 0;
         this.isTracking = false;
+        this.isPausedByBackground = false; // 新增: 标记是否因后台而暂停
         this.candidateSteps = 0;
         this.lastStepTime = 0;
         this.lastCandidateStepTime = 0;
@@ -84,13 +86,21 @@ export class WebStepCounter {
     async start() {
         if (this.isTracking) return;
 
-        if (location.protocol !== 'https:' && location.hostname !== 'localhost' && location.hostname !== '127.0.0.1') {
+        const isCapacitor = !!window.Capacitor;
+
+        // 1. HTTPS 检查 (Capacitor 环境豁免)
+        if (!isCapacitor && location.protocol !== 'https:' && location.hostname !== 'localhost' && location.hostname !== '127.0.0.1') {
             this._reportStatus("必须使用 HTTPS 协议", WebStepCounter.StatusType.ERROR, WebStepCounter.StatusCode.HTTPS_REQUIRED);
             return false;
         }
 
         this._reportStatus("正在请求传感器权限...", WebStepCounter.StatusType.INFO);
 
+        // Capacitor 优化: 绑定生命周期
+        if (isCapacitor && this.config.autoPauseOnBackground) {
+            this._initCapacitorLifecycle();
+        }
+
         const permissionGranted = await this._requestPermissions();
         if (!permissionGranted) return false;
 
@@ -109,13 +119,19 @@ export class WebStepCounter {
 
     stop() {
         this.isTracking = false;
-        window.removeEventListener('devicemotion', this.handleMotion);
-        window.removeEventListener('deviceorientation', this.handleOrientation);
-        window.removeEventListener('deviceorientationabsolute', this.handleOrientation);
+        this._removeSensors();
         
         if (this.watchId) {
             navigator.geolocation.clearWatch(this.watchId);
+            this.watchId = null;
+        }
+        
+        // 清理 Capacitor 监听
+        if (this.appListener) {
+            this.appListener.remove();
+            this.appListener = null;
         }
+
         this._reportStatus("已停止", WebStepCounter.StatusType.INFO);
     }
 
@@ -147,6 +163,49 @@ export class WebStepCounter {
 
     // --- Internal ---
 
+    // Capacitor 生命周期处理
+    _initCapacitorLifecycle() {
+        if (!window.Capacitor || !window.Capacitor.Plugins || !window.Capacitor.Plugins.App) return;
+        
+        const App = window.Capacitor.Plugins.App;
+        
+        // 监听 App 状态变化
+        this.appListener = App.addListener('appStateChange', ({ isActive }) => {
+            if (!this.isTracking) return;
+
+            if (!isActive) {
+                // 切到后台: 暂停传感器以省电，并防止 iOS 冻结导致的异常数据
+                this._reportStatus("App 进入后台，暂停计步", WebStepCounter.StatusType.INFO);
+                this._removeSensors();
+                this.isPausedByBackground = true;
+            } else {
+                // 切回前台: 恢复
+                if (this.isPausedByBackground) {
+                    this._reportStatus("App 回到前台，恢复计步", WebStepCounter.StatusType.INFO);
+                    this._addSensors();
+                    this.isPausedByBackground = false;
+                }
+            }
+        });
+    }
+
+    _addSensors() {
+        window.addEventListener('devicemotion', this.handleMotion);
+        // 重新检查环境支持情况来决定添加哪个 Orientation 事件
+        if (window.DeviceOrientationEvent) {
+            window.addEventListener('deviceorientation', this.handleOrientation);
+        }
+        if ('ondeviceorientationabsolute' in window) {
+            window.addEventListener('deviceorientationabsolute', this.handleOrientation);
+        }
+    }
+
+    _removeSensors() {
+        window.removeEventListener('devicemotion', this.handleMotion);
+        window.removeEventListener('deviceorientation', this.handleOrientation);
+        window.removeEventListener('deviceorientationabsolute', this.handleOrientation);
+    }
+
     async _requestPermissions() {
         if (typeof DeviceMotionEvent !== 'undefined' && typeof DeviceMotionEvent.requestPermission === 'function') {
             try {
@@ -175,13 +234,7 @@ export class WebStepCounter {
                 return false;
             }
         } else {
-            window.addEventListener('devicemotion', this.handleMotion);
-            if (window.DeviceOrientationEvent) {
-                window.addEventListener('deviceorientation', this.handleOrientation);
-            }
-            if ('ondeviceorientationabsolute' in window) {
-                window.addEventListener('deviceorientationabsolute', this.handleOrientation);
-            }
+            this._addSensors();
         }
         return true;
     }