@seastart/srtc-web-sdk 0.7.2 → 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 +16 -0
- package/package.json +1 -1
- package/srtc.d.mts +44 -2
- package/srtc.d.ts +44 -2
- package/srtc.js +1 -1
- package/srtc.mjs +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -2,6 +2,22 @@
|
|
|
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
|
+
|
|
15
|
+
## v0.7.3 - 2026-11-16
|
|
16
|
+
|
|
17
|
+
- feat: 新增音频处理器接口 `AudioTrackProcessor`,可通过 `audioProcessing` 声明对浏览器 3A(降噪 / 回声消除 / 自动增益)的要求,挂到麦克风时 SDK 按声明重新采集一次,卸载或挂载失败时恢复。DeepFilterNet / RNNoise 插件声明了 `{ noiseSuppression: false }`,挂载后自动关闭浏览器自带降噪,避免两道降噪叠加让人声发闷
|
|
18
|
+
- fix: 挂着处理器时 `stopCapture` / 切换设备只停了处理后的轨道,原始麦克风/摄像头没有停,浏览器录音、摄像头指示一直亮着
|
|
19
|
+
- fix: 已挂处理器时再次 `setProcessor`,新处理器拿到的是旧处理器即将销毁的输出轨道,导致无声/黑屏
|
|
20
|
+
|
|
5
21
|
## v0.7.2 - 2026-11-09
|
|
6
22
|
|
|
7
23
|
- 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.
|
|
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
|
@@ -446,15 +446,24 @@ export declare class LocalAudioTrack extends BaseWebrtcLocalTrack {
|
|
|
446
446
|
* 挂载音频处理器(如 RNN 降噪、变声)。传入数组时按顺序串联。
|
|
447
447
|
* 需先 startCapture 采集到轨道后调用。
|
|
448
448
|
*/
|
|
449
|
-
setProcessor(processor:
|
|
449
|
+
setProcessor(processor: AudioTrackProcessor | AudioTrackProcessor[]): Promise<void>;
|
|
450
450
|
/**
|
|
451
451
|
* 卸载音频处理器,还原为原始采集轨道。
|
|
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
|
*/
|
|
@@ -574,6 +583,15 @@ export declare class LocalCompositeRecorder {
|
|
|
574
583
|
*/
|
|
575
584
|
export declare class LocalMicTrack extends LocalAudioTrack {
|
|
576
585
|
constructor(captureOptions: MicCaptureOptions);
|
|
586
|
+
/**
|
|
587
|
+
* 挂载音频处理器。处理器声明了 audioProcessing(如降噪插件要求关闭浏览器降噪)时,
|
|
588
|
+
* 会按声明重新采集一次麦克风,卸载时恢复。
|
|
589
|
+
*/
|
|
590
|
+
setProcessor(processor: AudioTrackProcessor | AudioTrackProcessor[]): Promise<void>;
|
|
591
|
+
/**
|
|
592
|
+
* 卸载音频处理器,还原为原始采集轨道;处理器要求改动的浏览器 3A 开关一并恢复。
|
|
593
|
+
*/
|
|
594
|
+
removeProcessor(): Promise<void>;
|
|
577
595
|
/**
|
|
578
596
|
* 开始采集
|
|
579
597
|
* @param opt 采集参数
|
|
@@ -700,6 +718,8 @@ export declare class LocalVideoTrack extends BaseWebrtcLocalTrack {
|
|
|
700
718
|
export declare class ProcessorPipeline implements TrackProcessor {
|
|
701
719
|
readonly name: string;
|
|
702
720
|
processedTrack?: MediaStreamTrack;
|
|
721
|
+
/** 串联的各级处理器(按处理顺序,只读) */
|
|
722
|
+
readonly processors: readonly TrackProcessor[];
|
|
703
723
|
constructor(processors: TrackProcessor[]);
|
|
704
724
|
init(options: ProcessorOptions): Promise<void>;
|
|
705
725
|
destroy(): Promise<void>;
|
|
@@ -1307,6 +1327,17 @@ export interface AudioOutputOptions {
|
|
|
1307
1327
|
*/
|
|
1308
1328
|
volume?: number;
|
|
1309
1329
|
}
|
|
1330
|
+
/**
|
|
1331
|
+
* 浏览器自带的音频前处理开关(3A),语义与 getUserMedia 的同名约束一致。
|
|
1332
|
+
*/
|
|
1333
|
+
export interface AudioProcessingConstraints {
|
|
1334
|
+
/** 降噪 */
|
|
1335
|
+
noiseSuppression?: boolean;
|
|
1336
|
+
/** 回声消除 */
|
|
1337
|
+
echoCancellation?: boolean;
|
|
1338
|
+
/** 自动增益 */
|
|
1339
|
+
autoGainControl?: boolean;
|
|
1340
|
+
}
|
|
1310
1341
|
/**
|
|
1311
1342
|
* 音频发布配置
|
|
1312
1343
|
*/
|
|
@@ -1356,6 +1387,17 @@ export interface AudioSenderStats extends SenderStats {
|
|
|
1356
1387
|
/** 音频电平 */
|
|
1357
1388
|
audioLevel?: number;
|
|
1358
1389
|
}
|
|
1390
|
+
/**
|
|
1391
|
+
* 音频处理器:在通用 TrackProcessor 之上,可声明对原始音频采集的要求。
|
|
1392
|
+
*/
|
|
1393
|
+
export interface AudioTrackProcessor extends TrackProcessor {
|
|
1394
|
+
/**
|
|
1395
|
+
* 期望的浏览器音频前处理开关。挂到麦克风轨道时 SDK 按此重新采集一次,卸载时恢复。
|
|
1396
|
+
* 如降噪插件声明 `{ noiseSuppression: false }`,避免与浏览器自带降噪叠加让人声发闷。
|
|
1397
|
+
* 不声明的项沿用业务的采集参数。
|
|
1398
|
+
*/
|
|
1399
|
+
readonly audioProcessing?: AudioProcessingConstraints;
|
|
1400
|
+
}
|
|
1359
1401
|
/** 自动播放弹窗文案(面向终端用户) */
|
|
1360
1402
|
export interface AutoPlayDialogText {
|
|
1361
1403
|
/** 弹窗提示语 */
|
package/srtc.d.ts
CHANGED
|
@@ -446,15 +446,24 @@ export declare class LocalAudioTrack extends BaseWebrtcLocalTrack {
|
|
|
446
446
|
* 挂载音频处理器(如 RNN 降噪、变声)。传入数组时按顺序串联。
|
|
447
447
|
* 需先 startCapture 采集到轨道后调用。
|
|
448
448
|
*/
|
|
449
|
-
setProcessor(processor:
|
|
449
|
+
setProcessor(processor: AudioTrackProcessor | AudioTrackProcessor[]): Promise<void>;
|
|
450
450
|
/**
|
|
451
451
|
* 卸载音频处理器,还原为原始采集轨道。
|
|
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
|
*/
|
|
@@ -574,6 +583,15 @@ export declare class LocalCompositeRecorder {
|
|
|
574
583
|
*/
|
|
575
584
|
export declare class LocalMicTrack extends LocalAudioTrack {
|
|
576
585
|
constructor(captureOptions: MicCaptureOptions);
|
|
586
|
+
/**
|
|
587
|
+
* 挂载音频处理器。处理器声明了 audioProcessing(如降噪插件要求关闭浏览器降噪)时,
|
|
588
|
+
* 会按声明重新采集一次麦克风,卸载时恢复。
|
|
589
|
+
*/
|
|
590
|
+
setProcessor(processor: AudioTrackProcessor | AudioTrackProcessor[]): Promise<void>;
|
|
591
|
+
/**
|
|
592
|
+
* 卸载音频处理器,还原为原始采集轨道;处理器要求改动的浏览器 3A 开关一并恢复。
|
|
593
|
+
*/
|
|
594
|
+
removeProcessor(): Promise<void>;
|
|
577
595
|
/**
|
|
578
596
|
* 开始采集
|
|
579
597
|
* @param opt 采集参数
|
|
@@ -700,6 +718,8 @@ export declare class LocalVideoTrack extends BaseWebrtcLocalTrack {
|
|
|
700
718
|
export declare class ProcessorPipeline implements TrackProcessor {
|
|
701
719
|
readonly name: string;
|
|
702
720
|
processedTrack?: MediaStreamTrack;
|
|
721
|
+
/** 串联的各级处理器(按处理顺序,只读) */
|
|
722
|
+
readonly processors: readonly TrackProcessor[];
|
|
703
723
|
constructor(processors: TrackProcessor[]);
|
|
704
724
|
init(options: ProcessorOptions): Promise<void>;
|
|
705
725
|
destroy(): Promise<void>;
|
|
@@ -1307,6 +1327,17 @@ export interface AudioOutputOptions {
|
|
|
1307
1327
|
*/
|
|
1308
1328
|
volume?: number;
|
|
1309
1329
|
}
|
|
1330
|
+
/**
|
|
1331
|
+
* 浏览器自带的音频前处理开关(3A),语义与 getUserMedia 的同名约束一致。
|
|
1332
|
+
*/
|
|
1333
|
+
export interface AudioProcessingConstraints {
|
|
1334
|
+
/** 降噪 */
|
|
1335
|
+
noiseSuppression?: boolean;
|
|
1336
|
+
/** 回声消除 */
|
|
1337
|
+
echoCancellation?: boolean;
|
|
1338
|
+
/** 自动增益 */
|
|
1339
|
+
autoGainControl?: boolean;
|
|
1340
|
+
}
|
|
1310
1341
|
/**
|
|
1311
1342
|
* 音频发布配置
|
|
1312
1343
|
*/
|
|
@@ -1356,6 +1387,17 @@ export interface AudioSenderStats extends SenderStats {
|
|
|
1356
1387
|
/** 音频电平 */
|
|
1357
1388
|
audioLevel?: number;
|
|
1358
1389
|
}
|
|
1390
|
+
/**
|
|
1391
|
+
* 音频处理器:在通用 TrackProcessor 之上,可声明对原始音频采集的要求。
|
|
1392
|
+
*/
|
|
1393
|
+
export interface AudioTrackProcessor extends TrackProcessor {
|
|
1394
|
+
/**
|
|
1395
|
+
* 期望的浏览器音频前处理开关。挂到麦克风轨道时 SDK 按此重新采集一次,卸载时恢复。
|
|
1396
|
+
* 如降噪插件声明 `{ noiseSuppression: false }`,避免与浏览器自带降噪叠加让人声发闷。
|
|
1397
|
+
* 不声明的项沿用业务的采集参数。
|
|
1398
|
+
*/
|
|
1399
|
+
readonly audioProcessing?: AudioProcessingConstraints;
|
|
1400
|
+
}
|
|
1359
1401
|
/** 自动播放弹窗文案(面向终端用户) */
|
|
1360
1402
|
export interface AutoPlayDialogText {
|
|
1361
1403
|
/** 弹窗提示语 */
|