@seastart/srtc-web-sdk 0.5.0 → 0.5.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -2,6 +2,11 @@
2
2
 
3
3
  本文档记录 web SDK 各版本的改动点。遵循 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/) 风格。
4
4
 
5
+ ## v0.5.1 - 2026-04-27
6
+
7
+ - fix: 视频卡顿 (b7a36c2)
8
+ - feat: RemoteVideoTrack支持设置jitterBufferTarget(抗抖动目标延迟) (6aed177)
9
+
5
10
  ## v0.5.0 - 2026-04-23
6
11
 
7
12
  - feat: seastart引擎接入服务端下发质量报告
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@seastart/srtc-web-sdk",
3
- "version": "0.5.0",
3
+ "version": "0.5.1",
4
4
  "description": "srtc sdk for web",
5
5
  "main": "srtc.js",
6
6
  "module": "srtc.mjs",
package/srtc.d.mts CHANGED
@@ -1275,6 +1275,10 @@ export declare class RemoteAudioTrack extends BaseWebrtcTrack {
1275
1275
  * 远端视频流轨道
1276
1276
  */
1277
1277
  export declare class RemoteVideoTrack extends BaseWebrtcTrack {
1278
+ /**
1279
+ * 业务期望的抖动缓冲目标延迟(ms)。undefined 表示使用浏览器默认自适应策略。
1280
+ */
1281
+ private jitterBufferTargetMs?;
1278
1282
  constructor(info: BaseTrackInfo, uid: string);
1279
1283
  /**
1280
1284
  * 添加播放窗口
@@ -1324,6 +1328,25 @@ export declare class RemoteVideoTrack extends BaseWebrtcTrack {
1324
1328
  * @param container 播放容器
1325
1329
  */
1326
1330
  isPopOut(container: HTMLElement): boolean;
1331
+ /**
1332
+ * 设置接收端抗抖动缓冲的目标延迟(ms),命名与 W3C jitterBufferTarget 规范对齐。
1333
+ * - 0:低延迟优先,浏览器会保持最小可用 buffer
1334
+ * - 较大值(如 200~500):缓冲优先,更平滑但延迟更高
1335
+ * - undefined:清除设置,回到浏览器自适应
1336
+ * 实际生效需要 Chrome/Edge(同时兼容 jitterBufferTarget 与老的 playoutDelayHint),
1337
+ * Firefox/Safari 静默忽略。
1338
+ */
1339
+ setJitterBufferTarget(ms?: number): void;
1340
+ /**
1341
+ * 获取业务当前设定的抖动缓冲目标延迟(ms);undefined 表示未设置。
1342
+ */
1343
+ getJitterBufferTarget(): number | undefined;
1344
+ /**
1345
+ * 同时写 jitterBufferTarget(W3C 标准,Chrome 113+)和 playoutDelayHint
1346
+ * (Chrome 私有扩展,Chrome 70+),让新老浏览器都能生效。
1347
+ * 浏览器只支持其中一个时另一个不存在,'in' 判断后静默跳过。
1348
+ */
1349
+ private applyJitterBufferTarget;
1327
1350
  }
1328
1351
  export declare class SRTC extends BaseSRTC {
1329
1352
  /** 窄化父类的 channel 类型到 webrtc Channel,便于访问 webrtc 特有方法 */
@@ -2603,8 +2626,12 @@ export interface QualityEvaluation {
2603
2626
  * 接收数据统计
2604
2627
  */
2605
2628
  export interface ReceiverStats {
2606
- /** 接收端抗抖动缓冲区延迟,单位 ms */
2629
+ /** 接收端抗抖动缓冲区累计延迟(开播至今所有出 buffer 帧的延迟总和),单位 ms */
2607
2630
  jitterBufferDelay?: number;
2631
+ /** 已从抖动缓冲区出列的帧/样本累计数;用于把累计 jitterBufferDelay 折算为均值 */
2632
+ jitterBufferEmittedCount?: number;
2633
+ /** 周期内(与上一次 stats 采样之间)平均每帧抖动缓冲延迟,单位 ms;体感延迟以此为准 */
2634
+ jitterBufferAvgDelay?: number;
2608
2635
  /** 累计丢包数(基于 RTP 序列号间隙统计) */
2609
2636
  packetsLost?: number;
2610
2637
  /** 累计接收 RTP 包数 */
package/srtc.d.ts CHANGED
@@ -1275,6 +1275,10 @@ export declare class RemoteAudioTrack extends BaseWebrtcTrack {
1275
1275
  * 远端视频流轨道
1276
1276
  */
1277
1277
  export declare class RemoteVideoTrack extends BaseWebrtcTrack {
1278
+ /**
1279
+ * 业务期望的抖动缓冲目标延迟(ms)。undefined 表示使用浏览器默认自适应策略。
1280
+ */
1281
+ private jitterBufferTargetMs?;
1278
1282
  constructor(info: BaseTrackInfo, uid: string);
1279
1283
  /**
1280
1284
  * 添加播放窗口
@@ -1324,6 +1328,25 @@ export declare class RemoteVideoTrack extends BaseWebrtcTrack {
1324
1328
  * @param container 播放容器
1325
1329
  */
1326
1330
  isPopOut(container: HTMLElement): boolean;
1331
+ /**
1332
+ * 设置接收端抗抖动缓冲的目标延迟(ms),命名与 W3C jitterBufferTarget 规范对齐。
1333
+ * - 0:低延迟优先,浏览器会保持最小可用 buffer
1334
+ * - 较大值(如 200~500):缓冲优先,更平滑但延迟更高
1335
+ * - undefined:清除设置,回到浏览器自适应
1336
+ * 实际生效需要 Chrome/Edge(同时兼容 jitterBufferTarget 与老的 playoutDelayHint),
1337
+ * Firefox/Safari 静默忽略。
1338
+ */
1339
+ setJitterBufferTarget(ms?: number): void;
1340
+ /**
1341
+ * 获取业务当前设定的抖动缓冲目标延迟(ms);undefined 表示未设置。
1342
+ */
1343
+ getJitterBufferTarget(): number | undefined;
1344
+ /**
1345
+ * 同时写 jitterBufferTarget(W3C 标准,Chrome 113+)和 playoutDelayHint
1346
+ * (Chrome 私有扩展,Chrome 70+),让新老浏览器都能生效。
1347
+ * 浏览器只支持其中一个时另一个不存在,'in' 判断后静默跳过。
1348
+ */
1349
+ private applyJitterBufferTarget;
1327
1350
  }
1328
1351
  export declare class SRTC extends BaseSRTC {
1329
1352
  /** 窄化父类的 channel 类型到 webrtc Channel,便于访问 webrtc 特有方法 */
@@ -2603,8 +2626,12 @@ export interface QualityEvaluation {
2603
2626
  * 接收数据统计
2604
2627
  */
2605
2628
  export interface ReceiverStats {
2606
- /** 接收端抗抖动缓冲区延迟,单位 ms */
2629
+ /** 接收端抗抖动缓冲区累计延迟(开播至今所有出 buffer 帧的延迟总和),单位 ms */
2607
2630
  jitterBufferDelay?: number;
2631
+ /** 已从抖动缓冲区出列的帧/样本累计数;用于把累计 jitterBufferDelay 折算为均值 */
2632
+ jitterBufferEmittedCount?: number;
2633
+ /** 周期内(与上一次 stats 采样之间)平均每帧抖动缓冲延迟,单位 ms;体感延迟以此为准 */
2634
+ jitterBufferAvgDelay?: number;
2608
2635
  /** 累计丢包数(基于 RTP 序列号间隙统计) */
2609
2636
  packetsLost?: number;
2610
2637
  /** 累计接收 RTP 包数 */