deeptwins-engine-3d 0.1.1 → 0.1.3

package/LICENSE

@@ -1,21 +1,6 @@
-MIT License
-
-Copyright (c) sdzl
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+COPYRIGHT NOTICE & COMMERCIAL LICENSE
+Copyright (c) 2025 sdzl. All rights reserved.
+This software is proprietary and commercial. Unauthorized use, copying, modification,
+or redistribution is strictly prohibited without a valid license agreement.
+For licensing and pricing information, please contact:
+Email: shenduzhilian@gmail.com

package/README.md

@@ -2,38 +2,3 @@
 map for 3d
 
 ## Usage
-
-TODO
-
-## Options
-
-TODO
-
-## Development
-
-```bash
-# install dependencies
-$ npm install
-
-# develop library by docs demo
-$ npm start
-
-# build library source code
-$ npm run build
-
-# build library source code in watch mode
-$ npm run build:watch
-
-# build docs
-$ npm run docs:build
-
-# Locally preview the production build.
-$ npm run docs:preview
-
-# check your project for potential problems
-$ npm run doctor
-```
-
-## LICENSE
-
-MIT

package/dist/esm/cameraControl/ModelRoamRealTime.d.ts

@@ -6,7 +6,7 @@ interface Position {
     lng: number;
     lat: number;
     alt: number;
-    timestamp?: number;
+    timestamp: number;
 }
 export default class ModelRoamRealTime {
     readonly _map: any;
@@ -17,17 +17,21 @@ export default class ModelRoamRealTime {
     private readonly _onPositionUpdate;
     modelLayer: any;
     polylineLayer: any;
+    historyPolylineLayer: any;
     private _lastFrameTime;
     private _stepAccumulator;
     private _frameCount;
     private _fps;
-    private _time;
     private receivedPositions;
     private completedSegments;
     private currentSegment;
     private futureSegments;
     private currentPointIndex;
     private segmentCounter;
+    private TRAIL_POSITIONS_THRESHOLD;
+    private historyTrailPositions;
+    private trailDataUpdated;
+    private trailShowState;
     private _eventPostUpdate;
     private modelMatrix;
     private hpRoll;
@@ -83,23 +87,27 @@ export default class ModelRoamRealTime {
      * 初始化轨迹线Entity
      */
     private initTrailLine;
+    /**
+     * 创建历史轨迹线Entity
+     */
+    private createHistoryTrailLine;
     /**
      * 获取轨迹线位置点
      * 返回：已完成路径段的起始点和结束点 + 当前路径段已飞行的插值点
      */
     private getTrailLinePositions;
     /**
-     * 更新轨迹线 - 现在由CallbackProperty自动更新
+     * 检查并移动数据到历史轨迹
      */
-    private updateTrailLine;
+    private checkAndMoveToHistory;
     /**
-     * 获取当前状态信息
+     * 标记已经移动到历史的路径段
      */
-    getStatus(): any;
+    private markCompletedSegmentsAsMovedToHistory;
     /**
-     * 获取详细的飞行信息
+     * 更新轨迹线 - 现在由CallbackProperty自动更新
      */
-    getFlightDetails(): any;
+    private updateTrailLine;
     /**
      * 计算模型朝向
      * @param start 起始点
@@ -130,7 +138,7 @@ export default class ModelRoamRealTime {
      */
     setFollowFirst(options: any): void;
     /**
-     * 设置第一人称视角
+     * 设置第三人称视角
      */
     setFollowThird(options: any): void;
     /**
@@ -141,6 +149,15 @@ export default class ModelRoamRealTime {
      * 飞行定位到模型
      */
     private _flyToModel;
+    /**
+     * 显示隐藏飞行轨迹
+     * */
+    showPolylineLayer(isShow: boolean): void;
+    /**
+     * 强制更新轨迹数据
+     * 用于确保轨迹数据的连续性
+     */
+    forceUpdateTrailData(): void;
     /**
      * 监听
      */

package/dist/esm/cameraControl/ModelRoamRealTime.js

@@ -1,4 +1,10 @@
 function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+function _toConsumableArray(arr) { return _arrayWithoutHoles(arr) || _iterableToArray(arr) || _unsupportedIterableToArray(arr) || _nonIterableSpread(); }
+function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _iterableToArray(iter) { if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter); }
+function _arrayWithoutHoles(arr) { if (Array.isArray(arr)) return _arrayLikeToArray(arr); }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
 function _regeneratorRuntime() { "use strict"; /*! regenerator-runtime -- Copyright (c) 2014-present, Facebook, Inc. -- license (MIT): https://github.com/facebook/regenerator/blob/main/LICENSE */ _regeneratorRuntime = function _regeneratorRuntime() { return e; }; var t, e = {}, r = Object.prototype, n = r.hasOwnProperty, o = Object.defineProperty || function (t, e, r) { t[e] = r.value; }, i = "function" == typeof Symbol ? Symbol : {}, a = i.iterator || "@@iterator", c = i.asyncIterator || "@@asyncIterator", u = i.toStringTag || "@@toStringTag"; function define(t, e, r) { return Object.defineProperty(t, e, { value: r, enumerable: !0, configurable: !0, writable: !0 }), t[e]; } try { define({}, ""); } catch (t) { define = function define(t, e, r) { return t[e] = r; }; } function wrap(t, e, r, n) { var i = e && e.prototype instanceof Generator ? e : Generator, a = Object.create(i.prototype), c = new Context(n || []); return o(a, "_invoke", { value: makeInvokeMethod(t, r, c) }), a; } function tryCatch(t, e, r) { try { return { type: "normal", arg: t.call(e, r) }; } catch (t) { return { type: "throw", arg: t }; } } e.wrap = wrap; var h = "suspendedStart", l = "suspendedYield", f = "executing", s = "completed", y = {}; function Generator() {} function GeneratorFunction() {} function GeneratorFunctionPrototype() {} var p = {}; define(p, a, function () { return this; }); var d = Object.getPrototypeOf, v = d && d(d(values([]))); v && v !== r && n.call(v, a) && (p = v); var g = GeneratorFunctionPrototype.prototype = Generator.prototype = Object.create(p); function defineIteratorMethods(t) { ["next", "throw", "return"].forEach(function (e) { define(t, e, function (t) { return this._invoke(e, t); }); }); } function AsyncIterator(t, e) { function invoke(r, o, i, a) { var c = tryCatch(t[r], t, o); if ("throw" !== c.type) { var u = c.arg, h = u.value; return h && "object" == _typeof(h) && n.call(h, "__await") ? e.resolve(h.__await).then(function (t) { invoke("next", t, i, a); }, function (t) { invoke("throw", t, i, a); }) : e.resolve(h).then(function (t) { u.value = t, i(u); }, function (t) { return invoke("throw", t, i, a); }); } a(c.arg); } var r; o(this, "_invoke", { value: function value(t, n) { function callInvokeWithMethodAndArg() { return new e(function (e, r) { invoke(t, n, e, r); }); } return r = r ? r.then(callInvokeWithMethodAndArg, callInvokeWithMethodAndArg) : callInvokeWithMethodAndArg(); } }); } function makeInvokeMethod(e, r, n) { var o = h; return function (i, a) { if (o === f) throw new Error("Generator is already running"); if (o === s) { if ("throw" === i) throw a; return { value: t, done: !0 }; } for (n.method = i, n.arg = a;;) { var c = n.delegate; if (c) { var u = maybeInvokeDelegate(c, n); if (u) { if (u === y) continue; return u; } } if ("next" === n.method) n.sent = n._sent = n.arg;else if ("throw" === n.method) { if (o === h) throw o = s, n.arg; n.dispatchException(n.arg); } else "return" === n.method && n.abrupt("return", n.arg); o = f; var p = tryCatch(e, r, n); if ("normal" === p.type) { if (o = n.done ? s : l, p.arg === y) continue; return { value: p.arg, done: n.done }; } "throw" === p.type && (o = s, n.method = "throw", n.arg = p.arg); } }; } function maybeInvokeDelegate(e, r) { var n = r.method, o = e.iterator[n]; if (o === t) return r.delegate = null, "throw" === n && e.iterator.return && (r.method = "return", r.arg = t, maybeInvokeDelegate(e, r), "throw" === r.method) || "return" !== n && (r.method = "throw", r.arg = new TypeError("The iterator does not provide a '" + n + "' method")), y; var i = tryCatch(o, e.iterator, r.arg); if ("throw" === i.type) return r.method = "throw", r.arg = i.arg, r.delegate = null, y; var a = i.arg; return a ? a.done ? (r[e.resultName] = a.value, r.next = e.nextLoc, "return" !== r.method && (r.method = "next", r.arg = t), r.delegate = null, y) : a : (r.method = "throw", r.arg = new TypeError("iterator result is not an object"), r.delegate = null, y); } function pushTryEntry(t) { var e = { tryLoc: t[0] }; 1 in t && (e.catchLoc = t[1]), 2 in t && (e.finallyLoc = t[2], e.afterLoc = t[3]), this.tryEntries.push(e); } function resetTryEntry(t) { var e = t.completion || {}; e.type = "normal", delete e.arg, t.completion = e; } function Context(t) { this.tryEntries = [{ tryLoc: "root" }], t.forEach(pushTryEntry, this), this.reset(!0); } function values(e) { if (e || "" === e) { var r = e[a]; if (r) return r.call(e); if ("function" == typeof e.next) return e; if (!isNaN(e.length)) { var o = -1, i = function next() { for (; ++o < e.length;) if (n.call(e, o)) return next.value = e[o], next.done = !1, next; return next.value = t, next.done = !0, next; }; return i.next = i; } } throw new TypeError(_typeof(e) + " is not iterable"); } return GeneratorFunction.prototype = GeneratorFunctionPrototype, o(g, "constructor", { value: GeneratorFunctionPrototype, configurable: !0 }), o(GeneratorFunctionPrototype, "constructor", { value: GeneratorFunction, configurable: !0 }), GeneratorFunction.displayName = define(GeneratorFunctionPrototype, u, "GeneratorFunction"), e.isGeneratorFunction = function (t) { var e = "function" == typeof t && t.constructor; return !!e && (e === GeneratorFunction || "GeneratorFunction" === (e.displayName || e.name)); }, e.mark = function (t) { return Object.setPrototypeOf ? Object.setPrototypeOf(t, GeneratorFunctionPrototype) : (t.__proto__ = GeneratorFunctionPrototype, define(t, u, "GeneratorFunction")), t.prototype = Object.create(g), t; }, e.awrap = function (t) { return { __await: t }; }, defineIteratorMethods(AsyncIterator.prototype), define(AsyncIterator.prototype, c, function () { return this; }), e.AsyncIterator = AsyncIterator, e.async = function (t, r, n, o, i) { void 0 === i && (i = Promise); var a = new AsyncIterator(wrap(t, r, n, o), i); return e.isGeneratorFunction(r) ? a : a.next().then(function (t) { return t.done ? t.value : a.next(); }); }, defineIteratorMethods(g), define(g, u, "Generator"), define(g, a, function () { return this; }), define(g, "toString", function () { return "[object Generator]"; }), e.keys = function (t) { var e = Object(t), r = []; for (var n in e) r.push(n); return r.reverse(), function next() { for (; r.length;) { var t = r.pop(); if (t in e) return next.value = t, next.done = !1, next; } return next.done = !0, next; }; }, e.values = values, Context.prototype = { constructor: Context, reset: function reset(e) { if (this.prev = 0, this.next = 0, this.sent = this._sent = t, this.done = !1, this.delegate = null, this.method = "next", this.arg = t, this.tryEntries.forEach(resetTryEntry), !e) for (var r in this) "t" === r.charAt(0) && n.call(this, r) && !isNaN(+r.slice(1)) && (this[r] = t); }, stop: function stop() { this.done = !0; var t = this.tryEntries[0].completion; if ("throw" === t.type) throw t.arg; return this.rval; }, dispatchException: function dispatchException(e) { if (this.done) throw e; var r = this; function handle(n, o) { return a.type = "throw", a.arg = e, r.next = n, o && (r.method = "next", r.arg = t), !!o; } for (var o = this.tryEntries.length - 1; o >= 0; --o) { var i = this.tryEntries[o], a = i.completion; if ("root" === i.tryLoc) return handle("end"); if (i.tryLoc <= this.prev) { var c = n.call(i, "catchLoc"), u = n.call(i, "finallyLoc"); if (c && u) { if (this.prev < i.catchLoc) return handle(i.catchLoc, !0); if (this.prev < i.finallyLoc) return handle(i.finallyLoc); } else if (c) { if (this.prev < i.catchLoc) return handle(i.catchLoc, !0); } else { if (!u) throw new Error("try statement without catch or finally"); if (this.prev < i.finallyLoc) return handle(i.finallyLoc); } } } }, abrupt: function abrupt(t, e) { for (var r = this.tryEntries.length - 1; r >= 0; --r) { var o = this.tryEntries[r]; if (o.tryLoc <= this.prev && n.call(o, "finallyLoc") && this.prev < o.finallyLoc) { var i = o; break; } } i && ("break" === t || "continue" === t) && i.tryLoc <= e && e <= i.finallyLoc && (i = null); var a = i ? i.completion : {}; return a.type = t, a.arg = e, i ? (this.method = "next", this.next = i.finallyLoc, y) : this.complete(a); }, complete: function complete(t, e) { if ("throw" === t.type) throw t.arg; return "break" === t.type || "continue" === t.type ? this.next = t.arg : "return" === t.type ? (this.rval = this.arg = t.arg, this.method = "return", this.next = "end") : "normal" === t.type && e && (this.next = e), y; }, finish: function finish(t) { for (var e = this.tryEntries.length - 1; e >= 0; --e) { var r = this.tryEntries[e]; if (r.finallyLoc === t) return this.complete(r.completion, r.afterLoc), resetTryEntry(r), y; } }, catch: function _catch(t) { for (var e = this.tryEntries.length - 1; e >= 0; --e) { var r = this.tryEntries[e]; if (r.tryLoc === t) { var n = r.completion; if ("throw" === n.type) { var o = n.arg; resetTryEntry(r); } return o; } } throw new Error("illegal catch attempt"); }, delegateYield: function delegateYield(e, r, n) { return this.delegate = { iterator: values(e), resultName: r, nextLoc: n }, "next" === this.method && (this.arg = t), y; } }, e; }
 function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
 function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
@@ -14,7 +20,7 @@ import * as Cesium from 'deeptwins-cesium';
 import { cloneDeep, merge } from 'lodash';
 import { v4 as uuidv4 } from 'uuid';
 import * as constant from "../constant";
-import { colorString } from "../tool/utils";
+import PolylineEntity from "../graphicLayer/PolylineEntity";
 
 /**
  * 位置信息
@@ -48,15 +54,14 @@ var ModelRoamRealTime = /*#__PURE__*/function () {
     _defineProperty(this, "modelLayer", void 0);
     // 轨迹layer
     _defineProperty(this, "polylineLayer", void 0);
+    // 历史轨迹layer
+    _defineProperty(this, "historyPolylineLayer", void 0);
     // 上一帧时间
     _defineProperty(this, "_lastFrameTime", performance.now());
     // 累加器
     _defineProperty(this, "_stepAccumulator", 0);
     _defineProperty(this, "_frameCount", 0);
     _defineProperty(this, "_fps", 'N/A');
-    // 重新设计的数据结构
-    // 上个点位的时间
-    _defineProperty(this, "_time", performance.now());
     // 接收到的原始位置数据
     _defineProperty(this, "receivedPositions", []);
     // 已完成飞行的路径段
@@ -69,6 +74,14 @@ var ModelRoamRealTime = /*#__PURE__*/function () {
     _defineProperty(this, "currentPointIndex", 0);
     // 路径段计数器
     _defineProperty(this, "segmentCounter", 0);
+    // 轨迹线数据量阈值
+    _defineProperty(this, "TRAIL_POSITIONS_THRESHOLD", 1000);
+    // 历史轨迹位置点
+    _defineProperty(this, "historyTrailPositions", []);
+    // 轨迹数据更新标志
+    _defineProperty(this, "trailDataUpdated", false);
+    // 轨迹显示状态
+    _defineProperty(this, "trailShowState", true);
     // 帧率更新的事件
     _defineProperty(this, "_eventPostUpdate", void 0);
     // 模型参数
@@ -102,8 +115,9 @@ var ModelRoamRealTime = /*#__PURE__*/function () {
     _defineProperty(this, "updateModel", function () {
       var currentTime = performance.now();
       _this._frameCount++;
-      if (currentTime - _this._lastFrameTime > 1000) {
-        _this._fps = _this._frameCount;
+      var elapsed = currentTime - _this._lastFrameTime;
+      if (elapsed > 60) {
+        _this._fps = Math.min(Math.round(_this._frameCount * 1000 / elapsed), _this._map.targetFrameRate);
         _this._frameCount = 0;
         _this._lastFrameTime = currentTime;
       }
@@ -114,6 +128,7 @@ var ModelRoamRealTime = /*#__PURE__*/function () {
       // 检查当前路径段是否完成
       if (_this.currentPointIndex >= _this.currentSegment.interpolatedPoints.length) {
         _this.completeCurrentSegment();
+        _this._stepAccumulator += 1;
         return;
       }
       var currentPos = _this.currentSegment.interpolatedPoints[_this.currentPointIndex];
@@ -130,6 +145,9 @@ var ModelRoamRealTime = /*#__PURE__*/function () {
       // 初始化轨迹线（如果还未创建）
       _this.updateTrailLine();
 
+      // 重置轨迹数据更新标志
+      _this.trailDataUpdated = false;
+
       // 更新模型位置
       if (_this.modelLayer) {
         // 只有位置真正发生变化时才更新矩阵
@@ -149,19 +167,18 @@ var ModelRoamRealTime = /*#__PURE__*/function () {
           _this.updateCameraView();
         }
       }
-      _this.currentPointIndex++;
       if (_this._fps === 'N/A') {
         _this.currentPointIndex++;
       } else {
-        // 每帧应飞的“点数”（允许小数）
-        var exactStep = _this._map.targetFrameRate / _this._fps;
+        // 每帧应飞的"点数"（允许小数）
+        var exactStep = _this._fps ? _this._map.targetFrameRate / _this._fps : 1;
         // 累加步长
         _this._stepAccumulator += exactStep;
-        // 取整：当前帧应飞的“完整点数”
+        // 取整：当前帧应飞的"完整点数"
         var step = Math.max(1, Math.floor(_this._stepAccumulator));
         // 剩余留给下帧
-        _this._stepAccumulator -= step;
-        _this.currentPointIndex = _this.currentPointIndex + step;
+        _this._stepAccumulator -= Math.min(step, _this._stepAccumulator);
+        _this.currentPointIndex += step;
       }
     });
     if (!map) {
@@ -179,6 +196,11 @@ var ModelRoamRealTime = /*#__PURE__*/function () {
     this.polylineOptions = merge(constant.DEFAULT_POLYLINE_PRIMITIVE_OPTIONS(), cloneDeep(polyline || {}));
     this.flyTo = flyTo || false;
     this._onPositionUpdate = onPositionUpdate;
+
+    // 初始化轨迹显示状态
+    if (this.polylineOptions && typeof this.polylineOptions.show === 'boolean') {
+      this.trailShowState = this.polylineOptions.show;
+    }
   }
 
   /**
@@ -193,7 +215,7 @@ var ModelRoamRealTime = /*#__PURE__*/function () {
 
       // 添加时间戳
       if (!newPosition.timestamp) {
-        newPosition.timestamp = new Date().getTime();
+        newPosition.timestamp = performance.now();
       }
 
       // 如果是第一次接收数据，初始化模型
@@ -240,9 +262,7 @@ var ModelRoamRealTime = /*#__PURE__*/function () {
       var endC3 = Cesium.Cartesian3.fromDegrees(endPos.lng, endPos.lat, endPos.alt);
 
       // 计算飞行时间
-      var newTime = performance.now();
-      var flightTime = (newTime - this._time) / 1000;
-      this._time = newTime;
+      var flightTime = (endPos.timestamp - startPos.timestamp) / 1000;
 
       // 计算插值点
       var interpolatedPoints = this._getInterPosition(startC3, endC3, flightTime);
@@ -251,7 +271,8 @@ var ModelRoamRealTime = /*#__PURE__*/function () {
         endPos: endPos,
         interpolatedPoints: interpolatedPoints,
         segmentIndex: this.segmentCounter++,
-        isCompleted: false
+        isCompleted: false,
+        isMovedToHistory: false
       };
 
       // 如果当前没有正在飞行的路径段，则设为当前段
@@ -309,7 +330,7 @@ var ModelRoamRealTime = /*#__PURE__*/function () {
       }
 
       // 计算总的插值点数 用最大帧率*时间计算点位
-      var numberOfPoints = Math.max(10, Math.floor(flightTime * this._map.targetFrameRate));
+      var numberOfPoints = Math.max(2, Math.floor(flightTime * this._map.targetFrameRate) - 1);
 
       // 计算时间步长
       var timeStep = 1.0 / (numberOfPoints - 1);
@@ -422,18 +443,47 @@ var ModelRoamRealTime = /*#__PURE__*/function () {
     key: "initTrailLine",
     value: function initTrailLine() {
       var _this3 = this;
+      var mergeStyle = merge(constant.DEFAULT_POLYLINE_OPTIONS(), cloneDeep(this.polylineOptions || {}));
+      var currStyle = PolylineEntity.handleOptions(mergeStyle);
       // 创建轨迹线Entity，使用callback动态更新位置
       this.polylineLayer = this._map.entities.add({
         id: uuidv4(),
-        polyline: {
+        polyline: _objectSpread({
           positions: new Cesium.CallbackProperty(function () {
-            return _this3.getTrailLinePositions();
-          }, false),
-          width: this.polylineOptions.width || 2,
-          material: colorString(this.polylineOptions.color || Cesium.Color.YELLOW),
-          clampToGround: false
-        }
+            // 即使轨迹隐藏，也要更新数据
+            var positions = _this3.getTrailLinePositions();
+            _this3.trailDataUpdated = true;
+            return positions;
+          }, false)
+        }, currStyle)
       });
+
+      // 设置初始显示状态
+      if (this.polylineLayer) {
+        this.polylineLayer.polyline.show = this.trailShowState;
+      }
+    }
+
+    /**
+     * 创建历史轨迹线Entity
+     */
+  }, {
+    key: "createHistoryTrailLine",
+    value: function createHistoryTrailLine() {
+      var mergeStyle = merge(constant.DEFAULT_POLYLINE_OPTIONS(), cloneDeep(this.polylineOptions || {}));
+      var currStyle = PolylineEntity.handleOptions(mergeStyle);
+      // 创建历史轨迹线Entity，使用静态位置
+      this.historyPolylineLayer = this._map.entities.add({
+        id: uuidv4(),
+        polyline: _objectSpread({
+          positions: this.historyTrailPositions
+        }, currStyle)
+      });
+
+      // 同步当前轨迹线的显示状态
+      if (this.polylineLayer) {
+        this.historyPolylineLayer.polyline.show = this.polylineLayer.polyline.show;
+      }
     }
 
     /**
@@ -450,10 +500,10 @@ var ModelRoamRealTime = /*#__PURE__*/function () {
         return positions;
       }
 
-      // 添加已完成路径段的起始点和结束点
+      // 添加已完成路径段的起始点和结束点（只处理未移动到历史的路径段）
       if (Array.isArray(this.completedSegments)) {
         this.completedSegments.forEach(function (segment) {
-          if (segment.startPos && segment.endPos) {
+          if (segment.startPos && segment.endPos && !segment.isMovedToHistory) {
             // 添加起始点（如果这是第一个路径段或者与上一个路径段不重复）
             if (positions.length === 0) {
               positions.push(Cesium.Cartesian3.fromDegrees(segment.startPos.lng, segment.startPos.lat, segment.startPos.alt));
@@ -464,6 +514,9 @@ var ModelRoamRealTime = /*#__PURE__*/function () {
         });
       }
 
+      // 检查数据量是否超过阈值，如果超过则将部分数据移到历史轨迹
+      this.checkAndMoveToHistory(positions);
+
       // 如果当前有正在飞行的路径段，添加已飞行过的插值点
       if (this.currentSegment && Array.isArray(this.currentSegment.interpolatedPoints) && this.currentPointIndex >= 0) {
         // 如果还没有添加过任何点，先添加当前路径段的起始点
@@ -480,92 +533,76 @@ var ModelRoamRealTime = /*#__PURE__*/function () {
     }
 
     /**
-     * 更新轨迹线 - 现在由CallbackProperty自动更新
+     * 检查并移动数据到历史轨迹
      */
   }, {
-    key: "updateTrailLine",
-    value: function updateTrailLine() {
-      // 由于使用了CallbackProperty和getTrailLinePositions方法
-      // 轨迹线会自动更新显示：所有原始位置点 + 当前段已飞行的插值点
-      if (!this.polylineLayer && this.receivedPositions.length >= 2) {
-        this.initTrailLine();
+    key: "checkAndMoveToHistory",
+    value: function checkAndMoveToHistory(currentPositions) {
+      if (currentPositions.length > this.TRAIL_POSITIONS_THRESHOLD) {
+        var _this$historyTrailPos;
+        // 将所有超过阈值的点移动到历史轨迹
+        var positionsToHistory = currentPositions.slice(0, this.TRAIL_POSITIONS_THRESHOLD);
+
+        // 从当前轨迹中移除这些点
+        currentPositions.splice(0, this.TRAIL_POSITIONS_THRESHOLD);
+
+        // 标记已经移动到历史的路径段
+        this.markCompletedSegmentsAsMovedToHistory();
+        (_this$historyTrailPos = this.historyTrailPositions).push.apply(_this$historyTrailPos, _toConsumableArray(positionsToHistory));
+
+        // 如果历史轨迹图层不存在，创建它
+        if (!this.historyPolylineLayer) {
+          this.createHistoryTrailLine();
+        } else {
+          // 更新历史轨迹图层的位置
+          this.historyPolylineLayer.polyline.positions = this.historyTrailPositions;
+        }
+
+        // 同步显示状态
+        if (this.polylineLayer && this.historyPolylineLayer) {
+          this.historyPolylineLayer.polyline.show = this.polylineLayer.polyline.show;
+        }
       }
     }
 
     /**
-     * 获取当前状态信息
+     * 标记已经移动到历史的路径段
      */
   }, {
-    key: "getStatus",
-    value: function getStatus() {
-      var _this$currentSegment;
-      var currentProgress = this.currentSegment ? Math.round(this.currentPointIndex / this.currentSegment.interpolatedPoints.length * 100) : 0;
-      return {
-        status: this.status,
-        receivedPositionsCount: this.receivedPositions.length,
-        completedSegmentsCount: this.completedSegments.length,
-        currentSegmentIndex: ((_this$currentSegment = this.currentSegment) === null || _this$currentSegment === void 0 ? void 0 : _this$currentSegment.segmentIndex) || null,
-        currentSegmentProgress: "".concat(currentProgress, "%"),
-        futureSegmentsCount: this.futureSegments.length,
-        currentPointIndex: this.currentPointIndex,
-        totalTrailPoints: this.getTrailLinePositions().length,
-        isWaitingForData: !this.currentSegment && this.futureSegments.length === 0
-      };
+    key: "markCompletedSegmentsAsMovedToHistory",
+    value: function markCompletedSegmentsAsMovedToHistory() {
+      if (!Array.isArray(this.completedSegments) || this.completedSegments.length === 0) {
+        return;
+      }
+
+      // 标记除了最后一个路径段之外的所有已完成路径段
+      var segmentsToMark = this.completedSegments.length - 2;
+      for (var i = 0; i < segmentsToMark; i++) {
+        var segment = this.completedSegments[i];
+        if (segment.isCompleted && !segment.isMovedToHistory) {
+          segment.isMovedToHistory = true;
+        }
+      }
     }
 
     /**
-     * 获取详细的飞行信息
+     * 更新轨迹线 - 现在由CallbackProperty自动更新
      */
   }, {
-    key: "getFlightDetails",
-    value: function getFlightDetails() {
-      var _this4 = this;
-      return {
-        // 当前位置信息
-        currentPosition: this.currentSegment && this.currentPointIndex < this.currentSegment.interpolatedPoints.length ? function () {
-          var pos = _this4.currentSegment.interpolatedPoints[_this4.currentPointIndex];
-          var cartographic = Cesium.Cartographic.fromCartesian(pos);
-          return {
-            longitude: Cesium.Math.toDegrees(cartographic.longitude),
-            latitude: Cesium.Math.toDegrees(cartographic.latitude),
-            height: cartographic.height
-          };
-        }() : null,
-        // 当前路径段信息
-        currentSegment: this.currentSegment ? {
-          index: this.currentSegment.segmentIndex,
-          startPos: this.currentSegment.startPos,
-          endPos: this.currentSegment.endPos,
-          totalPoints: this.currentSegment.interpolatedPoints.length,
-          currentPoint: this.currentPointIndex,
-          progress: Math.round(this.currentPointIndex / this.currentSegment.interpolatedPoints.length * 100)
-        } : null,
-        // 队列信息
-        queue: {
-          completed: Array.isArray(this.completedSegments) ? this.completedSegments.map(function (seg) {
-            return {
-              index: seg.segmentIndex,
-              from: "(".concat(seg.startPos.lng, ", ").concat(seg.startPos.lat, ")"),
-              to: "(".concat(seg.endPos.lng, ", ").concat(seg.endPos.lat, ")")
-            };
-          }) : [],
-          future: Array.isArray(this.futureSegments) ? this.futureSegments.map(function (seg) {
-            return {
-              index: seg.segmentIndex,
-              from: "(".concat(seg.startPos.lng, ", ").concat(seg.startPos.lat, ")"),
-              to: "(".concat(seg.endPos.lng, ", ").concat(seg.endPos.lat, ")"),
-              points: seg.interpolatedPoints.length
-            };
-          }) : []
-        },
-        // 整体统计
-        statistics: {
-          totalDataReceived: this.receivedPositions.length,
-          totalSegmentsCreated: this.segmentCounter,
-          totalTrailPoints: this.getTrailLinePositions().length,
-          memoryStatus: "\u5DF2\u5B8C\u6210\u6BB5\u6570: ".concat(this.completedSegments.length, ", \u7B49\u5F85\u6BB5\u6570: ").concat(this.futureSegments.length)
-        }
-      };
+    key: "updateTrailLine",
+    value: function updateTrailLine() {
+      // 由于使用了CallbackProperty和getTrailLinePositions方法
+      // 轨迹线会自动更新显示：所有原始位置点 + 当前段已飞行的插值点
+      if (!this.polylineLayer && this.receivedPositions.length >= 2) {
+        this.initTrailLine();
+      }
+
+      // 强制更新轨迹数据，确保即使轨迹隐藏时数据也能正确更新
+      if (this.polylineLayer && !this.trailDataUpdated) {
+        // 手动触发一次数据更新
+        this.getTrailLinePositions();
+        this.trailDataUpdated = true;
+      }
     }
 
     /**
@@ -662,7 +699,20 @@ var ModelRoamRealTime = /*#__PURE__*/function () {
   }, {
     key: "updateThirdPersonView",
     value: function updateThirdPersonView(position) {
-      this._map.camera.lookAt(position, new Cesium.HeadingPitchRange(this.hpRoll.heading, Cesium.Math.toRadians(this.thirdPersonSettings.pitch), this.thirdPersonSettings.distance));
+      // 计算相机位置（在模型后方一定距离）
+      var transform = Cesium.Transforms.headingPitchRollToFixedFrame(position, this.hpRoll, Cesium.Ellipsoid.WGS84, Cesium.Transforms.localFrameToFixedFrameGenerator('north', 'west'));
+      var offset = new Cesium.Cartesian3(-this.thirdPersonSettings.distance, 0, 500);
+      var cameraPosition = Cesium.Matrix4.multiplyByPoint(transform, offset, new Cesium.Cartesian3());
+
+      // 设置相机位置和朝向
+      this._map.camera.setView({
+        destination: cameraPosition,
+        orientation: {
+          heading: this.hpRoll.heading,
+          pitch: Cesium.Math.toRadians(this.thirdPersonSettings.pitch),
+          roll: 0.0
+        }
+      });
     }
 
     /**
@@ -678,7 +728,7 @@ var ModelRoamRealTime = /*#__PURE__*/function () {
     }
 
     /**
-     * 设置第一人称视角
+     * 设置第三人称视角
      */
   }, {
     key: "setFollowThird",
@@ -710,6 +760,44 @@ var ModelRoamRealTime = /*#__PURE__*/function () {
       this._map.camera.flyToBoundingSphere(boundingSphere);
     }
 
+    /**
+     * 显示隐藏飞行轨迹
+     * */
+  }, {
+    key: "showPolylineLayer",
+    value: function showPolylineLayer(isShow) {
+      this.trailShowState = isShow;
+      if (this.polylineLayer) {
+        this.polylineLayer.polyline.show = isShow;
+      }
+      if (this.historyPolylineLayer) {
+        this.historyPolylineLayer.polyline.show = isShow;
+      }
+
+      // 如果显示轨迹，强制更新一次数据以确保轨迹连续性
+      if (isShow && this.polylineLayer) {
+        this.trailDataUpdated = false;
+        // 手动触发一次数据更新
+        this.getTrailLinePositions();
+        this.trailDataUpdated = true;
+      }
+    }
+
+    /**
+     * 强制更新轨迹数据
+     * 用于确保轨迹数据的连续性
+     */
+  }, {
+    key: "forceUpdateTrailData",
+    value: function forceUpdateTrailData() {
+      if (this.polylineLayer) {
+        this.trailDataUpdated = false;
+        // 手动触发一次数据更新
+        this.getTrailLinePositions();
+        this.trailDataUpdated = true;
+      }
+    }
+
     /**
      * 监听
      */
@@ -737,12 +825,19 @@ var ModelRoamRealTime = /*#__PURE__*/function () {
         this._map.entities.remove(this.polylineLayer);
         this.polylineLayer = null;
       }
+      if (this.historyPolylineLayer) {
+        this._map.entities.remove(this.historyPolylineLayer);
+        this.historyPolylineLayer = null;
+      }
       this.receivedPositions = [];
       this.completedSegments = [];
       this.currentSegment = null;
       this.futureSegments = [];
       this.currentPointIndex = 0;
       this.segmentCounter = 0;
+      this.historyTrailPositions = [];
+      this.trailDataUpdated = false;
+      this.trailShowState = true;
     }
   }]);
   return ModelRoamRealTime;

package/dist/esm/constant.js

@@ -353,10 +353,11 @@ export var DEFAULT_POLYLINE_TRAIL_LINK_MATERIAL_STYLE = function DEFAULT_POLYLIN
     mixRatio: 0.5,
     duration: 2,
     count: 3,
+    repeat: [1, 1],
+    repeatPixel: 1000,
     image: utils.getDeepTwinsFile('Image/line.png')
   };
 };
-
 // 动态墙材质默认的配置
 export var DEFAULT_DYNAMIC_WALL_MATERIAL_STYLE = function DEFAULT_DYNAMIC_WALL_MATERIAL_STYLE() {
   return {