@seastart/srtc-web-sdk 0.7.2 → 0.7.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 CHANGED
@@ -2,6 +2,12 @@
2
2
 
3
3
  本文档记录 web SDK 各版本的改动点。遵循 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/) 风格。
4
4
 
5
+ ## v0.7.3 - 2026-11-16
6
+
7
+ - feat: 新增音频处理器接口 `AudioTrackProcessor`,可通过 `audioProcessing` 声明对浏览器 3A(降噪 / 回声消除 / 自动增益)的要求,挂到麦克风时 SDK 按声明重新采集一次,卸载或挂载失败时恢复。DeepFilterNet / RNNoise 插件声明了 `{ noiseSuppression: false }`,挂载后自动关闭浏览器自带降噪,避免两道降噪叠加让人声发闷
8
+ - fix: 挂着处理器时 `stopCapture` / 切换设备只停了处理后的轨道,原始麦克风/摄像头没有停,浏览器录音、摄像头指示一直亮着
9
+ - fix: 已挂处理器时再次 `setProcessor`,新处理器拿到的是旧处理器即将销毁的输出轨道,导致无声/黑屏
10
+
5
11
  ## v0.7.2 - 2026-11-09
6
12
 
7
13
  - fix: 获取设备列表时摄像头存在但打不开(被占用、VDI 摄像头重定向异常等,`NotReadableError`/`AbortError`),不再连带麦克风一起失败,改为只申请麦克风后重试 (acf2f55)
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@seastart/srtc-web-sdk",
3
- "version": "0.7.2",
3
+ "version": "0.7.3",
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
@@ -446,7 +446,7 @@ export declare class LocalAudioTrack extends BaseWebrtcLocalTrack {
446
446
  * 挂载音频处理器(如 RNN 降噪、变声)。传入数组时按顺序串联。
447
447
  * 需先 startCapture 采集到轨道后调用。
448
448
  */
449
- setProcessor(processor: TrackProcessor | TrackProcessor[]): Promise<void>;
449
+ setProcessor(processor: AudioTrackProcessor | AudioTrackProcessor[]): Promise<void>;
450
450
  /**
451
451
  * 卸载音频处理器,还原为原始采集轨道。
452
452
  */
@@ -574,6 +574,15 @@ export declare class LocalCompositeRecorder {
574
574
  */
575
575
  export declare class LocalMicTrack extends LocalAudioTrack {
576
576
  constructor(captureOptions: MicCaptureOptions);
577
+ /**
578
+ * 挂载音频处理器。处理器声明了 audioProcessing(如降噪插件要求关闭浏览器降噪)时,
579
+ * 会按声明重新采集一次麦克风,卸载时恢复。
580
+ */
581
+ setProcessor(processor: AudioTrackProcessor | AudioTrackProcessor[]): Promise<void>;
582
+ /**
583
+ * 卸载音频处理器,还原为原始采集轨道;处理器要求改动的浏览器 3A 开关一并恢复。
584
+ */
585
+ removeProcessor(): Promise<void>;
577
586
  /**
578
587
  * 开始采集
579
588
  * @param opt 采集参数
@@ -700,6 +709,8 @@ export declare class LocalVideoTrack extends BaseWebrtcLocalTrack {
700
709
  export declare class ProcessorPipeline implements TrackProcessor {
701
710
  readonly name: string;
702
711
  processedTrack?: MediaStreamTrack;
712
+ /** 串联的各级处理器(按处理顺序,只读) */
713
+ readonly processors: readonly TrackProcessor[];
703
714
  constructor(processors: TrackProcessor[]);
704
715
  init(options: ProcessorOptions): Promise<void>;
705
716
  destroy(): Promise<void>;
@@ -1307,6 +1318,17 @@ export interface AudioOutputOptions {
1307
1318
  */
1308
1319
  volume?: number;
1309
1320
  }
1321
+ /**
1322
+ * 浏览器自带的音频前处理开关(3A),语义与 getUserMedia 的同名约束一致。
1323
+ */
1324
+ export interface AudioProcessingConstraints {
1325
+ /** 降噪 */
1326
+ noiseSuppression?: boolean;
1327
+ /** 回声消除 */
1328
+ echoCancellation?: boolean;
1329
+ /** 自动增益 */
1330
+ autoGainControl?: boolean;
1331
+ }
1310
1332
  /**
1311
1333
  * 音频发布配置
1312
1334
  */
@@ -1356,6 +1378,17 @@ export interface AudioSenderStats extends SenderStats {
1356
1378
  /** 音频电平 */
1357
1379
  audioLevel?: number;
1358
1380
  }
1381
+ /**
1382
+ * 音频处理器:在通用 TrackProcessor 之上,可声明对原始音频采集的要求。
1383
+ */
1384
+ export interface AudioTrackProcessor extends TrackProcessor {
1385
+ /**
1386
+ * 期望的浏览器音频前处理开关。挂到麦克风轨道时 SDK 按此重新采集一次,卸载时恢复。
1387
+ * 如降噪插件声明 `{ noiseSuppression: false }`,避免与浏览器自带降噪叠加让人声发闷。
1388
+ * 不声明的项沿用业务的采集参数。
1389
+ */
1390
+ readonly audioProcessing?: AudioProcessingConstraints;
1391
+ }
1359
1392
  /** 自动播放弹窗文案(面向终端用户) */
1360
1393
  export interface AutoPlayDialogText {
1361
1394
  /** 弹窗提示语 */
package/srtc.d.ts CHANGED
@@ -446,7 +446,7 @@ export declare class LocalAudioTrack extends BaseWebrtcLocalTrack {
446
446
  * 挂载音频处理器(如 RNN 降噪、变声)。传入数组时按顺序串联。
447
447
  * 需先 startCapture 采集到轨道后调用。
448
448
  */
449
- setProcessor(processor: TrackProcessor | TrackProcessor[]): Promise<void>;
449
+ setProcessor(processor: AudioTrackProcessor | AudioTrackProcessor[]): Promise<void>;
450
450
  /**
451
451
  * 卸载音频处理器,还原为原始采集轨道。
452
452
  */
@@ -574,6 +574,15 @@ export declare class LocalCompositeRecorder {
574
574
  */
575
575
  export declare class LocalMicTrack extends LocalAudioTrack {
576
576
  constructor(captureOptions: MicCaptureOptions);
577
+ /**
578
+ * 挂载音频处理器。处理器声明了 audioProcessing(如降噪插件要求关闭浏览器降噪)时,
579
+ * 会按声明重新采集一次麦克风,卸载时恢复。
580
+ */
581
+ setProcessor(processor: AudioTrackProcessor | AudioTrackProcessor[]): Promise<void>;
582
+ /**
583
+ * 卸载音频处理器,还原为原始采集轨道;处理器要求改动的浏览器 3A 开关一并恢复。
584
+ */
585
+ removeProcessor(): Promise<void>;
577
586
  /**
578
587
  * 开始采集
579
588
  * @param opt 采集参数
@@ -700,6 +709,8 @@ export declare class LocalVideoTrack extends BaseWebrtcLocalTrack {
700
709
  export declare class ProcessorPipeline implements TrackProcessor {
701
710
  readonly name: string;
702
711
  processedTrack?: MediaStreamTrack;
712
+ /** 串联的各级处理器(按处理顺序,只读) */
713
+ readonly processors: readonly TrackProcessor[];
703
714
  constructor(processors: TrackProcessor[]);
704
715
  init(options: ProcessorOptions): Promise<void>;
705
716
  destroy(): Promise<void>;
@@ -1307,6 +1318,17 @@ export interface AudioOutputOptions {
1307
1318
  */
1308
1319
  volume?: number;
1309
1320
  }
1321
+ /**
1322
+ * 浏览器自带的音频前处理开关(3A),语义与 getUserMedia 的同名约束一致。
1323
+ */
1324
+ export interface AudioProcessingConstraints {
1325
+ /** 降噪 */
1326
+ noiseSuppression?: boolean;
1327
+ /** 回声消除 */
1328
+ echoCancellation?: boolean;
1329
+ /** 自动增益 */
1330
+ autoGainControl?: boolean;
1331
+ }
1310
1332
  /**
1311
1333
  * 音频发布配置
1312
1334
  */
@@ -1356,6 +1378,17 @@ export interface AudioSenderStats extends SenderStats {
1356
1378
  /** 音频电平 */
1357
1379
  audioLevel?: number;
1358
1380
  }
1381
+ /**
1382
+ * 音频处理器:在通用 TrackProcessor 之上,可声明对原始音频采集的要求。
1383
+ */
1384
+ export interface AudioTrackProcessor extends TrackProcessor {
1385
+ /**
1386
+ * 期望的浏览器音频前处理开关。挂到麦克风轨道时 SDK 按此重新采集一次,卸载时恢复。
1387
+ * 如降噪插件声明 `{ noiseSuppression: false }`,避免与浏览器自带降噪叠加让人声发闷。
1388
+ * 不声明的项沿用业务的采集参数。
1389
+ */
1390
+ readonly audioProcessing?: AudioProcessingConstraints;
1391
+ }
1359
1392
  /** 自动播放弹窗文案(面向终端用户) */
1360
1393
  export interface AutoPlayDialogText {
1361
1394
  /** 弹窗提示语 */