deeptwins-engine-3d 0.1.67 → 0.1.68

package/dist/esm/cameraControl/ModelRoamHistory.js

@@ -1,6 +1,9 @@
 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 _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; }
+function asyncGeneratorStep(gen, resolve, reject, _next, _throw, key, arg) { try { var info = gen[key](arg); var value = info.value; } catch (error) { reject(error); return; } if (info.done) { resolve(value); } else { Promise.resolve(value).then(_next, _throw); } }
+function _asyncToGenerator(fn) { return function () { var self = this, args = arguments; return new Promise(function (resolve, reject) { var gen = fn.apply(self, args); function _next(value) { asyncGeneratorStep(gen, resolve, reject, _next, _throw, "next", value); } function _throw(err) { asyncGeneratorStep(gen, resolve, reject, _next, _throw, "throw", err); } _next(undefined); }); }; }
 function _classCallCheck(instance, Constructor) { if (!(instance instanceof Constructor)) { throw new TypeError("Cannot call a class as a function"); } }
 function _defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if ("value" in descriptor) descriptor.writable = true; Object.defineProperty(target, _toPropertyKey(descriptor.key), descriptor); } }
 function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); Object.defineProperty(Constructor, "prototype", { writable: false }); return Constructor; }
@@ -20,29 +23,35 @@ var ModelRoamHistory = /*#__PURE__*/function () {
     _defineProperty(this, "polylineEntity", void 0);
     _defineProperty(this, "modelLayer", void 0);
     _defineProperty(this, "modelEntity", void 0);
-    _defineProperty(this, "positionProperty", void 0);
-    // 视角
+    _defineProperty(this, "positionProperty", null);
     _defineProperty(this, "follow", null);
-    _defineProperty(this, "status", 'stop');
-    _defineProperty(this, "_eventRunning", void 0);
-    _defineProperty(this, "_eventComplete", void 0);
-    _defineProperty(this, "_eventCancel", void 0);
-    // 帧率更新的事件
+    _defineProperty(this, "status", 'initializing');
+    _defineProperty(this, "_eventRunning", null);
+    _defineProperty(this, "_eventComplete", null);
+    _defineProperty(this, "_eventCancel", null);
     _defineProperty(this, "_eventPreUpdate", void 0);
     _defineProperty(this, "_positions", []);
-    _defineProperty(this, "_currentPosition", void 0);
-    _defineProperty(this, "_heading", void 0);
-    _defineProperty(this, "_listenRunning", void 0);
-    // 第一人称视角设置
+    _defineProperty(this, "_currentPosition", null);
+    _defineProperty(this, "_heading", null);
+    _defineProperty(this, "_listenRunning", null);
+    _defineProperty(this, "_clockRange", Cesium.ClockRange.CLAMPED);
+    _defineProperty(this, "_initPromise", void 0);
+    _defineProperty(this, "_isReady", false);
+    _defineProperty(this, "_pendingStart", false);
+    _defineProperty(this, "_hasReachedStopTime", false);
+    _defineProperty(this, "_modelSourceId", null);
+    _defineProperty(this, "_samples", []);
     _defineProperty(this, "firstCameraSettings", {
       distance: 0,
       pitch: -45
     });
-    // 第三人称视角设置
     _defineProperty(this, "thirdPersonSettings", {
       distance: 500,
       pitch: -45
     });
+    if (!(map !== null && map !== void 0 && map._mapContext)) {
+      throw new Error('undefined map');
+    }
     var _ref = options || {},
       complete = _ref.complete,
       cancel = _ref.cancel,
@@ -51,31 +60,142 @@ var ModelRoamHistory = /*#__PURE__*/function () {
     cancel && (this._eventCancel = cancel);
     onRunning && (this._eventRunning = onRunning);
     this._mapContext = map._mapContext;
-    this._positions = positions;
-    this._init(options);
+    this._positions = this._normalizePositions(positions);
+    this._initPromise = this._init(options);
+    this._initPromise.catch(function () {
+      return undefined;
+    });
   }
   _createClass(ModelRoamHistory, [{
     key: "getMap",
     value: function getMap() {
       return this._mapContext && this._mapContext.getMap();
     }
+  }, {
+    key: "isReady",
+    value: function isReady() {
+      return this._isReady;
+    }
+  }, {
+    key: "getStatus",
+    value: function getStatus() {
+      return this.status;
+    }
   }, {
     key: "_init",
-    value: function _init(options) {
-      var _this = this;
-      var _ref2 = options || {},
-        polyline = _ref2.polyline,
-        model = _ref2.model,
-        _ref2$multiplier = _ref2.multiplier,
-        multiplier = _ref2$multiplier === void 0 ? 1 : _ref2$multiplier,
-        _ref2$clockRange = _ref2.clockRange,
-        clockRange = _ref2$clockRange === void 0 ? Cesium.ClockRange.CLAMPED : _ref2$clockRange,
-        _ref2$flyTo = _ref2.flyTo,
-        flyTo = _ref2$flyTo === void 0 ? false : _ref2$flyTo,
-        _ref2$clampToGround = _ref2.clampToGround,
-        clampToGround = _ref2$clampToGround === void 0 ? false : _ref2$clampToGround,
-        _ref2$splitNum = _ref2.splitNum,
-        splitNum = _ref2$splitNum === void 0 ? 50 : _ref2$splitNum;
+    value: function () {
+      var _init2 = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee(options) {
+        var _this$polylineLayer;
+        var _ref2, polyline, _ref2$model, model, _ref2$multiplier, multiplier, _ref2$clockRange, clockRange, _ref2$flyTo, flyTo, _ref2$clampToGround, clampToGround, _ref2$splitNum, splitNum, map, start, stop, _this$polylineLayer2, _this$modelLayer, samples, modelOptions, startPosition;
+        return _regeneratorRuntime().wrap(function _callee$(_context) {
+          while (1) switch (_context.prev = _context.next) {
+            case 0:
+              _ref2 = options || {}, polyline = _ref2.polyline, _ref2$model = _ref2.model, model = _ref2$model === void 0 ? {} : _ref2$model, _ref2$multiplier = _ref2.multiplier, multiplier = _ref2$multiplier === void 0 ? 1 : _ref2$multiplier, _ref2$clockRange = _ref2.clockRange, clockRange = _ref2$clockRange === void 0 ? Cesium.ClockRange.CLAMPED : _ref2$clockRange, _ref2$flyTo = _ref2.flyTo, flyTo = _ref2$flyTo === void 0 ? false : _ref2$flyTo, _ref2$clampToGround = _ref2.clampToGround, clampToGround = _ref2$clampToGround === void 0 ? false : _ref2$clampToGround, _ref2$splitNum = _ref2.splitNum, splitNum = _ref2$splitNum === void 0 ? 50 : _ref2$splitNum;
+              this._clockRange = clockRange;
+              map = this.getMap();
+              start = Cesium.JulianDate.fromDate(this._positions[0].time);
+              stop = Cesium.JulianDate.fromDate(this._positions[this._positions.length - 1].time);
+              this._createPolylineLayer(polyline, clampToGround);
+              this.polylineEntity = (_this$polylineLayer = this.polylineLayer) === null || _this$polylineLayer === void 0 || (_this$polylineLayer = _this$polylineLayer.layers) === null || _this$polylineLayer === void 0 || (_this$polylineLayer = _this$polylineLayer[0]) === null || _this$polylineLayer === void 0 ? void 0 : _this$polylineLayer.entity;
+              if (flyTo) {
+                (_this$polylineLayer2 = this.polylineLayer) === null || _this$polylineLayer2 === void 0 || _this$polylineLayer2.flyTo();
+              }
+              this._configureClock(start, stop, multiplier, clockRange);
+              this._bindSceneListener();
+              _context.prev = 10;
+              _context.next = 13;
+              return this._buildPositionSamples({
+                clampToGround: clampToGround,
+                splitNum: splitNum
+              });
+            case 13:
+              samples = _context.sent;
+              if (!(this.status === 'destroy')) {
+                _context.next = 16;
+                break;
+              }
+              return _context.abrupt("return");
+            case 16:
+              this.positionProperty = new Cesium.SampledPositionProperty();
+              this._samples = samples.slice().sort(function (a, b) {
+                return a.time.getTime() - b.time.getTime();
+              });
+              this._appendSamples(this._samples);
+              modelOptions = _objectSpread(_objectSpread({}, model || {}), clampToGround ? {
+                heightReference: Cesium.HeightReference.CLAMP_TO_GROUND
+              } : {});
+              this.modelEntity = new Cesium.Entity({
+                availability: new Cesium.TimeIntervalCollection([new Cesium.TimeInterval({
+                  start: start,
+                  stop: stop
+                })]),
+                orientation: new Cesium.VelocityOrientationProperty(this.positionProperty),
+                position: this.positionProperty,
+                model: ModelEntity.handleOptions(modelOptions)
+              });
+              this.modelLayer = map.addCustomSourceToGraphicLayer(this.modelEntity.position, {
+                type: 'model',
+                entity: this.modelEntity
+              });
+              this._modelSourceId = ((_this$modelLayer = this.modelLayer) === null || _this$modelLayer === void 0 ? void 0 : _this$modelLayer.sourceId) || null;
+              this.status = 'stop';
+              this._isReady = true;
+              startPosition = this.positionProperty.getValue(map.clock.currentTime);
+              if (startPosition) {
+                this._currentPosition = startPosition;
+              }
+              if (this._pendingStart) {
+                this._pendingStart = false;
+                this.start();
+              }
+              _context.next = 34;
+              break;
+            case 30:
+              _context.prev = 30;
+              _context.t0 = _context["catch"](10);
+              if (this.status !== 'destroy') {
+                this.status = 'error';
+              }
+              throw _context.t0;
+            case 34:
+            case "end":
+              return _context.stop();
+          }
+        }, _callee, this, [[10, 30]]);
+      }));
+      function _init(_x) {
+        return _init2.apply(this, arguments);
+      }
+      return _init;
+    }()
+  }, {
+    key: "_normalizePositions",
+    value: function _normalizePositions(positions) {
+      if (!Array.isArray(positions) || positions.length < 2) {
+        throw new Error('positions must contain at least two items');
+      }
+      var normalizedPositions = positions.map(function (item, index) {
+        var time = (item === null || item === void 0 ? void 0 : item.time) instanceof Date ? item.time : new Date(item === null || item === void 0 ? void 0 : item.time);
+        if (typeof (item === null || item === void 0 ? void 0 : item.lng) !== 'number' || typeof (item === null || item === void 0 ? void 0 : item.lat) !== 'number' || typeof (item === null || item === void 0 ? void 0 : item.alt) !== 'number' || Number.isNaN(time.getTime())) {
+          throw new Error("invalid position data at index ".concat(index));
+        }
+        return {
+          lng: item.lng,
+          lat: item.lat,
+          alt: item.alt,
+          time: time
+        };
+      });
+      for (var i = 1; i < normalizedPositions.length; i++) {
+        if (normalizedPositions[i].time.getTime() <= normalizedPositions[i - 1].time.getTime()) {
+          throw new Error('positions time must be in strictly ascending order');
+        }
+      }
+      return normalizedPositions;
+    }
+  }, {
+    key: "_createPolylineLayer",
+    value: function _createPolylineLayer(polyline, clampToGround) {
       var geoJson = {
         type: 'FeatureCollection',
         features: [{
@@ -90,277 +210,428 @@ var ModelRoamHistory = /*#__PURE__*/function () {
       };
       this.polylineLayer = this.getMap().addGraphicLayer(geoJson, {
         type: 'polyline',
-        id: '_modelHistoryRoam',
         style: _objectSpread(_objectSpread({}, polyline), {}, {
           clampToGround: clampToGround
         })
       });
-      this.polylineEntity = this.polylineLayer.layers[0].entity;
-      if (flyTo) {
-        this.polylineLayer.flyTo();
-      }
-      var start = Cesium.JulianDate.fromDate(this._positions[0].time);
-      var stop = Cesium.JulianDate.fromDate(this._positions[this._positions.length - 1].time);
-      this.getMap().clock.startTime = start.clone();
-      this.getMap().clock.stopTime = stop.clone();
-      this.getMap().clock.currentTime = start.clone();
-      // 播放速率
-      this.getMap().clock.multiplier = multiplier;
-      this.getMap().clock.clockRange = clockRange;
-      // 停止播放
-      this.getMap().clock.shouldAnimate = false;
+    }
+  }, {
+    key: "_configureClock",
+    value: function _configureClock(start, stop, multiplier, clockRange) {
+      var map = this.getMap();
+      map.clock.startTime = start.clone();
+      map.clock.stopTime = stop.clone();
+      map.clock.currentTime = start.clone();
+      map.clock.multiplier = multiplier;
+      map.clock.clockRange = clockRange;
+      map.clock.shouldAnimate = false;
+    }
+  }, {
+    key: "_bindSceneListener",
+    value: function _bindSceneListener() {
+      var _this = this;
       this._listenRunning = function () {
-        // 判断结束
-        if (Cesium.JulianDate.compare(_this.getMap().clock.currentTime, _this.getMap().clock.stopTime) >= 0 && clockRange !== Cesium.ClockRange.LOOP_STOP) {
+        if (!_this._isReady || !_this.positionProperty || _this.status === 'destroy' || _this.status === 'error') {
+          return;
+        }
+        var map = _this.getMap();
+        var clock = map.clock;
+        var currentTime = clock.currentTime;
+        var reachedStopTime = Cesium.JulianDate.compare(currentTime, clock.stopTime) >= 0;
+        if (reachedStopTime && !_this._hasReachedStopTime) {
+          _this._hasReachedStopTime = true;
           if (_this._eventComplete && _this.status === 'running') {
             _this._eventComplete();
           }
-          _this.status = 'stop';
-        } else {
-          // 监听运行状态
-          if (_this._eventRunning && _this.getMap().clock.shouldAnimate) {
-            // 获取当前时间
-            var currentTime = _this.getMap().clock.currentTime;
-            // 获取前一帧时间
-            var beforeTime = Cesium.JulianDate.addSeconds(currentTime, -0.1, new Cesium.JulianDate());
-            // 获取插值后的当前位置
-            var currentPosition = _this.positionProperty.getValue(currentTime);
-            // 获取前一帧的位置
-            var beforePosition = _this.positionProperty.getValue(beforeTime);
-            if (currentPosition) {
-              _this._currentPosition = currentPosition;
-              if (_this.modelLayer && _this._positions && beforePosition) {
-                _this._getHeading(currentPosition, beforePosition);
-              }
-              _this._eventRunning(_objectSpread(_objectSpread({}, cartesian3ToLngLatAlt(currentPosition)), {}, {
-                time: Cesium.JulianDate.toDate(currentTime)
-              }));
-            }
+          if (_this._clockRange !== Cesium.ClockRange.LOOP_STOP) {
+            _this.status = 'stop';
+            clock.shouldAnimate = false;
           }
+        } else if (!reachedStopTime) {
+          _this._hasReachedStopTime = false;
+        }
+        if (!clock.shouldAnimate) {
+          return;
+        }
+        var currentPosition = _this.positionProperty.getValue(currentTime);
+        if (!currentPosition) {
+          return;
+        }
+        _this._currentPosition = currentPosition;
+        var beforePosition = _this._getPreviousPosition(currentTime);
+        if (beforePosition) {
+          _this._updateHeading(currentPosition, beforePosition);
+        }
+        if (_this._eventRunning) {
+          _this._eventRunning(_objectSpread(_objectSpread({}, cartesian3ToLngLatAlt(currentPosition)), {}, {
+            time: Cesium.JulianDate.toDate(currentTime)
+          }));
         }
       };
-      // 监听帧率
       this._eventPreUpdate = this.getMap().on(constant.SCENE_EVENT_TYPE.PRE_UPDATE, this._listenRunning);
-      this.positionProperty = new Cesium.SampledPositionProperty();
-      if (clampToGround) {
-        // 贴地计算
-        model.heightReference = Cesium.HeightReference.CLAMP_TO_GROUND;
-        var _loop = function _loop() {
-          var position1 = _this._positions[i];
-          var position2 = _this._positions[i + 1];
-          var points = lineClampToGroundSplit({
-            map: _this.getMap(),
-            pos1: lngLatAltToCartesian3(position1.lng, position1.lat, position1.alt),
-            pos2: lngLatAltToCartesian3(position2.lng, position2.lat, position2.alt),
-            splitNum: splitNum
-          });
-          // 分段计算
-          var cartographicPoints = points.map(function (point) {
-            return Cesium.Cartographic.fromCartesian(point);
-          });
-          // 贴地计算
-          Cesium.sampleTerrainMostDetailed(_this.getMap().terrainProvider, cartographicPoints).then(function (updatedPoints) {
-            var startTime = position1.time;
-            var endTime = position2.time;
-            var totalInterval = endTime - startTime;
-            var segmentInterval = totalInterval / updatedPoints.length;
-            for (var j = 0; j < updatedPoints.length; j++) {
-              var dataPoint = updatedPoints[j];
-              var position = Cesium.Cartesian3.fromRadians(dataPoint.longitude, dataPoint.latitude, dataPoint.height);
-              var time = new Date(startTime.getTime() + j * segmentInterval);
-              _this.positionProperty.addSample(Cesium.JulianDate.fromDate(time), position);
-            }
-          });
+    }
+  }, {
+    key: "_buildPositionSamples",
+    value: function () {
+      var _buildPositionSamples2 = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee2(_ref3) {
+        var _this2 = this;
+        var clampToGround, splitNum, map, segmentTasks, segments;
+        return _regeneratorRuntime().wrap(function _callee2$(_context2) {
+          while (1) switch (_context2.prev = _context2.next) {
+            case 0:
+              clampToGround = _ref3.clampToGround, splitNum = _ref3.splitNum;
+              if (clampToGround) {
+                _context2.next = 3;
+                break;
+              }
+              return _context2.abrupt("return", this._positions.map(function (dataPoint) {
+                return {
+                  time: dataPoint.time,
+                  position: lngLatAltToCartesian3(dataPoint.lng, dataPoint.lat, dataPoint.alt)
+                };
+              }));
+            case 3:
+              map = this.getMap();
+              segmentTasks = this._positions.slice(0, -1).map(function (position1, index) {
+                var position2 = _this2._positions[index + 1];
+                var points = lineClampToGroundSplit({
+                  map: map,
+                  pos1: lngLatAltToCartesian3(position1.lng, position1.lat, position1.alt),
+                  pos2: lngLatAltToCartesian3(position2.lng, position2.lat, position2.alt),
+                  splitNum: splitNum
+                });
+                if (!points.length) {
+                  return Promise.resolve({
+                    index: index,
+                    samples: _this2._buildRawSegmentSamples(position1, position2)
+                  });
+                }
+                var cartographicPoints = points.map(function (point) {
+                  return Cesium.Cartographic.fromCartesian(point);
+                });
+                return Cesium.sampleTerrainMostDetailed(map.terrainProvider, cartographicPoints).then(function (updatedPoints) {
+                  return {
+                    index: index,
+                    samples: _this2._buildTerrainSegmentSamples(position1, position2, updatedPoints)
+                  };
+                });
+              });
+              _context2.next = 7;
+              return Promise.all(segmentTasks);
+            case 7:
+              segments = _context2.sent;
+              return _context2.abrupt("return", segments.sort(function (a, b) {
+                return a.index - b.index;
+              }).reduce(function (result, item) {
+                return result.concat(item.samples);
+              }, []));
+            case 9:
+            case "end":
+              return _context2.stop();
+          }
+        }, _callee2, this);
+      }));
+      function _buildPositionSamples(_x2) {
+        return _buildPositionSamples2.apply(this, arguments);
+      }
+      return _buildPositionSamples;
+    }()
+  }, {
+    key: "_buildRawSegmentSamples",
+    value: function _buildRawSegmentSamples(startPosition, endPosition) {
+      return [{
+        time: startPosition.time,
+        position: lngLatAltToCartesian3(startPosition.lng, startPosition.lat, startPosition.alt)
+      }, {
+        time: endPosition.time,
+        position: lngLatAltToCartesian3(endPosition.lng, endPosition.lat, endPosition.alt)
+      }];
+    }
+  }, {
+    key: "_buildTerrainSegmentSamples",
+    value: function _buildTerrainSegmentSamples(startPosition, endPosition, updatedPoints) {
+      if (!updatedPoints.length) {
+        return this._buildRawSegmentSamples(startPosition, endPosition);
+      }
+      if (updatedPoints.length === 1) {
+        return this._buildRawSegmentSamples(startPosition, endPosition);
+      }
+      var startTime = startPosition.time.getTime();
+      var endTime = endPosition.time.getTime();
+      var totalInterval = endTime - startTime;
+      var segmentInterval = totalInterval / (updatedPoints.length - 1);
+      return updatedPoints.map(function (dataPoint, index) {
+        return {
+          time: new Date(startTime + index * segmentInterval),
+          position: Cesium.Cartesian3.fromRadians(dataPoint.longitude, dataPoint.latitude, dataPoint.height)
         };
-        for (var i = 0; i < this._positions.length - 1; i++) {
-          _loop();
+      });
+    }
+  }, {
+    key: "_appendSamples",
+    value: function _appendSamples(samples) {
+      var _this3 = this;
+      if (!this.positionProperty) {
+        return;
+      }
+      var previousSample = null;
+      samples.forEach(function (sample) {
+        var _this3$positionProper;
+        if (_this3._shouldSkipSample(sample, previousSample)) {
+          return;
         }
-      } else {
-        for (var _i = 0; _i < this._positions.length; _i++) {
-          var dataPoint = this._positions[_i];
-          var position = lngLatAltToCartesian3(dataPoint.lng, dataPoint.lat, dataPoint.alt);
-          this.positionProperty.addSample(Cesium.JulianDate.fromDate(dataPoint.time), position);
+        (_this3$positionProper = _this3.positionProperty) === null || _this3$positionProper === void 0 || _this3$positionProper.addSample(Cesium.JulianDate.fromDate(sample.time), sample.position);
+        previousSample = sample;
+      });
+    }
+  }, {
+    key: "_shouldSkipSample",
+    value: function _shouldSkipSample(sample, previousSample) {
+      if (!previousSample) {
+        return false;
+      }
+      return previousSample.time.getTime() === sample.time.getTime() && Cesium.Cartesian3.equals(previousSample.position, sample.position);
+    }
+  }, {
+    key: "_getPreviousPosition",
+    value: function _getPreviousPosition(currentTime) {
+      if (!this.positionProperty || !this._samples.length) {
+        return null;
+      }
+      var currentTimeMs = Cesium.JulianDate.toDate(currentTime).getTime();
+      for (var i = this._samples.length - 1; i >= 0; i--) {
+        var sample = this._samples[i];
+        if (sample.time.getTime() >= currentTimeMs) {
+          continue;
         }
+        return sample.position;
       }
-      this.modelEntity = new Cesium.Entity({
-        availability: new Cesium.TimeIntervalCollection([new Cesium.TimeInterval({
-          start: start,
-          stop: stop
-        })]),
-        orientation: new Cesium.VelocityOrientationProperty(this.positionProperty),
-        position: this.positionProperty,
-        model: ModelEntity.handleOptions(model)
-      });
-      this.modelLayer = this.getMap().addCustomSourceToGraphicLayer(this.modelEntity.position, {
-        type: 'model',
-        entity: this.modelEntity
-      });
+      var fallbackTime = Cesium.JulianDate.addSeconds(currentTime, -0.01, new Cesium.JulianDate());
+      return this.positionProperty.getValue(fallbackTime) || null;
     }
-
-    // 获取方向角
   }, {
-    key: "_getHeading",
-    value: function _getHeading(currentPosition, beforePosition) {
-      // 当前位置与之前位置的 Cartographic 经纬度
+    key: "_updateHeading",
+    value: function _updateHeading(currentPosition, beforePosition) {
       var cartoNow = Cesium.Cartographic.fromCartesian(currentPosition);
       var cartoBefore = Cesium.Cartographic.fromCartesian(beforePosition);
-
-      // 把它们转为 Cartesian3
       var origin = Cesium.Cartesian3.fromRadians(cartoBefore.longitude, cartoBefore.latitude, cartoBefore.height);
       var target = Cesium.Cartesian3.fromRadians(cartoNow.longitude, cartoNow.latitude, cartoNow.height);
-
-      // 构造 ENU 变换矩阵（以 before 位置为原点）
       var enuTransform = Cesium.Transforms.eastNorthUpToFixedFrame(origin);
       var inverse = Cesium.Matrix4.inverse(enuTransform, new Cesium.Matrix4());
-
-      // 计算从 before → now 的方向向量
       var directionWorld = Cesium.Cartesian3.subtract(target, origin, new Cesium.Cartesian3());
+      if (Cesium.Cartesian3.magnitudeSquared(directionWorld) <= Cesium.Math.EPSILON12) {
+        return;
+      }
       var directionENU = Cesium.Matrix4.multiplyByPointAsVector(inverse, directionWorld, new Cesium.Cartesian3());
-
-      // 在 ENU 坐标中计算 heading
-      var heading = Cesium.Math.zeroToTwoPi(Math.atan2(directionENU.x, directionENU.y)); // 东为 x，北为 y
+      var heading = Cesium.Math.zeroToTwoPi(Math.atan2(directionENU.x, directionENU.y));
       this._heading = heading;
+      this._applyFollowView(currentPosition, heading);
+    }
+  }, {
+    key: "_applyFollowView",
+    value: function _applyFollowView(position, heading) {
       if (this.follow === 'first') {
-        this.updateFirstPersonView(currentPosition, heading);
+        this.updateFirstPersonView(position, heading);
       } else if (this.follow === 'third') {
-        this.updateThirdPersonView(currentPosition, heading);
+        this.updateThirdPersonView(position, heading);
       }
     }
-
-    // 开始播放场景
   }, {
     key: "start",
     value: function start() {
-      if (this.status === 'destroy') return;
+      if (this.status === 'destroy' || this.status === 'error') return;
+      if (!this._isReady) {
+        this._pendingStart = true;
+        return;
+      }
+      if (Cesium.JulianDate.compare(this.getMap().clock.currentTime, this.getMap().clock.stopTime) >= 0) {
+        this.getMap().clock.currentTime = this.getMap().clock.startTime.clone();
+      }
       this.status = 'running';
+      this._hasReachedStopTime = false;
       this.getMap().clock.shouldAnimate = true;
     }
-
-    // 暂停
   }, {
     key: "pause",
     value: function pause() {
-      if (this.status === 'destroy') return;
+      if (this.status !== 'running') return;
       this.status = 'pause';
       this.getMap().clock.shouldAnimate = false;
-      this._eventCancel && this._eventCancel();
     }
-
-    // 继续
   }, {
     key: "proceed",
     value: function proceed() {
-      if (this.status === 'destroy') return;
+      if (this.status === 'destroy' || this.status === 'error') return;
+      if (!this._isReady) {
+        this._pendingStart = true;
+        return;
+      }
+      if (this.status !== 'pause' && this.status !== 'stop' && this.status !== 'ready') {
+        return;
+      }
       this.status = 'running';
+      this._hasReachedStopTime = false;
       this.getMap().clock.shouldAnimate = true;
     }
-
-    // 停止
   }, {
     key: "stop",
     value: function stop() {
-      if (this.status === 'destroy') return;
+      if (this.status === 'destroy' || this.status === 'error') return;
+      this._pendingStart = false;
       this.status = 'stop';
       this.getMap().clock.shouldAnimate = false;
       this.getMap().clock.currentTime = Cesium.JulianDate.fromDate(this._positions[0].time);
+      if (this.positionProperty) {
+        var resetPosition = this.positionProperty.getValue(this.getMap().clock.currentTime);
+        if (resetPosition) {
+          this._currentPosition = resetPosition;
+          if (this._heading != null) {
+            this._applyFollowView(resetPosition, this._heading);
+          }
+        }
+      }
       this._eventCancel && this._eventCancel();
     }
-
-    // 第一人称视角跟随
   }, {
     key: "setFollowFirst",
-    value: function setFollowFirst(options) {
+    value: function setFollowFirst() {
+      var options = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
       if (this.status === 'destroy') return;
       this.firstCameraSettings = _objectSpread(_objectSpread({}, this.firstCameraSettings), options);
       this.follow = 'first';
-      this.updateFirstPersonView(this._currentPosition, this._heading);
+      if (this._currentPosition && this._heading != null) {
+        this.updateFirstPersonView(this._currentPosition, this._heading);
+      }
     }
-
-    // 第三人称视角跟随
   }, {
     key: "setFollowThird",
-    value: function setFollowThird(options) {
+    value: function setFollowThird() {
+      var options = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
       if (this.status === 'destroy') return;
       this.thirdPersonSettings = _objectSpread(_objectSpread({}, this.thirdPersonSettings), options);
       this.follow = 'third';
-      this.updateThirdPersonView(this._currentPosition, this._heading);
+      if (this._currentPosition && this._heading != null) {
+        this.updateThirdPersonView(this._currentPosition, this._heading);
+      }
     }
-
-    // 取消跟随
   }, {
     key: "cancelFollow",
     value: function cancelFollow() {
       if (this.status === 'destroy') return;
       this.follow = null;
     }
-
-    // 更新第一人称视角
   }, {
     key: "updateFirstPersonView",
     value: function updateFirstPersonView(position, heading) {
-      if (!position || !heading) {
+      if (!position || heading == null) {
         return;
       }
-      // 设置相机位置和朝向
+      var pitch = Cesium.Math.toRadians(this.firstCameraSettings.pitch);
+      var roll = 0.0;
+      var hpr = new Cesium.HeadingPitchRoll(heading, pitch, roll);
+      var orientationMatrix = Cesium.Transforms.headingPitchRollToFixedFrame(position, hpr, Cesium.Ellipsoid.WGS84, Cesium.Transforms.localFrameToFixedFrameGenerator('east', 'north'));
+      var forwardLocal = new Cesium.Cartesian3(0, 1, 0);
+      var rotation = Cesium.Matrix4.getMatrix3(orientationMatrix, new Cesium.Matrix3());
+      var forwardWorld = Cesium.Matrix3.multiplyByVector(rotation, forwardLocal, new Cesium.Cartesian3());
+      var offset = Cesium.Cartesian3.multiplyByScalar(forwardWorld, -this.firstCameraSettings.distance, new Cesium.Cartesian3());
+      var cameraPosition = Cesium.Cartesian3.add(position, offset, new Cesium.Cartesian3());
       this.getMap().camera.setView({
-        destination: position,
+        destination: cameraPosition,
         orientation: {
           heading: heading,
-          pitch: Cesium.Math.toRadians(this.firstCameraSettings.pitch),
-          roll: 0.0
+          pitch: pitch,
+          roll: roll
         }
       });
     }
-
-    // 更新第三人称视角
   }, {
     key: "updateThirdPersonView",
     value: function updateThirdPersonView(position, heading) {
-      if (!position || !heading) {
+      if (!position || heading == null) {
         return;
       }
-      this.getMap().camera.lookAt(position, new Cesium.HeadingPitchRange(heading, Cesium.Math.toRadians(this.thirdPersonSettings.pitch), this.thirdPersonSettings.distance));
+      var transform = Cesium.Transforms.headingPitchRollToFixedFrame(position, new Cesium.HeadingPitchRoll(heading, 0, 0), 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.getMap().camera.setView({
+        destination: cameraPosition,
+        orientation: {
+          heading: heading,
+          pitch: Cesium.Math.toRadians(this.thirdPersonSettings.pitch),
+          roll: 0.0
+        }
+      });
     }
-
-    // 监听
   }, {
     key: "on",
     value: function on(type, event) {
       return this.getMap()._event.listenToModelRoam(type, event, this);
     }
-
-    // 更新线
   }, {
     key: "updatePolyline",
     value: function updatePolyline(style) {
-      this.polylineLayer.setStyle(style);
+      var _this$polylineLayer3;
+      (_this$polylineLayer3 = this.polylineLayer) === null || _this$polylineLayer3 === void 0 || _this$polylineLayer3.setStyle(style);
     }
-
-    // 更新模型
   }, {
     key: "updateModel",
     value: function updateModel(style) {
-      this.modelLayer.setStyle(style);
+      var _this$modelLayer2;
+      (_this$modelLayer2 = this.modelLayer) === null || _this$modelLayer2 === void 0 || _this$modelLayer2.setStyle(style);
     }
-
-    // 销毁
+  }, {
+    key: "waitUntilReady",
+    value: function () {
+      var _waitUntilReady = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee3() {
+        return _regeneratorRuntime().wrap(function _callee3$(_context3) {
+          while (1) switch (_context3.prev = _context3.next) {
+            case 0:
+              _context3.next = 2;
+              return this._initPromise;
+            case 2:
+            case "end":
+              return _context3.stop();
+          }
+        }, _callee3, this);
+      }));
+      function waitUntilReady() {
+        return _waitUntilReady.apply(this, arguments);
+      }
+      return waitUntilReady;
+    }()
   }, {
     key: "destroy",
     value: function destroy() {
-      this.status = 'destroy';
-      this.getMap().clock.shouldAnimate = false;
-      this.getMap().clock.currentTime = Cesium.JulianDate.fromDate(new Date());
-      this._eventPreUpdate.off();
-      this._listenRunning = null;
-      this.getMap().removeLayer('_modelHistoryRoam');
-      this.getMap().removeSource('_modelHistoryRoam');
+      var _this$_eventPreUpdate, _this$_eventPreUpdate2, _this$polylineLayer4, _this$polylineLayer4$;
+      if (this.status === 'destroy') {
+        return;
+      }
+      var map = this.getMap();
+      map.clock.shouldAnimate = false;
       this.cancelFollow();
-      this.polylineLayer.remove();
+      this._pendingStart = false;
+      (_this$_eventPreUpdate = this._eventPreUpdate) === null || _this$_eventPreUpdate === void 0 || (_this$_eventPreUpdate2 = _this$_eventPreUpdate.off) === null || _this$_eventPreUpdate2 === void 0 || _this$_eventPreUpdate2.call(_this$_eventPreUpdate);
+      this._eventPreUpdate = null;
+      this._listenRunning = null;
+      if (this._modelSourceId) {
+        map.removeGraphicSource(this._modelSourceId);
+      } else {
+        var _this$modelLayer3, _this$modelLayer3$rem;
+        (_this$modelLayer3 = this.modelLayer) === null || _this$modelLayer3 === void 0 || (_this$modelLayer3$rem = _this$modelLayer3.remove) === null || _this$modelLayer3$rem === void 0 || _this$modelLayer3$rem.call(_this$modelLayer3);
+      }
+      (_this$polylineLayer4 = this.polylineLayer) === null || _this$polylineLayer4 === void 0 || (_this$polylineLayer4$ = _this$polylineLayer4.remove) === null || _this$polylineLayer4$ === void 0 || _this$polylineLayer4$.call(_this$polylineLayer4);
+      this.polylineLayer = null;
       this.polylineEntity = null;
-      this.modelLayer.remove();
+      this.modelLayer = null;
       this.modelEntity = null;
+      this._modelSourceId = null;
       this._positions = [];
+      this._samples = [];
       this.positionProperty = null;
+      this._currentPosition = null;
+      this._heading = null;
+      this._isReady = false;
+      this.status = 'destroy';
     }
   }]);
   return ModelRoamHistory;