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

package/esm/veplayer.biz.live.development.js

@@ -2991,8 +2991,8 @@ class Logger extends Plugin$2 {
       device_id: this._deviceId,
       ext: {
         veplayer_version: "2.3.1-rc.1",
-        flv_version: "3.0.19-rc.0",
-        hls_version: "3.0.20-alpha.2",
+        flv_version: "3.0.21-rc.3",
+        hls_version: "3.0.21-rc.3",
         rts_version: "0.2.1-alpha.0"
       }
     });
@@ -3361,7 +3361,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) => {
@@ -3381,7 +3383,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;
@@ -3440,7 +3445,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;
@@ -3454,7 +3462,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;
@@ -3468,18 +3479,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)) {
@@ -3490,7 +3508,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") {
@@ -3498,25 +3518,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();
@@ -3528,7 +3557,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 ?? []]
@@ -3546,9 +3578,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 ?? {};