@byteplus/veplayer 2.12.1 → 2.13.1-rc.0

package/umd/veplayer.d.ts

@@ -6217,6 +6217,7 @@ interface PrepareOptions {
     logger?: LoggerConfig;
 }
 interface LiveEN {
+    INVALID_PARAMETER: string;
     ERROR_TYPES?: any;
     // eslint-disable-next-line @typescript-eslint/member-ordering
     [key: string]: string | unknown;
@@ -7058,9 +7059,11 @@ interface Rtm {
     checkStatsErrorDelay?: number;
     /** {zh}
      * @brief 是否打开 RTM SEI
+     * @default true
      */
     /** {en}
      * @brief enable RTM SEI data.
+     * @default true
      */
     enableSei?: boolean;
 }
@@ -7305,6 +7308,32 @@ interface RTMNetWorkInfo {
      */
     avgLostRate?: number;
 }
+/** {zh}
+ * @list option
+ * @kind property
+ * @brief 服务端 SEI 延迟统计。
+ */
+/** {en}
+ * @list option
+ * @kind property
+ * @brief Server SEI delay statistics.
+ */
+interface SEIDelayStats {
+    /** {zh}
+     * @brief 服务端链路延迟，单位为毫秒。没有有效的服务端 SEI 数据时为空。
+     */
+    /** {en}
+     * @brief Server-side transfer delay in milliseconds. Empty when valid server SEI data is unavailable.
+     */
+    delay_s2s?: number;
+    /** {zh}
+     * @brief 推流端到播放端的延迟，单位为毫秒。没有有效的服务端 SEI 数据时为空。
+     */
+    /** {en}
+     * @brief Stream-to-end playback delay in milliseconds. Empty when valid server SEI data is unavailable.
+     */
+    delay_s2e?: number;
+}
 /** {zh}
  * @list option
  * @kind property
@@ -7315,7 +7344,7 @@ interface RTMNetWorkInfo {
  * @kind property
  * @brief RTM live stream information.
  */
-interface StatsSnapShoot {
+interface StatsSnapShoot extends SEIDelayStats {
     /** {en}
      * @brief Video information.
      */
@@ -7546,7 +7575,7 @@ interface StatsSnapShoot {
  * @kind property
  * @brief Basic information for live stream playback.
  */
-interface Stats$0 {
+interface Stats$0 extends SEIDelayStats {
     /** {zh}
      * @brief 音频格式。
      * @hidden
@@ -7704,6 +7733,7 @@ declare class VePlayerLive extends VePlayerBase {
      * @hidden
      */
     _protocolManager?: ProtocolManager;
+    private _seiDelayStats;
     /** {zh}
      * @hidden
      * @param options
@@ -7734,6 +7764,13 @@ declare class VePlayerLive extends VePlayerBase {
      * @hidden
      */
     get hls(): any;
+    /** {zh}
+     * @hidden
+     */
+    /** {en}
+     * @hidden
+     */
+    destroy(): void;
     /** {zh}
      * @brief 调用此方法开启直播日志上报。
      */
@@ -7886,6 +7923,10 @@ declare class VePlayerLive extends VePlayerBase {
          */
         source?: string;
     }, needUpdateProtocol?: boolean): Promise<void>;
+    private _resetSEIDelayStats;
+    private _handleSEI;
+    private _getPlayerBufferTime;
+    private _mergeSEIDelayStats;
 }
 /** {zh}
  * @detail api
@@ -11539,6 +11580,7 @@ declare namespace live {
         logger?: LoggerConfig;
     }
     interface LiveEN {
+        INVALID_PARAMETER: string;
         ERROR_TYPES?: any;
         // eslint-disable-next-line @typescript-eslint/member-ordering
         [key: string]: string | unknown;
@@ -12390,9 +12432,11 @@ declare namespace live {
         checkStatsErrorDelay?: number;
         /** {zh}
          * @brief 是否打开 RTM SEI
+         * @default true
          */
         /** {en}
          * @brief enable RTM SEI data.
+         * @default true
          */
         enableSei?: boolean;
     }
@@ -12637,6 +12681,32 @@ declare namespace live {
          */
         avgLostRate?: number;
     }
+    /** {zh}
+     * @list option
+     * @kind property
+     * @brief 服务端 SEI 延迟统计。
+     */
+    /** {en}
+     * @list option
+     * @kind property
+     * @brief Server SEI delay statistics.
+     */
+    interface SEIDelayStats {
+        /** {zh}
+         * @brief 服务端链路延迟，单位为毫秒。没有有效的服务端 SEI 数据时为空。
+         */
+        /** {en}
+         * @brief Server-side transfer delay in milliseconds. Empty when valid server SEI data is unavailable.
+         */
+        delay_s2s?: number;
+        /** {zh}
+         * @brief 推流端到播放端的延迟，单位为毫秒。没有有效的服务端 SEI 数据时为空。
+         */
+        /** {en}
+         * @brief Stream-to-end playback delay in milliseconds. Empty when valid server SEI data is unavailable.
+         */
+        delay_s2e?: number;
+    }
     /** {zh}
      * @list option
      * @kind property
@@ -12647,7 +12717,7 @@ declare namespace live {
      * @kind property
      * @brief RTM live stream information.
      */
-    interface StatsSnapShoot {
+    interface StatsSnapShoot extends SEIDelayStats {
         /** {en}
          * @brief Video information.
          */
@@ -12878,7 +12948,7 @@ declare namespace live {
      * @kind property
      * @brief Basic information for live stream playback.
      */
-    interface Stats$0 {
+    interface Stats$0 extends SEIDelayStats {
         /** {zh}
          * @brief 音频格式。
          * @hidden
@@ -13036,6 +13106,7 @@ declare namespace live {
          * @hidden
          */
         _protocolManager?: ProtocolManager;
+        private _seiDelayStats;
         /** {zh}
          * @hidden
          * @param options
@@ -13066,6 +13137,13 @@ declare namespace live {
          * @hidden
          */
         get hls(): any;
+        /** {zh}
+         * @hidden
+         */
+        /** {en}
+         * @hidden
+         */
+        destroy(): void;
         /** {zh}
          * @brief 调用此方法开启直播日志上报。
          */
@@ -13218,6 +13296,10 @@ declare namespace live {
              */
             source?: string;
         }, needUpdateProtocol?: boolean): Promise<void>;
+        private _resetSEIDelayStats;
+        private _handleSEI;
+        private _getPlayerBufferTime;
+        private _mergeSEIDelayStats;
     }
     /** {zh}
      * @detail api

package/umd/veplayer.development.js

@@ -14715,7 +14715,7 @@ var __publicField = (obj, key, value) => {
      * @brief Retrieve the player SDK version number.
      */
     get playerVersion() {
-      return "2.12.1";
+      return "2.13.1-rc.0";
     }
     /** {zh}
      * @brief 获取当前播放视频的清晰度唯一标识（definition）。
@@ -56510,7 +56510,7 @@ MediaSource ${JSON.stringify(attachMediaSourceData)} from ${logFromSource}`);
         device_id: deviceId,
         error_report_stop: true,
         ext: {
-          veplayer_version: "2.12.1",
+          veplayer_version: "2.13.1-rc.0",
           flv_version: "3.0.24-rc.6",
           hls_version: "3.0.24-rc.2",
           rts_version: "0.2.1-alpha.64"
@@ -56524,7 +56524,6 @@ MediaSource ${JSON.stringify(attachMediaSourceData)} from ${logFromSource}`);
     return transform2 ? transform2(value) : value.toString();
   }
   function getDefaultRow(data2) {
-    var _a;
     return {
       rows: [
         {
@@ -56565,7 +56564,10 @@ MediaSource ${JSON.stringify(attachMediaSourceData)} from ${logFromSource}`);
         {
           key: "bufferEnd",
           labelTextKey: "BUFFER_END",
-          value: normalizeNumber(Number((_a = data2.bufferEnd) == null ? void 0 : _a.toFixed(2)))
+          value: normalizeNumber(
+            data2.bufferEnd,
+            (value) => Number(value.toFixed(2)).toString()
+          )
         },
         {
           key: "currentTime",
@@ -73907,6 +73909,79 @@ MediaSource ${JSON.stringify(attachMediaSourceData)} from ${logFromSource}`);
     }
   }
   const liveVeStrategy = new LiveVeStrategy();
+  const isNumber = (value) => typeof value === "number" && Number.isFinite(value);
+  const getTimestamp = (delaySEI, currentKey, legacyKey) => {
+    const currentValue = delaySEI[currentKey];
+    if (isNumber(currentValue)) {
+      return currentValue;
+    }
+    const legacyValue = delaySEI[legacyKey];
+    return isNumber(legacyValue) ? legacyValue : void 0;
+  };
+  const utf8ArrayToString = (array) => {
+    let result = "";
+    let index = 0;
+    while (index < array.length) {
+      const first = array[index++];
+      if (first < 128) {
+        result += String.fromCharCode(first);
+      } else if (first < 224) {
+        const second = array[index++];
+        result += String.fromCharCode((first & 31) << 6 | second & 63);
+      } else {
+        const second = array[index++];
+        const third = array[index++];
+        result += String.fromCharCode(
+          (first & 15) << 12 | (second & 63) << 6 | third & 63
+        );
+      }
+    }
+    return result;
+  };
+  const getSEIDelayStats = (sei, bufferTime = 0, now3 = Date.now()) => {
+    if ((sei == null ? void 0 : sei.code) !== 100 || !sei.content) {
+      return;
+    }
+    try {
+      const rawSEI = utf8ArrayToString(sei.content);
+      const jsonStart = rawSEI.indexOf("{");
+      const jsonEnd = rawSEI.lastIndexOf("}");
+      if (jsonStart < 0 || jsonEnd < jsonStart) {
+        return;
+      }
+      const seiContent = JSON.parse(rawSEI.slice(jsonStart, jsonEnd + 1));
+      const delaySEI = seiContent == null ? void 0 : seiContent.video_e2e_delay;
+      if (!delaySEI || typeof delaySEI !== "object") {
+        return;
+      }
+      const push3 = getTimestamp(delaySEI, "push_edge_ts", "push_node");
+      const source = getTimestamp(delaySEI, "source_ts", "source_node");
+      const cmafSource = getTimestamp(
+        delaySEI,
+        "cmaf_source_ts",
+        "cmaf_source_node"
+      );
+      const hlsSource = getTimestamp(
+        delaySEI,
+        "hls_source_ts",
+        "hls_source_node"
+      );
+      const pull = getTimestamp(delaySEI, "pull_edge_ts", "pull_node");
+      const start = push3 ?? source;
+      const end = pull ?? hlsSource ?? cmafSource;
+      if (!isNumber(start) || !isNumber(end)) {
+        return;
+      }
+      const delayS2S = end - start;
+      const safeBufferTime = isNumber(bufferTime) ? Math.max(0, bufferTime) : 0;
+      return {
+        delay_s2s: delayS2S,
+        delay_s2e: delayS2S + Math.max(0, now3 - end) + safeBufferTime
+      };
+    } catch (e2) {
+      return;
+    }
+  };
   VeI18n.extend([
     {
       LANG: "zh-cn",
@@ -73945,6 +74020,22 @@ MediaSource ${JSON.stringify(attachMediaSourceData)} from ${logFromSource}`);
        * @hidden
        */
       __publicField(this, "_protocolManager");
+      __publicField(this, "_seiDelayStats", {});
+      __publicField(this, "_resetSEIDelayStats", () => {
+        this._seiDelayStats = {};
+      });
+      __publicField(this, "_handleSEI", (data2) => {
+        const stats = getSEIDelayStats(data2 == null ? void 0 : data2.sei, this._getPlayerBufferTime());
+        if (stats) {
+          this._seiDelayStats = stats;
+        }
+      });
+      this.on(Events.SEI, this._handleSEI);
+      this.on(Events.URL_CHANGE, this._resetSEIDelayStats);
+      this.on(Events.SOURCE_CHANGE, this._resetSEIDelayStats);
+      this.on(Events.DEFINITION_CHANGE, this._resetSEIDelayStats);
+      this.on(Events.REPLAY, this._resetSEIDelayStats);
+      this.on(Events.FALLBACK, this._resetSEIDelayStats);
     }
     /** {zh}
      * @brief 获取已经播放的时长，不包含暂停和等待时间，单位为秒。
@@ -73986,6 +74077,22 @@ MediaSource ${JSON.stringify(attachMediaSourceData)} from ${logFromSource}`);
       var _a, _b;
       return (_b = (_a = this._player.plugins) == null ? void 0 : _a.hls) == null ? void 0 : _b.hls;
     }
+    /** {zh}
+     * @hidden
+     */
+    /** {en}
+     * @hidden
+     */
+    destroy() {
+      this.off(Events.SEI, this._handleSEI);
+      this.off(Events.URL_CHANGE, this._resetSEIDelayStats);
+      this.off(Events.SOURCE_CHANGE, this._resetSEIDelayStats);
+      this.off(Events.DEFINITION_CHANGE, this._resetSEIDelayStats);
+      this.off(Events.REPLAY, this._resetSEIDelayStats);
+      this.off(Events.FALLBACK, this._resetSEIDelayStats);
+      this._resetSEIDelayStats();
+      super.destroy();
+    }
     /** {zh}
      * @brief 调用此方法开启直播日志上报。
      */
@@ -74122,7 +74229,8 @@ MediaSource ${JSON.stringify(attachMediaSourceData)} from ${logFromSource}`);
      */
     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();
+      const stats = await ((_c = (_b = (_a = this._player) == null ? void 0 : _a.plugins) == null ? void 0 : _b.rts) == null ? void 0 : _c.getStatsSnapshoot());
+      return this._mergeSEIDelayStats(stats);
     }
     /** {zh}
      * @brief 获取 FLV 拉流的播放信息。
@@ -74133,7 +74241,8 @@ MediaSource ${JSON.stringify(attachMediaSourceData)} from ${logFromSource}`);
      */
     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();
+      const stats = (_c = (_b = (_a = this._player) == null ? void 0 : _a.plugins) == null ? void 0 : _b.flv) == null ? void 0 : _c.getStats();
+      return this._mergeSEIDelayStats(stats);
     }
     /** {zh}
      * @brief 获取 HLS 拉流的播放信息。
@@ -74145,8 +74254,9 @@ MediaSource ${JSON.stringify(attachMediaSourceData)} from ${logFromSource}`);
      * @hidden
      */
     getHLSStats() {
-      var _a, _b, _c;
-      return (_c = (_b = (_a = this._player) == null ? void 0 : _a.plugins) == null ? void 0 : _b.hls) == null ? void 0 : _c.getStats();
+      var _a, _b, _c, _d;
+      const stats = ((_d = (_c = (_b = (_a = this._player) == null ? void 0 : _a.plugins) == null ? void 0 : _b.hls) == null ? void 0 : _c.getStats) == null ? void 0 : _d.call(_c)) ?? {};
+      return this._mergeSEIDelayStats(stats);
     }
     /** {en}
      * @brief This method is used to update the playlist, supporting updates to source, resolution, and related information.
@@ -74174,6 +74284,40 @@ MediaSource ${JSON.stringify(attachMediaSourceData)} from ${logFromSource}`);
       }
       return super.updatePlaylist(playlist, target);
     }
+    _getPlayerBufferTime() {
+      var _a, _b, _c, _d, _e2;
+      try {
+        const rtm = ((_b = (_a = this._player) == null ? void 0 : _a.plugins) == null ? void 0 : _b.rts) ?? ((_d = (_c = this._player) == null ? void 0 : _c.plugins) == null ? void 0 : _d.rtm);
+        if (rtm) {
+          const jitterBufferDelay = rtm.jitterBufferDelay;
+          if (Number.isFinite(jitterBufferDelay) && jitterBufferDelay >= 0) {
+            return jitterBufferDelay;
+          }
+        }
+      } catch (e2) {
+      }
+      const video = (_e2 = this._player) == null ? void 0 : _e2.video;
+      const buffered = video == null ? void 0 : video.buffered;
+      if (!video || !(buffered == null ? void 0 : buffered.length)) {
+        return 0;
+      }
+      try {
+        return Math.trunc(
+          (buffered.end(buffered.length - 1) - video.currentTime) * 1e3
+        );
+      } catch (e2) {
+        return 0;
+      }
+    }
+    _mergeSEIDelayStats(stats) {
+      if (!stats) {
+        return stats;
+      }
+      return {
+        ...stats,
+        ...this._seiDelayStats
+      };
+    }
   }
   async function createLivePlayer(options) {
     var _a, _b, _c, _d, _e2, _f, _g, _h, _i2, _j, _k;
@@ -74206,6 +74350,10 @@ MediaSource ${JSON.stringify(attachMediaSourceData)} from ${logFromSource}`);
       playerOptions,
       recommendation
     );
+    finalOptions.rtm = {
+      enableSei: true,
+      ...finalOptions.rtm
+    };
     await liveLicenseManager.create();
     const licenseFatalError = liveLicenseManager.getLicenseFatalError();
     const protocolManager = await ProtocolManager.create(finalOptions);
@@ -74309,7 +74457,7 @@ MediaSource ${JSON.stringify(attachMediaSourceData)} from ${logFromSource}`);
     }
     await ((_a = liveVeStrategy.veStrategyManager) == null ? void 0 : _a.init({
       ...options,
-      playerVersion: "2.12.1",
+      playerVersion: "2.13.1-rc.0",
       type: "LIVE"
     }));
     return liveVeStrategy.veStrategyManager;

package/umd/veplayer.live.d.ts

@@ -6217,6 +6217,7 @@ interface PrepareOptions {
     logger?: LoggerConfig;
 }
 interface LiveEN {
+    INVALID_PARAMETER: string;
     ERROR_TYPES?: any;
     // eslint-disable-next-line @typescript-eslint/member-ordering
     [key: string]: string | unknown;
@@ -7058,9 +7059,11 @@ interface Rtm {
     checkStatsErrorDelay?: number;
     /** {zh}
      * @brief 是否打开 RTM SEI
+     * @default true
      */
     /** {en}
      * @brief enable RTM SEI data.
+     * @default true
      */
     enableSei?: boolean;
 }
@@ -7305,6 +7308,32 @@ interface RTMNetWorkInfo {
      */
     avgLostRate?: number;
 }
+/** {zh}
+ * @list option
+ * @kind property
+ * @brief 服务端 SEI 延迟统计。
+ */
+/** {en}
+ * @list option
+ * @kind property
+ * @brief Server SEI delay statistics.
+ */
+interface SEIDelayStats {
+    /** {zh}
+     * @brief 服务端链路延迟，单位为毫秒。没有有效的服务端 SEI 数据时为空。
+     */
+    /** {en}
+     * @brief Server-side transfer delay in milliseconds. Empty when valid server SEI data is unavailable.
+     */
+    delay_s2s?: number;
+    /** {zh}
+     * @brief 推流端到播放端的延迟，单位为毫秒。没有有效的服务端 SEI 数据时为空。
+     */
+    /** {en}
+     * @brief Stream-to-end playback delay in milliseconds. Empty when valid server SEI data is unavailable.
+     */
+    delay_s2e?: number;
+}
 /** {zh}
  * @list option
  * @kind property
@@ -7315,7 +7344,7 @@ interface RTMNetWorkInfo {
  * @kind property
  * @brief RTM live stream information.
  */
-interface StatsSnapShoot {
+interface StatsSnapShoot extends SEIDelayStats {
     /** {en}
      * @brief Video information.
      */
@@ -7546,7 +7575,7 @@ interface StatsSnapShoot {
  * @kind property
  * @brief Basic information for live stream playback.
  */
-interface Stats$0 {
+interface Stats$0 extends SEIDelayStats {
     /** {zh}
      * @brief 音频格式。
      * @hidden
@@ -7704,6 +7733,7 @@ declare class VePlayerLive extends VePlayerBase {
      * @hidden
      */
     _protocolManager?: ProtocolManager;
+    private _seiDelayStats;
     /** {zh}
      * @hidden
      * @param options
@@ -7734,6 +7764,13 @@ declare class VePlayerLive extends VePlayerBase {
      * @hidden
      */
     get hls(): any;
+    /** {zh}
+     * @hidden
+     */
+    /** {en}
+     * @hidden
+     */
+    destroy(): void;
     /** {zh}
      * @brief 调用此方法开启直播日志上报。
      */
@@ -7886,6 +7923,10 @@ declare class VePlayerLive extends VePlayerBase {
          */
         source?: string;
     }, needUpdateProtocol?: boolean): Promise<void>;
+    private _resetSEIDelayStats;
+    private _handleSEI;
+    private _getPlayerBufferTime;
+    private _mergeSEIDelayStats;
 }
 /** {zh}
  * @detail api
@@ -11539,6 +11580,7 @@ declare namespace live {
         logger?: LoggerConfig;
     }
     interface LiveEN {
+        INVALID_PARAMETER: string;
         ERROR_TYPES?: any;
         // eslint-disable-next-line @typescript-eslint/member-ordering
         [key: string]: string | unknown;
@@ -12390,9 +12432,11 @@ declare namespace live {
         checkStatsErrorDelay?: number;
         /** {zh}
          * @brief 是否打开 RTM SEI
+         * @default true
          */
         /** {en}
          * @brief enable RTM SEI data.
+         * @default true
          */
         enableSei?: boolean;
     }
@@ -12637,6 +12681,32 @@ declare namespace live {
          */
         avgLostRate?: number;
     }
+    /** {zh}
+     * @list option
+     * @kind property
+     * @brief 服务端 SEI 延迟统计。
+     */
+    /** {en}
+     * @list option
+     * @kind property
+     * @brief Server SEI delay statistics.
+     */
+    interface SEIDelayStats {
+        /** {zh}
+         * @brief 服务端链路延迟，单位为毫秒。没有有效的服务端 SEI 数据时为空。
+         */
+        /** {en}
+         * @brief Server-side transfer delay in milliseconds. Empty when valid server SEI data is unavailable.
+         */
+        delay_s2s?: number;
+        /** {zh}
+         * @brief 推流端到播放端的延迟，单位为毫秒。没有有效的服务端 SEI 数据时为空。
+         */
+        /** {en}
+         * @brief Stream-to-end playback delay in milliseconds. Empty when valid server SEI data is unavailable.
+         */
+        delay_s2e?: number;
+    }
     /** {zh}
      * @list option
      * @kind property
@@ -12647,7 +12717,7 @@ declare namespace live {
      * @kind property
      * @brief RTM live stream information.
      */
-    interface StatsSnapShoot {
+    interface StatsSnapShoot extends SEIDelayStats {
         /** {en}
          * @brief Video information.
          */
@@ -12878,7 +12948,7 @@ declare namespace live {
      * @kind property
      * @brief Basic information for live stream playback.
      */
-    interface Stats$0 {
+    interface Stats$0 extends SEIDelayStats {
         /** {zh}
          * @brief 音频格式。
          * @hidden
@@ -13036,6 +13106,7 @@ declare namespace live {
          * @hidden
          */
         _protocolManager?: ProtocolManager;
+        private _seiDelayStats;
         /** {zh}
          * @hidden
          * @param options
@@ -13066,6 +13137,13 @@ declare namespace live {
          * @hidden
          */
         get hls(): any;
+        /** {zh}
+         * @hidden
+         */
+        /** {en}
+         * @hidden
+         */
+        destroy(): void;
         /** {zh}
          * @brief 调用此方法开启直播日志上报。
          */
@@ -13218,6 +13296,10 @@ declare namespace live {
              */
             source?: string;
         }, needUpdateProtocol?: boolean): Promise<void>;
+        private _resetSEIDelayStats;
+        private _handleSEI;
+        private _getPlayerBufferTime;
+        private _mergeSEIDelayStats;
     }
     /** {zh}
      * @detail api