cesium-xs-sdk 1.0.16 → 1.0.17

package/dist/cesium-xs-sdk.cjs.js

@@ -3566,6 +3566,58 @@ class EventModule {
     }
 }
 
+/**
+ * 双击判定器
+ *
+ * 背景：Cesium 的 ScreenSpaceEventType.LEFT_DOUBLE_CLICK 唯一来源是 canvas 上的
+ * DOM dblclick 事件，而 DOM dblclick 依赖浏览器/操作系统的双击合成
+ * （时间阈值 + 位移阈值 + 触屏 touch slop + 双击缩放启发式），移动场景下经常
+ * 不触发，导致"双击结束绘制/测量"在移动端静默失效。
+ *
+ * 本判定器在 SDK 自己的 LEFT_CLICK（mouse:click）流水上自维护双击判定：
+ * 连续两次 click 间隔 < 时间阈值 且 屏幕位移 < 位移阈值，即判定为双击。
+ * 如此双击收尾在鼠标、触屏、任何浏览器上行为一致，彻底移除对 DOM dblclick
+ * 合成的依赖（桌面端 DOM dblclick 路径保留作为冗余，二者靠
+ * _isDrawing / _isMeasuring 守卫天然防重）。
+ *
+ * 阈值取向：宁可漏判（用户多点一下），不可误判（把正常快速加点误判成双击收尾）。
+ */
+const DOUBLE_CLICK_INTERVAL_MS = 300; // 时间阈值（ms）
+const DOUBLE_CLICK_DISTANCE_PX = 10;  // 屏幕位移阈值（px）
+
+class DoubleClickDetector {
+  constructor() {
+    /** @type {{timestamp: number, screenPos: {x: number, y: number}} | null} */
+    this._last = null;
+  }
+
+  /**
+   * 清空内部状态。工具 activate / deactivate / 绘制会话结束 / 取消时调用，
+   * 避免跨工具、跨绘制会话的脏状态污染下一次判定。
+   */
+  reset() {
+    this._last = null;
+  }
+
+  /**
+   * 喂入一次 click，返回是否构成双击。
+   * 注意：无论是否构成双击，本次点击都会成为下次判定的"上一次点击"。
+   *
+   * @param {number} timestamp performance.now()
+   * @param {{x: number, y: number}} screenPos 屏幕坐标（取 movement.position）
+   * @returns {boolean} 是否构成双击
+   */
+  feed(timestamp, screenPos) {
+    const prev = this._last;
+    this._last = { timestamp, screenPos };
+    if (!prev) return false;
+    if (timestamp - prev.timestamp > DOUBLE_CLICK_INTERVAL_MS) return false;
+    const dx = screenPos.x - prev.screenPos.x;
+    const dy = screenPos.y - prev.screenPos.y;
+    return Math.hypot(dx, dy) <= DOUBLE_CLICK_DISTANCE_PX;
+  }
+}
+
 const Cesium$d = getCesium();
 
 /**
@@ -3581,6 +3633,8 @@ class BaseTool {
     this._options = options;
     this._isActive = false;
     this._handlers = []; // 注册的事件处理器 ID
+    // 自维护双击判定器（DOM dblclick 在移动端经常不合成，见 DoubleClickDetector 注释）
+    this._doubleClickDetector = new DoubleClickDetector();
   }
 
   /**
@@ -3589,6 +3643,8 @@ class BaseTool {
   activate() {
     if (this._isActive) return;
     this._isActive = true;
+    // 防止跨工具切换时残留上次会话的末次点击，污染本次双击判定
+    this._doubleClickDetector.reset();
     this.onActivate();
   }
 
@@ -3598,6 +3654,7 @@ class BaseTool {
   deactivate() {
     if (!this._isActive) return;
     this._isActive = false;
+    this._doubleClickDetector.reset();
     this.onDeactivate();
     this.clearHandlers();
   }
@@ -3612,6 +3669,19 @@ class BaseTool {
    */
   onDeactivate() { }
 
