@seastart/srtc-web-sdk 0.5.3 → 0.5.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 +5 -0
- package/package.json +1 -1
- package/srtc.d.mts +64 -0
- package/srtc.d.ts +64 -0
- package/srtc.js +1 -1
- package/srtc.mjs +1 -1
package/CHANGELOG.md
CHANGED
package/package.json
CHANGED
package/srtc.d.mts
CHANGED
|
@@ -1087,6 +1087,15 @@ export declare class ChannelEventType extends CommonChannelEventType {
|
|
|
1087
1087
|
*/
|
|
1088
1088
|
export declare class LocalAudioTrack extends BaseWebrtcTrack {
|
|
1089
1089
|
constructor();
|
|
1090
|
+
/**
|
|
1091
|
+
* 挂载音频处理器(如 RNN 降噪、变声)。传入数组时按顺序串联。
|
|
1092
|
+
* 需先 startCapture 采集到轨道后调用。
|
|
1093
|
+
*/
|
|
1094
|
+
setProcessor(processor: TrackProcessor | TrackProcessor[]): Promise<void>;
|
|
1095
|
+
/**
|
|
1096
|
+
* 卸载音频处理器,还原为原始采集轨道。
|
|
1097
|
+
*/
|
|
1098
|
+
removeProcessor(): Promise<void>;
|
|
1090
1099
|
/**
|
|
1091
1100
|
* 获取音量
|
|
1092
1101
|
*/
|
|
@@ -1323,6 +1332,15 @@ export declare class LocalScreenTrack extends LocalVideoTrack {
|
|
|
1323
1332
|
*/
|
|
1324
1333
|
export declare class LocalVideoTrack extends BaseWebrtcTrack {
|
|
1325
1334
|
constructor();
|
|
1335
|
+
/**
|
|
1336
|
+
* 挂载视频处理器(如美颜、虚化背景)。传入数组时按顺序串联。
|
|
1337
|
+
* 需先 startCapture 采集到轨道后调用。
|
|
1338
|
+
*/
|
|
1339
|
+
setProcessor(processor: TrackProcessor | TrackProcessor[]): Promise<void>;
|
|
1340
|
+
/**
|
|
1341
|
+
* 卸载视频处理器,还原为原始采集轨道。
|
|
1342
|
+
*/
|
|
1343
|
+
removeProcessor(): Promise<void>;
|
|
1326
1344
|
setMediaStreamTrack(mediaStreamTrack?: MediaStreamTrack): void;
|
|
1327
1345
|
/**
|
|
1328
1346
|
* 获取联播轨道(小流)
|
|
@@ -1380,6 +1398,23 @@ export declare class LocalVideoTrack extends BaseWebrtcTrack {
|
|
|
1380
1398
|
*/
|
|
1381
1399
|
isPopOut(container: HTMLElement): boolean;
|
|
1382
1400
|
}
|
|
1401
|
+
/**
|
|
1402
|
+
* 处理器串联组合器:把多个 TrackProcessor 收敛成一个。
|
|
1403
|
+
* 第一性原理——每个处理器都是 track→track 的变换,可逐级串联:
|
|
1404
|
+
* 源 → P1 → P2 → ... → processedTrack。
|
|
1405
|
+
*
|
|
1406
|
+
* 音频链共享一个 AudioContext,避免每级单独创建上下文(浏览器对 AudioContext 数量有限制)。
|
|
1407
|
+
*/
|
|
1408
|
+
export declare class ProcessorPipeline implements TrackProcessor {
|
|
1409
|
+
readonly name: string;
|
|
1410
|
+
processedTrack?: MediaStreamTrack;
|
|
1411
|
+
private processors;
|
|
1412
|
+
/** 仅当本组合器自建共享上下文时持有,destroy 时负责关闭 */
|
|
1413
|
+
private ownedAudioContext?;
|
|
1414
|
+
constructor(processors: TrackProcessor[]);
|
|
1415
|
+
init(options: ProcessorOptions): Promise<void>;
|
|
1416
|
+
destroy(): Promise<void>;
|
|
1417
|
+
}
|
|
1383
1418
|
/**
|
|
1384
1419
|
* 远端混音流
|
|
1385
1420
|
*/
|
|
@@ -2788,6 +2823,21 @@ export interface PopOutOptions {
|
|
|
2788
2823
|
/** 是否隐藏原始播放视图,默认true */
|
|
2789
2824
|
hideOriginView?: boolean;
|
|
2790
2825
|
}
|
|
2826
|
+
/**
|
|
2827
|
+
* 处理器初始化参数
|
|
2828
|
+
*/
|
|
2829
|
+
export interface ProcessorOptions {
|
|
2830
|
+
/** 源 MediaStreamTrack(采集得到的原始轨道) */
|
|
2831
|
+
track: MediaStreamTrack;
|
|
2832
|
+
/** 轨道类型 audio / video */
|
|
2833
|
+
kind: TrackKind;
|
|
2834
|
+
/**
|
|
2835
|
+
* 可选共享 AudioContext。
|
|
2836
|
+
* 串联多个音频处理器时由 ProcessorPipeline 传入同一个上下文,
|
|
2837
|
+
* 减少多级 destination→source 往返及重复创建 AudioContext 的开销。
|
|
2838
|
+
*/
|
|
2839
|
+
audioContext?: AudioContext;
|
|
2840
|
+
}
|
|
2791
2841
|
/**
|
|
2792
2842
|
* 属性更改项
|
|
2793
2843
|
*/
|
|
@@ -3024,6 +3074,20 @@ export interface TrackMetric {
|
|
|
3024
3074
|
/** 其他由 track.getInfo() 展开的字段 */
|
|
3025
3075
|
[key: string]: any;
|
|
3026
3076
|
}
|
|
3077
|
+
/**
|
|
3078
|
+
* 轨道处理器接口。
|
|
3079
|
+
* 插件作者实现此接口即可接入 SDK:输入一条轨道,产出一条处理后的轨道。
|
|
3080
|
+
*/
|
|
3081
|
+
export interface TrackProcessor {
|
|
3082
|
+
/** 处理器名称,用于日志与串联展示 */
|
|
3083
|
+
readonly name: string;
|
|
3084
|
+
/** 处理后的输出轨道;init 成功后必须可用 */
|
|
3085
|
+
readonly processedTrack?: MediaStreamTrack;
|
|
3086
|
+
/** 初始化:建立内部处理管线,并产出 processedTrack */
|
|
3087
|
+
init(options: ProcessorOptions): Promise<void>;
|
|
3088
|
+
/** 释放资源:断开音频节点、关闭自建的 AudioContext 等 */
|
|
3089
|
+
destroy(): Promise<void>;
|
|
3090
|
+
}
|
|
3027
3091
|
/**
|
|
3028
3092
|
* 程博流媒体服务连接信息
|
|
3029
3093
|
*/
|
package/srtc.d.ts
CHANGED
|
@@ -1087,6 +1087,15 @@ export declare class ChannelEventType extends CommonChannelEventType {
|
|
|
1087
1087
|
*/
|
|
1088
1088
|
export declare class LocalAudioTrack extends BaseWebrtcTrack {
|
|
1089
1089
|
constructor();
|
|
1090
|
+
/**
|
|
1091
|
+
* 挂载音频处理器(如 RNN 降噪、变声)。传入数组时按顺序串联。
|
|
1092
|
+
* 需先 startCapture 采集到轨道后调用。
|
|
1093
|
+
*/
|
|
1094
|
+
setProcessor(processor: TrackProcessor | TrackProcessor[]): Promise<void>;
|
|
1095
|
+
/**
|
|
1096
|
+
* 卸载音频处理器,还原为原始采集轨道。
|
|
1097
|
+
*/
|
|
1098
|
+
removeProcessor(): Promise<void>;
|
|
1090
1099
|
/**
|
|
1091
1100
|
* 获取音量
|
|
1092
1101
|
*/
|
|
@@ -1323,6 +1332,15 @@ export declare class LocalScreenTrack extends LocalVideoTrack {
|
|
|
1323
1332
|
*/
|
|
1324
1333
|
export declare class LocalVideoTrack extends BaseWebrtcTrack {
|
|
1325
1334
|
constructor();
|
|
1335
|
+
/**
|
|
1336
|
+
* 挂载视频处理器(如美颜、虚化背景)。传入数组时按顺序串联。
|
|
1337
|
+
* 需先 startCapture 采集到轨道后调用。
|
|
1338
|
+
*/
|
|
1339
|
+
setProcessor(processor: TrackProcessor | TrackProcessor[]): Promise<void>;
|
|
1340
|
+
/**
|
|
1341
|
+
* 卸载视频处理器,还原为原始采集轨道。
|
|
1342
|
+
*/
|
|
1343
|
+
removeProcessor(): Promise<void>;
|
|
1326
1344
|
setMediaStreamTrack(mediaStreamTrack?: MediaStreamTrack): void;
|
|
1327
1345
|
/**
|
|
1328
1346
|
* 获取联播轨道(小流)
|
|
@@ -1380,6 +1398,23 @@ export declare class LocalVideoTrack extends BaseWebrtcTrack {
|
|
|
1380
1398
|
*/
|
|
1381
1399
|
isPopOut(container: HTMLElement): boolean;
|
|
1382
1400
|
}
|
|
1401
|
+
/**
|
|
1402
|
+
* 处理器串联组合器:把多个 TrackProcessor 收敛成一个。
|
|
1403
|
+
* 第一性原理——每个处理器都是 track→track 的变换,可逐级串联:
|
|
1404
|
+
* 源 → P1 → P2 → ... → processedTrack。
|
|
1405
|
+
*
|
|
1406
|
+
* 音频链共享一个 AudioContext,避免每级单独创建上下文(浏览器对 AudioContext 数量有限制)。
|
|
1407
|
+
*/
|
|
1408
|
+
export declare class ProcessorPipeline implements TrackProcessor {
|
|
1409
|
+
readonly name: string;
|
|
1410
|
+
processedTrack?: MediaStreamTrack;
|
|
1411
|
+
private processors;
|
|
1412
|
+
/** 仅当本组合器自建共享上下文时持有,destroy 时负责关闭 */
|
|
1413
|
+
private ownedAudioContext?;
|
|
1414
|
+
constructor(processors: TrackProcessor[]);
|
|
1415
|
+
init(options: ProcessorOptions): Promise<void>;
|
|
1416
|
+
destroy(): Promise<void>;
|
|
1417
|
+
}
|
|
1383
1418
|
/**
|
|
1384
1419
|
* 远端混音流
|
|
1385
1420
|
*/
|
|
@@ -2788,6 +2823,21 @@ export interface PopOutOptions {
|
|
|
2788
2823
|
/** 是否隐藏原始播放视图,默认true */
|
|
2789
2824
|
hideOriginView?: boolean;
|
|
2790
2825
|
}
|
|
2826
|
+
/**
|
|
2827
|
+
* 处理器初始化参数
|
|
2828
|
+
*/
|
|
2829
|
+
export interface ProcessorOptions {
|
|
2830
|
+
/** 源 MediaStreamTrack(采集得到的原始轨道) */
|
|
2831
|
+
track: MediaStreamTrack;
|
|
2832
|
+
/** 轨道类型 audio / video */
|
|
2833
|
+
kind: TrackKind;
|
|
2834
|
+
/**
|
|
2835
|
+
* 可选共享 AudioContext。
|
|
2836
|
+
* 串联多个音频处理器时由 ProcessorPipeline 传入同一个上下文,
|
|
2837
|
+
* 减少多级 destination→source 往返及重复创建 AudioContext 的开销。
|
|
2838
|
+
*/
|
|
2839
|
+
audioContext?: AudioContext;
|
|
2840
|
+
}
|
|
2791
2841
|
/**
|
|
2792
2842
|
* 属性更改项
|
|
2793
2843
|
*/
|
|
@@ -3024,6 +3074,20 @@ export interface TrackMetric {
|
|
|
3024
3074
|
/** 其他由 track.getInfo() 展开的字段 */
|
|
3025
3075
|
[key: string]: any;
|
|
3026
3076
|
}
|
|
3077
|
+
/**
|
|
3078
|
+
* 轨道处理器接口。
|
|
3079
|
+
* 插件作者实现此接口即可接入 SDK:输入一条轨道,产出一条处理后的轨道。
|
|
3080
|
+
*/
|
|
3081
|
+
export interface TrackProcessor {
|
|
3082
|
+
/** 处理器名称,用于日志与串联展示 */
|
|
3083
|
+
readonly name: string;
|
|
3084
|
+
/** 处理后的输出轨道;init 成功后必须可用 */
|
|
3085
|
+
readonly processedTrack?: MediaStreamTrack;
|
|
3086
|
+
/** 初始化:建立内部处理管线,并产出 processedTrack */
|
|
3087
|
+
init(options: ProcessorOptions): Promise<void>;
|
|
3088
|
+
/** 释放资源:断开音频节点、关闭自建的 AudioContext 等 */
|
|
3089
|
+
destroy(): Promise<void>;
|
|
3090
|
+
}
|
|
3027
3091
|
/**
|
|
3028
3092
|
* 程博流媒体服务连接信息
|
|
3029
3093
|
*/
|