@volcengine/veplayer 2.2.1-rc.0 → 2.3.0-rc.1

package/esm/veplayer.vod.development.js

@@ -43,8 +43,8 @@ function _typeof(obj) {
     return obj2 && "function" == typeof Symbol && obj2.constructor === Symbol && obj2 !== Symbol.prototype ? "symbol" : typeof obj2;
   }, _typeof(obj);
 }
-function _classCallCheck(instance, Constructor) {
-  if (!(instance instanceof Constructor)) {
+function _classCallCheck(instance2, Constructor) {
+  if (!(instance2 instanceof Constructor)) {
     throw new TypeError("Cannot call a class as a function");
   }
 }
@@ -1449,7 +1449,7 @@ var sniffer = {
     }
   }
 };
-var version = "3.0.11-alpha.2";
+var version = "3.0.12";
 var ERROR_TYPE_MAP = {
   1: "media",
   2: "media",
@@ -2311,10 +2311,10 @@ var INDEXDB = /* @__PURE__ */ function() {
   }, {
     key: "addData",
     value: function addData(storename, data) {
-      var store = this.myDB.db.transaction(storename, "readwrite").objectStore(storename);
+      var store2 = this.myDB.db.transaction(storename, "readwrite").objectStore(storename);
       var request;
       for (var i = 0; i < data.length; i++) {
-        request = store.add(data[i]);
+        request = store2.add(data[i]);
         request.onerror = function() {
         };
         request.onsuccess = function() {
@@ -2324,10 +2324,10 @@ var INDEXDB = /* @__PURE__ */ function() {
   }, {
     key: "putData",
     value: function putData(storename, data) {
-      var store = this.myDB.db.transaction(storename, "readwrite").objectStore(storename);
+      var store2 = this.myDB.db.transaction(storename, "readwrite").objectStore(storename);
       var request;
       for (var i = 0; i < data.length; i++) {
-        request = store.put(data[i]);
+        request = store2.put(data[i]);
         request.onerror = function() {
         };
         request.onsuccess = function() {
@@ -2338,8 +2338,8 @@ var INDEXDB = /* @__PURE__ */ function() {
     key: "getDataByKey",
     value: function getDataByKey(storename, key, callback) {
       var self2 = this;
-      var store = this.myDB.db.transaction(storename, "readwrite").objectStore(storename);
-      var request = store.get(key);
+      var store2 = this.myDB.db.transaction(storename, "readwrite").objectStore(storename);
+      var request = store2.get(key);
       request.onerror = function() {
         callback.call(self2, null);
       };
@@ -2351,14 +2351,14 @@ var INDEXDB = /* @__PURE__ */ function() {
   }, {
     key: "deleteData",
     value: function deleteData(storename, key) {
-      var store = this.myDB.db.transaction(storename, "readwrite").objectStore(storename);
-      store.delete(key);
+      var store2 = this.myDB.db.transaction(storename, "readwrite").objectStore(storename);
+      store2.delete(key);
     }
   }, {
     key: "clearData",
     value: function clearData(storename) {
-      var store = this.myDB.db.transaction(storename, "readwrite").objectStore(storename);
-      store.clear();
+      var store2 = this.myDB.db.transaction(storename, "readwrite").objectStore(storename);
+      store2.clear();
     }
   }]);
   return INDEXDB2;
@@ -2475,24 +2475,24 @@ function removePluginHooks(pluginName) {
     return plugin.removeHooks && plugin.removeHooks.apply(plugin, args);
   }
 }
-function hooksDescriptor(instance) {
+function hooksDescriptor(instance2) {
   var presetHooks = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : [];
-  instance.__hooks = {};
+  instance2.__hooks = {};
   presetHooks && presetHooks.map(function(item) {
-    instance.__hooks[item] = null;
+    instance2.__hooks[item] = null;
   });
-  Object.defineProperty(instance, "hooks", {
+  Object.defineProperty(instance2, "hooks", {
     get: function get() {
-      return instance.__hooks && Object.keys(instance.__hooks).map(function(key) {
-        if (instance.__hooks[key]) {
+      return instance2.__hooks && Object.keys(instance2.__hooks).map(function(key) {
+        if (instance2.__hooks[key]) {
           return key;
         }
       });
     }
   });
 }
-function delHooksDescriptor(instance) {
-  instance.__hooks = null;
+function delHooksDescriptor(instance2) {
+  instance2.__hooks = null;
 }
 function runHooks(obj, hookName, handler) {
   for (var _len5 = arguments.length, args = new Array(_len5 > 3 ? _len5 - 3 : 0), _key5 = 3; _key5 < _len5; _key5++) {
@@ -3208,7 +3208,7 @@ var Plugin = /* @__PURE__ */ function(_BasePlugin) {
       var cs = window.getComputedStyle(this.root, null);
       var cssDisplayValue = cs.getPropertyValue("display");
       if (cssDisplayValue === "none") {
-        return this.root.style.display = "block";
+        this.root.style.display = "block";
       }
     }
   }, {
@@ -3465,28 +3465,11 @@ var pluginsManager = {
     !player.config.closeResizeObserver && addObserver(player.root, function() {
       player.resize();
     });
-    if (Object.keys(this.pluginGroup).length === 0) {
-      player.isUserActive = true;
-    }
     this.pluginGroup[cgid] = {
-      _player: player,
       _originalOptions: player.config || {},
       _plugins: {}
     };
   },
-  checkPlayerRoot: function checkPlayerRoot(root) {
-    if (this.pluginGroup) {
-      var _keys = Object.keys(this.pluginGroup);
-      for (var i = 0; i < _keys.length; i++) {
-        var _p = this.pluginGroup[_keys[i]]._player;
-        if (_p.root === root) {
-          return _p;
-        }
-      }
-      return null;
-    }
-    return null;
-  },
   formatPluginInfo: function formatPluginInfo(plugin, config) {
     var PLUFGIN = null;
     var options = null;
@@ -3561,7 +3544,7 @@ var pluginsManager = {
     }
     var plugins = this.pluginGroup[cgid]._plugins;
     var originalOptions = this.pluginGroup[cgid]._originalOptions;
-    options.player = this.pluginGroup[cgid]._player;
+    options.player = player;
     var pluginName = options.pluginName || plugin.pluginName;
     if (!pluginName) {
       throw new Error("The property pluginName is necessary");
@@ -3760,37 +3743,6 @@ var pluginsManager = {
       }
     });
   },
-  setCurrentUserActive: function setCurrentUserActive(playerId, isActive) {
-    if (!this.pluginGroup[playerId]) {
-      return;
-    }
-    if (!isActive) {
-      this.pluginGroup[playerId]._player.isUserActive = isActive;
-      return playerId;
-    }
-    var keys = Object.keys(this.pluginGroup);
-    for (var i = 0; i < keys.length; i++) {
-      var c = this.pluginGroup[keys[i]];
-      if (c && c._player) {
-        this.pluginGroup[keys[i]]._player.isUserActive = false;
-      }
-    }
-    this.pluginGroup[playerId]._player.isUserActive = isActive;
-    return playerId;
-  },
-  getCurrentUseActiveId: function getCurrentUseActiveId() {
-    if (!this.pluginGroup) {
-      return;
-    }
-    var keys = Object.keys(this.pluginGroup);
-    for (var i = 0; i < keys.length; i++) {
-      var c = this.pluginGroup[keys[i]];
-      if (c && c._player && c._player.isUserActive) {
-        return keys[i];
-      }
-    }
-    return null;
-  },
   destroy: function destroy(player) {
     var cgid = player._pluginInfoId;
     if (!this.pluginGroup[cgid]) {
@@ -4046,7 +3998,7 @@ var Controls = /* @__PURE__ */ function(_Plugin) {
     }
   }, {
     key: "show",
-    value: function show() {
+    value: function show(value) {
       this.root.style.display = "";
       this.player.focus();
     }
@@ -4339,9 +4291,158 @@ var STATES = {
   DESTROYED: 8
 };
 var STATE_ARRAY = ["ERROR", "INITIAL", "READY", "ATTACHING", "ATTACHED", "NOTALLOW", "RUNNING", "ENDED", "DESTROYED"];
+var store = {};
+var instance = null;
+var InstManager = /* @__PURE__ */ function(_EventEmitter) {
+  _inherits(InstManager2, _EventEmitter);
+  var _super = _createSuper(InstManager2);
+  function InstManager2() {
+    _classCallCheck(this, InstManager2);
+    return _super.apply(this, arguments);
+  }
+  _createClass(InstManager2, [{
+    key: "add",
+    value: function add(player) {
+      if (!player) {
+        return;
+      }
+      store[player.playerId] = player;
+      if (Object.keys(store).length === 1) {
+        this.setActive(player.playerId, true);
+      }
+    }
+  }, {
+    key: "remove",
+    value: function remove(player) {
+      if (!player) {
+        return;
+      }
+      player.isUserActive;
+      delete store[player.playerId];
+    }
+  }, {
+    key: "_iterate",
+    value: function _iterate(fn) {
+      var endEarly = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : false;
+      for (var key in store) {
+        if (Object.prototype.hasOwnProperty.call(store, key)) {
+          var player = store[key];
+          if (endEarly) {
+            if (fn(player)) {
+              break;
+            }
+          } else {
+            fn(player);
+          }
+        }
+      }
+    }
+  }, {
+    key: "forEach",
+    value: function forEach(fn) {
+      this._iterate(fn);
+    }
+  }, {
+    key: "find",
+    value: function find(fn) {
+      var result = null;
+      this._iterate(function(player) {
+        var flag = fn(player);
+        if (flag) {
+          result = player;
+        }
+        return flag;
+      }, true);
+      return result;
+    }
+  }, {
+    key: "findAll",
+    value: function findAll(fn) {
+      var results = [];
+      this._iterate(function(player) {
+        if (fn(player)) {
+          results.push(player);
+        }
+      });
+      return results;
+    }
+  }, {
+    key: "setActive",
+    value: function setActive(playerId) {
+      var isActive = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : true;
+      if (!store[playerId]) {
+        return;
+      }
+      if (isActive) {
+        this.forEach(function(inst) {
+          if (playerId === inst.playerId) {
+            inst.isUserActive = true;
+            inst.isInstNext = false;
+          } else {
+            inst.isUserActive = false;
+          }
+        });
+      } else {
+        store[playerId].isUserActive = isActive;
+      }
+      return playerId;
+    }
+  }, {
+    key: "getActiveId",
+    value: function getActiveId() {
+      var keys = Object.keys(store);
+      for (var i = 0; i < keys.length; i++) {
+        var c = store[keys[i]];
+        if (c && c.isUserActive) {
+          return keys[i];
+        }
+      }
+      return null;
+    }
+  }, {
+    key: "setNext",
+    value: function setNext(playerId) {
+      var isNext = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : true;
+      if (!store[playerId]) {
+        return;
+      }
+      if (isNext) {
+        this.forEach(function(inst) {
+          if (playerId === inst.playerId) {
+            inst.isUserActive = false;
+            inst.isInstNext = true;
+          } else {
+            inst.isInstNext = false;
+          }
+        });
+      } else {
+        store[playerId].isInstNext = isNext;
+      }
+      return playerId;
+    }
+  }], [{
+    key: "getInstance",
+    value: function getInstance() {
+      instance || (instance = new InstManager2());
+      return instance;
+    }
+  }]);
+  return InstManager2;
+}(eventemitter3Exports.EventEmitter);
+function checkPlayerRoot(root) {
+  var keys = Object.keys(store);
+  for (var i = 0; i < keys.length; i++) {
+    var p = store[keys[i]];
+    if (p.root === root) {
+      return p;
+    }
+  }
+  return null;
+}
 var PlAYER_HOOKS = ["play", "pause", "replay", "retry"];
 var REAL_TIME_SPEED = 0;
 var AVG_SPEED = 0;
+var instManager = null;
 var Player = /* @__PURE__ */ function(_MediaProxy) {
   _inherits(Player2, _MediaProxy);
   var _super = _createSuper(Player2);
@@ -4354,11 +4455,11 @@ var Player = /* @__PURE__ */ function(_MediaProxy) {
       if (!_this.config) {
         return;
       }
-      var _this$config = _this.config, autoplay2 = _this$config.autoplay, startTime = _this$config.startTime, defaultPlaybackRate = _this$config.defaultPlaybackRate;
-      XG_DEBUG.logInfo("player", "canPlayFunc, startTime", startTime);
-      if (startTime) {
-        _this.currentTime = startTime > _this.duration ? _this.duration : startTime;
-        _this.config.startTime = 0;
+      var _this$config = _this.config, autoplay2 = _this$config.autoplay, defaultPlaybackRate = _this$config.defaultPlaybackRate;
+      XG_DEBUG.logInfo("player", "canPlayFunc, startTime", _this.__startTime);
+      if (_this.__startTime > 0 && _this.duration > 0) {
+        _this.currentTime = _this.__startTime > _this.duration ? _this.duration : _this.__startTime;
+        _this.__startTime = -1;
       }
       _this.playbackRate = defaultPlaybackRate;
       (autoplay2 || _this._useAutoplay) && _this.mediaPlay();
@@ -4449,6 +4550,7 @@ var Player = /* @__PURE__ */ function(_MediaProxy) {
     _this.isSeeking = false;
     _this.isCanplay = false;
     _this._useAutoplay = false;
+    _this.__startTime = -1;
     _this.rotateDeg = 0;
     _this.isActive = false;
     _this.fullscreen = false;
@@ -4503,6 +4605,7 @@ var Player = /* @__PURE__ */ function(_MediaProxy) {
     _this.innerStates = {
       isActiveLocked: false
     };
+    _this.instManager = instManager;
     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")));
@@ -4540,7 +4643,7 @@ var Player = /* @__PURE__ */ function(_MediaProxy) {
   _createClass(Player2, [{
     key: "_initDOM",
     value: function _initDOM() {
-      var _this2 = this;
+      var _instManager, _this2 = this;
       this.root = this.config.id ? document.getElementById(this.config.id) : null;
       if (!this.root) {
         var el = this.config.el;
@@ -4556,12 +4659,13 @@ var Player = /* @__PURE__ */ function(_MediaProxy) {
           return false;
         }
       }
-      var ret = pluginsManager.checkPlayerRoot(this.root);
+      var ret = checkPlayerRoot(this.root);
       if (ret) {
         XG_DEBUG.logWarn("The is an Player instance already exists in this.root, destroy it and reinitialize");
         ret.destroy();
       }
       this.root.setAttribute(PLATER_ID, this.playerId);
+      (_instManager = instManager) === null || _instManager === void 0 ? void 0 : _instManager.add(this);
       pluginsManager.init(this);
       this._initBaseDoms();
       var XgVideoProxy = this.constructor.XgVideoProxy;
@@ -4704,10 +4808,13 @@ var Player = /* @__PURE__ */ function(_MediaProxy) {
         !util.isMSE(this.media) && this.load();
         (sniffer.os.isIpad || sniffer.os.isPhone) && this.mediaPlay();
       }
-      if (readyState >= 2) {
+      var startTime = this.config.startTime;
+      this.__startTime = startTime > 0 ? startTime : -1;
+      this.config.startTime = 0;
+      if (readyState >= 2 && this.duration > 0) {
         this.canPlayFunc();
       } else {
-        this.once(CANPLAY, this.canPlayFunc);
+        this.on(CANPLAY, this.canPlayFunc);
       }
       if (!this.hasStart || this.state < STATES.ATTACHED) {
         pluginsManager.afterInit(this);
@@ -4949,6 +5056,7 @@ var Player = /* @__PURE__ */ function(_MediaProxy) {
       }
       _src = this.preProcessUrl(_src).url;
       var curTime = this.currentTime;
+      this.__startTime = curTime;
       var isPaused = this.paused && !this.isError;
       this.src = _src;
       return new Promise(function(resolve, reject) {
@@ -4958,7 +5066,10 @@ var Player = /* @__PURE__ */ function(_MediaProxy) {
           reject(e);
         };
         var _canplay = function _canplay2() {
-          _this9.currentTime = curTime;
+          if (_this9.duration > 0 && _this9.__startTime > 0) {
+            _this9.currentTime = _this9.__startTime;
+            _this9.__startTime = -1;
+          }
           if (isPaused) {
             _this9.pause();
           }
@@ -5185,7 +5296,7 @@ var Player = /* @__PURE__ */ function(_MediaProxy) {
       clsList.forEach(function(cls) {
         _this16.removeClass(cls);
       });
-      this.addClass(STATE_CLASS.ENTER);
+      this.addClass(STATE_CLASS.NO_START);
       this.emit(RESET);
     }
   }, {
@@ -5214,7 +5325,7 @@ var Player = /* @__PURE__ */ function(_MediaProxy) {
   }, {
     key: "destroy",
     value: function destroy2() {
-      var _this18 = this;
+      var _instManager2, _this18 = this;
       var innerContainer = this.innerContainer, root = this.root, media = this.media;
       if (!root || !media) {
         return;
@@ -5227,6 +5338,7 @@ var Player = /* @__PURE__ */ function(_MediaProxy) {
       this._detachSourceEvents(this.media);
       util.clearAllTimers(this);
       this.emit(DESTROY);
+      (_instManager2 = instManager) === null || _instManager2 === void 0 ? void 0 : _instManager2.remove(this);
       pluginsManager.destroy(this);
       delHooksDescriptor(this);
       _get(_getPrototypeOf(Player2.prototype), "destroy", this).call(this);
@@ -5578,6 +5690,14 @@ var Player = /* @__PURE__ */ function(_MediaProxy) {
       this.isCanplay = true;
       this.waitTimer && util.clearTimeout(this, this.waitTimer);
     }
+  }, {
+    key: "onDurationchange",
+    value: function onDurationchange() {
+      if (this.__startTime > 0 && this.duration > 0) {
+        this.currentTime = this.__startTime;
+        this.__startTime = -1;
+      }
+    }
   }, {
     key: "onLoadeddata",
     value: function onLoadeddata() {
@@ -5755,8 +5875,9 @@ 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) {
+      var _this$videoPos = this.videoPos, vy = _this$videoPos.vy, vx = _this$videoPos.vx, h = _this$videoPos.h, w = _this$videoPos.w;
+      var rotate = this.videoPos.rotate;
+      if (rotate < 0 && h < 0 && w < 0) {
         return;
       }
       var _pi = this.videoPos._pi;
@@ -5767,6 +5888,7 @@ var Player = /* @__PURE__ */ function(_MediaProxy) {
         return;
       }
       this.videoPos.pi = _pi;
+      rotate = rotate < 0 ? 0 : rotate;
       var _pos = {
         rotate
       };
@@ -6199,7 +6321,8 @@ var Player = /* @__PURE__ */ function(_MediaProxy) {
     }
   }, {
     key: "setUserActive",
-    value: function setUserActive(isActive, isMuted) {
+    value: function setUserActive(isActive) {
+      var isMuted = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : false;
       if (typeof isMuted === "boolean" && isMuted !== this.muted) {
         this.addInnerOP("volumechange");
         this.muted = isMuted;
@@ -6214,15 +6337,25 @@ var Player = /* @__PURE__ */ function(_MediaProxy) {
     set: function set(value) {
       XG_DEBUG.config.debug = value;
     }
+  }, {
+    key: "instManager",
+    get: function get() {
+      return instManager;
+    },
+    set: function set(value) {
+      instManager = value;
+    }
   }, {
     key: "getCurrentUserActivePlayerId",
     value: function getCurrentUserActivePlayerId() {
-      return pluginsManager.getCurrentUseActiveId();
+      var _instManager3;
+      return (_instManager3 = instManager) === null || _instManager3 === void 0 ? void 0 : _instManager3.getActiveId();
     }
   }, {
     key: "setCurrentUserActive",
-    value: function setCurrentUserActive2(playerId, isActive) {
-      pluginsManager.setCurrentUserActive(playerId, isActive);
+    value: function setCurrentUserActive(playerId, isActive) {
+      var _instManager4;
+      (_instManager4 = instManager) === null || _instManager4 === void 0 ? void 0 : _instManager4.setActive(playerId, isActive);
     }
   }, {
     key: "isHevcSupported",
@@ -6257,6 +6390,7 @@ var Player = /* @__PURE__ */ function(_MediaProxy) {
 }(MediaProxy);
 _defineProperty(Player, "defaultPreset", null);
 _defineProperty(Player, "XgVideoProxy", null);
+Player.instManager = InstManager.getInstance();
 var index_min = "";
 var ErrorCode = /* @__PURE__ */ ((ErrorCode2) => {
   ErrorCode2[ErrorCode2["MANIFEST_HLS_ERROR"] = 1100] = "MANIFEST_HLS_ERROR";
@@ -6383,6 +6517,14 @@ const ERROR_INFO = {
     messageTextKey: "MODULE_LOAD_ERROR",
     level: "Fatal"
     /* Fatal */
+  },
+  [
+    7100
+    /* DRM_LICENSE */
+  ]: {
+    messageTextKey: "DRM_LICENSE",
+    level: "Fatal"
+    /* Fatal */
   }
 };
 const ERROR_TYPE_INFO = {
@@ -6452,7 +6594,12 @@ const ERROR_TYPE_INFO = {
   }
 };
 class VeError extends Error {
-  /**
+  /** {zh}
+   * @hidden
+   * @param error
+   * @param i18n
+   */
+  /** {en}
    * @hidden
    * @param error
    * @param i18n
@@ -6465,16 +6612,25 @@ class VeError extends Error {
     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 错误码，对应[错误码字典](#错误码)。
+     * @brief 错误码。
+     */
+    /** {en}
+     * @brief The error code.
      */
     __publicField(this, "errorCode");
-    /**
+    /** {zh}
      * @brief 错误等级。
      */
+    /** {en}
+     * @brief The error level.
+     */
     __publicField(this, "level");
-    /**
+    /** {zh}
      * @brief 其他错误信息。
      */
+    /** {en}
+     * @brief Other error messages.
+     */
     __publicField(this, "ext");
     this.errorCode = (errorInfo == null ? void 0 : errorInfo.errorCode) ?? "UNKNOWN";
     this.level = (errorInfo == null ? void 0 : errorInfo.level) ?? "Error";
@@ -6527,7 +6683,7 @@ var Poster = /* @__PURE__ */ function(_Plugin) {
     }
   }, {
     key: "show",
-    value: function show() {
+    value: function show(value) {
       util.removeClass(this.root, "hide");
     }
   }, {
@@ -6606,10 +6762,11 @@ var Poster = /* @__PURE__ */ function(_Plugin) {
   }, {
     key: "render",
     value: function render() {
-      var _this$config = this.config, poster = _this$config.poster, hideCanplay = _this$config.hideCanplay, fillMode = _this$config.fillMode;
+      var _this$config = this.config, poster = _this$config.poster, hideCanplay = _this$config.hideCanplay, fillMode = _this$config.fillMode, notHidden = _this$config.notHidden;
       var _bg = this.getBgSize(fillMode);
       var style = poster ? "background-image:url(".concat(poster, ");").concat(_bg) : _bg;
-      return '<xg-poster class="xgplayer-poster '.concat(hideCanplay ? "xg-showplay" : "", '" style="').concat(style, '">\n    </xg-poster>');
+      var className = notHidden ? "xg-not-hidden" : hideCanplay ? "xg-showplay" : "";
+      return '<xg-poster class="xgplayer-poster '.concat(className, '" style="').concat(style, '">\n    </xg-poster>');
     }
   }], [{
     key: "pluginName",
@@ -6622,6 +6779,7 @@ var Poster = /* @__PURE__ */ function(_Plugin) {
       return {
         isEndedShow: true,
         hideCanplay: false,
+        notHidden: false,
         poster: "",
         fillMode: "fixWidth"
       };
@@ -6765,7 +6923,7 @@ var Start = /* @__PURE__ */ function(_Plugin) {
     }
   }, {
     key: "show",
-    value: function show() {
+    value: function show(value) {
       util.removeClass(this.root, "hide");
     }
   }, {
@@ -7727,14 +7885,14 @@ var PCPlugin = /* @__PURE__ */ function(_BasePlugin) {
     key: "initEvents",
     value: function initEvents() {
       var _this3 = this;
-      var _this$player = this.player, video = _this$player.video, root = _this$player.root;
+      var _this$player = this.player, media = _this$player.media, root = _this$player.root;
       var enableContextmenu = this.playerConfig.enableContextmenu;
       root && root.addEventListener("click", this.onVideoClick, false);
       root && root.addEventListener("dblclick", this.onVideoDblClick, false);
       Object.keys(MOUSE_EVENTS).map(function(item) {
         root.addEventListener(item, _this3[MOUSE_EVENTS[item]], false);
       });
-      enableContextmenu && video && video.addEventListener("contextmenu", this.onContextmenu, false);
+      !enableContextmenu && media && media.addEventListener("contextmenu", this.onContextmenu, false);
     }
   }, {
     key: "switchPlayPause",
@@ -9458,16 +9616,6 @@ var Fullscreen = /* @__PURE__ */ function(_IconPlugin) {
         }
       }
     }
-  }, {
-    key: "show",
-    value: function show() {
-      _get(_getPrototypeOf(Fullscreen2.prototype), "show", this).call(this);
-    }
-  }, {
-    key: "hide",
-    value: function hide() {
-      _get(_getPrototypeOf(Fullscreen2.prototype), "hide", this).call(this);
-    }
   }, {
     key: "render",
     value: function render() {
@@ -9923,11 +10071,14 @@ var PIP = /* @__PURE__ */ function(_IconPlugin) {
         }, 0);
         !paused && player.mediaPlay();
         _this3.setAttr("data-state", "normal");
+        _this3.pipWindow = null;
         player.emit(PIP_CHANGE, false);
       };
       this.enterPIPCallback = function(e) {
         player.emit(PIP_CHANGE, true);
-        _this3.pipWindow = e.pictureInPictureWindow;
+        if (e !== null && e !== void 0 && e.pictureInPictureWindow) {
+          _this3.pipWindow = e.pictureInPictureWindow;
+        }
         _this3.setAttr("data-state", "pip");
       };
       this.onWebkitpresentationmodechanged = function(e) {
@@ -9948,10 +10099,33 @@ var PIP = /* @__PURE__ */ function(_IconPlugin) {
         PIP2.checkWebkitSetPresentationMode(player.media) && player.media.addEventListener("webkitpresentationmodechanged", this.onWebkitpresentationmodechanged);
       }
     }
+  }, {
+    key: "copyStyleIntoPiPWindow",
+    value: function copyStyleIntoPiPWindow(pipWin) {
+      var textContent = _toConsumableArray(document.styleSheets).map(function(style2) {
+        try {
+          return _toConsumableArray(style2.cssRules).map(function(rule) {
+            return rule.cssText;
+          }).join("");
+        } catch (e) {
+          var link = document.createElement("link");
+          link.rel = "stylesheet";
+          link.type = style2.type;
+          link.media = style2.media;
+          link.href = style2.href;
+          pipWin.document.head.appendChild(link);
+        }
+        return "";
+      }).filter(Boolean).join("\n");
+      var style = document.createElement("style");
+      style.textContent = textContent;
+      pipWin.document.head.appendChild(style);
+    }
   }, {
     key: "requestPIP",
     value: function requestPIP() {
-      var player = this.player, playerConfig = this.playerConfig;
+      var _this4 = this;
+      var player = this.player, playerConfig = this.playerConfig, config = this.config;
       if (!this.isPIPAvailable() || this.isPip) {
         return;
       }
@@ -9960,7 +10134,62 @@ var PIP = /* @__PURE__ */ function(_IconPlugin) {
         if (poster) {
           player.media.poster = util.typeOf(poster) === "String" ? poster : poster.poster;
         }
-        PIP2.checkWebkitSetPresentationMode(player.media) ? player.media.webkitSetPresentationMode("picture-in-picture") : player.media.requestPictureInPicture();
+        if (config.preferDocument && this.isDocPIPAvailable()) {
+          var pipOptions = {};
+          if (config.width && config.height) {
+            pipOptions.width = config.width;
+            pipOptions.height = config.height;
+          } else {
+            var playerRect = player.root.getBoundingClientRect();
+            pipOptions.width = playerRect.width;
+            pipOptions.height = playerRect.height;
+          }
+          documentPictureInPicture.requestWindow(pipOptions).then(function(pipWin) {
+            var docPiPNode = config.docPiPNode, docPiPStyle = config.docPiPStyle;
+            _this4.enterPIPCallback();
+            var pipRoot = docPiPNode || player.root;
+            var parentNode = pipRoot.parentElement;
+            var previousSibling = pipRoot.previousSibling;
+            var nextSibling = pipRoot.nextSibling;
+            _this4.copyStyleIntoPiPWindow(pipWin);
+            var styles = document.createElement("style");
+            styles.append("body{padding:0; margin:0;}");
+            if (docPiPStyle) {
+              var cssContent = "";
+              if (typeof docPiPStyle === "string") {
+                cssContent = docPiPStyle;
+              } else if (typeof docPiPStyle === "function") {
+                cssContent = docPiPStyle.call(config);
+              }
+              if (cssContent) {
+                styles.append(cssContent);
+              }
+            } else if (pipRoot === player.root) {
+              styles.append("\n              .xgplayer{width: 100%!important; height: 100%!important;}\n            ");
+            }
+            pipWin.document.head.append(styles);
+            pipWin.document.body.append(pipRoot);
+            pipWin.addEventListener("pagehide", function(event) {
+              if (parentNode) {
+                if (nextSibling) {
+                  parentNode.insertBefore(pipRoot, nextSibling);
+                } else if (previousSibling) {
+                  parentNode.insertBefore(pipRoot, previousSibling.nextSibling);
+                } else {
+                  parentNode.appendChild(pipRoot);
+                }
+              } else {
+              }
+              _this4.leavePIPCallback();
+            }, {
+              once: true
+            });
+          });
+        } else if (PIP2.checkWebkitSetPresentationMode(player.media)) {
+          player.media.webkitSetPresentationMode("picture-in-picture");
+        } else {
+          player.media.requestPictureInPicture();
+        }
         return true;
       } catch (reason) {
         console.error("requestPiP", reason);
@@ -9973,7 +10202,14 @@ var PIP = /* @__PURE__ */ function(_IconPlugin) {
       var player = this.player;
       try {
         if (this.isPIPAvailable() && this.isPip) {
-          PIP2.checkWebkitSetPresentationMode(player.media) ? player.media.webkitSetPresentationMode("inline") : document.exitPictureInPicture();
+          var _documentPictureInPic;
+          if (this.isDocPIPAvailable() && (_documentPictureInPic = documentPictureInPicture) !== null && _documentPictureInPic !== void 0 && _documentPictureInPic.window) {
+            documentPictureInPicture.window.close();
+          } else if (PIP2.checkWebkitSetPresentationMode(player.media)) {
+            player.media.webkitSetPresentationMode("inline");
+          } else {
+            document.exitPictureInPicture();
+          }
         }
         return true;
       } catch (reason) {
@@ -9984,15 +10220,21 @@ var PIP = /* @__PURE__ */ function(_IconPlugin) {
   }, {
     key: "isPip",
     get: function get() {
+      var _documentPictureInPic2;
       var player = this.player;
-      return document.pictureInPictureElement && document.pictureInPictureElement === player.media || player.media.webkitPresentationMode === PresentationMode.PIP;
+      return !!(this.isDocPIPAvailable() && (_documentPictureInPic2 = documentPictureInPicture) !== null && _documentPictureInPic2 !== void 0 && _documentPictureInPic2.window) || document.pictureInPictureElement && document.pictureInPictureElement === player.media || player.media.webkitPresentationMode === PresentationMode.PIP;
     }
   }, {
     key: "isPIPAvailable",
     value: function isPIPAvailable() {
       var video = this.player.media;
       var _isEnabled = util.typeOf(document.pictureInPictureEnabled) === "Boolean" ? document.pictureInPictureEnabled : true;
-      return _isEnabled && (util.typeOf(video.disablePictureInPicture) === "Boolean" && !video.disablePictureInPicture || video.webkitSupportsPresentationMode && util.typeOf(video.webkitSetPresentationMode) === "Function");
+      return _isEnabled && (util.typeOf(video.disablePictureInPicture) === "Boolean" && !video.disablePictureInPicture || video.webkitSupportsPresentationMode && util.typeOf(video.webkitSetPresentationMode) === "Function") || this.isDocPIPAvailable();
+    }
+  }, {
+    key: "isDocPIPAvailable",
+    value: function isDocPIPAvailable() {
+      return "documentPictureInPicture" in window && /^(https|file)/.test(location.protocol);
     }
   }, {
     key: "destroy",
@@ -10024,7 +10266,12 @@ var PIP = /* @__PURE__ */ function(_IconPlugin) {
       return {
         position: POSITIONS$1.CONTROLS_RIGHT,
         index: 6,
-        showIcon: false
+        showIcon: false,
+        preferDocument: false,
+        width: void 0,
+        height: void 0,
+        docPiPNode: void 0,
+        docPiPStyle: void 0
       };
     }
   }, {
@@ -12016,7 +12263,7 @@ class DefinitionPlugin extends OptionsIcon {
     }
     this._waitingStartTime = Date.now();
     const currentTime = this.player.currentTime;
-    this._timer = setTimeout(() => {
+    this._timer = window.setTimeout(() => {
       if (this.player && this.player.currentTime <= currentTime + 0.1) {
         this.player.emit(Events.LONG_WAITING);
         if (this.config.needFallback) {
@@ -12121,7 +12368,8 @@ const NAME_MAP = {
   "plugin:hls": "veplayer.plugin.hls.[env].[ext]",
   "plugin:shaka": "veplayer.plugin.shaka.[env].[ext]",
   "plugin:rtm": "veplayer.plugin.rtm.[env].[ext]",
-  "plugin:xgvideo": "veplayer.plugin.xgvideo.[env].[ext]"
+  "plugin:xgvideo": "veplayer.plugin.xgvideo.[env].[ext]",
+  "plugin:drm": "veplayer.plugin.drm.[env].[ext]"
 };
 var DynamicModule = /* @__PURE__ */ ((DynamicModule2) => {
   DynamicModule2["BizVod"] = "biz:vod";
@@ -12132,6 +12380,7 @@ var DynamicModule = /* @__PURE__ */ ((DynamicModule2) => {
   DynamicModule2["PluginShaka"] = "plugin:shaka";
   DynamicModule2["PluginRtm"] = "plugin:rtm";
   DynamicModule2["PluginXgvideo"] = "plugin:xgvideo";
+  DynamicModule2["PluginDrm"] = "plugin:drm";
   return DynamicModule2;
 })(DynamicModule || {});
 class Loader {
@@ -12175,13 +12424,13 @@ class Loader {
         src: src2 ?? moduleSrc,
         name,
         state: 0,
-        exports: {}
+        exports: { __PLUGIN_NAME__: name }
       };
       this.modules[name] = module;
       this.mountPromiseMap[name] = this._mount(module);
       return this.mountPromiseMap[name];
     });
-    __publicField(this, "register", (name, exports) => {
+    __publicField(this, "registerPlugin", (name, exports) => {
       if (!this._moduleSystem) {
         throw new Error(
           `You have to specify moduleSystem first, call setModuleSystem(moduleSystem) to set module system`
@@ -12208,6 +12457,11 @@ class Loader {
       }
       return this.modules[name].exports;
     });
+    __publicField(this, "register", (exports) => {
+      return exports.map((exportModule) => {
+        return this.registerPlugin(exportModule.__PLUGIN_NAME__, exportModule);
+      });
+    });
     this._baseUrl = options.baseUrl;
   }
   get baseUrl() {
@@ -12247,6 +12501,7 @@ const baseUrl = src.slice(0, src.lastIndexOf("/"));
 const loader = new Loader({
   baseUrl
 });
+loader.registerPlugin;
 const register2 = loader.register;
 function setModuleSystem(moduleSystem) {
   loader.setModuleSystem(moduleSystem);
@@ -12436,7 +12691,7 @@ class Autoplay extends Plugin {
   }
   wxCanPlayFn() {
     window.WeixinJSBridge && window.WeixinJSBridge.invoke("getNetworkType", {}, () => {
-      this._wxTimer = setTimeout(() => {
+      this._wxTimer = window.setTimeout(() => {
         this._wxTimer && clearTimeout(this._wxTimer);
         const ret = this.player.play();
         if (ret && ret.then) {
@@ -12510,8 +12765,8 @@ class Autoplay extends Plugin {
     this._state.showUnmuteBt = true;
     this._state.mode = 1;
     this.renderUnmuteBt();
-    this._timer = setTimeout(() => {
-      this._timer && clearTimeout(this._timer);
+    this._timer = window.setTimeout(() => {
+      this._timer && window.clearTimeout(this._timer);
       const ret = this.player.play();
       if (ret && ret.then) {
         ret.then(() => {
@@ -12983,7 +13238,10 @@ const transformOption = (options) => {
   return xgOptions;
 };
 class VePlayerBase {
-  /**
+  /** {zh}
+   * @hidden
+   */
+  /** {en}
    * @hidden
    */
   constructor(options = {}) {
@@ -13036,7 +13294,7 @@ class VePlayerBase {
     this._errorCallback = (err) => this._handleFallback(err);
     this._player.on(ERROR, this._errorCallback);
   }
-  /**
+  /** {zh}
    * @brief 获取视频的就绪状态，其状态枚举值、枚举名称和说明如下：
    * - `0`：HAVE_NOTHING，没有关于媒体资源的可用信息
    * - `1`：HAVE_METADATA，已检索到足够多的媒体资源来初始化元数据, 快进/快退不会引发异常
@@ -13044,68 +13302,107 @@ class VePlayerBase {
    * - `3`：HAVE_FUTURE_DATA，当前播放位置以及未来至少一小段时间的数据是可用的（至少有两帧以上的数据）
    * - `4`：HAVE_ENOUGH_DATA，有足够的数据可用，并且下载速率足够，媒体可以不间断地播放到最后
    */
+  /** {en}
+   * @brief Gets the readiness of the video.
+   * - `0`: HAVE_NOTHING, which means there is no information about the media resources.
+   * - `1`: HAVE_METADATA, which means enough media resources have been retrieved to initialize the metadata and fast-forward/rewind will not raise an exception.
+   * - `2`: HAVE_CURRENT_DATA, which means the data for the current playback position is available, but there is not enough data to play the next frame.
+   * - `3`: HAVE_FUTURE_DATA, which means there is enough data for the current playback position and at least a short period in the future (at least two following frames).
+   * - `4`: HAVE_ENOUGH_DATA, which means there is enough data and the download rate is sufficient for the video to be played without interruption until the end.
+   */
   get readyState() {
     return this._player.readyState;
   }
-  /**
+  /** {zh}
    * @brief 获取当前已缓冲的时间范围。
    */
+  /** {en}
+   * @brief Gets the currently buffered time range.
+   */
   get buffered() {
     return this._player.buffered;
   }
-  /**
+  /** {zh}
    * @brief 获取已经播放的音频/视频的时间范围。
    */
+  /** {en}
+   * @brief Gets the time range of the audio/video that has been played.
+   */
   get played() {
     return this._player.played;
   }
-  /**
+  /** {zh}
    * @brief 设置/获取视频当前的播放时间, 单位为 s。
    */
+  /** {en}
+   * @brief Sets or gets the current playback position of the video, in seconds.
+   */
   get cumulateTime() {
     return this._player.cumulateTime;
   }
-  /**
+  /** {zh}
    * @brief 获取是否处于焦点状态，处于焦点状态会显示控制栏。
    */
+  /** {en}
+   * @brief Gets whether the player has focus. The control bar is displayed when the player has focus.
+   */
   get isFocused() {
     return this._player.isActive;
   }
-  /**
+  /** {zh}
    * @brief 获取播放器是否处于全屏状态。
    */
+  /** {en}
+   * @brief Gets whether the player is in full-screen mode, in which the player covers the entire desktop.
+   */
   get isFullscreen() {
     return this._player.isFullscreen;
   }
-  /**
+  /** {zh}
    * @brief 获取播放器是否处于网页全屏状态。
    */
+  /** {en}
+   * @brief Gets whether the player is in full-window mode, in which the player covers the entire browser window.
+   */
   get isCssFullscreen() {
     return this._player.isCssfullScreen;
   }
-  /**
+  /** {zh}
    * @brief 获取视频的网络状态，其状态枚举值、枚举名称和说明如下：
    * - `0`：NETWORK_EMPTY，目前还没有数据，readyState 的值是 HAVE_NOTHING
    * - `1`：NETWORK_IDLE，HTMLMediaElement 处于活动状态并已选择资源，但未使用网络
    * - `2`：NETWORK_LOADING，浏览器正在下载 HTMLMediaElement 数据
    * - `3`：NETWORK_NO_SOURCE，未找到 HTMLMediaElement src。
    */
+  /** {en}
+   * @brief Gets the network condition of the video.
+   * - `0`: NETWORK_EMPTY, which means there is no data yet, and `readyState` is `HAVE_NOTHING`.
+   * - `1`: NETWORK_IDLE, which means the `HTMLMediaElement` element is active and the resources have been selected, but the network is not in use.
+   * - `2`: NETWORK_LOADING, which means the browser is downloading the data of the `HTMLMediaElement` element.
+   * - `3`: NETWORK_NO_SOURCE, the media source is not found according to the `src` property of the `HTMLMediaElement` element.
+   */
   get networkState() {
     return this._player.networkState;
   }
-  /**
+  /** {zh}
    * @brief 获取当前视频是否处于暂停状态。
    */
+  /** {en}
+   * @brief Gets whether the current video is suspended.
+   */
   get paused() {
     return this._player.paused;
   }
-  /**
+  /** {zh}
    * @brief 获取当前视频是否播放结束。
    */
+  /** {en}
+   * @brief Gets whether the current video has finished playing.
+   */
   get ended() {
     return this._player.ended;
   }
-  /**
+  /** {zh}
    * @brief 获取播放器当前所处的状态，其状态枚举值、枚举名称和说明如下：
    * - `0`：ERROR，播放出现错误
    * - `1`：INITIAL，初始化
@@ -13117,81 +13414,130 @@ class VePlayerBase {
    * - `7`：ENDED，播放结束
    * - `8`：DESTROYED，播放器实例处于已被销毁
    */
+  /** {en}
+   * @brief Gets the current state of the player.
+   * - `0`: ERROR, which means a playback error occurred
+   * - `1`: INITIAL, which means initialization
+   * - `2`: READY, which means the configuration/event/plug-in has been initialized/bound/instantiated
+   * - `3`: ATTACHING, which means the media object is being mounted.
+   * - `4`: ATTACHED, which means the media object has been mounted in the DOM
+   * - `5`: NOTALLOW, which means the playback is blocked
+   * - `6`: RUNNING, which means the playback has started successfully
+   * - `7`: ENDED, which means the playback has ended
+   * - `8`: DESTROYED, which means the player instance is destroyed
+   */
   get state() {
     return this._player.state;
   }
-  /**
+  /** {zh}
    * 获取当前播放视频的拉流地址。
    */
+  /** {en}
+   * Gets the current pull stream address.
+   */
   get url() {
     return this._player.config.url;
   }
-  /**
-   * @brief 获取当播放视频的线路名称唯一标识（name）。
+  /** {zh}
+   * @brief 获取当前播放视频的线路名称唯一标识（name）。
+   */
+  /** {en}
+   * @brief Gets the current playback source ID.
    */
   get source() {
     var _a;
     return (_a = this._sourceManager.source) == null ? void 0 : _a.name;
   }
-  /**
+  /** {zh}
    * @brief 获取当前播放视频的清晰度唯一标识（definition）。
    */
+  /** {en}
+   * @brief Gets the current resolution ID.
+   */
   get definition() {
     var _a;
     return (_a = this._sourceManager.definition) == null ? void 0 : _a.definition;
   }
-  /**
+  /** {zh}
    * @brief 获取和设置播放器的跨域配置信息，更多信息参考 [crossorigin](https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/crossorigin) 属性介绍。
    */
+  /** {en}
+   * @brief Gets the player's cross-domain configurations. For more information, refer to [crossorigin](https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/crossorigin).
+   */
   get crossOrigin() {
     return this._player.crossOrigin;
   }
-  /**
+  /** {zh}
    * @brief 获取和设置播放器的跨域配置信息，更多信息参考 [crossorigin](https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/crossorigin) 属性介绍。
    */
+  /** {en}
+   * @brief Sets the player's cross-domain configurations. For more information, refer to the [crossorigin](https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/crossorigin).
+   */
   set crossOrigin(crossOrigin) {
     this._player.crossOrigin = crossOrigin;
   }
-  /**
+  /** {zh}
    * @brief 获取和设置视频的音量，取值范围为 [0,1]。
    */
+  /** {en}
+   * @brief Gets the volume of the video. The value range is [0,1].
+   */
   // eslint-disable-next-line @typescript-eslint/member-ordering
   get volume() {
     return this._player.volume;
   }
-  /**
+  /** {zh}
    * @brief 获取和设置视频的音量，取值范围为 [0,1]。
    */
+  /** {en}
+   * @brief Sets the volume of the video. Valid range: [0,1].
+   */
   set volume(volume) {
     this._player.volume = volume;
   }
-  /**
+  /** {zh}
    * @brief 获取和设置视频静音状态。
    * - `true`：静音
    * - `false`：非静音
    */
+  /** {en}
+   * @brief Gets whether the video is muted.
+   * - `true`: Muted.
+   * - `false`: Not muted.
+   */
   // eslint-disable-next-line @typescript-eslint/member-ordering
   get muted() {
     return this._player.muted;
   }
-  /**
+  /** {zh}
    * @brief 获取和设置视频静音状态。
    * - `true`：静音
    * - `false`：非静音
    */
+  /** {en}
+   * @brief Mute or unmute the video.
+   * - `true`: Mute the video.
+   * - `false`: Unmute the video.
+   */
   set muted(isMuted) {
     this._player.muted = isMuted;
   }
-  /**
+  /** {zh}
    * @brief 获取和设置当前语言。
    */
+  /** {en}
+   * @brief Gets the current language.
+   */
   // eslint-disable-next-line @typescript-eslint/member-ordering
   get lang() {
     return this._i18nManager.getLang();
   }
-  /**
+  /** {zh}
    * @brief 获取和设置当前语言。
    */
+  /** {en}
+   * @brief Sets the current language.
+   */
   set lang(lang) {
     var _a, _b;
     if (this._player.lang === lang) {
@@ -13213,7 +13559,10 @@ class VePlayerBase {
   get _src() {
     return this._player.currentSrc;
   }
-  /**
+  /** {zh}
+   * @hidden
+   */
+  /** {en}
    * @hidden
    */
   static async create(options = {}, Constructor) {
@@ -13243,11 +13592,16 @@ class VePlayerBase {
       sourceManager
     });
   }
-  /**
+  /** {zh}
    * @brief 调用此方法切换拉流地址、线路、清晰度。
    * @param target 目标地址，可以是播放地址，也可以是线路和清晰度
    * @param options 更多配置信息
    */
+  /** {en}
+   * @brief Switches the pull stream address, playback source, or resolution.
+   * @param target The target pull stream address, playback source, or resolution.
+   * @param options More configurations.
+   */
   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) {
@@ -13264,20 +13618,31 @@ class VePlayerBase {
     await this._switch(targetDefinition);
     return targetDefinition;
   }
-  /**
+  /** {zh}
    * @brief 调用此方法更新拉流地址列表。
    * @param playlist 要更新的播放列表。
    * @param target 更新后默认播放的资源。
    */
+  /** {en}
+   * @brief Updates the list of pull stream addresses.
+   * @param Playlist The updated list.
+   * @param Target The default playback resource after the update.
+   */
   updatePlaylist(playlist, target) {
     const sourceManager = this._sourceManager.updateSources(playlist, target);
     return this._switch(sourceManager.definition);
   }
   // TODO: 等西瓜播放器完善错误码后增加函数重载以提供更好的类型
   /**
+  /** {zh}
    * @brief 调用此方法监听指定事件，事件处理函数只执行一次。
    * @param event 表示事件的名称。
-   * @param callback 表示事件的名称。
+   * @param callback 表示事件的回调函数。
+   */
+  /** {en}
+   * @brief Listens for a specified event. The event handler is executed only once.
+   * @param event The event name.
+   * @param callback The callback function for the event.
    */
   once(event, callback) {
     var _a;
@@ -13290,10 +13655,15 @@ class VePlayerBase {
       this._player.once(xgEventName, xgCallback);
     }
   }
-  /**
+  /** {zh}
    * @brief 调用此方法解绑或移除指定事件的事件监听。
    * @param event 表示事件的名称。
-   * @param callback 表示事件的名称。
+   * @param callback 表示事件的回调函数。
+   */
+  /** {en}
+   * @brief Stops listening for a specified event.
+   * @param event The event name.
+   * @param callback The callback function for the event.
    */
   off(event, callback) {
     var _a;
@@ -13304,26 +13674,39 @@ class VePlayerBase {
       this._events[event].delete(callback);
     }
   }
-  /**
+  /** {zh}
    * @brief 调用此方法触发指定事件。
    * @param event 表示事件的名称。
    * @param data 事件信息。
    */
+  /** {en}
+   * @brief Triggers a specified event.
+   * @param event The event name.
+   * @param data The event information.
+   */
   emit(event, data) {
     const { xgEventName } = this._transformEvent(event);
     this._player.emit(xgEventName, data);
   }
-  /**
+  /** {zh}
    * @brief 调用此方法解绑或移除指定事件的所有事件监听。
    */
+  /** {en}
+   * @brief Stops listening to any player event.
+   */
   offAll() {
     this._events = {};
     this._player.offAll();
   }
-  /**
+  /** {zh}
    * @brief 调用此方法监听指定事件。
-   * @param event 事件。
-   * @param callback 事件回调。
+   * @param event 表示事件名称。
+   * @param callback 表示事件的回调函数。
+   */
+  /** {en}
+   * @brief Listens for a specified event.
+   * @param event The event name.
+   * @param callback The callback function for the event.
    */
   on(event, callback) {
     var _a;
@@ -13336,102 +13719,153 @@ class VePlayerBase {
       this._player.on(xgEventName, xgCallback);
     }
   }
-  /**
+  /** {zh}
    * @brief 调用此方法开始播放 。
    */
+  /** {en}
+   * @brief Starts playback.
+   */
   play() {
     /* istanbul ignore next -- @preserve */
     return this._player.play();
   }
-  /**
+  /** {zh}
    * @brief 调用此方法暂停播放。
    */
+  /** {en}
+   * @brief Pauses playback.
+   */
   pause() {
     /* istanbul ignore next -- @preserve */
     return this._player.pause();
   }
-  /**
+  /** {zh}
    * @brief 调用此方法打开画中画。
    */
+  /** {en}
+   * @brief Turns on Picture-in-Picture (PIP).
+   */
   requestPIP() {
     var _a;
     /* istanbul ignore next -- @preserve */
     (_a = this._player.plugins.pip) == null ? void 0 : _a.requestPIP();
   }
-  /**
+  /** {zh}
    * @brief 调用此方法关闭画中画。
    */
+  /** {en}
+   * @brief Turns off Picture-in-Picture (PIP).
+   */
   exitPIP() {
     var _a;
     /* istanbul ignore next -- @preserve */
     (_a = this._player.plugins.pip) == null ? void 0 : _a.exitPIP();
   }
-  /**
+  /** {zh}
    * @brief 调用此方法重新拉流。
    */
+  /** {en}
+   * @brief Retries stream-pulling.
+   */
   retry() {
     return this._player.retry();
   }
-  /**
+  /** {zh}
    * @brief 播放器获取焦点，调用该方法 `veplayer.isFocused` 将会变为 `true`，并触发 `PLAYER_FOCUS` 事件。
    * @param data 播放器获取焦点配置信息。
    */
+  /** {en}
+   * @brief The player gets focus. When the method is called, `veplayer.isFocused` will become `true` and the `PLAYER_FOCUS` event will be triggered.
+   * @param data Related configurations.
+   */
   focus(data) {
     return this._player.focus(data);
   }
-  /**
+  /** {zh}
    * @brief 播放器失去焦点，调用该方法 `veplayer.isFocused` 将会变为 `false`，并触发 `PLAYER_BLUR` 事件。
    * @param data 播放器失去焦点配置信息。
    */
+  /** {en}
+   * @brief The player loses focus. When the method is called, `veplayer.isFocused` will become `false` and the `PLAYER_BLUR` event will be triggered.
+   * @param data The related configurations.
+   */
   blur(data) {
     return this._player.blur(data);
   }
-  /**
+  /** {zh}
    * @brief 调用此方法进入系统全屏状态。如果该方法调用的时候处于网页全屏状态会自动退出网页全屏，下发事件 `Events.FULLSCREEN_CHANGE`。
    * @param el 全屏作用的 DOM 节点。
    */
+  /** {en}
+   * @brief Turns the player into full-screen mode, in which the player covers the entire desktop. If the player is in full-window mode when the method is called, it will automatically exit full-window mode, and the `Events.FULLSCREEN_CHANGE` event will be triggered.
+   * @param el The DOM node in which the player is displayed in full-screen mode.
+   */
   requestFullscreen(el) {
     return this._player.getFullscreen(el);
   }
-  /**
+  /** {zh}
    * @brief 调用此方法退出系统全屏状态，调用该方法 `veplayer.isFullscreen` 将会变为 `false`，并触发 `Events.FULLSCREEN_CHANGE` 事件。
    * @param el 全屏作用的 DOM 节点。
    */
+  /** {en}
+   * @brief Exits full-screen mode. After the method is called, `veplayer.isFullscreen` will become `false` and the `Events.FULLSCREEN_CHANGE` event will be triggered.
+   * @param el The DOM node of the full screen effect.
+   */
   exitFullscreen(el) {
     return this._player.exitFullscreen(el);
   }
-  /**
+  /** {zh}
    * @brief 调用此方法进入网页样式全屏状态，播放器进入网页全屏，利用 CSS 模拟实现全屏效果。如果该接口调用的时候处于全屏状态，会自动退出全屏，下发事件 `Events.CSS_FULLSCREEN_CHANGE`。
    * @param el 全屏作用的 DOM 节点。
    */
+  /** {en}
+   * @brief Turns the player into full-window mode, in which the player covers the entire browser window. If the player is in full-screen mode when the method is called, it will automatically exit full-screen mode, and the `Events.CSS_FULLSCREEN_CHANGE` event will be triggered.
+   * @param el The DOM node in which the player is displayed in full-window mode.
+   */
   requestCssFullscreen(el) {
     return this._player.getCssFullscreen(el);
   }
-  /**
+  /** {zh}
    * @brief 调用此方法退出网页样式全屏状态。 调用该方法 `veplayer.isFullscreen` 将会变为 `false`，并触发 `Events.CSS_FULLSCREEN_CHANGE` 事件。
    */
+  /** {en}
+   * @brief Exits the full-window mode. When the method is called, `veplayer.isFullscreen` will become `false` and the `Events.CSS_FULLSCREEN_CHANGE` event will be triggered.
+   */
   exitCssFullscreen() {
     return this._player.exitCssFullscreen();
   }
-  /**
+  /** {zh}
    * @brief 调用此方法在当前播放器上注册指定插件。
    * @param plugin 插件构造函数。
    * @param config 插件的配置列表。
    */
+  /** {en}
+   * @brief Registers a specified plug-in to the current player.
+   * @param Plugin The plugin constructor.
+   * @param config The plugin configurations.
+   */
   registerPlugin(plugin, config) {
     return this._player.registerPlugin(plugin, config);
   }
-  /**
+  /** {zh}
    * @brief 调用此方法在当前播放器上销毁/注销指定插件。
    * @param plugin 插件实例或者插件名称。
    */
+  /** {en}
+   * @brief Destroys or unregisters a specified plugin from the player.
+   * @param Plugin The plugin instance or name.
+   */
   unRegisterPlugin(plugin) {
     return this._player.unRegisterPlugin(plugin);
   }
-  /**
+  /** {zh}
    * @brief 调用此接口显示指定插件图标。
    * @param pluginNames 插件名称
    */
+  /** {en}
+   * @brief Displays the icon of a specified plugin.
+   * @param PluginNames The plugin name.
+   */
   showIcon(pluginNames) {
     const morePlugin = this._player.getPlugin("more");
     pluginNames.forEach((pluginName) => {
@@ -13445,10 +13879,14 @@ class VePlayerBase {
       }
     });
   }
-  /**
+  /** {zh}
    * @brief 调用此接口隐藏指定插件图标。
    * @param pluginNames 插件名称
    */
+  /** {en}
+   * @brief Hides the icon of a specified plugin.
+   * @param PluginNames The plugin name.
+   */
   hideIcon(pluginNames) {
     const morePlugin = this._player.getPlugin("more");
     pluginNames.forEach((pluginName) => {
@@ -13462,14 +13900,20 @@ class VePlayerBase {
       }
     });
   }
-  /**
+  /** {zh}
    * @brief 调用此方法销毁播放器实例。
    */
+  /** {en}
+   * @brief Destroys the player instance.
+   */
   destroy() {
     this._player.off(ERROR, this._errorCallback);
     this._player.destroy();
   }
-  /**
+  /** {zh}
+   * @hidden
+   */
+  /** {en}
    * @hidden
    */
   async prepare(url) {