+  /**
+   * 判定本次 mouse:click 是否构成"双击"（自维护判定，不依赖 DOM dblclick 合成）。
+   * 子类应在"绘制 / 测量进行中"才调用本方法，避免把开启新会话的首次点击误判为双击。
+   * @param {object} movement Cesium click 事件 movement（取 movement.position 作为屏幕坐标）
+   * @returns {boolean}
+   * @protected
+   */
+  _isDoubleClick(movement) {
+    const pos = movement && movement.position;
+    if (!pos) return false;
+    return this._doubleClickDetector.feed(performance.now(), { x: pos.x, y: pos.y });
+  }
+
   /**
    * 注册事件观察者
    * @param {string} eventType 事件类型
@@ -3941,8 +4011,30 @@ class DrawTool extends BaseTool {
     // lngLat 已经是经纬度数组 [lon, lat, height]
     if (!lngLat) return;
 
-    // 优先处理标绘类型
     const plotConfig = PLOT_DRAW_CONFIG[this._drawType];
+
+    // === 自维护双击收尾判定 ===
+    // DOM dblclick 在移动端/触屏经常不被浏览器合成（见 change-log），这里在
+    // LEFT_CLICK 流水上自行判定：绘制中 + 类型支持双击收尾 + 两次 click
+    // 时间/位移在阈值内 → 收尾。本次（双击第二次）点击不加点——双击第一次
+    // 点击已把最后顶点加入 _tempPositions，直接收尾的结果与 DOM dblclick
+    // 路径（_onDoubleClick pop 掉重叠点）逐点一致。
+    // 不满足最小点数时降级为普通加点，落到下方正常逻辑。
+    if (this._isDrawing && this._supportsDoubleClickFinish() && this._isDoubleClick(movement)) {
+      const minPoints = plotConfig ? plotConfig.minPoints
+        : (this._drawType === DrawType.POLYGON ? 3 : 2); // 线 2 / 面 3
+      if (this._tempPositions.length >= minPoints) {
+        if (plotConfig) {
+          this._finishPlotDrawing(plotConfig);
+        } else {
+          this.finishDrawing();
+        }
+        return;
+      }
+      // 不满足最小点数：本次点击降级为普通加点（落到下方逻辑）
+    }
+
+    // 优先处理标绘类型
     if (plotConfig) {
       this._handlePlotClick(lngLat, plotConfig);
       return;
@@ -4082,6 +4174,18 @@ class DrawTool extends BaseTool {
     }
   }
 
+  /**
+   * 当前绘制类型是否支持"双击收尾"：
+   * 仅线 / 面 / 声明了 finishOnDoubleClick 的标绘类型支持；
+   * 点 / 矩形 / 圆保持不响应（与 _onDoubleClick 的语义一致）。
+   * @private
+   */
+  _supportsDoubleClickFinish() {
+    if (this._drawType === DrawType.LINE || this._drawType === DrawType.POLYGON) return true;
+    const plotConfig = PLOT_DRAW_CONFIG[this._drawType];
+    return !!(plotConfig && plotConfig.finishOnDoubleClick);
+  }
+
   /**
    * 双击结束绘制（移动端用：移动端没有右键；桌面端：避免绘制过程中双击误触发放大）
    * 与 _onRightClick 等价，仅线 / 面 / 标绘（声明了 finishOnDoubleClick 的）响应；
@@ -4747,6 +4851,9 @@ class DrawTool extends BaseTool {
     this._tempPositions = [];
     this._previewPlot = null;
 
+    // 绘制会话结束：清空双击判定器，避免下次绘制的开头点击与本次末次点击构成误判
+    this._doubleClickDetector.reset();
+
     this._emitGraphicCreated(config.plotType, id);
   }
 
@@ -4778,6 +4885,8 @@ class DrawTool extends BaseTool {
     this._clickCount = 0;
     this._startPos = null;
     this._currentMousePos = null;
+    // 绘制会话取消：清空双击判定器，避免下次绘制受本次末次点击污染
+    this._doubleClickDetector.reset();
     this._emitDrawCancel();
   }
 
@@ -4833,6 +4942,9 @@ class DrawTool extends BaseTool {
     this._clickCount = 0;
     this._currentMousePos = null;
 
+    // 绘制会话结束：清空双击判定器，避免下次绘制的开头点击与本次末次点击构成误判
+    this._doubleClickDetector.reset();
+
     if (deferredPreviewLine) {
       requestAnimationFrame(() => this.removeTempEntity(deferredPreviewLine));
     }
@@ -7734,7 +7846,7 @@ class MeasureTool extends BaseTool {
     controller.enableRotate = this._originalEnableRotate;
   }
 
-  _onClick(lngLat, _pickedEntity, _movement) {
+  _onClick(lngLat, _pickedEntity, movement) {
     if (!lngLat) return;
 
     // 拖拽刚结束：吞掉紧跟 mouseup 的 click，避免误开新测量
@@ -7743,6 +7855,21 @@ class MeasureTool extends BaseTool {
       return;
     }
 
+    // === 自维护双击收尾判定 ===
+    // DOM dblclick 在移动端/触屏经常不被浏览器合成（见 change-log），这里在
+    // LEFT_CLICK 流水上自行判定：测量中（非拖拽中）+ 两次 click 时间/位移在
+    // 阈值内 → 收尾。本次（双击第二次）点击不加点——双击第一次点击已把最后
+    // 顶点加入 _positions，直接收尾的结果与 DOM dblclick 路径（_onDoubleClick
+    // pop 掉重叠点）逐点一致。不满足最小点数时降级为普通加点。
+    if (this._isMeasuring && !this._isDragging && this._isDoubleClick(movement)) {
+      const minPoints = this._measureType === MeasureType.AREA ? 3 : 2;
+      if (this._positions.length >= minPoints) {
+        this._finishMeasurement();
+        return;
+      }
+      // 不满足最小点数：本次点击降级为普通加点（落到下方逻辑）
+    }
+
     // 同步鼠标位置为本次 click 的经纬度：修复"地图拖动后原地点击 → 预览线
     // 自动连接到旧鼠标位置"的 bug（主要暴露在移动端双击完成测量后）。
     //
@@ -7981,6 +8108,9 @@ class MeasureTool extends BaseTool {
     // 测量已完成 → 恢复地图拖动 / 旋转
     this._restoreCameraAfterMeasuring();
 
+    // 测量会话结束：清空双击判定器，避免下次测量受本次末次点击污染
+    this._doubleClickDetector.reset();
+
     this._emitMeasureComplete(result);
   }
 
@@ -8082,6 +8212,8 @@ class MeasureTool extends BaseTool {
     this.clearMeasurements();
     // 取消时也要恢复地图拖动（与 _finishMeasurement 对称）
     this._restoreCameraAfterMeasuring();
+    // 测量会话取消：清空双击判定器，避免下次测量受本次末次点击污染
+    this._doubleClickDetector.reset();
     this._emitMeasureCancel();
   }