@volcengine/veplayer 2.12.1 → 2.13.1-rc.0

package/esm/veplayer.live.development.js

@@ -14711,7 +14711,7 @@ class VePlayerBase {
    * @brief Retrieve the player SDK version number.
    */
   get playerVersion() {
-    return "2.12.1";
+    return "2.13.1-rc.0";
   }
   /** {zh}
    * @brief 获取当前播放视频的清晰度唯一标识（definition）。
@@ -56506,7 +56506,7 @@ let Logger$1 = class Logger2 extends Plugin {
       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"
@@ -56520,7 +56520,6 @@ function normalizeNumber(value, transform2) {
   return transform2 ? transform2(value) : value.toString();
 }
 function getDefaultRow(data2) {
-  var _a;
   return {
     rows: [
       {
@@ -56561,7 +56560,10 @@ function getDefaultRow(data2) {
       {
         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",
@@ -73908,6 +73910,79 @@ class LiveVeStrategy {
   }
 }
 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",
@@ -73946,6 +74021,22 @@ class VePlayerLive extends VePlayerBase {
      * @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 获取已经播放的时长，不包含暂停和等待时间，单位为秒。
@@ -73987,6 +74078,22 @@ class VePlayerLive extends VePlayerBase {
     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 调用此方法开启直播日志上报。
    */
@@ -74123,7 +74230,8 @@ class VePlayerLive extends VePlayerBase {
    */
   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 拉流的播放信息。
@@ -74134,7 +74242,8 @@ class VePlayerLive extends VePlayerBase {
    */
   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 拉流的播放信息。
@@ -74146,8 +74255,9 @@ class VePlayerLive extends VePlayerBase {
    * @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.
@@ -74175,6 +74285,40 @@ class VePlayerLive extends VePlayerBase {
     }
     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;
@@ -74207,6 +74351,10 @@ async function createLivePlayer(options) {
     playerOptions,
     recommendation
   );
+  finalOptions.rtm = {
+    enableSei: true,
+    ...finalOptions.rtm
+  };
   await liveLicenseManager.create();
   const licenseFatalError = liveLicenseManager.getLicenseFatalError();
   const protocolManager = await ProtocolManager.create(finalOptions);
@@ -74310,7 +74458,7 @@ async function prepare(options) {
   }
   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;