@seastart/srtc-web-sdk 0.4.2 → 0.4.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 +7 -0
- package/README.md +2 -2
- package/package.json +1 -1
- package/srtc.d.mts +252 -3
- package/srtc.d.ts +252 -3
- package/srtc.js +1 -1
- package/srtc.mjs +1 -1
package/CHANGELOG.md
ADDED
package/README.md
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
# SRTC Web SDK (SRTC浏览器sdk)
|
|
2
2
|
|
|
3
3
|
## 介绍
|
|
4
|
-
srtc(
|
|
4
|
+
[srtc](https://www.stmlink.com)是一款是支持完全私有化部署的实时音视频通信引擎,覆盖全平台 SDK, 支持信创国产化,兼容传统 SIP/H.323 设备,集成 AI Agent 能力。可以快速帮助您搭建低成本、低延时、高品质的音视频互动解决方案。
|
|
5
5
|
|
|
6
6
|
## sdk使用帮助
|
|
7
|
-
|
|
7
|
+
[srtc使用帮助](https://docs.stmlink.com/zh/rtc/web/integration)
|
package/package.json
CHANGED
package/srtc.d.mts
CHANGED
|
@@ -40,10 +40,18 @@ declare abstract class BaseSRTC {
|
|
|
40
40
|
*/
|
|
41
41
|
getChannelInfo(): BaseChannelInfo | null;
|
|
42
42
|
/**
|
|
43
|
-
* 获取流媒体引擎的metric
|
|
44
|
-
|
|
43
|
+
* 获取流媒体引擎的metric快照(全量,含每条轨道的统计)
|
|
44
|
+
*/
|
|
45
|
+
getStreamMetric(): StreamMetric | undefined;
|
|
46
|
+
/**
|
|
47
|
+
* 获取当前网络总体统计,只关心网络全景时用,比 getStreamMetric 更轻量
|
|
48
|
+
*/
|
|
49
|
+
getNetworkStats(): NetworkStats | undefined;
|
|
50
|
+
/**
|
|
51
|
+
* 获取当前连接质量评估结果(等级 / MOS / 触发原因)
|
|
52
|
+
* 配合 CONNECTION_QUALITY_CHANGED 事件使用
|
|
45
53
|
*/
|
|
46
|
-
|
|
54
|
+
getConnectionQuality(): QualityEvaluation | undefined;
|
|
47
55
|
/**
|
|
48
56
|
* 获取某用户信息
|
|
49
57
|
* @returns
|
|
@@ -163,6 +171,12 @@ declare class CommonChannelEventType {
|
|
|
163
171
|
static readonly TRACK_UNMUTED = "track_unmuted";
|
|
164
172
|
/** 流轨道停止,对应data为BaseTrack */
|
|
165
173
|
static readonly TRACK_ENDED = "track_ended";
|
|
174
|
+
/** 连接质量等级变化,对应data为 ConnectionQualityEventData */
|
|
175
|
+
static readonly CONNECTION_QUALITY_CHANGED = "connection_quality_changed";
|
|
176
|
+
/** 发送端被CPU持续限制,对应data为 QualityEvaluation */
|
|
177
|
+
static readonly CPU_CONSTRAINED = "cpu_constrained";
|
|
178
|
+
/** 发送端被带宽持续限制,对应data为 QualityEvaluation */
|
|
179
|
+
static readonly BANDWIDTH_CONSTRAINED = "bandwidth_constrained";
|
|
166
180
|
}
|
|
167
181
|
/** 频道外事件类型 */
|
|
168
182
|
declare class CommonImEventType {
|
|
@@ -651,6 +665,21 @@ export declare enum Codec {
|
|
|
651
665
|
/** OPUS编码 */
|
|
652
666
|
OPUS = 1398100047
|
|
653
667
|
}
|
|
668
|
+
/**
|
|
669
|
+
* 连接质量等级(对齐 LiveKit 5 档)
|
|
670
|
+
*/
|
|
671
|
+
export declare enum ConnectionQuality {
|
|
672
|
+
/** 初始占位,采样不足时使用,避免误报 */
|
|
673
|
+
Unknown = "unknown",
|
|
674
|
+
/** 优秀:几乎无损 */
|
|
675
|
+
Excellent = "excellent",
|
|
676
|
+
/** 良好:轻微丢包或延迟 */
|
|
677
|
+
Good = "good",
|
|
678
|
+
/** 较差:明显卡顿、丢包或被 cpu/bandwidth 限制 */
|
|
679
|
+
Poor = "poor",
|
|
680
|
+
/** 连接已丢失,媒体无法传输,应触发重连 */
|
|
681
|
+
Lost = "lost"
|
|
682
|
+
}
|
|
654
683
|
/**
|
|
655
684
|
* 终端类型枚举
|
|
656
685
|
*/
|
|
@@ -816,6 +845,30 @@ export interface AudioPublishOptions {
|
|
|
816
845
|
/** 自定义属性 */
|
|
817
846
|
props?: Record<string, any>;
|
|
818
847
|
}
|
|
848
|
+
export interface AudioReceiverStats extends ReceiverStats {
|
|
849
|
+
/** 类型 */
|
|
850
|
+
type: "audio";
|
|
851
|
+
/** 音频电平 */
|
|
852
|
+
audioLevel?: number;
|
|
853
|
+
/** 隐藏样本数 */
|
|
854
|
+
concealedSamples?: number;
|
|
855
|
+
/** 隐藏事件次数 */
|
|
856
|
+
concealmentEvents?: number;
|
|
857
|
+
/** 静音隐藏样本数 */
|
|
858
|
+
silentConcealedSamples?: number;
|
|
859
|
+
/** 静音隐藏事件次数 */
|
|
860
|
+
silentConcealmentEvents?: number;
|
|
861
|
+
/** 总音频能量 */
|
|
862
|
+
totalAudioEnergy?: number;
|
|
863
|
+
/** 总样本时长 */
|
|
864
|
+
totalSamplesDuration?: number;
|
|
865
|
+
}
|
|
866
|
+
export interface AudioSenderStats extends SenderStats {
|
|
867
|
+
/** 类型 */
|
|
868
|
+
type: "audio";
|
|
869
|
+
/** 音频电平 */
|
|
870
|
+
audioLevel?: number;
|
|
871
|
+
}
|
|
819
872
|
/**
|
|
820
873
|
* sdk编译信息
|
|
821
874
|
*/
|
|
@@ -858,6 +911,15 @@ export interface CameraPreset {
|
|
|
858
911
|
capture: CameraCaptureOptions;
|
|
859
912
|
publish: VideoPublishOptions;
|
|
860
913
|
}
|
|
914
|
+
/**
|
|
915
|
+
* 连接质量变化事件 data
|
|
916
|
+
*/
|
|
917
|
+
export interface ConnectionQualityEventData {
|
|
918
|
+
/** 当前评估结果(等级、MOS、原因等) */
|
|
919
|
+
evaluation: QualityEvaluation;
|
|
920
|
+
/** 变化前的质量等级 */
|
|
921
|
+
previous: ConnectionQuality;
|
|
922
|
+
}
|
|
861
923
|
/**
|
|
862
924
|
* 自定义消息
|
|
863
925
|
*/
|
|
@@ -1075,6 +1137,33 @@ export interface MixedAudioMediaStreamTrack extends MediaStreamTrack {
|
|
|
1075
1137
|
removeTrack(track: MediaStreamTrack): void;
|
|
1076
1138
|
trackCount: number;
|
|
1077
1139
|
}
|
|
1140
|
+
/**
|
|
1141
|
+
* 网络总体统计
|
|
1142
|
+
*/
|
|
1143
|
+
export interface NetworkStats {
|
|
1144
|
+
/** 下行码率kb/s */
|
|
1145
|
+
bitrate_down: number;
|
|
1146
|
+
/** 上行码率kb/s */
|
|
1147
|
+
bitrate_up: number;
|
|
1148
|
+
/** 下行丢包率 */
|
|
1149
|
+
lossrate_down: number;
|
|
1150
|
+
/** 上行丢包率 */
|
|
1151
|
+
lossrate_up: number;
|
|
1152
|
+
/** 上行包数 */
|
|
1153
|
+
pkt_up: number;
|
|
1154
|
+
/** 下行包数 */
|
|
1155
|
+
pkt_down: number;
|
|
1156
|
+
/** 上行丢包数 */
|
|
1157
|
+
pkt_loss_up: number;
|
|
1158
|
+
/** 下行丢包数 */
|
|
1159
|
+
pkt_loss_down: number;
|
|
1160
|
+
/** SFU/BWE 估算的可用上行带宽 kb/s,来自 candidate-pair */
|
|
1161
|
+
available_outgoing_bitrate?: number;
|
|
1162
|
+
/** SFU/BWE 估算的可用下行带宽 kb/s,来自 candidate-pair */
|
|
1163
|
+
available_incoming_bitrate?: number;
|
|
1164
|
+
/** candidate-pair 实时链路 RTT ms,比 remote-inbound-rtp 更准确 */
|
|
1165
|
+
current_rtt?: number;
|
|
1166
|
+
}
|
|
1078
1167
|
/** 画中画句柄,用于控制画中画状态 */
|
|
1079
1168
|
export interface PipHandle {
|
|
1080
1169
|
/** 画中画类型:document-pip 支持自定义UI,video-pip 为传统模式 */
|
|
@@ -1129,6 +1218,42 @@ export interface PropChangeItem<T> {
|
|
|
1129
1218
|
/** 更改前的值 */
|
|
1130
1219
|
old: any;
|
|
1131
1220
|
}
|
|
1221
|
+
/**
|
|
1222
|
+
* 质量评估结果快照
|
|
1223
|
+
*/
|
|
1224
|
+
export interface QualityEvaluation {
|
|
1225
|
+
/** 上行质量 */
|
|
1226
|
+
uplink: ConnectionQuality;
|
|
1227
|
+
/** 下行质量 */
|
|
1228
|
+
downlink: ConnectionQuality;
|
|
1229
|
+
/** 总体质量,取上下行中较差的一档 */
|
|
1230
|
+
overall: ConnectionQuality;
|
|
1231
|
+
/** 音频 MOS 估算,范围 1.0 ~ 4.5 */
|
|
1232
|
+
mos: number;
|
|
1233
|
+
/** 触发当前等级的主要原因描述,便于排查 */
|
|
1234
|
+
reasons: string[];
|
|
1235
|
+
/** 采样时间戳 */
|
|
1236
|
+
timestamp: number;
|
|
1237
|
+
}
|
|
1238
|
+
/**
|
|
1239
|
+
* 接收数据统计
|
|
1240
|
+
*/
|
|
1241
|
+
export interface ReceiverStats {
|
|
1242
|
+
/** 抖动缓冲延迟 */
|
|
1243
|
+
jitterBufferDelay?: number;
|
|
1244
|
+
/** 丢包数 */
|
|
1245
|
+
packetsLost?: number;
|
|
1246
|
+
/** 已接收的包数 */
|
|
1247
|
+
packetsReceived?: number;
|
|
1248
|
+
/** 已接收的字节数 */
|
|
1249
|
+
bytesReceived?: number;
|
|
1250
|
+
/** 流ID */
|
|
1251
|
+
streamId?: string;
|
|
1252
|
+
/** 抖动 */
|
|
1253
|
+
jitter?: number;
|
|
1254
|
+
/** 时间戳 */
|
|
1255
|
+
timestamp: number;
|
|
1256
|
+
}
|
|
1132
1257
|
/**
|
|
1133
1258
|
* 屏幕采集音频配置
|
|
1134
1259
|
*/
|
|
@@ -1192,6 +1317,62 @@ export interface SdkInitParams {
|
|
|
1192
1317
|
/** 日志目标 */
|
|
1193
1318
|
logTarget?: LogTarget;
|
|
1194
1319
|
}
|
|
1320
|
+
/**
|
|
1321
|
+
* 发送数据统计
|
|
1322
|
+
*/
|
|
1323
|
+
export interface SenderStats {
|
|
1324
|
+
/** 已发送的包数 */
|
|
1325
|
+
packetsSent?: number;
|
|
1326
|
+
/** 已发送的字节数 */
|
|
1327
|
+
bytesSent?: number;
|
|
1328
|
+
/** 远端感知到的抖动 */
|
|
1329
|
+
jitter?: number;
|
|
1330
|
+
/** 远端报告的丢包数 */
|
|
1331
|
+
packetsLost?: number;
|
|
1332
|
+
/** 远端报告的往返时延(ms) */
|
|
1333
|
+
roundTripTime?: number;
|
|
1334
|
+
/** 出站流ID */
|
|
1335
|
+
streamId?: string;
|
|
1336
|
+
/** 时间戳 */
|
|
1337
|
+
timestamp: number;
|
|
1338
|
+
}
|
|
1339
|
+
/**
|
|
1340
|
+
* 流媒体引擎周期性输出的 metric 快照
|
|
1341
|
+
*/
|
|
1342
|
+
export interface StreamMetric {
|
|
1343
|
+
/** 网络总体统计 */
|
|
1344
|
+
network: NetworkStats;
|
|
1345
|
+
/** 本地发布的音频轨道 */
|
|
1346
|
+
local_audios: TrackMetric[];
|
|
1347
|
+
/** 本地发布的视频轨道 */
|
|
1348
|
+
local_videos: TrackMetric[];
|
|
1349
|
+
/** 订阅的远端音频轨道 */
|
|
1350
|
+
remote_audios: TrackMetric[];
|
|
1351
|
+
/** 订阅的远端视频轨道 */
|
|
1352
|
+
remote_videos: TrackMetric[];
|
|
1353
|
+
}
|
|
1354
|
+
/**
|
|
1355
|
+
* 单条轨道的实时 metric 快照
|
|
1356
|
+
* 由 BaseTrack.getInfo() 展开 + 运行时计算字段
|
|
1357
|
+
*/
|
|
1358
|
+
export interface TrackMetric {
|
|
1359
|
+
/** 实时码率 kb/s */
|
|
1360
|
+
bitrate?: number;
|
|
1361
|
+
/** 音频电平 dBFS */
|
|
1362
|
+
db?: number;
|
|
1363
|
+
/** 视频宽 */
|
|
1364
|
+
width?: number;
|
|
1365
|
+
/** 视频高 */
|
|
1366
|
+
height?: number;
|
|
1367
|
+
/** 实时帧率 */
|
|
1368
|
+
fps?: number;
|
|
1369
|
+
/** 原始 sender/receiver stats */
|
|
1370
|
+
stats?: AudioSenderStats | VideoSenderStats | AudioReceiverStats | VideoReceiverStats;
|
|
1371
|
+
/** 订阅端轨道所属用户 uid */
|
|
1372
|
+
uid?: string;
|
|
1373
|
+
/** 其他由 track.getInfo() 展开的字段 */
|
|
1374
|
+
[key: string]: any;
|
|
1375
|
+
}
|
|
1195
1376
|
/**
|
|
1196
1377
|
* 用户离开事件data
|
|
1197
1378
|
*/
|
|
@@ -1234,6 +1415,74 @@ export interface VideoPublishOptions {
|
|
|
1234
1415
|
props?: Record<string, any>;
|
|
1235
1416
|
simulcasts?: VideoPublishOptions[];
|
|
1236
1417
|
}
|
|
1418
|
+
export interface VideoReceiverStats extends ReceiverStats {
|
|
1419
|
+
/** 类型 */
|
|
1420
|
+
type: "video";
|
|
1421
|
+
/** 已解码的帧数 */
|
|
1422
|
+
framesDecoded: number;
|
|
1423
|
+
/** 丢帧数 */
|
|
1424
|
+
framesDropped: number;
|
|
1425
|
+
/** 已接收的帧数 */
|
|
1426
|
+
framesReceived: number;
|
|
1427
|
+
/** 帧率 */
|
|
1428
|
+
framesPerSecond?: number;
|
|
1429
|
+
/** 帧宽度 */
|
|
1430
|
+
frameWidth?: number;
|
|
1431
|
+
/** 帧高度 */
|
|
1432
|
+
frameHeight?: number;
|
|
1433
|
+
/** 发送的FIR(Full Intra Request)请求次数 */
|
|
1434
|
+
firCount?: number;
|
|
1435
|
+
/** 发送的PLI(Picture Loss Indication)请求次数 */
|
|
1436
|
+
pliCount?: number;
|
|
1437
|
+
/** 发送的NACK(Negative Acknowledgement)请求次数 */
|
|
1438
|
+
nackCount?: number;
|
|
1439
|
+
/** 解码器实现 */
|
|
1440
|
+
decoderImplementation?: string;
|
|
1441
|
+
/** MIME类型 */
|
|
1442
|
+
mimeType?: string;
|
|
1443
|
+
/** 视频卡顿次数(单次冻结 > 1s 或 > 3倍平均帧间隔,W3C 定义) */
|
|
1444
|
+
freezeCount?: number;
|
|
1445
|
+
/** 视频卡顿累计时长(s) */
|
|
1446
|
+
totalFreezesDuration?: number;
|
|
1447
|
+
/** 视频暂停次数(远端暂停发送) */
|
|
1448
|
+
pauseCount?: number;
|
|
1449
|
+
/** 视频暂停累计时长(s) */
|
|
1450
|
+
totalPausesDuration?: number;
|
|
1451
|
+
/** 由多 RTP 包拼装的帧数 */
|
|
1452
|
+
framesAssembledFromMultiplePackets?: number;
|
|
1453
|
+
/** 所有帧累计拼装耗时(s) */
|
|
1454
|
+
totalAssemblyTime?: number;
|
|
1455
|
+
}
|
|
1456
|
+
export interface VideoSenderStats extends SenderStats {
|
|
1457
|
+
/** 类型 */
|
|
1458
|
+
type: "video";
|
|
1459
|
+
/** 收到的FIR(Full Intra Request)请求次数 */
|
|
1460
|
+
firCount: number;
|
|
1461
|
+
/** 收到的PLI(Picture Loss Indication)请求次数 */
|
|
1462
|
+
pliCount: number;
|
|
1463
|
+
/** 收到的NACK(Negative Acknowledgement)请求次数 */
|
|
1464
|
+
nackCount: number;
|
|
1465
|
+
/** RTP流ID */
|
|
1466
|
+
rid: string;
|
|
1467
|
+
/** 帧宽度 */
|
|
1468
|
+
frameWidth: number;
|
|
1469
|
+
/** 帧高度 */
|
|
1470
|
+
frameHeight: number;
|
|
1471
|
+
/** 帧率 */
|
|
1472
|
+
framesPerSecond: number;
|
|
1473
|
+
/** 已发送的帧数 */
|
|
1474
|
+
framesSent: number;
|
|
1475
|
+
/** 质量限制原因(bandwidth, cpu, other, none) */
|
|
1476
|
+
qualityLimitationReason?: string;
|
|
1477
|
+
/** 质量限制持续时间 */
|
|
1478
|
+
qualityLimitationDurations?: Record<string, number>;
|
|
1479
|
+
/** 质量限制分辨率变化次数 */
|
|
1480
|
+
qualityLimitationResolutionChanges?: number;
|
|
1481
|
+
/** 重传包数 */
|
|
1482
|
+
retransmittedPacketsSent?: number;
|
|
1483
|
+
/** 目标码率 */
|
|
1484
|
+
targetBitrate: number;
|
|
1485
|
+
}
|
|
1237
1486
|
/**
|
|
1238
1487
|
* 重试执行器函数:直接调用开始执行,.cancel()取消重试,函数失败会返回maxretry或canceled
|
|
1239
1488
|
*/
|
package/srtc.d.ts
CHANGED
|
@@ -40,10 +40,18 @@ declare abstract class BaseSRTC {
|
|
|
40
40
|
*/
|
|
41
41
|
getChannelInfo(): BaseChannelInfo | null;
|
|
42
42
|
/**
|
|
43
|
-
* 获取流媒体引擎的metric
|
|
44
|
-
|
|
43
|
+
* 获取流媒体引擎的metric快照(全量,含每条轨道的统计)
|
|
44
|
+
*/
|
|
45
|
+
getStreamMetric(): StreamMetric | undefined;
|
|
46
|
+
/**
|
|
47
|
+
* 获取当前网络总体统计,只关心网络全景时用,比 getStreamMetric 更轻量
|
|
48
|
+
*/
|
|
49
|
+
getNetworkStats(): NetworkStats | undefined;
|
|
50
|
+
/**
|
|
51
|
+
* 获取当前连接质量评估结果(等级 / MOS / 触发原因)
|
|
52
|
+
* 配合 CONNECTION_QUALITY_CHANGED 事件使用
|
|
45
53
|
*/
|
|
46
|
-
|
|
54
|
+
getConnectionQuality(): QualityEvaluation | undefined;
|
|
47
55
|
/**
|
|
48
56
|
* 获取某用户信息
|
|
49
57
|
* @returns
|
|
@@ -163,6 +171,12 @@ declare class CommonChannelEventType {
|
|
|
163
171
|
static readonly TRACK_UNMUTED = "track_unmuted";
|
|
164
172
|
/** 流轨道停止,对应data为BaseTrack */
|
|
165
173
|
static readonly TRACK_ENDED = "track_ended";
|
|
174
|
+
/** 连接质量等级变化,对应data为 ConnectionQualityEventData */
|
|
175
|
+
static readonly CONNECTION_QUALITY_CHANGED = "connection_quality_changed";
|
|
176
|
+
/** 发送端被CPU持续限制,对应data为 QualityEvaluation */
|
|
177
|
+
static readonly CPU_CONSTRAINED = "cpu_constrained";
|
|
178
|
+
/** 发送端被带宽持续限制,对应data为 QualityEvaluation */
|
|
179
|
+
static readonly BANDWIDTH_CONSTRAINED = "bandwidth_constrained";
|
|
166
180
|
}
|
|
167
181
|
/** 频道外事件类型 */
|
|
168
182
|
declare class CommonImEventType {
|
|
@@ -651,6 +665,21 @@ export declare enum Codec {
|
|
|
651
665
|
/** OPUS编码 */
|
|
652
666
|
OPUS = 1398100047
|
|
653
667
|
}
|
|
668
|
+
/**
|
|
669
|
+
* 连接质量等级(对齐 LiveKit 5 档)
|
|
670
|
+
*/
|
|
671
|
+
export declare enum ConnectionQuality {
|
|
672
|
+
/** 初始占位,采样不足时使用,避免误报 */
|
|
673
|
+
Unknown = "unknown",
|
|
674
|
+
/** 优秀:几乎无损 */
|
|
675
|
+
Excellent = "excellent",
|
|
676
|
+
/** 良好:轻微丢包或延迟 */
|
|
677
|
+
Good = "good",
|
|
678
|
+
/** 较差:明显卡顿、丢包或被 cpu/bandwidth 限制 */
|
|
679
|
+
Poor = "poor",
|
|
680
|
+
/** 连接已丢失,媒体无法传输,应触发重连 */
|
|
681
|
+
Lost = "lost"
|
|
682
|
+
}
|
|
654
683
|
/**
|
|
655
684
|
* 终端类型枚举
|
|
656
685
|
*/
|
|
@@ -816,6 +845,30 @@ export interface AudioPublishOptions {
|
|
|
816
845
|
/** 自定义属性 */
|
|
817
846
|
props?: Record<string, any>;
|
|
818
847
|
}
|
|
848
|
+
export interface AudioReceiverStats extends ReceiverStats {
|
|
849
|
+
/** 类型 */
|
|
850
|
+
type: "audio";
|
|
851
|
+
/** 音频电平 */
|
|
852
|
+
audioLevel?: number;
|
|
853
|
+
/** 隐藏样本数 */
|
|
854
|
+
concealedSamples?: number;
|
|
855
|
+
/** 隐藏事件次数 */
|
|
856
|
+
concealmentEvents?: number;
|
|
857
|
+
/** 静音隐藏样本数 */
|
|
858
|
+
silentConcealedSamples?: number;
|
|
859
|
+
/** 静音隐藏事件次数 */
|
|
860
|
+
silentConcealmentEvents?: number;
|
|
861
|
+
/** 总音频能量 */
|
|
862
|
+
totalAudioEnergy?: number;
|
|
863
|
+
/** 总样本时长 */
|
|
864
|
+
totalSamplesDuration?: number;
|
|
865
|
+
}
|
|
866
|
+
export interface AudioSenderStats extends SenderStats {
|
|
867
|
+
/** 类型 */
|
|
868
|
+
type: "audio";
|
|
869
|
+
/** 音频电平 */
|
|
870
|
+
audioLevel?: number;
|
|
871
|
+
}
|
|
819
872
|
/**
|
|
820
873
|
* sdk编译信息
|
|
821
874
|
*/
|
|
@@ -858,6 +911,15 @@ export interface CameraPreset {
|
|
|
858
911
|
capture: CameraCaptureOptions;
|
|
859
912
|
publish: VideoPublishOptions;
|
|
860
913
|
}
|
|
914
|
+
/**
|
|
915
|
+
* 连接质量变化事件 data
|
|
916
|
+
*/
|
|
917
|
+
export interface ConnectionQualityEventData {
|
|
918
|
+
/** 当前评估结果(等级、MOS、原因等) */
|
|
919
|
+
evaluation: QualityEvaluation;
|
|
920
|
+
/** 变化前的质量等级 */
|
|
921
|
+
previous: ConnectionQuality;
|
|
922
|
+
}
|
|
861
923
|
/**
|
|
862
924
|
* 自定义消息
|
|
863
925
|
*/
|
|
@@ -1075,6 +1137,33 @@ export interface MixedAudioMediaStreamTrack extends MediaStreamTrack {
|
|
|
1075
1137
|
removeTrack(track: MediaStreamTrack): void;
|
|
1076
1138
|
trackCount: number;
|
|
1077
1139
|
}
|
|
1140
|
+
/**
|
|
1141
|
+
* 网络总体统计
|
|
1142
|
+
*/
|
|
1143
|
+
export interface NetworkStats {
|
|
1144
|
+
/** 下行码率kb/s */
|
|
1145
|
+
bitrate_down: number;
|
|
1146
|
+
/** 上行码率kb/s */
|
|
1147
|
+
bitrate_up: number;
|
|
1148
|
+
/** 下行丢包率 */
|
|
1149
|
+
lossrate_down: number;
|
|
1150
|
+
/** 上行丢包率 */
|
|
1151
|
+
lossrate_up: number;
|
|
1152
|
+
/** 上行包数 */
|
|
1153
|
+
pkt_up: number;
|
|
1154
|
+
/** 下行包数 */
|
|
1155
|
+
pkt_down: number;
|
|
1156
|
+
/** 上行丢包数 */
|
|
1157
|
+
pkt_loss_up: number;
|
|
1158
|
+
/** 下行丢包数 */
|
|
1159
|
+
pkt_loss_down: number;
|
|
1160
|
+
/** SFU/BWE 估算的可用上行带宽 kb/s,来自 candidate-pair */
|
|
1161
|
+
available_outgoing_bitrate?: number;
|
|
1162
|
+
/** SFU/BWE 估算的可用下行带宽 kb/s,来自 candidate-pair */
|
|
1163
|
+
available_incoming_bitrate?: number;
|
|
1164
|
+
/** candidate-pair 实时链路 RTT ms,比 remote-inbound-rtp 更准确 */
|
|
1165
|
+
current_rtt?: number;
|
|
1166
|
+
}
|
|
1078
1167
|
/** 画中画句柄,用于控制画中画状态 */
|
|
1079
1168
|
export interface PipHandle {
|
|
1080
1169
|
/** 画中画类型:document-pip 支持自定义UI,video-pip 为传统模式 */
|
|
@@ -1129,6 +1218,42 @@ export interface PropChangeItem<T> {
|
|
|
1129
1218
|
/** 更改前的值 */
|
|
1130
1219
|
old: any;
|
|
1131
1220
|
}
|
|
1221
|
+
/**
|
|
1222
|
+
* 质量评估结果快照
|
|
1223
|
+
*/
|
|
1224
|
+
export interface QualityEvaluation {
|
|
1225
|
+
/** 上行质量 */
|
|
1226
|
+
uplink: ConnectionQuality;
|
|
1227
|
+
/** 下行质量 */
|
|
1228
|
+
downlink: ConnectionQuality;
|
|
1229
|
+
/** 总体质量,取上下行中较差的一档 */
|
|
1230
|
+
overall: ConnectionQuality;
|
|
1231
|
+
/** 音频 MOS 估算,范围 1.0 ~ 4.5 */
|
|
1232
|
+
mos: number;
|
|
1233
|
+
/** 触发当前等级的主要原因描述,便于排查 */
|
|
1234
|
+
reasons: string[];
|
|
1235
|
+
/** 采样时间戳 */
|
|
1236
|
+
timestamp: number;
|
|
1237
|
+
}
|
|
1238
|
+
/**
|
|
1239
|
+
* 接收数据统计
|
|
1240
|
+
*/
|
|
1241
|
+
export interface ReceiverStats {
|
|
1242
|
+
/** 抖动缓冲延迟 */
|
|
1243
|
+
jitterBufferDelay?: number;
|
|
1244
|
+
/** 丢包数 */
|
|
1245
|
+
packetsLost?: number;
|
|
1246
|
+
/** 已接收的包数 */
|
|
1247
|
+
packetsReceived?: number;
|
|
1248
|
+
/** 已接收的字节数 */
|
|
1249
|
+
bytesReceived?: number;
|
|
1250
|
+
/** 流ID */
|
|
1251
|
+
streamId?: string;
|
|
1252
|
+
/** 抖动 */
|
|
1253
|
+
jitter?: number;
|
|
1254
|
+
/** 时间戳 */
|
|
1255
|
+
timestamp: number;
|
|
1256
|
+
}
|
|
1132
1257
|
/**
|
|
1133
1258
|
* 屏幕采集音频配置
|
|
1134
1259
|
*/
|
|
@@ -1192,6 +1317,62 @@ export interface SdkInitParams {
|
|
|
1192
1317
|
/** 日志目标 */
|
|
1193
1318
|
logTarget?: LogTarget;
|
|
1194
1319
|
}
|
|
1320
|
+
/**
|
|
1321
|
+
* 发送数据统计
|
|
1322
|
+
*/
|
|
1323
|
+
export interface SenderStats {
|
|
1324
|
+
/** 已发送的包数 */
|
|
1325
|
+
packetsSent?: number;
|
|
1326
|
+
/** 已发送的字节数 */
|
|
1327
|
+
bytesSent?: number;
|
|
1328
|
+
/** 远端感知到的抖动 */
|
|
1329
|
+
jitter?: number;
|
|
1330
|
+
/** 远端报告的丢包数 */
|
|
1331
|
+
packetsLost?: number;
|
|
1332
|
+
/** 远端报告的往返时延(ms) */
|
|
1333
|
+
roundTripTime?: number;
|
|
1334
|
+
/** 出站流ID */
|
|
1335
|
+
streamId?: string;
|
|
1336
|
+
/** 时间戳 */
|
|
1337
|
+
timestamp: number;
|
|
1338
|
+
}
|
|
1339
|
+
/**
|
|
1340
|
+
* 流媒体引擎周期性输出的 metric 快照
|
|
1341
|
+
*/
|
|
1342
|
+
export interface StreamMetric {
|
|
1343
|
+
/** 网络总体统计 */
|
|
1344
|
+
network: NetworkStats;
|
|
1345
|
+
/** 本地发布的音频轨道 */
|
|
1346
|
+
local_audios: TrackMetric[];
|
|
1347
|
+
/** 本地发布的视频轨道 */
|
|
1348
|
+
local_videos: TrackMetric[];
|
|
1349
|
+
/** 订阅的远端音频轨道 */
|
|
1350
|
+
remote_audios: TrackMetric[];
|
|
1351
|
+
/** 订阅的远端视频轨道 */
|
|
1352
|
+
remote_videos: TrackMetric[];
|
|
1353
|
+
}
|
|
1354
|
+
/**
|
|
1355
|
+
* 单条轨道的实时 metric 快照
|
|
1356
|
+
* 由 BaseTrack.getInfo() 展开 + 运行时计算字段
|
|
1357
|
+
*/
|
|
1358
|
+
export interface TrackMetric {
|
|
1359
|
+
/** 实时码率 kb/s */
|
|
1360
|
+
bitrate?: number;
|
|
1361
|
+
/** 音频电平 dBFS */
|
|
1362
|
+
db?: number;
|
|
1363
|
+
/** 视频宽 */
|
|
1364
|
+
width?: number;
|
|
1365
|
+
/** 视频高 */
|
|
1366
|
+
height?: number;
|
|
1367
|
+
/** 实时帧率 */
|
|
1368
|
+
fps?: number;
|
|
1369
|
+
/** 原始 sender/receiver stats */
|
|
1370
|
+
stats?: AudioSenderStats | VideoSenderStats | AudioReceiverStats | VideoReceiverStats;
|
|
1371
|
+
/** 订阅端轨道所属用户 uid */
|
|
1372
|
+
uid?: string;
|
|
1373
|
+
/** 其他由 track.getInfo() 展开的字段 */
|
|
1374
|
+
[key: string]: any;
|
|
1375
|
+
}
|
|
1195
1376
|
/**
|
|
1196
1377
|
* 用户离开事件data
|
|
1197
1378
|
*/
|
|
@@ -1234,6 +1415,74 @@ export interface VideoPublishOptions {
|
|
|
1234
1415
|
props?: Record<string, any>;
|
|
1235
1416
|
simulcasts?: VideoPublishOptions[];
|
|
1236
1417
|
}
|
|
1418
|
+
export interface VideoReceiverStats extends ReceiverStats {
|
|
1419
|
+
/** 类型 */
|
|
1420
|
+
type: "video";
|
|
1421
|
+
/** 已解码的帧数 */
|
|
1422
|
+
framesDecoded: number;
|
|
1423
|
+
/** 丢帧数 */
|
|
1424
|
+
framesDropped: number;
|
|
1425
|
+
/** 已接收的帧数 */
|
|
1426
|
+
framesReceived: number;
|
|
1427
|
+
/** 帧率 */
|
|
1428
|
+
framesPerSecond?: number;
|
|
1429
|
+
/** 帧宽度 */
|
|
1430
|
+
frameWidth?: number;
|
|
1431
|
+
/** 帧高度 */
|
|
1432
|
+
frameHeight?: number;
|
|
1433
|
+
/** 发送的FIR(Full Intra Request)请求次数 */
|
|
1434
|
+
firCount?: number;
|
|
1435
|
+
/** 发送的PLI(Picture Loss Indication)请求次数 */
|
|
1436
|
+
pliCount?: number;
|
|
1437
|
+
/** 发送的NACK(Negative Acknowledgement)请求次数 */
|
|
1438
|
+
nackCount?: number;
|
|
1439
|
+
/** 解码器实现 */
|
|
1440
|
+
decoderImplementation?: string;
|
|
1441
|
+
/** MIME类型 */
|
|
1442
|
+
mimeType?: string;
|
|
1443
|
+
/** 视频卡顿次数(单次冻结 > 1s 或 > 3倍平均帧间隔,W3C 定义) */
|
|
1444
|
+
freezeCount?: number;
|
|
1445
|
+
/** 视频卡顿累计时长(s) */
|
|
1446
|
+
totalFreezesDuration?: number;
|
|
1447
|
+
/** 视频暂停次数(远端暂停发送) */
|
|
1448
|
+
pauseCount?: number;
|
|
1449
|
+
/** 视频暂停累计时长(s) */
|
|
1450
|
+
totalPausesDuration?: number;
|
|
1451
|
+
/** 由多 RTP 包拼装的帧数 */
|
|
1452
|
+
framesAssembledFromMultiplePackets?: number;
|
|
1453
|
+
/** 所有帧累计拼装耗时(s) */
|
|
1454
|
+
totalAssemblyTime?: number;
|
|
1455
|
+
}
|
|
1456
|
+
export interface VideoSenderStats extends SenderStats {
|
|
1457
|
+
/** 类型 */
|
|
1458
|
+
type: "video";
|
|
1459
|
+
/** 收到的FIR(Full Intra Request)请求次数 */
|
|
1460
|
+
firCount: number;
|
|
1461
|
+
/** 收到的PLI(Picture Loss Indication)请求次数 */
|
|
1462
|
+
pliCount: number;
|
|
1463
|
+
/** 收到的NACK(Negative Acknowledgement)请求次数 */
|
|
1464
|
+
nackCount: number;
|
|
1465
|
+
/** RTP流ID */
|
|
1466
|
+
rid: string;
|
|
1467
|
+
/** 帧宽度 */
|
|
1468
|
+
frameWidth: number;
|
|
1469
|
+
/** 帧高度 */
|
|
1470
|
+
frameHeight: number;
|
|
1471
|
+
/** 帧率 */
|
|
1472
|
+
framesPerSecond: number;
|
|
1473
|
+
/** 已发送的帧数 */
|
|
1474
|
+
framesSent: number;
|
|
1475
|
+
/** 质量限制原因(bandwidth, cpu, other, none) */
|
|
1476
|
+
qualityLimitationReason?: string;
|
|
1477
|
+
/** 质量限制持续时间 */
|
|
1478
|
+
qualityLimitationDurations?: Record<string, number>;
|
|
1479
|
+
/** 质量限制分辨率变化次数 */
|
|
1480
|
+
qualityLimitationResolutionChanges?: number;
|
|
1481
|
+
/** 重传包数 */
|
|
1482
|
+
retransmittedPacketsSent?: number;
|
|
1483
|
+
/** 目标码率 */
|
|
1484
|
+
targetBitrate: number;
|
|
1485
|
+
}
|
|
1237
1486
|
/**
|
|
1238
1487
|
* 重试执行器函数:直接调用开始执行,.cancel()取消重试,函数失败会返回maxretry或canceled
|
|
1239
1488
|
*/
|