@volcengine/veplayer 2.0.0-rc.1 → 2.1.0-rc.0

package/umd/veplayer.vod.development.js

@@ -8,6 +8,16 @@ var __publicField = (obj, key, value) => {
   return value;
 };
 
+  var Codec = /* @__PURE__ */ ((Codec2) => {
+    Codec2["H265"] = "h265";
+    Codec2["H264"] = "h264";
+    return Codec2;
+  })(Codec || {});
+  var DecodeType = /* @__PURE__ */ ((DecodeType2) => {
+    DecodeType2["Software"] = "software";
+    DecodeType2["Hardware"] = "hardware";
+    return DecodeType2;
+  })(DecodeType || {});
   function ownKeys(object, enumerableOnly) {
     var keys = Object.keys(object);
     if (Object.getOwnPropertySymbols) {
@@ -1004,6 +1014,9 @@ var __publicField = (obj, key, value) => {
     }
     return /^blob/.test(video.currentSrc) || /^blob/.test(video.src);
   };
+  util.isBlob = function(url) {
+    return /^blob/.test(url);
+  };
   util.generateSessionId = function() {
     var did = arguments.length > 0 && arguments[0] !== void 0 ? arguments[0] : 0;
     var d = (/* @__PURE__ */ new Date()).getTime();
@@ -1064,6 +1077,69 @@ var __publicField = (obj, key, value) => {
     }
     return val % 360;
   };
+  util.getIndexByTime = function(time, segments) {
+    var _len = segments.length;
+    var _index = -1;
+    if (_len < 1) {
+      return _index;
+    }
+    if (time <= segments[0].end || _len < 2) {
+      _index = 0;
+    } else if (time > segments[_len - 1].end) {
+      _index = _len - 1;
+    } else {
+      for (var i = 1; i < _len; i++) {
+        if (time > segments[i - 1].end && time <= segments[i].end) {
+          _index = i;
+          break;
+        }
+      }
+    }
+    return _index;
+  };
+  util.getOffsetCurrentTime = function(currentTime, segments) {
+    var index = arguments.length > 2 && arguments[2] !== void 0 ? arguments[2] : -1;
+    var _index = -1;
+    if (index >= 0 && index < segments.length) {
+      _index = index;
+    } else {
+      _index = util.getIndexByTime(currentTime, segments);
+    }
+    if (_index < 0) {
+      return -1;
+    }
+    var _len = segments.length;
+    var _segments$_index = segments[_index], start = _segments$_index.start, end = _segments$_index.end, cTime = _segments$_index.cTime, offset = _segments$_index.offset;
+    if (currentTime < start) {
+      return cTime;
+    } else if (currentTime >= start && currentTime <= end) {
+      return currentTime - offset;
+    } else if (currentTime > end && _index >= _len - 1) {
+      return end;
+    }
+    return -1;
+  };
+  util.getCurrentTimeByOffset = function(offsetTime, segments) {
+    var _index = -1;
+    if (!segments || segments.length < 0) {
+      return offsetTime;
+    }
+    for (var i = 0; i < segments.length; i++) {
+      if (offsetTime <= segments[i].duration) {
+        _index = i;
+        break;
+      }
+    }
+    if (_index !== -1) {
+      var start = segments[_index].start;
+      if (_index - 1 < 0) {
+        return start + offsetTime;
+      } else {
+        return start + (offsetTime - segments[_index - 1].duration);
+      }
+    }
+    return offsetTime;
+  };
   function isObject(value) {
     var type = _typeof(value);
     return value !== null && (type === "object" || type === "function");
@@ -1153,7 +1229,7 @@ var __publicField = (obj, key, value) => {
     function debounced() {
       var time = Date.now();
       var isInvoking = shouldInvoke(time);
-      for (var _len = arguments.length, args = new Array(_len), _key = 0; _key < _len; _key++) {
+      for (var _len2 = arguments.length, args = new Array(_len2), _key = 0; _key < _len2; _key++) {
         args[_key] = arguments[_key];
       }
       lastArgs = args;
@@ -1360,7 +1436,7 @@ var __publicField = (obj, key, value) => {
       }
     }
   };
-  var version = "3.0.7";
+  var version = "3.0.10-alpha.4";
   var ERROR_TYPE_MAP = {
     1: "media",
     2: "media",
@@ -1446,6 +1522,7 @@ var __publicField = (obj, key, value) => {
   var DURATION_CHANGE = "durationchange";
   var VOLUME_CHANGE = "volumechange";
   var LOADED_DATA = "loadeddata";
+  var LOADED_METADATA = "loadedmetadata";
   var RATE_CHANGE = "ratechange";
   var PROGRESS = "progress";
   var LOAD_START = "loadstart";
@@ -1485,7 +1562,7 @@ var __publicField = (obj, key, value) => {
   var SOURCE_ERROR = "source_error";
   var SOURCE_SUCCESS = "source_success";
   var SWITCH_SUBTITLE = "switch_subtitle";
-  var VIDEO_EVENTS = ["play", "playing", "ended", "pause", "error", "seeking", "seeked", "timeupdate", "waiting", "canplay", "canplaythrough", "durationchange", "volumechange", "loadeddata", "ratechange", "progress", "loadstart", "emptied", "stalled", "suspend", "abort", "lowdecode"];
+  var VIDEO_EVENTS = ["play", "playing", "ended", "pause", "error", "seeking", "seeked", "timeupdate", "waiting", "canplay", "canplaythrough", "durationchange", "volumechange", "loadeddata", "loadedmetadata", "ratechange", "progress", "loadstart", "emptied", "stalled", "suspend", "abort", "lowdecode"];
   var STATS_EVENTS = {
     STATS_INFO: "stats_info",
     STATS_DOWNLOAD: "stats_download",
@@ -1514,6 +1591,7 @@ var __publicField = (obj, key, value) => {
     FPS_STUCK,
     FULLSCREEN_CHANGE,
     LOADED_DATA,
+    LOADED_METADATA,
     LOAD_START,
     MINI_STATE_CHANGE,
     PAUSE,
@@ -1651,6 +1729,9 @@ var __publicField = (obj, key, value) => {
       if (options.loop) {
         _this.mediaConfig.loop = "loop";
       }
+      if (options.autoplayMuted && !Object.prototype.hasOwnProperty.call(_this.mediaConfig, "muted")) {
+        _this.mediaConfig.muted = true;
+      }
       _this.media = util.createDom(_this.mediaConfig.mediaType, "", _this.mediaConfig, "");
       if (options.defaultPlaybackRate) {
         _this.media.defaultPlaybackRate = _this.media.playbackRate = options.defaultPlaybackRate;
@@ -1729,10 +1810,11 @@ var __publicField = (obj, key, value) => {
         var _this6 = this;
         video.removeAttribute("src");
         video.load();
-        urls.forEach(function(item) {
+        urls.forEach(function(item, index) {
           _this6.media.appendChild(util.createDom("source", "", {
             src: "".concat(item.src),
-            type: "".concat(item.type || "")
+            type: "".concat(item.type || ""),
+            "data-index": index + 1
           }));
         });
         var _c = video.children;
@@ -1740,6 +1822,7 @@ var __publicField = (obj, key, value) => {
           return;
         }
         this._videoSourceCount = _c.length;
+        this._videoSourceIndex = _c.length;
         this._vLoadeddata = function(e) {
           _this6.emit(SOURCE_SUCCESS, {
             src: e.target.currentSrc,
@@ -1754,8 +1837,9 @@ var __publicField = (obj, key, value) => {
           }
         }
         !this._sourceError && (this._sourceError = function(e) {
-          _this6._videoSourceCount--;
-          if (_this6._videoSourceCount === 0) {
+          var _dIndex = parseInt(e.target.getAttribute("data-index"), 10);
+          _this6._videoSourceIndex--;
+          if (_this6._videoSourceIndex === 0 || _dIndex >= _this6._videoSourceCount) {
             var _err = {
               code: 4,
               message: "sources_load_error"
@@ -2082,7 +2166,7 @@ var __publicField = (obj, key, value) => {
         this.emit(WAITING);
         this._currentTime = 0;
         this._duration = 0;
-        if (/^blob/.test(this.media.currentSrc) || /^blob/.test(this.media.src)) {
+        if (util.isMSE(this.media)) {
           this.onWaiting();
           return;
         }
@@ -3790,6 +3874,7 @@ var __publicField = (obj, key, value) => {
       },
       enableSwipeHandler: function enableSwipeHandler() {
       },
+      preProcessUrl: null,
       ignores: [],
       whitelist: [],
       inactive: 3e3,
@@ -3871,7 +3956,7 @@ var __publicField = (obj, key, value) => {
           autoHide: false
         });
       });
-      _defineProperty(_assertThisInitialized(_this), "onMouseLeave", function() {
+      _defineProperty(_assertThisInitialized(_this), "onMouseLeave", function(e) {
         var _assertThisInitialize2 = _assertThisInitialized(_this), player = _assertThisInitialize2.player;
         player.focus();
       });
@@ -3949,12 +4034,13 @@ var __publicField = (obj, key, value) => {
     }, {
       key: "show",
       value: function show() {
-        util.addClass(this.root, "show");
+        this.root.style.display = "";
+        this.player.focus();
       }
     }, {
       key: "hide",
       value: function hide() {
-        util.removeClass(this.root, "show");
+        this.root.style.display = "none";
       }
     }, {
       key: "mode",
@@ -4356,6 +4442,7 @@ var __publicField = (obj, key, value) => {
       _this.cssfullscreen = false;
       _this.isRotateFullscreen = false;
       _this._fullscreenEl = null;
+      _this.timeSegments = [];
       _this._cssfullscreenEl = null;
       _this.curDefinition = null;
       _this._orgCss = "";
@@ -4365,7 +4452,7 @@ var __publicField = (obj, key, value) => {
       _this.videoPos = {
         pi: 1,
         scale: 0,
-        rotate: 0,
+        rotate: -1,
         x: 0,
         y: 0,
         h: -1,
@@ -4373,11 +4460,21 @@ var __publicField = (obj, key, value) => {
         vy: 0,
         vx: 0
       };
+      _this.sizeInfo = {
+        width: 0,
+        height: 0,
+        left: 0,
+        top: 0
+      };
       _this._accPlayed = {
         t: 0,
         acc: 0,
         loopAcc: 0
       };
+      _this._offsetInfo = {
+        currentTime: -1,
+        duration: 0
+      };
       _this.innerContainer = null;
       _this.controls = null;
       _this.topBar = null;
@@ -4390,6 +4487,9 @@ var __publicField = (obj, key, value) => {
       _this.isUserActive = false;
       _this._onceSeekCanplay = null;
       _this._isPauseBeforeSeek = 0;
+      _this.innerStates = {
+        isActiveLocked: false
+      };
       var rootInit = _this._initDOM();
       if (!rootInit) {
         console.error(new Error("can't find the dom which id is ".concat(_this.config.id, " or this.config.el does not exist")));
@@ -4475,16 +4575,16 @@ var __publicField = (obj, key, value) => {
           this.addClass(STATE_CLASS.NO_START);
         }
         if (this.config.fluid) {
-          var _this$config3 = this.config, width = _this$config3.width, height = _this$config3.height;
-          if (typeof width !== "number" || typeof height !== "number") {
-            width = 600;
-            height = 337.5;
+          var _this$config3 = this.config, _width = _this$config3.width, _height = _this$config3.height;
+          if (typeof _width !== "number" || typeof _height !== "number") {
+            _width = 600;
+            _height = 337.5;
           }
           var style = {
             width: "100%",
             height: "0",
             "max-width": "100%",
-            "padding-top": "".concat(height * 100 / width, "%")
+            "padding-top": "".concat(_height * 100 / _width, "%")
           };
           Object.keys(style).forEach(function(key) {
             _this2.root.style[key] = style[key];
@@ -4500,6 +4600,11 @@ var __publicField = (obj, key, value) => {
             }
           });
         }
+        var _this$root$getBoundin = this.root.getBoundingClientRect(), width = _this$root$getBoundin.width, height = _this$root$getBoundin.height, left = _this$root$getBoundin.left, top = _this$root$getBoundin.top;
+        this.sizeInfo.width = width;
+        this.sizeInfo.height = height;
+        this.sizeInfo.left = left;
+        this.sizeInfo.top = top;
         return true;
       }
     }, {
@@ -4583,7 +4688,7 @@ var __publicField = (obj, key, value) => {
         var readyState = this.media.readyState;
         XG_DEBUG.logInfo("_startInit readyState", readyState);
         if (this.config.autoplay) {
-          !(/^blob/.test(this.media.currentSrc) || /^blob/.test(this.media.src)) && this.load();
+          !util.isMSE(this.media) && this.load();
           (sniffer.os.isIpad || sniffer.os.isPhone) && this.mediaPlay();
         }
         if (readyState >= 2) {
@@ -4811,7 +4916,8 @@ var __publicField = (obj, key, value) => {
           if (!url) {
             url = _this8.url || _this8.config.url;
           }
-          var ret = _this8._startInit(url);
+          var _furl = _this8.preProcessUrl(url);
+          var ret = _this8._startInit(_furl.url);
           return ret;
         }).catch(function(e) {
           e.fileName = "player";
@@ -4828,6 +4934,7 @@ var __publicField = (obj, key, value) => {
         if (util.typeOf(url) === "Object") {
           _src = url.url;
         }
+        _src = this.preProcessUrl(_src).url;
         var curTime = this.currentTime;
         var isPaused = this.paused && !this.isError;
         this.src = _src;
@@ -5166,7 +5273,11 @@ var __publicField = (obj, key, value) => {
         this.addClass(STATE_CLASS.LOADING);
         runHooks(this, "retry", function() {
           var cur = _this20.currentTime;
-          _this20.src = _this20.config.url;
+          var url = _this20.config.url;
+          var _srcRet = !util.isMSE(_this20.media) ? _this20.preProcessUrl(url) : {
+            url
+          };
+          _this20.src = _srcRet.url;
           !_this20.config.isLive && (_this20.currentTime = cur);
           _this20.once(CANPLAY, function() {
             _this20.mediaPlay();
@@ -5227,7 +5338,7 @@ var __publicField = (obj, key, value) => {
         var fullEl = util.getFullScreenEl();
         if (fullEl === this._fullscreenEl) {
           this.onFullscreenChange();
-          return;
+          return Promise.resolve();
         }
         try {
           for (var i = 0; i < GET_FULLSCREEN_API.length; i++) {
@@ -5400,30 +5511,38 @@ var __publicField = (obj, key, value) => {
       key: "onFocus",
       value: function onFocus() {
         var _this21 = this;
-        var _ref = arguments.length > 0 && arguments[0] !== void 0 ? arguments[0] : {}, _ref$autoHide = _ref.autoHide, autoHide = _ref$autoHide === void 0 ? !this.config.closePlayerBlur : _ref$autoHide, _ref$delay = _ref.delay, delay = _ref$delay === void 0 ? this.config.inactive : _ref$delay;
+        var data = arguments.length > 0 && arguments[0] !== void 0 ? arguments[0] : {
+          autoHide: true,
+          delay: 3e3
+        };
+        var innerStates = this.innerStates;
         this.isActive = true;
         this.removeClass(STATE_CLASS.INACTIVE);
         if (this.userTimer) {
           util.clearTimeout(this, this.userTimer);
           this.userTimer = null;
         }
-        if (!autoHide) {
+        if (data.isLock !== void 0) {
+          innerStates.isActiveLocked = data.isLock;
+        }
+        if (data.autoHide === false || data.isLock === true || innerStates.isActiveLocked) {
           if (this.userTimer) {
             util.clearTimeout(this, this.userTimer);
             this.userTimer = null;
           }
           return;
         }
+        var time = data && data.delay ? data.delay : this.config.inactive;
         this.userTimer = util.setTimeout(this, function() {
           _this21.userTimer = null;
           _this21.blur();
-        }, delay);
+        }, time);
       }
     }, {
       key: "onBlur",
       value: function onBlur() {
-        var _ref2 = arguments.length > 0 && arguments[0] !== void 0 ? arguments[0] : {}, _ref2$ignorePaused = _ref2.ignorePaused, ignorePaused = _ref2$ignorePaused === void 0 ? false : _ref2$ignorePaused;
-        if (!this.isActive) {
+        var _ref = arguments.length > 0 && arguments[0] !== void 0 ? arguments[0] : {}, _ref$ignorePaused = _ref.ignorePaused, ignorePaused = _ref$ignorePaused === void 0 ? false : _ref$ignorePaused;
+        if (!this.isActive || this.innerStates.isActiveLocked) {
           return;
         }
         var closePauseVideoFocus = this.config.closePauseVideoFocus;
@@ -5546,7 +5665,7 @@ var __publicField = (obj, key, value) => {
     }, {
       key: "onTimeupdate",
       value: function onTimeupdate() {
-        !this._videoHeight && this.resize();
+        !this._videoHeight && this.media.videoHeight && this.resize();
         if ((this.waitTimer || this.hasClass(STATE_CLASS.LOADING)) && this.media.readyState > 2) {
           this.removeClass(STATE_CLASS.LOADING);
           util.clearTimeout(this, this.waitTimer);
@@ -5621,8 +5740,11 @@ var __publicField = (obj, key, value) => {
       key: "resizePosition",
       value: function resizePosition() {
         var _this$videoPos = this.videoPos, rotate = _this$videoPos.rotate, vy = _this$videoPos.vy, vx = _this$videoPos.vx, h = _this$videoPos.h, w = _this$videoPos.w;
+        if (rotate < 0 && !vy && !vx) {
+          return;
+        }
         var _pi = this.videoPos._pi;
-        if (!_pi) {
+        if (!_pi && this.media.videoHeight) {
           _pi = this.media.videoWidth / this.media.videoHeight * 100;
         }
         if (!_pi) {
@@ -5722,9 +5844,14 @@ var __publicField = (obj, key, value) => {
         if (!this.media) {
           return;
         }
+        var containerSize = this.root.getBoundingClientRect();
+        this.sizeInfo.width = containerSize.width;
+        this.sizeInfo.height = containerSize.height;
+        this.sizeInfo.left = containerSize.left;
+        this.sizeInfo.top = containerSize.top;
         var _this$media = this.media, videoWidth = _this$media.videoWidth, videoHeight = _this$media.videoHeight;
         var _this$config6 = this.config, fitVideoSize = _this$config6.fitVideoSize, videoFillMode = _this$config6.videoFillMode;
-        if (videoFillMode === "fill" || videoFillMode === "cover") {
+        if (videoFillMode === "fill" || videoFillMode === "cover" || videoFillMode === "contain") {
           this.setAttribute("data-xgfill", videoFillMode);
         }
         if (!videoHeight || !videoWidth) {
@@ -5732,7 +5859,6 @@ var __publicField = (obj, key, value) => {
         }
         this._videoHeight = videoHeight;
         this._videoWidth = videoWidth;
-        var containerSize = this.root.getBoundingClientRect();
         var controlsHeight = this.controls && this.innerContainer ? this.controls.root.getBoundingClientRect().height : 0;
         var width = containerSize.width;
         var height = containerSize.height - controlsHeight;
@@ -5787,6 +5913,14 @@ var __publicField = (obj, key, value) => {
         XG_DEBUG.logInfo("setState", "state from:".concat(STATE_ARRAY[this.state], " to:").concat(STATE_ARRAY[newState]));
         this._state = newState;
       }
+    }, {
+      key: "preProcessUrl",
+      value: function preProcessUrl(url, ext) {
+        var preProcessUrl2 = this.config.preProcessUrl;
+        return !util.isBlob(url) && preProcessUrl2 && typeof preProcessUrl2 === "function" ? preProcessUrl2(url, ext) : {
+          url
+        };
+      }
     }, {
       key: "state",
       get: function get() {
@@ -5960,9 +6094,8 @@ var __publicField = (obj, key, value) => {
     }, {
       key: "cumulateTime",
       get: function get() {
-        var _accPlayed = this._accPlayed;
-        this.updateAcc("get");
-        return _accPlayed.acc;
+        var _this$_accPlayed = this._accPlayed, acc = _this$_accPlayed.acc, t = _this$_accPlayed.t;
+        return t ? (/* @__PURE__ */ new Date()).getTime() - t + acc : acc;
       }
     }, {
       key: "zoom",
@@ -6001,6 +6134,22 @@ var __publicField = (obj, key, value) => {
       set: function set(val) {
         REAL_TIME_SPEED = val;
       }
+    }, {
+      key: "offsetCurrentTime",
+      get: function get() {
+        return this._offsetInfo.currentTime || 0;
+      },
+      set: function set(val) {
+        this._offsetInfo.currentTime = val;
+      }
+    }, {
+      key: "offsetDuration",
+      get: function get() {
+        return this._offsetInfo.duration || 0;
+      },
+      set: function set(val) {
+        this._offsetInfo.duration = val || 0;
+      }
     }, {
       key: "hook",
       value: function hook$1(hookName, handler) {
@@ -6126,7 +6275,7 @@ var __publicField = (obj, key, value) => {
     ErrorCode2[ErrorCode2["RUNTIME_NO_CANPLAY_ERROR"] = 9001] = "RUNTIME_NO_CANPLAY_ERROR";
     ErrorCode2[ErrorCode2["RUNTIME_BUFFERBREAK_ERROR"] = 9002] = "RUNTIME_BUFFERBREAK_ERROR";
     ErrorCode2[ErrorCode2["RUNTIME_BWAITING_TIMEOUT_ERROR"] = 9002] = "RUNTIME_BWAITING_TIMEOUT_ERROR";
-    ErrorCode2[ErrorCode2["MODULE_LOAD_ERROR"] = 100] = "MODULE_LOAD_ERROR";
+    ErrorCode2[ErrorCode2["MODULE_LOAD_ERROR"] = 110] = "MODULE_LOAD_ERROR";
     ErrorCode2["UNKNOWN"] = "UNKNOWN";
     return ErrorCode2;
   })(ErrorCode || {});
@@ -6212,7 +6361,7 @@ var __publicField = (obj, key, value) => {
       /* Error */
     },
     [
-      100
+      110
       /* MODULE_LOAD_ERROR */
     ]: {
       messageTextKey: "MODULE_LOAD_ERROR",
@@ -6287,6 +6436,11 @@ var __publicField = (obj, key, value) => {
     }
   };
   class VeError extends Error {
+    /**
+     * @hidden
+     * @param error
+     * @param i18n
+     */
     constructor(error2, i18n) {
       var _a;
       const errorInfo = typeof error2 === "string" ? {
@@ -6294,8 +6448,17 @@ var __publicField = (obj, key, value) => {
       } : error2;
       const message = (i18n == null ? void 0 : i18n.getText(errorInfo == null ? void 0 : errorInfo.messageTextKey)) ?? (errorInfo == null ? void 0 : errorInfo.message) ?? ((_a = errorInfo == null ? void 0 : errorInfo.error) == null ? void 0 : _a.message) ?? (i18n == null ? void 0 : i18n.getText("UNKNOWN"));
       super(message);
+      /**
+       * @brief 错误码，对应[错误码字典](#错误码)。
+       */
       __publicField(this, "errorCode");
+      /**
+       * @brief 错误等级。
+       */
       __publicField(this, "level");
+      /**
+       * @brief 其他错误信息。
+       */
       __publicField(this, "ext");
       this.errorCode = (errorInfo == null ? void 0 : errorInfo.errorCode) ?? "UNKNOWN";
       this.level = (errorInfo == null ? void 0 : errorInfo.level) ?? "Error";
@@ -7632,10 +7795,56 @@ var __publicField = (obj, key, value) => {
   var Touche = /* @__PURE__ */ function() {
     function Touche2(dom) {
       var _this = this;
-      var config = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : {
+      var _config = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : {
         eventType: "touch"
       };
       _classCallCheck(this, Touche2);
+      _defineProperty(this, "onTouchStart", function(e) {
+        var _pos = _this._pos, root = _this.root;
+        var touch = getTouch(e.touches);
+        _pos.x = touch ? parseInt(touch.pageX, 10) : e.pageX;
+        _pos.y = touch ? parseInt(touch.pageX, 10) : e.pageX;
+        _pos.start = true;
+        _this.__setPress(e);
+        root.addEventListener(_this.events.end, _this.onTouchEnd);
+        root.addEventListener(_this.events.cancel, _this.onTouchCancel);
+        root.addEventListener(_this.events.move, _this.onTouchMove);
+        _this.trigger(EVENTS.TOUCH_START, e);
+      });
+      _defineProperty(this, "onTouchCancel", function(e) {
+        _this.onTouchEnd(e);
+      });
+      _defineProperty(this, "onTouchEnd", function(e) {
+        var _pos = _this._pos, root = _this.root;
+        _this.__clearPress();
+        root.removeEventListener(_this.events.cancel, _this.onTouchCancel);
+        root.removeEventListener(_this.events.end, _this.onTouchEnd);
+        root.removeEventListener(_this.events.move, _this.onTouchMove);
+        e.moving = _pos.moving;
+        e.press = _pos.press;
+        _pos.press && _this.trigger(EVENTS.PRESS_END, e);
+        _this.trigger(EVENTS.TOUCH_END, e);
+        !_pos.press && !_pos.moving && _this.__setDb(e);
+        _pos.press = false;
+        _pos.start = false;
+        _pos.moving = false;
+      });
+      _defineProperty(this, "onTouchMove", function(e) {
+        var _pos = _this._pos, config = _this.config;
+        var touch = getTouch(e.touches);
+        var x = touch ? parseInt(touch.pageX, 10) : e.pageX;
+        var y = touch ? parseInt(touch.pageY, 10) : e.pageX;
+        var diffx = x - _pos.x;
+        var diffy = y - _pos.y;
+        if (Math.abs(diffy) < config.miniStep && Math.abs(diffx) < config.miniStep) {
+          return;
+        }
+        _this.__clearPress();
+        _pos.press && _this.trigger(EVENTS.PRESS_END, e);
+        _pos.press = false;
+        _pos.moving = true;
+        _this.trigger(EVENTS.TOUCH_MOVE, e);
+      });
       this._pos = {
         moving: false,
         start: false,
@@ -7643,11 +7852,11 @@ var __publicField = (obj, key, value) => {
         y: 0
       };
       this.config = getDefaultConfig();
-      Object.keys(config).map(function(key) {
-        _this.config[key] = config[key];
+      Object.keys(_config).map(function(key) {
+        _this.config[key] = _config[key];
       });
       this.root = dom;
-      this.events = config.eventType === "mouse" ? MOUSES : TOUCHS;
+      this.events = _config.eventType === "mouse" ? MOUSES : TOUCHS;
       this.pressIntrvalId = null;
       this.dbIntrvalId = null;
       this.__handlers = {};
@@ -7656,10 +7865,6 @@ var __publicField = (obj, key, value) => {
     _createClass(Touche2, [{
       key: "_initEvent",
       value: function _initEvent() {
-        this.onTouchStart = this.onTouchStart.bind(this);
-        this.onTouchMove = this.onTouchMove.bind(this);
-        this.onTouchEnd = this.onTouchEnd.bind(this);
-        this.onTouchCancel = this.onTouchCancel.bind(this);
         this.root.addEventListener(this.events.start, this.onTouchStart);
       }
     }, {
@@ -7745,60 +7950,6 @@ var __publicField = (obj, key, value) => {
           }
         });
       }
-    }, {
-      key: "onTouchStart",
-      value: function onTouchStart(e) {
-        var _pos = this._pos, root = this.root;
-        var touch = getTouch(e.touches);
-        _pos.x = touch ? parseInt(touch.pageX, 10) : e.pageX;
-        _pos.y = touch ? parseInt(touch.pageX, 10) : e.pageX;
-        _pos.start = true;
-        this.__setPress(e);
-        root.addEventListener(this.events.end, this.onTouchEnd);
-        root.addEventListener(this.events.cancel, this.onTouchCancel);
-        root.addEventListener(this.events.move, this.onTouchMove);
-        this.trigger(EVENTS.TOUCH_START, e);
-      }
-    }, {
-      key: "onTouchCancel",
-      value: function onTouchCancel(e) {
-        this.onTouchEnd(e);
-      }
-    }, {
-      key: "onTouchEnd",
-      value: function onTouchEnd(e) {
-        var _pos = this._pos, root = this.root;
-        this.__clearPress();
-        root.removeEventListener(this.events.cancel, this.onTouchCancel);
-        root.removeEventListener(this.events.end, this.onTouchEnd);
-        root.removeEventListener(this.events.move, this.onTouchMove);
-        e.moving = _pos.moving;
-        e.press = _pos.press;
-        _pos.press && this.trigger(EVENTS.PRESS_END, e);
-        this.trigger(EVENTS.TOUCH_END, e);
-        !_pos.press && !_pos.moving && this.__setDb(e);
-        _pos.press = false;
-        _pos.start = false;
-        _pos.moving = false;
-      }
-    }, {
-      key: "onTouchMove",
-      value: function onTouchMove(e) {
-        var _pos = this._pos, config = this.config;
-        var touch = getTouch(e.touches);
-        var x = touch ? parseInt(touch.pageX, 10) : e.pageX;
-        var y = touch ? parseInt(touch.pageY, 10) : e.pageX;
-        var diffx = x - _pos.x;
-        var diffy = y - _pos.y;
-        if (Math.abs(diffy) < config.miniStep && Math.abs(diffx) < config.miniStep) {
-          return;
-        }
-        this.__clearPress();
-        _pos.press && this.trigger(EVENTS.PRESS_END, e);
-        _pos.press = false;
-        _pos.moving = true;
-        this.trigger(EVENTS.TOUCH_MOVE, e);
-      }
     }, {
       key: "destroy",
       value: function destroy() {
@@ -7808,8 +7959,8 @@ var __publicField = (obj, key, value) => {
           touchmove: "onTouchMove",
           touchstart: "onTouchStart"
         };
-        Object.keys(map).map(function(key) {
-          _this4.root.removeEventListener("touchend", _this4[map[key]]);
+        Object.keys(map).forEach(function(key) {
+          _this4.root.removeEventListener(key, _this4[map[key]]);
         });
       }
     }]);
@@ -8460,38 +8611,61 @@ var __publicField = (obj, key, value) => {
       }
       _this = _super.call.apply(_super, [this].concat(args));
       _defineProperty(_assertThisInitialized(_this), "onBodyKeyDown", function(event) {
-        var e = event || window.event;
-        if (!_this.player || !_this.player.isUserActive && !_this.config.isIgnoreUserActive) {
+        if (!_this.player) {
           return;
         }
-        if (_this.config.disable || _this.config.disableBodyTrigger || !_this.checkIsVisible() || e.metaKey || e.altKey || e.ctrlKey) {
+        var e = event || window.event;
+        var keyCode = e.keyCode;
+        var _assertThisInitialize = _assertThisInitialized(_this), _keyState = _assertThisInitialize._keyState, player = _assertThisInitialize.player;
+        var _this$config = _this.config, disable = _this$config.disable, disableBodyTrigger = _this$config.disableBodyTrigger, isIgnoreUserActive = _this$config.isIgnoreUserActive;
+        if (disable || disableBodyTrigger || !player.isUserActive && !isIgnoreUserActive || isDisableTag(e.target) || !_this.checkIsVisible() || e.metaKey || e.altKey || e.ctrlKey) {
+          _keyState.isBodyKeyDown = false;
           return;
         }
-        var keyCode = e.keyCode;
-        if ((e.target === document.body || _this.config.isGlobalTrigger && !isDisableTag(e.target)) && _this.checkCode(keyCode, true)) {
-          preventDefault(e);
-          _this.handleKeyCode(keyCode, event);
-          return false;
+        if (!event.repeat && !_keyState.isKeyDown) {
+          if ((e.target === document.body || _this.config.isGlobalTrigger && !isDisableTag(e.target)) && _this.checkCode(keyCode, true)) {
+            _keyState.isBodyKeyDown = true;
+          }
+          document.addEventListener("keyup", _this.onBodyKeyUp);
         }
-        return false;
+        _keyState.isBodyKeyDown && _this.handleKeyDown(e);
       });
-      _defineProperty(_assertThisInitialized(_this), "onKeydown", function(event) {
-        var e = event || window.event;
-        if (_this.config.disable || _this.config.disableRootTrigger || e.metaKey || e.altKey || e.ctrlKey) {
+      _defineProperty(_assertThisInitialized(_this), "onBodyKeyUp", function(event) {
+        if (!_this.player) {
           return;
         }
-        if (!_this.player.isUserActive && !_this.config.isIgnoreUserActive) {
+        document.removeEventListener("keyup", _this.onBodyKeyUp);
+        _this.handleKeyUp(event);
+      });
+      _defineProperty(_assertThisInitialized(_this), "onKeydown", function(event) {
+        if (!_this.player) {
           return;
         }
-        if (!_this.player.isUserActive && !_this.config.isIgnoreUserActive) {
+        var e = event || window.event;
+        var _assertThisInitialize2 = _assertThisInitialized(_this), _keyState = _assertThisInitialize2._keyState;
+        if (!e.repeat) {
+          if (_this.config.disable || _this.config.disableRootTrigger || e.metaKey || e.altKey || e.ctrlKey) {
+            return;
+          }
+          if (!_this.player.isUserActive && !_this.config.isIgnoreUserActive) {
+            return;
+          }
+          if (e && (e.keyCode === 37 || _this.checkCode(e.keyCode)) && (e.target === _this.player.root || e.target === _this.player.video || e.target === _this.player.controls.el)) {
+            _keyState.isKeyDown = true;
+          }
+          _this.player.root.addEventListener("keyup", _this.onKeyup);
+        }
+        if (!_keyState.isKeyDown) {
           return;
         }
-        if (e && (e.keyCode === 37 || _this.checkCode(e.keyCode)) && (e.target === _this.player.root || e.target === _this.player.video || e.target === _this.player.controls.el)) {
-          preventDefault(e);
-        } else {
-          return true;
+        _this.handleKeyDown(e);
+      });
+      _defineProperty(_assertThisInitialized(_this), "onKeyup", function(event) {
+        if (!_this.player) {
+          return;
         }
-        _this.handleKeyCode(e.keyCode, event);
+        _this.player.root.removeEventListener("keyup", _this.onKeyup);
+        _this.handleKeyUp(event);
       });
       return _this;
     }
@@ -8505,7 +8679,7 @@ var __publicField = (obj, key, value) => {
             if (!_this2.keyCodeMap[key]) {
               _this2.keyCodeMap[key] = extendkeyCodeMap[key];
             } else {
-              ["keyCode", "action", "disable", "isBodyTarget"].map(function(key1) {
+              ["keyCode", "action", "disable", "pressAction", "disablePress", "isBodyTarget"].map(function(key1) {
                 extendkeyCodeMap[key][key1] && (_this2.keyCodeMap[key][key1] = extendkeyCodeMap[key][key1]);
               });
             }
@@ -8525,37 +8699,51 @@ var __publicField = (obj, key, value) => {
             keyCode: 32,
             action: "playPause",
             disable: false,
+            disablePress: false,
             noBodyTarget: false
           },
           up: {
             keyCode: 38,
             action: "upVolume",
             disable: false,
+            disablePress: false,
             noBodyTarget: true
           },
           down: {
             keyCode: 40,
             action: "downVolume",
             disable: false,
+            disablePress: false,
             noBodyTarget: true
           },
           left: {
             keyCode: 37,
             action: "seekBack",
+            disablePress: false,
             disable: false
           },
           right: {
             keyCode: 39,
             action: "seek",
+            pressAction: "changePlaybackRate",
+            disablePress: false,
             disable: false
           },
           esc: {
             keyCode: 27,
             action: "exitFullscreen",
+            disablePress: true,
             disable: false
           }
         };
         this.mergekeyCodeMap();
+        this._keyState = {
+          isKeyDown: false,
+          isBodyKeyDown: false,
+          isPress: false,
+          tt: 0,
+          playbackRate: 0
+        };
         this.player.root.addEventListener("keydown", this.onKeydown);
         document.addEventListener("keydown", this.onBodyKeyDown);
       }
@@ -8589,6 +8777,9 @@ var __publicField = (obj, key, value) => {
       key: "downVolume",
       value: function downVolume(event) {
         var player = this.player;
+        if (player.volume <= 0) {
+          return;
+        }
         var val = parseFloat((player.volume - 0.1).toFixed(1));
         var props = {
           volume: {
@@ -8609,6 +8800,9 @@ var __publicField = (obj, key, value) => {
       key: "upVolume",
       value: function upVolume(event) {
         var player = this.player;
+        if (player.volume >= 1) {
+          return;
+        }
         var val = parseFloat((player.volume + 0.1).toFixed(1));
         var props = {
           volume: {
@@ -8628,42 +8822,57 @@ var __publicField = (obj, key, value) => {
     }, {
       key: "seek",
       value: function seek(event) {
-        var _this$player = this.player, currentTime = _this$player.currentTime, duration = _this$player.duration;
-        var _time = currentTime;
-        if (currentTime + this.seekStep <= duration) {
-          _time = currentTime + this.seekStep;
+        var _this$player = this.player, currentTime = _this$player.currentTime, offsetCurrentTime = _this$player.offsetCurrentTime, duration = _this$player.duration, offsetDuration = _this$player.offsetDuration, timeSegments = _this$player.timeSegments;
+        var _time = offsetCurrentTime > -1 ? offsetCurrentTime : currentTime;
+        var _duration = offsetDuration || duration;
+        var _step = event.repeat && this.seekStep >= 4 ? parseInt(this.seekStep / 2, 10) : this.seekStep;
+        if (_time + _step <= _duration) {
+          _time = _time + _step;
         } else {
-          _time = duration;
+          _time = _duration;
         }
+        var _seekTime = util.getCurrentTimeByOffset(_time, timeSegments);
         var props = {
           currentTime: {
             from: currentTime,
-            to: _time
+            to: _seekTime
           }
         };
         this.emitUserAction(event, "seek", {
           props
         });
-        this.player.currentTime = _time;
+        this.player.currentTime = _seekTime;
       }
     }, {
       key: "seekBack",
       value: function seekBack(event) {
-        var currentTime = this.player.currentTime;
-        var _time = 0;
-        if (currentTime - this.seekStep >= 0) {
-          _time = currentTime - this.seekStep;
-        }
+        var _this$player2 = this.player, currentTime = _this$player2.currentTime, offsetCurrentTime = _this$player2.offsetCurrentTime, timeSegments = _this$player2.timeSegments;
+        var _step = event.repeat ? parseInt(this.seekStep / 2, 10) : this.seekStep;
+        var _time = offsetCurrentTime > -1 ? offsetCurrentTime : currentTime;
+        var _seekTime = _time - _step;
+        if (_seekTime < 0) {
+          _seekTime = 0;
+        }
+        _seekTime = util.getCurrentTimeByOffset(_seekTime, timeSegments);
         var props = {
           currentTime: {
             from: currentTime,
-            to: _time
+            to: _seekTime
           }
         };
         this.emitUserAction(event, "seek", {
           props
         });
-        this.player.currentTime = _time;
+        this.player.currentTime = _seekTime;
+      }
+    }, {
+      key: "changePlaybackRate",
+      value: function changePlaybackRate(event) {
+        var _keyState = this._keyState, config = this.config, player = this.player;
+        if (_keyState.playbackRate === 0) {
+          _keyState.playbackRate = player.playbackRate;
+          player.playbackRate = config.playbackRate;
+        }
       }
     }, {
       key: "playPause",
@@ -8701,32 +8910,66 @@ var __publicField = (obj, key, value) => {
           player.exitCssFullscreen();
         }
       }
+    }, {
+      key: "handleKeyDown",
+      value: function handleKeyDown(e) {
+        var _keyState = this._keyState;
+        if (e.repeat) {
+          _keyState.isPress = true;
+          var _t = Date.now();
+          if (_t - _keyState.tt < 200) {
+            return;
+          }
+          _keyState.tt = _t;
+        }
+        preventDefault(e);
+        this.handleKeyCode(e.keyCode, e, _keyState.isPress);
+      }
+    }, {
+      key: "handleKeyUp",
+      value: function handleKeyUp(e) {
+        var _keyState = this._keyState;
+        if (_keyState.playbackRate > 0) {
+          this.player.playbackRate = _keyState.playbackRate;
+          _keyState.playbackRate = 0;
+        }
+        _keyState.isKeyDown = false;
+        _keyState.isPress = false;
+        _keyState.tt = 0;
+      }
     }, {
       key: "handleKeyCode",
-      value: function handleKeyCode(curKeyCode, event) {
-        var _this4 = this;
-        Object.keys(this.keyCodeMap).map(function(key) {
-          var _this4$keyCodeMap$key = _this4.keyCodeMap[key], action = _this4$keyCodeMap$key.action, keyCode = _this4$keyCodeMap$key.keyCode, disable = _this4$keyCodeMap$key.disable;
-          if (keyCode === curKeyCode && !disable) {
-            if (typeof action === "function") {
-              action(event, _this4.player);
-            } else if (typeof action === "string") {
-              if (typeof _this4[action] === "function") {
-                _this4[action](event, _this4.player);
+      value: function handleKeyCode(curKeyCode, event, isPress) {
+        var arr = Object.keys(this.keyCodeMap);
+        for (var i = 0; i < arr.length; i++) {
+          var _this$keyCodeMap$arr$ = this.keyCodeMap[arr[i]], action = _this$keyCodeMap$arr$.action, keyCode = _this$keyCodeMap$arr$.keyCode, disable = _this$keyCodeMap$arr$.disable, pressAction = _this$keyCodeMap$arr$.pressAction, disablePress = _this$keyCodeMap$arr$.disablePress;
+          if (keyCode === curKeyCode) {
+            if (!disable && !(isPress && disablePress)) {
+              var _action = !isPress ? action : pressAction || action;
+              if (typeof _action === "function") {
+                action(event, this.player, isPress);
+              } else if (typeof _action === "string") {
+                if (typeof this[_action] === "function") {
+                  this[_action](event, this.player, isPress);
+                }
               }
+              this.emit(SHORTCUT, _objectSpread2({
+                key: arr[i],
+                target: event.target,
+                isPress
+              }, this.keyCodeMap[arr[i]]));
             }
-            _this4.emit(SHORTCUT, _objectSpread2({
-              key,
-              target: event.target
-            }, _this4.keyCodeMap[key]));
+            break;
           }
-        });
+        }
       }
     }, {
       key: "destroy",
       value: function destroy() {
         this.player.root.removeEventListener("keydown", this.onKeydown);
         document.removeEventListener("keydown", this.onBodyKeyDown);
+        this.player.root.removeEventListener("keyup", this.onKeyup);
+        document.removeEventListener("keyup", this.onBodyKeyUp);
       }
     }, {
       key: "disable",
@@ -8748,12 +8991,13 @@ var __publicField = (obj, key, value) => {
       get: function get() {
         return {
           seekStep: 10,
-          checkVisible: true,
+          checkVisible: false,
           disableBodyTrigger: false,
           disableRootTrigger: false,
           isGlobalTrigger: false,
           keyCodeMap: {},
           disable: false,
+          playbackRate: 2,
           isIgnoreUserActive: false
         };
       }
@@ -10046,6 +10290,9 @@ var __publicField = (obj, key, value) => {
     get url() {
       return this._currentUrlRef.url;
     }
+    set url(url) {
+      this._currentUrlRef.url = url;
+    }
     next() {
       const next = this._currentUrlRef.next;
       /* istanbul ignore next -- @preserve */
@@ -10123,7 +10370,6 @@ var __publicField = (obj, key, value) => {
       __publicField(this, "defaultSource");
       __publicField(this, "defaultDefinition");
       __publicField(this, "maxFallbackRound");
-      __publicField(this, "_prepareList", []);
       __publicField(this, "_currentDefinition");
       __publicField(this, "_sources");
       __publicField(this, "_fallbackCount", 0);
@@ -10158,6 +10404,11 @@ var __publicField = (obj, key, value) => {
       var _a;
       return (_a = this.definition) == null ? void 0 : _a.url;
     }
+    set url(url) {
+      if (this.definition) {
+        this.definition.url = url;
+      }
+    }
     /**
      * 以给定的参数搜索源和对应清晰度。`source` 和 `definition`
      * 都是可选的，当未指定时，使用当前的 {@link SourceManager.source}
@@ -10227,14 +10478,6 @@ var __publicField = (obj, key, value) => {
       this.resetFallback();
       return this;
     }
-    registerPrepare(prepare) {
-      this._prepareList.push(prepare);
-    }
-    async prepare(url) {
-      for (const prepare of this._prepareList) {
-        await prepare(url);
-      }
-    }
     resetFallback() {
       this._fallbackCount = 0;
     }
@@ -10676,12 +10919,13 @@ var __publicField = (obj, key, value) => {
     }
   }
   var optionsIcon = "";
-  const ListType = {
-    Middle: "middle",
-    Bottom: "bottom",
-    Fullscreen: "fullscreen",
-    Inner: "inner"
-  };
+  var ListType = /* @__PURE__ */ ((ListType2) => {
+    ListType2["Middle"] = "middle";
+    ListType2["Bottom"] = "bottom";
+    ListType2["Fullscreen"] = "fullscreen";
+    ListType2["Inner"] = "inner";
+    return ListType2;
+  })(ListType || {});
   var RenderType = /* @__PURE__ */ ((RenderType2) => {
     RenderType2["Icon"] = "Icon";
     RenderType2["Text"] = "Text";
@@ -10689,20 +10933,26 @@ var __publicField = (obj, key, value) => {
   })(RenderType || {});
   const isMobile$1 = sniffer.device === "mobile";
   const MOBILE_LIST_TYPES = [
-    ListType.Bottom,
-    ListType.Fullscreen,
-    ListType.Inner
+    "bottom",
+    "fullscreen",
+    "inner"
+    /* Inner */
+  ];
+  const PC_LIST_TYPES = [
+    "middle"
+    /* Middle */
   ];
-  const PC_LIST_TYPES = [ListType.Middle];
   const MODAL_TYPES = [
-    ListType.Bottom,
-    ListType.Inner,
-    ListType.Fullscreen
+    "bottom",
+    "inner",
+    "fullscreen"
+    /* Fullscreen */
   ];
   const CUSTOM_TYPES = [
-    ListType.Bottom,
-    ListType.Inner,
-    ListType.Fullscreen
+    "bottom",
+    "inner",
+    "fullscreen"
+    /* Fullscreen */
   ];
   class OptionsIcon extends Plugin {
     constructor(args) {
@@ -10740,7 +10990,7 @@ var __publicField = (obj, key, value) => {
         // 默认手机端在“右上角”，pc端在控制栏右侧
         position: isMobile$1 ? POSITIONS.ROOT_TOP_RIGHT : POSITIONS.CONTROLS_RIGHT,
         // 默认手机端列表展示底部，pc端在控制栏默认
-        listType: isMobile$1 ? ListType.Bottom : ListType.Middle,
+        listType: isMobile$1 ? "bottom" : "middle",
         index: 100,
         list: [],
         listStyle: {},
@@ -10922,10 +11172,10 @@ var __publicField = (obj, key, value) => {
         listType = this.player.config.listType;
       }
       if (!isMobile$1 && (!listType || !MOBILE_LIST_TYPES.includes(listType))) {
-        listType = ListType.Bottom;
+        listType = "bottom";
       }
       if (!isMobile$1 && (!listType || !PC_LIST_TYPES.includes(listType))) {
-        listType = ListType.Middle;
+        listType = "middle";
       }
       return listType;
     }
@@ -11818,9 +12068,7 @@ var __publicField = (obj, key, value) => {
         toastPlugin.remove(this._toastId);
       }
       this._toastId = toastPlugin.toast(
-        `${i18nManager.getText("DEFINITION_SWITCHING")} ${(definition.text && this.player.config.i18nManager.normalize(
-          definition.text
-        )) ?? definition.definition} ...`,
+        `${i18nManager.getText("DEFINITION_SWITCHING")} ${definition.showText ?? definition.definition} ...`,
         {
           duration: 2e3,
           closable: true
@@ -12627,11 +12875,6 @@ var __publicField = (obj, key, value) => {
     }
   }
   var veplayerBase = "";
-  var Codec = /* @__PURE__ */ ((Codec2) => {
-    Codec2["H265"] = "h265";
-    Codec2["H264"] = "h264";
-    return Codec2;
-  })(Codec || {});
   const { POSITIONS: XGPosition } = Plugin;
   const POSITIONS = {
     ...XGPosition,
@@ -12641,7 +12884,7 @@ var __publicField = (obj, key, value) => {
     id: "veplayer",
     width: "100%",
     height: "100%",
-    decodeType: "hardware",
+    decodeType: DecodeType.Hardware,
     fullscreen: {
       useCssFullscreen: false
     }
@@ -12669,6 +12912,9 @@ var __publicField = (obj, key, value) => {
     return xgOptions;
   };
   class VePlayerBase {
+    /**
+     * @hidden
+     */
     constructor(options = {}) {
       __publicField(this, "_player");
       __publicField(this, "_sourceManager");
@@ -12716,85 +12962,172 @@ var __publicField = (obj, key, value) => {
         veplayer: this
       });
       this.emit(Events.PLAYER_CREATE_FINISH, this._player);
-      this._sourceManager.registerPrepare((url) => this.prepare(url));
       this._errorCallback = (err) => this._handleFallback(err);
       this._player.on(ERROR, this._errorCallback);
     }
+    /**
+     * @brief 获取视频的就绪状态，其状态枚举值、枚举名称和说明如下：
+     * - `0`：HAVE_NOTHING，没有关于媒体资源的可用信息
+     * - `1`：HAVE_METADATA，已检索到足够多的媒体资源来初始化元数据, 快进/快退不会引发异常
+     * - `2`：HAVE_CURRENT_DATA，当前播放位置的数据可用，但不足以播放下一帧
+     * - `3`：HAVE_FUTURE_DATA，当前播放位置以及未来至少一小段时间的数据是可用的（至少有两帧以上的数据）
+     * - `4`：HAVE_ENOUGH_DATA，有足够的数据可用，并且下载速率足够，媒体可以不间断地播放到最后
+     */
     get readyState() {
       return this._player.readyState;
     }
+    /**
+     * @brief 获取当前已缓冲的时间范围。
+     */
     get buffered() {
       return this._player.buffered;
     }
+    /**
+     * @brief 获取已经播放的音频/视频的时间范围。
+     */
     get played() {
       return this._player.played;
     }
+    /**
+     * @brief 设置/获取视频当前的播放时间, 单位为 s。
+     */
     get cumulateTime() {
       return this._player.cumulateTime;
     }
+    /**
+     * @brief 获取是否处于焦点状态，处于焦点状态会显示控制栏。
+     */
     get isFocused() {
       return this._player.isActive;
     }
+    /**
+     * @brief 获取播放器是否处于全屏状态。
+     */
     get isFullscreen() {
       return this._player.isFullscreen;
     }
+    /**
+     * @brief 获取播放器是否处于网页全屏状态。
+     */
     get isCssFullscreen() {
       return this._player.isCssfullScreen;
     }
+    /**
+     * @brief 获取视频的网络状态，其状态枚举值、枚举名称和说明如下：
+     * - `0`：NETWORK_EMPTY，目前还没有数据，readyState 的值是 HAVE_NOTHING
+     * - `1`：NETWORK_IDLE，HTMLMediaElement 处于活动状态并已选择资源，但未使用网络
+     * - `2`：NETWORK_LOADING，浏览器正在下载 HTMLMediaElement 数据
+     * - `3`：NETWORK_NO_SOURCE，未找到 HTMLMediaElement src。
+     */
     get networkState() {
       return this._player.networkState;
     }
+    /**
+     * @brief 获取当前视频是否处于暂停状态。
+     */
     get paused() {
       return this._player.paused;
     }
+    /**
+     * @brief 获取当前视频是否播放结束。
+     */
     get ended() {
       return this._player.ended;
     }
+    /**
+     * @brief 获取播放器当前所处的状态，其状态枚举值、枚举名称和说明如下：
+     * - `0`：ERROR，播放出现错误
+     * - `1`：INITIAL，初始化
+     * - `2`：READY，配置/事件/插件等均已经初始化/绑定/实例化完成
+     * - `3`：ATTACHING，进入媒体对象挂载阶段
+     * - `4`：ATTACHED，媒体对象已经挂载到了 DOM 中
+     * - `5`：NOTALLOW，播放被阻止
+     * - `6`：RUNNING，已经成功起播进入播放流程
+     * - `7`：ENDED，播放结束
+     * - `8`：DESTROYED，播放器实例处于已被销毁
+     */
     get state() {
       return this._player.state;
     }
+    /**
+     * 获取当前播放视频的拉流地址。
+     */
     get url() {
       return this._player.config.url;
     }
+    /**
+     * @brief 获取当播放视频的线路名称唯一标识（name）。
+     */
     get source() {
       var _a;
       return (_a = this._sourceManager.source) == null ? void 0 : _a.name;
     }
+    /**
+     * @brief 获取当前播放视频的清晰度唯一标识（definition）。
+     */
     get definition() {
       var _a;
       return (_a = this._sourceManager.definition) == null ? void 0 : _a.definition;
     }
+    /**
+     * @brief 获取和设置播放器的跨域配置信息，更多信息参考 [crossorigin](https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/crossorigin) 属性介绍。
+     */
     get crossOrigin() {
       return this._player.crossOrigin;
     }
+    /**
+     * @brief 获取和设置播放器的跨域配置信息，更多信息参考 [crossorigin](https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/crossorigin) 属性介绍。
+     */
     set crossOrigin(crossOrigin) {
       this._player.crossOrigin = crossOrigin;
     }
+    /**
+     * @brief 获取和设置视频的音量，取值范围为 [0,1]。
+     */
     // eslint-disable-next-line @typescript-eslint/member-ordering
     get volume() {
       return this._player.volume;
     }
+    /**
+     * @brief 获取和设置视频的音量，取值范围为 [0,1]。
+     */
     set volume(volume) {
       this._player.volume = volume;
     }
+    /**
+     * @brief 获取和设置视频静音状态。
+     * - `true`：静音
+     * - `false`：非静音
+     */
     // eslint-disable-next-line @typescript-eslint/member-ordering
     get muted() {
       return this._player.muted;
     }
+    /**
+     * @brief 获取和设置视频静音状态。
+     * - `true`：静音
+     * - `false`：非静音
+     */
     set muted(isMuted) {
       this._player.muted = isMuted;
     }
+    /**
+     * @brief 获取和设置当前语言。
+     */
     // eslint-disable-next-line @typescript-eslint/member-ordering
     get lang() {
       return this._i18nManager.getLang();
     }
+    /**
+     * @brief 获取和设置当前语言。
+     */
     set lang(lang) {
       var _a, _b;
       if (this._player.lang === lang) {
         return;
       }
       if (!VeI18n.isLangValid(lang)) {
-        const langKeys = VeI18n.langKeys().join(",");
+        const langKeys = VeI18n.langKeys.join(",");
         const message = {
           en: `Sorry, we couldn't set the language to ${lang} because it's not currently supported. The list of supported languages includes ${langKeys}.`,
           "zh-cn": `不支持当前设置的语言${lang}, 支持的语言有${langKeys}, 请重新设置`
@@ -12809,8 +13142,11 @@ var __publicField = (obj, key, value) => {
     get _src() {
       return this._player.currentSrc;
     }
+    /**
+     * @hidden
+     */
     static async create(options = {}, Constructor) {
-      var _a;
+      var _a, _b, _c;
       const sourceManager = new SourceManager({
         sources: Source.normalize({
           url: options.url,
@@ -12822,18 +13158,28 @@ var __publicField = (obj, key, value) => {
         defaultDefinition: options.defaultDefinition,
         maxFallbackRound: options.maxFallbackRound
       });
+      const prepareResult = await ((_a = options == null ? void 0 : options.preparePlugins) == null ? void 0 : _a.call(
+        options,
+        sourceManager.url ?? ""
+      ));
+      if ((_b = prepareResult == null ? void 0 : prepareResult.options) == null ? void 0 : _b.url) {
+        sourceManager.url = (_c = prepareResult == null ? void 0 : prepareResult.options) == null ? void 0 : _c.url;
+      }
       options.url = sourceManager.url;
-      const prepareResult = await ((_a = options == null ? void 0 : options.preparePlugins) == null ? void 0 : _a.call(options, options.url ?? ""));
       return new (Constructor ?? VePlayerBase)({
         ...options,
         prepareResult,
         sourceManager
       });
     }
+    /**
+     * @brief 调用此方法切换拉流地址、线路、清晰度。
+     * @param target 目标地址，可以是播放地址，也可以是线路和清晰度
+     * @param options 更多配置信息
+     */
     async switch(target, options) {
       var _a, _b;
       if (typeof target === "string" && this._sourceManager.sources.length === 1 && ((_b = (_a = this._sourceManager.sources) == null ? void 0 : _a[0].definitions) == null ? void 0 : _b.length) === 1) {
-        this._sourceManager.updateSources(target);
         await this._switchUrl(target);
         return this._sourceManager.definition;
       }
@@ -12846,12 +13192,22 @@ var __publicField = (obj, key, value) => {
       await this._switch(targetDefinition);
       return targetDefinition;
     }
+    /**
+     * @brief 调用此方法更新拉流地址列表。
+     * @param playlist 要更新的播放列表。
+     * @param target 更新后默认播放的资源。
+     */
     updatePlaylist(playlist, target) {
       const sourceManager = this._sourceManager.updateSources(playlist, target);
       return this._switch(sourceManager.definition);
     }
     // TODO: 等西瓜播放器完善错误码后增加函数重载以提供更好的类型
-    once(event, callback, ...args) {
+    /**
+     * @brief 调用此方法监听指定事件，事件处理函数只执行一次。
+     * @param event 表示事件的名称。
+     * @param callback 表示事件的名称。
+     */
+    once(event, callback) {
       var _a;
       const { xgCallback, xgEventName } = this._transformEvent(event, callback);
       if (xgCallback) {
@@ -12859,27 +13215,45 @@ var __publicField = (obj, key, value) => {
           this._events[event] = /* @__PURE__ */ new Map();
         }
         this._events[event].set(callback, xgCallback);
-        this._player.once(xgEventName, xgCallback, ...args);
+        this._player.once(xgEventName, xgCallback);
       }
     }
-    off(event, callback, ...args) {
+    /**
+     * @brief 调用此方法解绑或移除指定事件的事件监听。
+     * @param event 表示事件的名称。
+     * @param callback 表示事件的名称。
+     */
+    off(event, callback) {
       var _a;
       const xgCallback = (_a = this._events[event]) == null ? void 0 : _a.get(callback);
       const { xgEventName } = this._transformEvent(event);
       if (xgCallback) {
-        this._player.off(xgEventName, xgCallback, ...args);
+        this._player.off(xgEventName, xgCallback);
         this._events[event].delete(callback);
       }
     }
-    emit(event, data, ...args) {
+    /**
+     * @brief 调用此方法触发指定事件。
+     * @param event 表示事件的名称。
+     * @param data 事件信息。
+     */
+    emit(event, data) {
       const { xgEventName } = this._transformEvent(event);
-      this._player.emit(xgEventName, data, ...args);
+      this._player.emit(xgEventName, data);
     }
+    /**
+     * @brief 调用此方法解绑或移除指定事件的所有事件监听。
+     */
     offAll() {
       this._events = {};
       this._player.offAll();
     }
-    on(event, callback, ...args) {
+    /**
+     * @brief 调用此方法监听指定事件。
+     * @param event 事件。
+     * @param callback 事件回调。
+     */
+    on(event, callback) {
       var _a;
       const { xgCallback, xgEventName } = this._transformEvent(event, callback);
       if (xgCallback) {
@@ -12887,56 +13261,105 @@ var __publicField = (obj, key, value) => {
           this._events[event] = /* @__PURE__ */ new Map();
         }
         this._events[event].set(callback, xgCallback);
-        this._player.on(xgEventName, xgCallback, ...args);
+        this._player.on(xgEventName, xgCallback);
       }
     }
+    /**
+     * @brief 调用此方法开始播放 。
+     */
     play() {
       /* istanbul ignore next -- @preserve */
       return this._player.play();
     }
+    /**
+     * @brief 调用此方法暂停播放。
+     */
     pause() {
       /* istanbul ignore next -- @preserve */
       return this._player.pause();
     }
+    /**
+     * @brief 调用此方法打开画中画。
+     */
     requestPIP() {
       var _a;
       /* istanbul ignore next -- @preserve */
       (_a = this._player.plugins.pip) == null ? void 0 : _a.requestPIP();
     }
+    /**
+     * @brief 调用此方法关闭画中画。
+     */
     exitPIP() {
       var _a;
       /* istanbul ignore next -- @preserve */
       (_a = this._player.plugins.pip) == null ? void 0 : _a.exitPIP();
     }
+    /**
+     * @brief 调用此方法重新拉流。
+     */
     retry() {
-      this._player.emit(Events.RETRY);
       return this._player.retry();
     }
+    /**
+     * @brief 播放器获取焦点，调用该方法 `veplayer.isFocused` 将会变为 `true`，并触发 `PLAYER_FOCUS` 事件。
+     * @param data 播放器获取焦点配置信息。
+     */
     focus(data) {
       return this._player.focus(data);
     }
+    /**
+     * @brief 播放器失去焦点，调用该方法 `veplayer.isFocused` 将会变为 `false`，并触发 `PLAYER_BLUR` 事件。
+     * @param data 播放器失去焦点配置信息。
+     */
     blur(data) {
       return this._player.blur(data);
     }
-    getFullscreen(el) {
+    /**
+     * @brief 调用此方法进入系统全屏状态。如果该方法调用的时候处于网页全屏状态会自动退出网页全屏，下发事件 `Events.FULLSCREEN_CHANGE`。
+     * @param el 全屏作用的 DOM 节点。
+     */
+    requestFullscreen(el) {
       return this._player.getFullscreen(el);
     }
+    /**
+     * @brief 调用此方法退出系统全屏状态，调用该方法 `veplayer.isFullscreen` 将会变为 `false`，并触发 `Events.FULLSCREEN_CHANGE` 事件。
+     * @param el 全屏作用的 DOM 节点。
+     */
     exitFullscreen(el) {
       return this._player.exitFullscreen(el);
     }
-    getCssFullscreen(el) {
+    /**
+     * @brief 调用此方法进入网页样式全屏状态，播放器进入网页全屏，利用 CSS 模拟实现全屏效果。如果该接口调用的时候处于全屏状态，会自动退出全屏，下发事件 `Events.CSS_FULLSCREEN_CHANGE`。
+     * @param el 全屏作用的 DOM 节点。
+     */
+    requestCssFullscreen(el) {
       return this._player.getCssFullscreen(el);
     }
+    /**
+     * @brief 调用此方法退出网页样式全屏状态。 调用该方法 `veplayer.isFullscreen` 将会变为 `false`，并触发 `Events.CSS_FULLSCREEN_CHANGE` 事件。
+     */
     exitCssFullscreen() {
       return this._player.exitCssFullscreen();
     }
+    /**
+     * @brief 调用此方法在当前播放器上注册指定插件。
+     * @param plugin 插件构造函数。
+     * @param config 插件的配置列表。
+     */
     registerPlugin(plugin, config) {
       return this._player.registerPlugin(plugin, config);
     }
-    unRegisterPlugin(plugin, removedFromConfig) {
-      return this._player.unRegisterPlugin(plugin, removedFromConfig);
+    /**
+     * @brief 调用此方法在当前播放器上销毁/注销指定插件。
+     * @param plugin 插件实例或者插件名称。
+     */
+    unRegisterPlugin(plugin) {
+      return this._player.unRegisterPlugin(plugin);
     }
-    // 显示插件
+    /**
+     * @brief 调用此接口显示指定插件图标。
+     * @param pluginNames 插件名称
+     */
     showIcon(pluginNames) {
       const morePlugin = this._player.getPlugin("more");
       pluginNames.forEach((pluginName) => {
@@ -12950,7 +13373,10 @@ var __publicField = (obj, key, value) => {
         }
       });
     }
-    // 隐藏插件显示
+    /**
+     * @brief 调用此接口隐藏指定插件图标。
+     * @param pluginNames 插件名称
+     */
     hideIcon(pluginNames) {
       const morePlugin = this._player.getPlugin("more");
       pluginNames.forEach((pluginName) => {
@@ -12964,10 +13390,16 @@ var __publicField = (obj, key, value) => {
         }
       });
     }
+    /**
+     * @brief 调用此方法销毁播放器实例。
+     */
     destroy() {
       this._player.off(ERROR, this._errorCallback);
       this._player.destroy();
     }
+    /**
+     * @hidden
+     */
     async prepare(url) {
       var _a, _b;
       const result = await ((_a = this._preparePlugins) == null ? void 0 : _a.call(this, url));
@@ -12983,9 +13415,12 @@ var __publicField = (obj, key, value) => {
       if (result == null ? void 0 : result.options) {
         this._player.setConfig(result.options);
       }
-      return addedPlugins.map((plugin) => {
-        return this._player.registerPlugin(plugin);
-      });
+      return {
+        plugins: addedPlugins.map((plugin) => {
+          return this._player.registerPlugin(plugin);
+        }),
+        options: result == null ? void 0 : result.options
+      };
     }
     async _handleFallback(err) {
       this._player.addClass(STATE_CLASS.ENTER);
@@ -13020,7 +13455,10 @@ var __publicField = (obj, key, value) => {
     async _switch(targetDefinition) {
       var _a, _b, _c, _d, _e, _f;
       const preDefinition = clonedeep(this._sourceManager.definition);
-      const newPlugins = await this.prepare(targetDefinition.url);
+      const { plugins: newPlugins, options } = await this.prepare(targetDefinition.url) || {};
+      if (options == null ? void 0 : options.url) {
+        targetDefinition.url = options == null ? void 0 : options.url;
+      }
       this._sourceManager.switch(targetDefinition);
       (_b = (_a = this._player) == null ? void 0 : _a.plugins) == null ? void 0 : _b.sources.renderItemList();
       (_d = (_c = this._player) == null ? void 0 : _c.plugins) == null ? void 0 : _d.definition.renderItemList();
@@ -13036,11 +13474,13 @@ var __publicField = (obj, key, value) => {
       }
     }
     async _switchUrl(url) {
-      const newPlugins = await this.prepare(url);
+      const { plugins: newPlugins, options } = await this.prepare(url) || {};
+      const newUrl = (options == null ? void 0 : options.url) ?? url;
+      this._sourceManager.updateSources(newUrl);
       if (newPlugins == null ? void 0 : newPlugins.length) {
-        this._callBeforePlayerInitForUrl(newPlugins, url);
+        this._callBeforePlayerInitForUrl(newPlugins, newUrl);
       } else {
-        const res = this._player.switchURL(url, false);
+        const res = this._player.switchURL(newUrl, false);
         const curTime = this._player.currentTime;
         if (res && res.then) {
           return res;