deeke-script-app 1.7.8 → 1.8.0

package/@deekeScript/@type/interface/Access.d.ts

@@ -136,6 +136,39 @@ interface access {
       * @return true 如果权限被永久拒绝或禁用
       */
      public isStoragePermissionPermanentlyDenied(): boolean;
+
+     /**
+      * 检查是否有位置权限
+      * 
+      * 权限说明：
+      * - 检查 ACCESS_FINE_LOCATION（精确定位）或 ACCESS_COARSE_LOCATION（粗略定位）权限
+      * - 如果授予了 ACCESS_FINE_LOCATION，则自动拥有 ACCESS_COARSE_LOCATION 权限
+      * 
+      * @return true 如果有权限
+      */
+     public hasLocationPermission(): boolean;
+
+     /**
+      * 申请位置权限
+      * 
+      * 权限说明：
+      * - 优先请求 ACCESS_FINE_LOCATION（精确定位）
+      * - 如果用户拒绝了精确定位，系统可能降级为 ACCESS_COARSE_LOCATION（粗略定位）
+      * 
+      * 注意：这是异步操作，不会阻塞
+      * 如果用户禁用了权限，需要调用 isLocationPermissionPermanentlyDenied() 检查是否被永久拒绝
+      */
+     public requestLocationPermissions(): void;
+
+     /**
+      * 检查位置权限是否被永久拒绝（用户选择了"不再询问"）
+      * 
+      * 如果返回true，说明用户之前拒绝过权限并选择了"不再询问"，
+      * 系统不会再弹出权限对话框，需要引导用户去设置页面手动开启
+      * 
+      * @return true 如果权限被永久拒绝
+      */
+     public isLocationPermissionPermanentlyDenied(): boolean;
 }
 
 export { };

package/@deekeScript/@type/interface/Device.d.ts

@@ -28,13 +28,11 @@ interface Device {
      */
     public androidVersion(): string;
 
-    /**
-     * 生成设备唯一标识符， 卸载App前，可以通过getUuid获取，卸载后丢失
-     */
-    public createUuid(): string;
-
     /**
      * 获取设备唯一标识符
+     * 
+     * 返回系统级别的 ANDROID_ID，在设备恢复出厂设置之前会保持不变，保证设备唯一性。
+     * 注意：设备恢复出厂设置后，ANDROID_ID 可能会改变。App卸载不会影响此标识符。
      */
     public getUuid(): string;
 
@@ -207,6 +205,27 @@ interface Device {
         publicIP: string;
         publicIPV6: string;
     };
+
+    /**
+     * 获取设备当前位置信息
+     * 
+     * 需要先申请位置权限（使用Access.requestLocationPermissions()）。
+     * 此方法会优先使用GPS定位（更精确），如果GPS不可用，会尝试使用网络定位。
+     * 如果仍然无法获取位置，会尝试使用被动定位提供者。
+     * 
+     * @returns 位置信息对象，包含纬度、经度、海拔、精度、速度、方向角、时间戳和定位提供者。
+     *          如果获取失败或没有权限，返回 null
+     */
+    public getLocation(): {
+        latitude: number;
+        longitude: number;
+        altitude: number;
+        accuracy: number;
+        speed: number;
+        bearing: number;
+        time: number;
+        provider: string;
+    } | null;
 }
 
 export { };

package/@deekeScript/@type/interface/System.d.ts

@@ -9,6 +9,18 @@ interface System {
      */
     public sleep(milliSecond: number): void;
 
+    /**
+     * 精确休眠
+     * @param milliSecond 毫秒
+     * 
+     * 与sleep()方法相比，preciseSleep()使用更精确的休眠机制，
+     * 通过WakeLock保持CPU唤醒状态，并使用循环检查来确保休眠时间的准确性。
+     * 
+     * 注意：此方法会保持CPU唤醒状态，可能会增加电量消耗。
+     * 如果不需要精确的休眠时间，建议使用sleep()方法。
+     */
+    public preciseSleep(milliSecond: number): void;
+
     /**
      * 释放内存
      */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "deeke-script-app",
-  "version": "1.7.8",
+  "version": "1.8.0",
   "description": "DeekeScript应用",
   "main": "src/index.ts",
   "scripts": {