@seastart/srtc-web-sdk 0.7.3 → 0.7.4

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,16 @@
2
2
 
3
3
  本文档记录 web SDK 各版本的改动点。遵循 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/) 风格。
4
4
 
5
+ ## v0.7.4 - 2026-11-19
6
+
7
+ - feat: 本地音频轨 `getVolume()` 实现(之前恒返回 0),返回 0~100 的输入音量:约 -45dBFS 以下为 0、-10dBFS 以上为 100;分析用的 AudioContext 首次调用时创建,轨道替换或停止采集时释放 (dd77453)
8
+ - fix: 断线处理对齐 rtc-go (305570d)
9
+ - 媒体重连放弃(不可恢复的业务错误或重试用尽)时抛 `DISCONNECTED`(带原因),不再停在会控在、媒体全断的状态
10
+ - 会控 MQTT 会话丢失(CONNACK sessionPresent=false)时补拉频道详情,补发成员/轨道事件后再抛 `RECONNECTED`;会话仍在时照旧由 broker 补发
11
+ - 入会时 MQTT 首连失败、重试成功后 join 不再挂起
12
+ - 旧会话迟到的 user_leave 不再误删重新入会的成员
13
+ - 远端轨道无变化时不再误报 `USER_TRACK_UPDATE`
14
+
5
15
  ## v0.7.3 - 2026-11-16
6
16
 
7
17
  - feat: 新增音频处理器接口 `AudioTrackProcessor`,可通过 `audioProcessing` 声明对浏览器 3A(降噪 / 回声消除 / 自动增益)的要求,挂到麦克风时 SDK 按声明重新采集一次,卸载或挂载失败时恢复。DeepFilterNet / RNNoise 插件声明了 `{ noiseSuppression: false }`,挂载后自动关闭浏览器自带降噪,避免两道降噪叠加让人声发闷
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@seastart/srtc-web-sdk",
3
- "version": "0.7.3",
3
+ "version": "0.7.4",
4
4
  "description": "SRTC Web SDK: real-time audio/video for browsers, built for private deployment | SRTC 浏览器端实时音视频 SDK,支持完全私有化部署",
5
5
  "homepage": "https://docs.stmlink.com/zh/rtc/web/integration",
6
6
  "main": "srtc.js",
package/srtc.d.mts CHANGED
@@ -452,9 +452,18 @@ export declare class LocalAudioTrack extends BaseWebrtcLocalTrack {
452
452
  */
453
453
  removeProcessor(): Promise<void>;
454
454
  /**
455
- * 获取音量
455
+ * 获取当前音频输入音量,范围 0~100(整数)。
456
+ *
457
+ * 按 dB 换算:约 -45dBFS(房间底噪)以下为 0,约 -10dBFS(正常说话峰值)以上为 100。
458
+ * 返回的是瞬时值,做音柱时建议约 100ms 轮询一次,并在 UI 层做「快起慢落」平滑。
459
+ * 未采集、已停止采集或 `track.enabled = false` 时返回 0。
460
+ * 首次调用时才创建分析用的 AudioContext,轨道替换或停止采集时自动释放。
456
461
  */
457
462
  getVolume(): number;
463
+ /**
464
+ * 轨道替换(切设备、挂处理器、停止采集)时释放音量计,下次 getVolume 绑定新轨道
465
+ */
466
+ setMediaStreamTrack(mediaStreamTrack?: MediaStreamTrack): void;
458
467
  /**
459
468
  * 是否正在播放
460
469
  */
package/srtc.d.ts CHANGED
@@ -452,9 +452,18 @@ export declare class LocalAudioTrack extends BaseWebrtcLocalTrack {
452
452
  */
453
453
  removeProcessor(): Promise<void>;
454
454
  /**
455
- * 获取音量
455
+ * 获取当前音频输入音量,范围 0~100(整数)。
456
+ *
457
+ * 按 dB 换算:约 -45dBFS(房间底噪)以下为 0,约 -10dBFS(正常说话峰值)以上为 100。
458
+ * 返回的是瞬时值,做音柱时建议约 100ms 轮询一次,并在 UI 层做「快起慢落」平滑。
459
+ * 未采集、已停止采集或 `track.enabled = false` 时返回 0。
460
+ * 首次调用时才创建分析用的 AudioContext,轨道替换或停止采集时自动释放。
456
461
  */
457
462
  getVolume(): number;
463
+ /**
464
+ * 轨道替换(切设备、挂处理器、停止采集)时释放音量计,下次 getVolume 绑定新轨道
465
+ */
466
+ setMediaStreamTrack(mediaStreamTrack?: MediaStreamTrack): void;
458
467
  /**
459
468
  * 是否正在播放
460
469
  */