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

package/umd/veplayer.development.js

@@ -1461,7 +1461,7 @@ var __publicField = (obj, key, value) => {
       }
     }
   };
-  var version = "3.0.20-alpha.4";
+  var version = "3.0.21-rc.3";
   var ERROR_TYPE_MAP = {
     1: "media",
     2: "media",
@@ -2812,6 +2812,18 @@ var __publicField = (obj, key, value) => {
           }
         }
       }
+    }, {
+      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() {
@@ -3457,7 +3469,7 @@ var __publicField = (obj, key, value) => {
         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;
@@ -3486,16 +3498,17 @@ var __publicField = (obj, key, value) => {
           }
         });
         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 (e2) {
         }
-        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;
       }
@@ -3527,7 +3540,8 @@ var __publicField = (obj, key, value) => {
     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: {},
@@ -5119,7 +5133,7 @@ var __publicField = (obj, key, value) => {
           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(e2) {
@@ -5137,7 +5151,7 @@ var __publicField = (obj, key, value) => {
         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;
@@ -5478,7 +5492,7 @@ var __publicField = (obj, key, value) => {
         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;
@@ -6134,11 +6148,11 @@ var __publicField = (obj, key, value) => {
         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
         };
       }
@@ -6720,11 +6734,11 @@ var __publicField = (obj, key, value) => {
       } : error2;
       const message = (i18n == null ? void 0 : i18n.getText(errorInfo == null ? void 0 : errorInfo.messageTextKey)) ?? (errorInfo == null ? void 0 : errorInfo.message) ?? ((_a = errorInfo == null ? void 0 : errorInfo.error) == null ? void 0 : _a.message) ?? (i18n == null ? void 0 : i18n.getText("UNKNOWN"));
       super(message);
-      /**
+      /** {zh}
        * @brief 错误码。
        */
       /** {en}
-       * @brief The error code.
+       * @brief Error code.
        */
       __publicField(this, "errorCode");
       /** {zh}
@@ -8510,7 +8524,7 @@ var __publicField = (obj, key, value) => {
         }
         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;
           }
         });
@@ -8824,10 +8838,13 @@ var __publicField = (obj, key, value) => {
     }, {
       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) {
@@ -8888,12 +8905,12 @@ var __publicField = (obj, key, value) => {
     }, {
       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",
@@ -9762,7 +9779,7 @@ var __publicField = (obj, key, value) => {
     }, {
       key: "toggleFullScreen",
       value: function toggleFullScreen(e2) {
-        if (e2) {
+        if (e2 instanceof Event) {
           e2.preventDefault();
           e2.stopPropagation();
         }
@@ -10445,7 +10462,7 @@ var __publicField = (obj, key, value) => {
       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();
       }
     }, {
@@ -13577,28 +13594,33 @@ var __publicField = (obj, key, value) => {
       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
@@ -13618,7 +13640,9 @@ var __publicField = (obj, key, value) => {
       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
@@ -13813,9 +13837,14 @@ var __publicField = (obj, key, value) => {
     /** {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）。
@@ -13963,8 +13992,8 @@ var __publicField = (obj, key, value) => {
     }
     /** {zh}
      * @brief 调用此方法切换拉流地址、线路、清晰度。
-     * @param target 目标地址，可以是播放地址，也可以是线路和清晰度
-     * @param options 更多配置信息
+     * @param target 目标地址，可以是播放地址，也可以是线路和清晰度。
+     * @param options 更多配置信息。
      */
     /** {en}
      * @brief Switches the pull stream address, playback source, or resolution.
@@ -13975,7 +14004,9 @@ var __publicField = (obj, key, value) => {
       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);
@@ -14002,16 +14033,15 @@ var __publicField = (obj, key, value) => {
       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;
@@ -14162,10 +14192,14 @@ var __publicField = (obj, key, value) => {
       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);
     }
@@ -14237,7 +14271,7 @@ var __publicField = (obj, key, value) => {
     }
     /** {zh}
      * @brief 调用此接口显示指定插件图标。
-     * @param pluginNames 插件名称
+     * @param pluginNames 插件名称。
      */
     /** {en}
      * @brief Displays the icon of a specified plugin.
@@ -14258,7 +14292,7 @@ var __publicField = (obj, key, value) => {
     }
     /** {zh}
      * @brief 调用此接口隐藏指定插件图标。
-     * @param pluginNames 插件名称
+     * @param pluginNames 插件名称。
      */
     /** {en}
      * @brief Hides the icon of a specified plugin.
@@ -14330,7 +14364,14 @@ var __publicField = (obj, key, value) => {
       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
@@ -22067,9 +22108,9 @@ var __publicField = (obj, key, value) => {
         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"
         }
       });
@@ -22398,7 +22439,9 @@ var __publicField = (obj, key, value) => {
     }
   ]);
   const LIVE_DEFAULT_OPTIONS = {
-    autoplay: { muted: true }
+    autoplay: {
+      muted: true
+    }
   };
   const LIVE_DEFAULT_PLUGINS = [...DEFAULT_PLUGINS, Refresh, Logger, InfoPanel];
   var RTMCodec = /* @__PURE__ */ ((RTMCodec2) => {
@@ -22418,7 +22461,10 @@ var __publicField = (obj, key, value) => {
       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;
@@ -22477,7 +22523,10 @@ var __publicField = (obj, key, value) => {
       (_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;
@@ -22491,7 +22540,10 @@ var __publicField = (obj, key, value) => {
       }
     }
     /** {zh}
-     * @brief 关闭 Abr
+     * @brief 关闭码率自适应（ABR）切换功能。
+     */
+    /** {en}
+     * @brief Disable the Adaptive Bitrate Streaming (ABR) switching feature.
      */
     closeAbr() {
       var _a, _b, _c, _d;
@@ -22505,18 +22557,25 @@ var __publicField = (obj, key, value) => {
       }
     }
     /** {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)) {
@@ -22527,7 +22586,9 @@ var __publicField = (obj, key, value) => {
         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") {
@@ -22535,25 +22596,34 @@ var __publicField = (obj, key, value) => {
       }
     }
     /** {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();
@@ -22565,7 +22635,10 @@ var __publicField = (obj, key, value) => {
     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 ?? []]
@@ -22583,9 +22656,24 @@ var __publicField = (obj, key, value) => {
         },
         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 ?? {};