@volcengine/veplayer 2.5.0-rc.1 → 2.6.0-rc.0

package/esm/veplayer.development.js

@@ -1457,7 +1457,7 @@ var sniffer$1 = {
     }
   }
 };
-var version = "3.0.20-alpha.4";
+var version = "3.0.21-rc.3";
 var ERROR_TYPE_MAP = {
   1: "media",
   2: "media",
@@ -2808,6 +2808,18 @@ var BasePlugin = /* @__PURE__ */ function() {
         }
       }
     }
+  }, {
+    key: "defineMethod",
+    value: function defineMethod(Obj, map) {
+      for (var key in map) {
+        if (Object.prototype.hasOwnProperty.call(map, key) && typeof map[key] === "function") {
+          Object.defineProperty(Obj, key, {
+            configurable: true,
+            value: map[key]
+          });
+        }
+      }
+    }
   }, {
     key: "defaultConfig",
     get: function get() {
@@ -3453,7 +3465,7 @@ var ResizeObserver = /* @__PURE__ */ function() {
       if (!this.observer) {
         return;
       }
-      this.observer && this.observer.observe(target);
+      this.observer.observe(target);
       var _pid = target.getAttribute(PLATER_ID);
       var __handlers = this.__handlers;
       var index = -1;
@@ -3482,16 +3494,17 @@ var ResizeObserver = /* @__PURE__ */ function() {
         }
       });
       try {
-        this.observer && this.observer.unobserve(target);
+        var _this$observer;
+        (_this$observer = this.observer) === null || _this$observer === void 0 ? void 0 : _this$observer.unobserve(target);
       } catch (e3) {
       }
-      this.observer && this.observer.unobserve(target);
       i2 > -1 && this.__handlers.splice(i2, 1);
     }
   }, {
     key: "destroyObserver",
     value: function destroyObserver() {
-      this.observer && this.observer.disconnect();
+      var _this$observer2;
+      (_this$observer2 = this.observer) === null || _this$observer2 === void 0 ? void 0 : _this$observer2.disconnect();
       this.observer = null;
       this.__handlers = null;
     }
@@ -3523,7 +3536,8 @@ function addObserver(target, handler) {
   return resizeObserver;
 }
 function unObserver(target, handler) {
-  resizeObserver.unObserver(target, handler);
+  var _resizeObserver;
+  (_resizeObserver = resizeObserver) === null || _resizeObserver === void 0 ? void 0 : _resizeObserver.unObserver(target, handler);
 }
 var pluginsManager = {
   pluginGroup: {},
@@ -5115,7 +5129,7 @@ var Player = /* @__PURE__ */ function(_MediaProxy) {
         if (!url) {
           url = _this8.url || _this8.config.url;
         }
-        var _furl = _this8._preProcessUrl(url);
+        var _furl = _this8.preProcessUrl(url);
         var ret = _this8._startInit(_furl.url);
         return ret;
       }).catch(function(e3) {
@@ -5133,7 +5147,7 @@ var Player = /* @__PURE__ */ function(_MediaProxy) {
       if (util$1.typeOf(url) === "Object") {
         _src = url.url;
       }
-      _src = this._preProcessUrl(_src).url;
+      _src = this.preProcessUrl(_src).url;
       var curTime = this.currentTime;
       this.__startTime = curTime;
       var isPaused = this.paused && !this.isError;
@@ -5474,7 +5488,7 @@ var Player = /* @__PURE__ */ function(_MediaProxy) {
       runHooks(this, "retry", function() {
         var cur = _this20.currentTime;
         var url = _this20.config.url;
-        var _srcRet = !util$1.isMSE(_this20.media) ? _this20._preProcessUrl(url) : {
+        var _srcRet = !util$1.isMSE(_this20.media) ? _this20.preProcessUrl(url) : {
           url
         };
         _this20.src = _srcRet.url;
@@ -6130,11 +6144,11 @@ var Player = /* @__PURE__ */ function(_MediaProxy) {
       this._state = newState;
     }
   }, {
-    key: "_preProcessUrl",
-    value: function _preProcessUrl(url, ext) {
-      var _this$config7 = this.config, preProcessUrl = _this$config7.preProcessUrl, preProcessUrlOptions = _this$config7.preProcessUrlOptions;
+    key: "preProcessUrl",
+    value: function preProcessUrl(url, ext) {
+      var _this$config7 = this.config, preProcessUrl2 = _this$config7.preProcessUrl, preProcessUrlOptions = _this$config7.preProcessUrlOptions;
       var processUrlOptions = Object.assign({}, preProcessUrlOptions, ext);
-      return !util$1.isBlob(url) && typeof preProcessUrl === "function" ? preProcessUrl(url, processUrlOptions) : {
+      return !util$1.isBlob(url) && typeof preProcessUrl2 === "function" ? preProcessUrl2(url, processUrlOptions) : {
         url
       };
     }
@@ -6716,11 +6730,11 @@ let VeError$1 = 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);
-    /**
+    /** {zh}
      * @brief 错误码。
      */
     /** {en}
-     * @brief The error code.
+     * @brief Error code.
      */
     __publicField(this, "errorCode");
     /** {zh}
@@ -8506,7 +8520,7 @@ var MobilePlugin = /* @__PURE__ */ function(_Plugin) {
       }
       this.on(DURATION_CHANGE, function() {
         var player2 = _this2.player, config2 = _this2.config;
-        if (player2.duration * 1e3 < config2.moveDuration) {
+        if (player2.duration > 0 && player2.duration * 1e3 < config2.moveDuration) {
           config2.moveDuration = player2.duration * 1e3;
         }
       });
@@ -8820,10 +8834,13 @@ var MobilePlugin = /* @__PURE__ */ function(_Plugin) {
   }, {
     key: "updateBrightness",
     value: function updateBrightness(percent) {
+      var pos = this.pos, config = this.config, xgMask = this.xgMask;
+      if (!config.darkness) {
+        return;
+      }
       if (this.player.rotateDeg) {
         percent = -percent;
       }
-      var pos = this.pos, config = this.config, xgMask = this.xgMask;
       var light = pos.light + 0.8 * percent;
       light = light > config.maxDarkness ? config.maxDarkness : light < 0 ? 0 : light;
       if (xgMask) {
@@ -8884,12 +8901,12 @@ var MobilePlugin = /* @__PURE__ */ function(_Plugin) {
   }, {
     key: "disableGesture",
     value: function disableGesture() {
-      this.config.disableGesture = false;
+      this.config.disableGesture = true;
     }
   }, {
     key: "enableGesture",
     value: function enableGesture() {
-      this.config.disableGesture = true;
+      this.config.disableGesture = false;
     }
   }, {
     key: "destroy",
@@ -9758,7 +9775,7 @@ var Fullscreen = /* @__PURE__ */ function(_IconPlugin) {
   }, {
     key: "toggleFullScreen",
     value: function toggleFullScreen(e3) {
-      if (e3) {
+      if (e3 instanceof Event) {
         e3.preventDefault();
         e3.stopPropagation();
       }
@@ -10441,7 +10458,7 @@ var PIP = /* @__PURE__ */ function(_IconPlugin) {
     key: "isPIPAvailable",
     value: function isPIPAvailable() {
       var video = this.player.media;
-      var _isEnabled = util$1.typeOf(document.pictureInPictureEnabled) === "Boolean" ? document.pictureInPictureEnabled : true;
+      var _isEnabled = util$1.typeOf(document.pictureInPictureEnabled) === "Boolean" ? document.pictureInPictureEnabled : false;
       return _isEnabled && (util$1.typeOf(video.disablePictureInPicture) === "Boolean" && !video.disablePictureInPicture || video.webkitSupportsPresentationMode && util$1.typeOf(video.webkitSetPresentationMode) === "Function") || this.isDocPIPAvailable();
     }
   }, {
@@ -13573,28 +13590,33 @@ const DEFAULT_OPTIONS = {
     useCssFullscreen: false
   }
 };
-const transformOption = (options) => {
-  const { autoplay: autoplay2, ...rest } = options;
-  const xgOptions = rest;
-  if (xgOptions.poster) {
-    xgOptions.poster = escapeHtml(xgOptions.poster);
-  }
-  xgOptions.icons = {
-    ...DEFAULT_ICONS,
-    ...xgOptions.icons ? escapeIcons(xgOptions.icons) : {}
-  };
-  xgOptions.autoplay = Boolean(autoplay2);
-  if (autoplay2 && typeof autoplay2 !== "boolean") {
-    xgOptions.autoplayMuted = autoplay2 == null ? void 0 : autoplay2.muted;
-    xgOptions.videoAttributes = {
-      ...xgOptions.videoAttributes ?? {},
-      muted: autoplay2 == null ? void 0 : autoplay2.muted
+const transformOption = (
+  /** {zh}
+   * @param options 更多配置信息。
+   */
+  (options) => {
+    const { autoplay: autoplay2, ...rest } = options;
+    const xgOptions = rest;
+    if (xgOptions.poster) {
+      xgOptions.poster = escapeHtml(xgOptions.poster);
+    }
+    xgOptions.icons = {
+      ...DEFAULT_ICONS,
+      ...xgOptions.icons ? escapeIcons(xgOptions.icons) : {}
     };
-    xgOptions.autoplayPlugin = autoplay2;
+    xgOptions.autoplay = Boolean(autoplay2);
+    if (autoplay2 && typeof autoplay2 !== "boolean") {
+      xgOptions.autoplayMuted = autoplay2 == null ? void 0 : autoplay2.muted;
+      xgOptions.videoAttributes = {
+        ...xgOptions.videoAttributes ?? {},
+        muted: autoplay2 == null ? void 0 : autoplay2.muted
+      };
+      xgOptions.autoplayPlugin = autoplay2;
+    }
+    delete xgOptions.i18n;
+    return xgOptions;
   }
-  delete xgOptions.i18n;
-  return xgOptions;
-};
+);
 class VePlayerBase {
   /** {zh}
    * @hidden
@@ -13614,7 +13636,9 @@ class VePlayerBase {
     this._sourceManager = options.sourceManager;
     this._preparePlugins = options.preparePlugins;
     this._previousPrepareResult = options.prepareResult;
-    this._i18nManager = options.i18nManager ?? new VeI18n({ i18n: options.i18n });
+    this._i18nManager = options.i18nManager ?? new VeI18n({
+      i18n: options.i18n
+    });
     const xgOptions = transformOption({
       ...options,
       ...(_a = this._previousPrepareResult) == null ? void 0 : _a.options
@@ -13809,9 +13833,14 @@ class VePlayerBase {
   /** {zh}
    * 获取播放器版本号
    * @returns
+   * @brief
+   *        获取播放器 SDK 版本号。
+   */
+  /** {en}
+   * @brief Retrieve the player SDK version number.
    */
   get playerVersion() {
-    return "2.5.0-rc.1";
+    return "2.6.0-rc.0";
   }
   /** {zh}
    * @brief 获取当前播放视频的清晰度唯一标识（definition）。
@@ -13959,8 +13988,8 @@ class VePlayerBase {
   }
   /** {zh}
    * @brief 调用此方法切换拉流地址、线路、清晰度。
-   * @param target 目标地址，可以是播放地址，也可以是线路和清晰度
-   * @param options 更多配置信息
+   * @param target 目标地址，可以是播放地址，也可以是线路和清晰度。
+   * @param options 更多配置信息。
    */
   /** {en}
    * @brief Switches the pull stream address, playback source, or resolution.
@@ -13971,7 +14000,9 @@ class VePlayerBase {
     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, { seamless: options == null ? void 0 : options.seamless });
+      await this._switchUrl(target, {
+        seamless: options == null ? void 0 : options.seamless
+      });
       return this._sourceManager.definition;
     }
     const targetDefinition = this._sourceManager.find(target, options);
@@ -13998,16 +14029,15 @@ class VePlayerBase {
     return this._switch(sourceManager.definition);
   }
   // TODO: 等西瓜播放器完善错误码后增加函数重载以提供更好的类型
-  /**
   /** {zh}
    * @brief 调用此方法监听指定事件，事件处理函数只执行一次。
    * @param event 表示事件的名称。
    * @param callback 表示事件的回调函数。
    */
   /** {en}
-   * @brief Add a one-time listener function for the specified event.
-   * @param event The event name.
-   * @param callback The callback function for the event.
+   * @brief Call this method to listen for the specified event. The event handler is executed only once.
+   * @param event The name representing the event.
+   * @param callback Callback functions representing events.
    */
   once(event, callback) {
     var _a;
@@ -14158,10 +14188,14 @@ class VePlayerBase {
     return this._player.blur(data);
   }
   /** {zh}
-   * @brief 判断浏览器是否支持播放格式
-   * @param type 播放格式
+   * @brief 判断浏览器是否支持播放格式。
+   * @param type 播放格式。
    * @returns
    */
+  /** {en}
+   * @brief Determine whether the browser supports the playback format.
+   * @param type The playback format.
+   */
   canPlayType(type) {
     return this._player.canPlayType(type);
   }
@@ -14233,7 +14267,7 @@ class VePlayerBase {
   }
   /** {zh}
    * @brief 调用此接口显示指定插件图标。
-   * @param pluginNames 插件名称
+   * @param pluginNames 插件名称。
    */
   /** {en}
    * @brief Displays the icon of a specified plugin.
@@ -14254,7 +14288,7 @@ class VePlayerBase {
   }
   /** {zh}
    * @brief 调用此接口隐藏指定插件图标。
-   * @param pluginNames 插件名称
+   * @param pluginNames 插件名称。
    */
   /** {en}
    * @brief Hides the icon of a specified plugin.
@@ -14326,7 +14360,14 @@ class VePlayerBase {
     this._player.once("canplay", () => {
       this._sourceManager.resetFallback();
     });
-    this.emit(Events$1.FALLBACK, { from: { url: preUrl }, to: { url } });
+    this.emit(Events$1.FALLBACK, {
+      from: {
+        url: preUrl
+      },
+      to: {
+        url
+      }
+    });
     this._switchUrl(url);
   }
   // eslint-disable-next-line @typescript-eslint/no-explicit-any
@@ -22063,9 +22104,9 @@ class Logger extends Plugin {
       user_id: this._userId,
       device_id: this._deviceId,
       ext: {
-        veplayer_version: "2.5.0-rc.1",
-        flv_version: "3.0.19-rc.0",
-        hls_version: "3.0.20-alpha.2",
+        veplayer_version: "2.6.0-rc.0",
+        flv_version: "3.0.21-rc.3",
+        hls_version: "3.0.21-rc.3",
         rts_version: "0.2.1-alpha.0"
       }
     });
@@ -22394,7 +22435,9 @@ VeI18n.extend([
   }
 ]);
 const LIVE_DEFAULT_OPTIONS = {
-  autoplay: { muted: true }
+  autoplay: {
+    muted: true
+  }
 };
 const LIVE_DEFAULT_PLUGINS = [...DEFAULT_PLUGINS, Refresh, Logger, InfoPanel];
 var RTMCodec = /* @__PURE__ */ ((RTMCodec2) => {
@@ -22414,7 +22457,10 @@ class VePlayerLive extends VePlayerBase {
     super(options);
   }
   /** {zh}
-   * @brief 获取已经播放的时间
+   * @brief 获取已经播放的时长，不包含暂停和等待时间，单位为秒。
+   */
+  /** {en}
+   * @brief Obtain the duration that has been played, excluding pause and waiting time, with the unit of seconds.
    */
   get playTime() {
     var _a, _b, _c, _d;
@@ -22473,7 +22519,10 @@ class VePlayerLive extends VePlayerBase {
     (_a = this._player.plugins) == null ? void 0 : _a.infopanel.close();
   }
   /** {zh}
-   * @brief 打开 Abr
+   * @brief 打开码率自适应（ABR）切换功能。
+   */
+  /** {en}
+   * @brief Enable the Adaptive Bitrate Streaming (ABR) switching feature.
    */
   openAbr() {
     var _a, _b, _c, _d;
@@ -22487,7 +22536,10 @@ class VePlayerLive extends VePlayerBase {
     }
   }
   /** {zh}
-   * @brief 关闭 Abr
+   * @brief 关闭码率自适应（ABR）切换功能。
+   */
+  /** {en}
+   * @brief Disable the Adaptive Bitrate Streaming (ABR) switching feature.
    */
   closeAbr() {
     var _a, _b, _c, _d;
@@ -22501,18 +22553,25 @@ class VePlayerLive extends VePlayerBase {
     }
   }
   /** {zh}
-   * @brief 调用此方法更新 DRM 鉴权配置。
-   * @hidden
+   * @brief 调用此方法更新 DRM 配置。
+   */
+  /** {en}
+   * @brief Use this method to update DRM configuration.
+   * @param config
    */
   updateDrmConfig(config) {
     var _a, _b, _c;
     (_c = (_b = (_a = this._player) == null ? void 0 : _a.plugins) == null ? void 0 : _b.drm) == null ? void 0 : _c.updateDrmConfig(config);
   }
   /** {zh}
-   * @brief 切换 flv Abr
-   * @param options 切换 Abr 的配置。
+   * @brief 修改 ABR 配置，包含修改是否开启 ABR 功能，和修改其他清晰度。
+   * @param options ABR 的配置。
    * @returns
    */
+  /** {en}
+   * @brief Modify ABR configuration, including enabling or disabling the ABR feature and adjusting other resolutions.
+   * @param options Configuration of ABR.
+   */
   switchAbr(options) {
     var _a, _b;
     if (!((_a = this._player.plugins) == null ? void 0 : _a.abr)) {
@@ -22523,7 +22582,9 @@ class VePlayerLive extends VePlayerBase {
       if (!url) {
         return;
       }
-      this.switch(url, { seamless: true });
+      this.switch(url, {
+        seamless: true
+      });
       this._player.plugins.abr.bitrate = options.bitrate;
     }
     if (typeof (options == null ? void 0 : options.enable) !== "undefined") {
@@ -22531,25 +22592,34 @@ class VePlayerLive extends VePlayerBase {
     }
   }
   /** {zh}
-   * @brief 获取 RTM 的网络相关信息
+   * @brief 获取 RTM 拉流的网络评估信息。
    * @returns
    */
+  /** {en}
+   * @brief Obtain the network assessment information of RTM pull streaming.
+   */
   getRTMNetWorkInfo() {
     var _a, _b, _c;
     return (_c = (_b = (_a = this._player) == null ? void 0 : _a.plugins) == null ? void 0 : _b.rts) == null ? void 0 : _c.getNetWorkInfo();
   }
   /** {zh}
-   * @brief 获取 RTM 播放信息
+   * @brief 获取 RTM 拉流的播放信息。
    * @returns
    */
+  /** {en}
+   * @brief Obtain the playback information of RTM pull stream.
+   */
   async getRTMStats() {
     var _a, _b, _c;
     return (_c = (_b = (_a = this._player) == null ? void 0 : _a.plugins) == null ? void 0 : _b.rts) == null ? void 0 : _c.getStatsSnapshoot();
   }
   /** {zh}
-   * @brief 获取 FLV 播放信息
+   * @brief 获取 FLV 拉流的播放信息。
    * @returns
    */
+  /** {en}
+   * @brief Obtain the playback information of FLV pull streaming.
+   */
   getFLVStats() {
     var _a, _b, _c;
     return (_c = (_b = (_a = this._player) == null ? void 0 : _a.plugins) == null ? void 0 : _b.flv) == null ? void 0 : _c.getStats();
@@ -22561,7 +22631,10 @@ async function createLivePlayer(options) {
   if (!options || !options.url && !options.playlist) {
     throw create(ErrorCode.INVALID_PARAMETER, new VeI18n());
   }
-  const i18n = new VeI18n({ lang: options == null ? void 0 : options.lang, i18n: options == null ? void 0 : options.i18n });
+  const i18n = new VeI18n({
+    lang: options == null ? void 0 : options.lang,
+    i18n: options == null ? void 0 : options.i18n
+  });
   const finalOptions = {
     ...options,
     plugins: [...LIVE_DEFAULT_PLUGINS, ...options.plugins ?? []]
@@ -22579,9 +22652,24 @@ async function createLivePlayer(options) {
       },
       async preparePlugins(url) {
         const [typeStrategy, drmStrategy, abrStrategy] = await Promise.all([
-          getTypeStrategy({ ...finalOptions, url }, player),
-          getDrmStrategy({ ...finalOptions, url }, player),
-          getAbrStrategy({ ...finalOptions, url })
+          getTypeStrategy(
+            {
+              ...finalOptions,
+              url
+            },
+            player
+          ),
+          getDrmStrategy(
+            {
+              ...finalOptions,
+              url
+            },
+            player
+          ),
+          getAbrStrategy({
+            ...finalOptions,
+            url
+          })
         ]);
         const { options: options2, plugins } = typeStrategy ?? {};
         const { options: drmOptions, plugins: drmPlugins } = drmStrategy ?? {};