@seastart/srtc-web-sdk 0.6.1 → 0.6.3
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 +12 -0
- package/package.json +1 -1
- package/srtc.d.mts +27 -0
- package/srtc.d.ts +27 -0
- package/srtc.js +1 -1
- package/srtc.mjs +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -2,6 +2,18 @@
|
|
|
2
2
|
|
|
3
3
|
本文档记录 web SDK 各版本的改动点。遵循 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/) 风格。
|
|
4
4
|
|
|
5
|
+
## v0.6.3 - 2026-09-23
|
|
6
|
+
|
|
7
|
+
- fix: 本地混音改为直连 AudioContext 出声,修复 Web 端接收音频发钝 (3e5b181)
|
|
8
|
+
- fix: 混音 warnup 元素补静音并保留引用,堵住混音偶发无声 (a7c8eb3)
|
|
9
|
+
- feat: RemoteAudioTrack 补齐 setJitterBufferTarget / getJitterBufferTarget(此前仅视频轨支持)
|
|
10
|
+
|
|
11
|
+
## v0.6.2 - 2026-09-02
|
|
12
|
+
|
|
13
|
+
- fix(channel): 同一 desc 重复发布直接抛错,堵住关不掉的幽灵轨 (98ca84c)
|
|
14
|
+
- fix: 默认频道判定不再只靠对象身份,避免实例被响应式代理时事件全丢 (227da4f)
|
|
15
|
+
- fix: 业务错误不再被吞成「调用被取消」,重连遇容量不足可自愈 (f721a6d)
|
|
16
|
+
|
|
5
17
|
## v0.6.1 - 2026-08-06
|
|
6
18
|
|
|
7
19
|
- fix: Channel 直订远端轨事件丢失(muted/ended/pip 等不通知);channel.subscribeRemote* 返回平台化类型(RemoteVideoTrack 等),无需再断言
|
package/package.json
CHANGED
package/srtc.d.mts
CHANGED
|
@@ -722,6 +722,20 @@ export declare class RemoteAudioMixTrack extends RemoteAudioTrack implements IRe
|
|
|
722
722
|
*/
|
|
723
723
|
export declare class RemoteAudioTrack extends BaseWebrtcTrack {
|
|
724
724
|
constructor(info: BaseTrackInfo, uid: string);
|
|
725
|
+
/**
|
|
726
|
+
* 设置接收端抗抖动缓冲的目标延迟(ms),命名与 W3C jitterBufferTarget 规范对齐。
|
|
727
|
+
* - 0:低延迟优先,浏览器会保持最小可用 buffer
|
|
728
|
+
* - 较大值(如 200~500):缓冲优先,更平滑但延迟更高
|
|
729
|
+
* - undefined:清除设置,回到浏览器自适应
|
|
730
|
+
* 默认不设置(浏览器自适应)。
|
|
731
|
+
* 实际生效需要 Chrome/Edge(同时兼容 jitterBufferTarget 与老的 playoutDelayHint),
|
|
732
|
+
* Firefox/Safari 静默忽略。
|
|
733
|
+
*/
|
|
734
|
+
setJitterBufferTarget(ms?: number): void;
|
|
735
|
+
/**
|
|
736
|
+
* 获取业务当前设定的抖动缓冲目标延迟(ms);undefined 表示未设置。
|
|
737
|
+
*/
|
|
738
|
+
getJitterBufferTarget(): number | undefined;
|
|
725
739
|
/**
|
|
726
740
|
* 是否正在播放
|
|
727
741
|
*/
|
|
@@ -1686,6 +1700,19 @@ export interface MixedAudioMediaStreamTrack extends MediaStreamTrack {
|
|
|
1686
1700
|
addTrack(track: MediaStreamTrack): void;
|
|
1687
1701
|
removeTrack(track: MediaStreamTrack): void;
|
|
1688
1702
|
trackCount: number;
|
|
1703
|
+
/**
|
|
1704
|
+
* 扬声器播放支路的增益节点:混音结果经它直连 `context.destination` 出声。
|
|
1705
|
+
*
|
|
1706
|
+
* 为什么要单开这条支路,而不是拿本轨(destination 产出的 MediaStreamTrack)喂 `<audio>` 播:
|
|
1707
|
+
* Chrome 上 `<audio srcObject=MediaStream>` 走的是 WebMediaPlayerMS 那套面向 WebRTC 通信音频的
|
|
1708
|
+
* 渲染路径,实测会把混音结果的音质明显搞钝(2026-09-23 三路对照:track 直接喂 `<audio>` 正常、
|
|
1709
|
+
* AudioContext 直连 destination 出声正常、唯独 destination→`<audio>` 这一跳发钝)。
|
|
1710
|
+
* 直接从 AudioContext 出声可以完全绕开它。
|
|
1711
|
+
*
|
|
1712
|
+
* 默认 gain=0(不出声),由 AudioMixTrackTrait.startSpeakerPlay 打开——
|
|
1713
|
+
* 这样 LocalAudioMixTrack 那种「只要混音轨去发布、不需要本地外放」的用法不受影响。
|
|
1714
|
+
*/
|
|
1715
|
+
speakerGain: GainNode;
|
|
1689
1716
|
}
|
|
1690
1717
|
/**
|
|
1691
1718
|
* 网络总体统计
|
package/srtc.d.ts
CHANGED
|
@@ -722,6 +722,20 @@ export declare class RemoteAudioMixTrack extends RemoteAudioTrack implements IRe
|
|
|
722
722
|
*/
|
|
723
723
|
export declare class RemoteAudioTrack extends BaseWebrtcTrack {
|
|
724
724
|
constructor(info: BaseTrackInfo, uid: string);
|
|
725
|
+
/**
|
|
726
|
+
* 设置接收端抗抖动缓冲的目标延迟(ms),命名与 W3C jitterBufferTarget 规范对齐。
|
|
727
|
+
* - 0:低延迟优先,浏览器会保持最小可用 buffer
|
|
728
|
+
* - 较大值(如 200~500):缓冲优先,更平滑但延迟更高
|
|
729
|
+
* - undefined:清除设置,回到浏览器自适应
|
|
730
|
+
* 默认不设置(浏览器自适应)。
|
|
731
|
+
* 实际生效需要 Chrome/Edge(同时兼容 jitterBufferTarget 与老的 playoutDelayHint),
|
|
732
|
+
* Firefox/Safari 静默忽略。
|
|
733
|
+
*/
|
|
734
|
+
setJitterBufferTarget(ms?: number): void;
|
|
735
|
+
/**
|
|
736
|
+
* 获取业务当前设定的抖动缓冲目标延迟(ms);undefined 表示未设置。
|
|
737
|
+
*/
|
|
738
|
+
getJitterBufferTarget(): number | undefined;
|
|
725
739
|
/**
|
|
726
740
|
* 是否正在播放
|
|
727
741
|
*/
|
|
@@ -1686,6 +1700,19 @@ export interface MixedAudioMediaStreamTrack extends MediaStreamTrack {
|
|
|
1686
1700
|
addTrack(track: MediaStreamTrack): void;
|
|
1687
1701
|
removeTrack(track: MediaStreamTrack): void;
|
|
1688
1702
|
trackCount: number;
|
|
1703
|
+
/**
|
|
1704
|
+
* 扬声器播放支路的增益节点:混音结果经它直连 `context.destination` 出声。
|
|
1705
|
+
*
|
|
1706
|
+
* 为什么要单开这条支路,而不是拿本轨(destination 产出的 MediaStreamTrack)喂 `<audio>` 播:
|
|
1707
|
+
* Chrome 上 `<audio srcObject=MediaStream>` 走的是 WebMediaPlayerMS 那套面向 WebRTC 通信音频的
|
|
1708
|
+
* 渲染路径,实测会把混音结果的音质明显搞钝(2026-09-23 三路对照:track 直接喂 `<audio>` 正常、
|
|
1709
|
+
* AudioContext 直连 destination 出声正常、唯独 destination→`<audio>` 这一跳发钝)。
|
|
1710
|
+
* 直接从 AudioContext 出声可以完全绕开它。
|
|
1711
|
+
*
|
|
1712
|
+
* 默认 gain=0(不出声),由 AudioMixTrackTrait.startSpeakerPlay 打开——
|
|
1713
|
+
* 这样 LocalAudioMixTrack 那种「只要混音轨去发布、不需要本地外放」的用法不受影响。
|
|
1714
|
+
*/
|
|
1715
|
+
speakerGain: GainNode;
|
|
1689
1716
|
}
|
|
1690
1717
|
/**
|
|
1691
1718
|
* 网络总体统计
|