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

package/esm/veplayer.vod.development.js

@@ -4,6 +4,16 @@ var __publicField = (obj, key, value) => {
   __defNormalProp(obj, typeof key !== "symbol" ? key + "" : 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) {
@@ -1000,6 +1010,9 @@ util.isMSE = function(video) {
   }
   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();
@@ -1060,6 +1073,69 @@ util.convertDeg = function(val) {
   }
   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");
@@ -1149,7 +1225,7 @@ function debounce(func, wait, options) {
   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;
@@ -1356,7 +1432,7 @@ var sniffer = {
     }
   }
 };
-var version = "3.0.7";
+var version = "3.0.10-alpha.4";
 var ERROR_TYPE_MAP = {
   1: "media",
   2: "media",
@@ -1442,6 +1518,7 @@ var CANPLAY_THROUGH = "canplaythrough";
 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";
@@ -1481,7 +1558,7 @@ var RESET = "reset";
 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",
@@ -1510,6 +1587,7 @@ var XGEvents = /* @__PURE__ */ Object.freeze({
   FPS_STUCK,
   FULLSCREEN_CHANGE,
   LOADED_DATA,
+  LOADED_METADATA,
   LOAD_START,
   MINI_STATE_CHANGE,
   PAUSE,
@@ -1647,6 +1725,9 @@ var MediaProxy = /* @__PURE__ */ function(_EventEmitter) {
     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;
@@ -1725,10 +1806,11 @@ var MediaProxy = /* @__PURE__ */ function(_EventEmitter) {
       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;
@@ -1736,6 +1818,7 @@ var MediaProxy = /* @__PURE__ */ function(_EventEmitter) {
         return;
       }
       this._videoSourceCount = _c.length;
+      this._videoSourceIndex = _c.length;
       this._vLoadeddata = function(e) {
         _this6.emit(SOURCE_SUCCESS, {
           src: e.target.currentSrc,
@@ -1750,8 +1833,9 @@ var MediaProxy = /* @__PURE__ */ function(_EventEmitter) {
         }
       }
       !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"
@@ -2078,7 +2162,7 @@ var MediaProxy = /* @__PURE__ */ function(_EventEmitter) {
       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;
       }
@@ -3786,6 +3870,7 @@ function getDefaultConfig$1() {
     },
     enableSwipeHandler: function enableSwipeHandler() {
     },
+    preProcessUrl: null,
     ignores: [],
     whitelist: [],
     inactive: 3e3,
@@ -3867,7 +3952,7 @@ var Controls = /* @__PURE__ */ function(_Plugin) {
         autoHide: false
       });
     });
-    _defineProperty(_assertThisInitialized(_this), "onMouseLeave", function() {
+    _defineProperty(_assertThisInitialized(_this), "onMouseLeave", function(e) {
       var _assertThisInitialize2 = _assertThisInitialized(_this), player = _assertThisInitialize2.player;
       player.focus();
     });
@@ -3945,12 +4030,13 @@ var Controls = /* @__PURE__ */ function(_Plugin) {
   }, {
     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",
@@ -4352,6 +4438,7 @@ var Player = /* @__PURE__ */ function(_MediaProxy) {
     _this.cssfullscreen = false;
     _this.isRotateFullscreen = false;
     _this._fullscreenEl = null;
+    _this.timeSegments = [];
     _this._cssfullscreenEl = null;
     _this.curDefinition = null;
     _this._orgCss = "";
@@ -4361,7 +4448,7 @@ var Player = /* @__PURE__ */ function(_MediaProxy) {
     _this.videoPos = {
       pi: 1,
       scale: 0,
-      rotate: 0,
+      rotate: -1,
       x: 0,
       y: 0,
       h: -1,
@@ -4369,11 +4456,21 @@ var Player = /* @__PURE__ */ function(_MediaProxy) {
       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;
@@ -4386,6 +4483,9 @@ var Player = /* @__PURE__ */ function(_MediaProxy) {
     _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")));
@@ -4471,16 +4571,16 @@ var Player = /* @__PURE__ */ function(_MediaProxy) {
         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];
@@ -4496,6 +4596,11 @@ var Player = /* @__PURE__ */ function(_MediaProxy) {
           }
         });
       }
+      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;
     }
   }, {
@@ -4579,7 +4684,7 @@ var Player = /* @__PURE__ */ function(_MediaProxy) {
       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) {
@@ -4807,7 +4912,8 @@ var Player = /* @__PURE__ */ function(_MediaProxy) {
         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";
@@ -4824,6 +4930,7 @@ var Player = /* @__PURE__ */ function(_MediaProxy) {
       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;
@@ -5162,7 +5269,11 @@ var Player = /* @__PURE__ */ function(_MediaProxy) {
       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();
@@ -5223,7 +5334,7 @@ var Player = /* @__PURE__ */ function(_MediaProxy) {
       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++) {
@@ -5396,30 +5507,38 @@ var Player = /* @__PURE__ */ function(_MediaProxy) {
     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;
@@ -5542,7 +5661,7 @@ var Player = /* @__PURE__ */ function(_MediaProxy) {
   }, {
     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);
@@ -5617,8 +5736,11 @@ var Player = /* @__PURE__ */ function(_MediaProxy) {
     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) {
@@ -5718,9 +5840,14 @@ var Player = /* @__PURE__ */ function(_MediaProxy) {
       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) {
@@ -5728,7 +5855,6 @@ var Player = /* @__PURE__ */ function(_MediaProxy) {
       }
       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;
@@ -5783,6 +5909,14 @@ var Player = /* @__PURE__ */ function(_MediaProxy) {
       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() {
@@ -5956,9 +6090,8 @@ var Player = /* @__PURE__ */ function(_MediaProxy) {
   }, {
     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",
@@ -5997,6 +6130,22 @@ var Player = /* @__PURE__ */ function(_MediaProxy) {
     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) {
@@ -6122,7 +6271,7 @@ var ErrorCode = /* @__PURE__ */ ((ErrorCode2) => {
   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 || {});
@@ -6208,7 +6357,7 @@ const ERROR_INFO = {
     /* Error */
   },
   [
-    100
+    110
     /* MODULE_LOAD_ERROR */
   ]: {
     messageTextKey: "MODULE_LOAD_ERROR",
@@ -6283,6 +6432,11 @@ const ERROR_TYPE_INFO = {
   }
 };
 class VeError extends Error {
+  /**
+   * @hidden
+   * @param error
+   * @param i18n
+   */
   constructor(error2, i18n) {
     var _a;
     const errorInfo = typeof error2 === "string" ? {
@@ -6290,8 +6444,17 @@ class VeError extends Error {
     } : 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";
@@ -7628,10 +7791,56 @@ function getDefaultConfig() {
 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,
@@ -7639,11 +7848,11 @@ var Touche = /* @__PURE__ */ function() {
       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 = {};
@@ -7652,10 +7861,6 @@ var Touche = /* @__PURE__ */ function() {
   _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);
     }
   }, {
@@ -7741,60 +7946,6 @@ var Touche = /* @__PURE__ */ function() {
         }
       });
     }
-  }, {
-    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 destroy2() {
@@ -7804,8 +7955,8 @@ var Touche = /* @__PURE__ */ function() {
         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]]);
       });
     }
   }]);
@@ -8456,38 +8607,61 @@ var Keyboard = /* @__PURE__ */ function(_BasePlugin) {
     }
     _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;
   }
@@ -8501,7 +8675,7 @@ var Keyboard = /* @__PURE__ */ function(_BasePlugin) {
           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]);
             });
           }
@@ -8521,37 +8695,51 @@ var Keyboard = /* @__PURE__ */ function(_BasePlugin) {
           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);
     }
@@ -8585,6 +8773,9 @@ var Keyboard = /* @__PURE__ */ function(_BasePlugin) {
     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: {
@@ -8605,6 +8796,9 @@ var Keyboard = /* @__PURE__ */ function(_BasePlugin) {
     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: {
@@ -8624,42 +8818,57 @@ var Keyboard = /* @__PURE__ */ function(_BasePlugin) {
   }, {
     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",
@@ -8697,32 +8906,66 @@ var Keyboard = /* @__PURE__ */ function(_BasePlugin) {
         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 destroy2() {
       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",
@@ -8744,12 +8987,13 @@ var Keyboard = /* @__PURE__ */ function(_BasePlugin) {
     get: function get() {
       return {
         seekStep: 10,
-        checkVisible: true,
+        checkVisible: false,
         disableBodyTrigger: false,
         disableRootTrigger: false,
         isGlobalTrigger: false,
         keyCodeMap: {},
         disable: false,
+        playbackRate: 2,
         isIgnoreUserActive: false
       };
     }
@@ -10042,6 +10286,9 @@ class Definition {
   get url() {
     return this._currentUrlRef.url;
   }
+  set url(url) {
+    this._currentUrlRef.url = url;
+  }
   next() {
     const next = this._currentUrlRef.next;
     /* istanbul ignore next -- @preserve */
@@ -10119,7 +10366,6 @@ class SourceManager {
     __publicField(this, "defaultSource");
     __publicField(this, "defaultDefinition");
     __publicField(this, "maxFallbackRound");
-    __publicField(this, "_prepareList", []);
     __publicField(this, "_currentDefinition");
     __publicField(this, "_sources");
     __publicField(this, "_fallbackCount", 0);
@@ -10154,6 +10400,11 @@ class SourceManager {
     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}
@@ -10223,14 +10474,6 @@ class SourceManager {
     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;
   }
@@ -10672,12 +10915,13 @@ class MobilePlayerPanel {
   }
 }
 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";
@@ -10685,20 +10929,26 @@ var RenderType = /* @__PURE__ */ ((RenderType2) => {
 })(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) {
@@ -10736,7 +10986,7 @@ class OptionsIcon extends Plugin {
       // 默认手机端在“右上角”，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: {},
@@ -10918,10 +11168,10 @@ class OptionsIcon extends Plugin {
       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;
   }
@@ -11814,9 +12064,7 @@ class DefinitionPlugin extends OptionsIcon {
       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
@@ -12623,11 +12871,6 @@ class VeI18n {
   }
 }
 var veplayerBase = "";
-var Codec = /* @__PURE__ */ ((Codec2) => {
-  Codec2["H265"] = "h265";
-  Codec2["H264"] = "h264";
-  return Codec2;
-})(Codec || {});
 const { POSITIONS: XGPosition } = Plugin;
 const POSITIONS = {
   ...XGPosition,
@@ -12637,7 +12880,7 @@ const DEFAULT_OPTIONS = {
   id: "veplayer",
   width: "100%",
   height: "100%",
-  decodeType: "hardware",
+  decodeType: DecodeType.Hardware,
   fullscreen: {
     useCssFullscreen: false
   }
@@ -12665,6 +12908,9 @@ const transformOption = (options) => {
   return xgOptions;
 };
 class VePlayerBase {
+  /**
+   * @hidden
+   */
   constructor(options = {}) {
     __publicField(this, "_player");
     __publicField(this, "_sourceManager");
@@ -12712,85 +12958,172 @@ class VePlayerBase {
       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}, 请重新设置`
@@ -12805,8 +13138,11 @@ class VePlayerBase {
   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,
@@ -12818,18 +13154,28 @@ class VePlayerBase {
       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;
     }
@@ -12842,12 +13188,22 @@ class VePlayerBase {
     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) {
@@ -12855,27 +13211,45 @@ class VePlayerBase {
         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) {
@@ -12883,56 +13257,105 @@ class VePlayerBase {
         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) => {
@@ -12946,7 +13369,10 @@ class VePlayerBase {
       }
     });
   }
-  // 隐藏插件显示
+  /**
+   * @brief 调用此接口隐藏指定插件图标。
+   * @param pluginNames 插件名称
+   */
   hideIcon(pluginNames) {
     const morePlugin = this._player.getPlugin("more");
     pluginNames.forEach((pluginName) => {
@@ -12960,10 +13386,16 @@ class VePlayerBase {
       }
     });
   }
+  /**
+   * @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));
@@ -12979,9 +13411,12 @@ class VePlayerBase {
     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);
@@ -13016,7 +13451,10 @@ class VePlayerBase {
   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();
@@ -13032,11 +13470,13 @@ class VePlayerBase {
     }
   }
   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;