@seastart/srtc-web-sdk 0.5.4 → 0.5.6
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 +9 -0
- package/package.json +1 -1
- package/srtc.d.mts +33 -0
- package/srtc.d.ts +33 -0
- package/srtc.js +1 -1
- package/srtc.mjs +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -2,6 +2,15 @@
|
|
|
2
2
|
|
|
3
3
|
本文档记录 web SDK 各版本的改动点。遵循 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/) 风格。
|
|
4
4
|
|
|
5
|
+
## v0.5.6 - 2026-06-16
|
|
6
|
+
|
|
7
|
+
- feat: 视频支持前置摄像头镜像,前置默认开启且可由用户调整
|
|
8
|
+
- feat: DeepFilterNet 降噪插件
|
|
9
|
+
|
|
10
|
+
## v0.5.5 - 2026-06-08
|
|
11
|
+
|
|
12
|
+
- fix: 本地录制移动端画面横屏及大小窗成员黑屏修复 (b979814)
|
|
13
|
+
|
|
5
14
|
## v0.5.4 - 2026-06-03
|
|
6
15
|
|
|
7
16
|
- feat: 新增音视频处理器插件机制
|
package/package.json
CHANGED
package/srtc.d.mts
CHANGED
|
@@ -1133,6 +1133,23 @@ export declare class LocalCameraTrack extends LocalVideoTrack {
|
|
|
1133
1133
|
* @returns
|
|
1134
1134
|
*/
|
|
1135
1135
|
changeDeviceId(deviceId: string): Promise<void>;
|
|
1136
|
+
/**
|
|
1137
|
+
* 是否前置摄像头。供本地预览镜像判断使用。
|
|
1138
|
+
* 采集时显式指定的 facingMode 最可靠;未指定时按前置处理(对齐浏览器/LiveKit 的默认:
|
|
1139
|
+
* 拿不到朝向时按"自拍"看待,笔记本内置摄像头即属此类)。
|
|
1140
|
+
*/
|
|
1141
|
+
isFrontFacing(): boolean;
|
|
1142
|
+
/**
|
|
1143
|
+
* 设置镜像开关。前置摄像头默认开启,可在此调整;
|
|
1144
|
+
* 后置摄像头不支持镜像,调用无任何反应(满足"后置操作无反应")。
|
|
1145
|
+
* @param enabled 是否开启镜像
|
|
1146
|
+
*/
|
|
1147
|
+
setMirror(enabled: boolean): void;
|
|
1148
|
+
/**
|
|
1149
|
+
* 当前是否处于镜像状态 = 前置摄像头 且 镜像开关开启。
|
|
1150
|
+
* 后置摄像头恒为 false。渲染层据此决定是否水平翻转。
|
|
1151
|
+
*/
|
|
1152
|
+
isMirrored(): boolean;
|
|
1136
1153
|
/**
|
|
1137
1154
|
* 切换摄像头朝向(仅手机)
|
|
1138
1155
|
* @returns
|
|
@@ -1236,6 +1253,13 @@ export declare class LocalCompositeRecorder {
|
|
|
1236
1253
|
* 从原生 MediaStreamTrack 或 SDK Track 中取出当前实际媒体轨。
|
|
1237
1254
|
*/
|
|
1238
1255
|
private resolveMediaStreamTrack;
|
|
1256
|
+
/**
|
|
1257
|
+
* 读取 SDK Track 的视频旋转角度(FourCC)。
|
|
1258
|
+
*
|
|
1259
|
+
* 原生 MediaStreamTrack 不携带旋转信息,按未旋转(ANGLE_UP)处理。
|
|
1260
|
+
* 用于让录制 canvas 与正常播放路径(CSS transform)的旋转表现保持一致。
|
|
1261
|
+
*/
|
|
1262
|
+
private resolveTrackAngle;
|
|
1239
1263
|
/**
|
|
1240
1264
|
* 判断是否为可监听 MSTRACK_REPLACED 的 SDK Track。
|
|
1241
1265
|
*/
|
|
@@ -1254,6 +1278,13 @@ export declare class LocalCompositeRecorder {
|
|
|
1254
1278
|
* 同步视频解码元素。
|
|
1255
1279
|
*
|
|
1256
1280
|
* 每个视频 track 都需要一个隐藏 HTMLVideoElement 作为 canvas.drawImage 的帧来源。
|
|
1281
|
+
* 这里以底层 MediaStreamTrack「对象引用」为 key 做复用:同一个 track 即使被多个槽位
|
|
1282
|
+
* 引用(例如大小窗布局下同一成员同时出现在大窗和小窗),也只创建一个解码 video 共享。
|
|
1283
|
+
* 否则同一个远端 track 被多个独立 video 同时播放会产生竞态,偶发其中一个 video
|
|
1284
|
+
* 取不到帧(videoWidth=0)导致对应槽位黑屏。
|
|
1285
|
+
*
|
|
1286
|
+
* 注意:不能用 track.id 字符串做 key——远端 track 的 id 全局不保证唯一,
|
|
1287
|
+
* 不同用户可能碰撞,会导致多个槽位错误共享同一路画面(“都变成同一个人”)。
|
|
1257
1288
|
*/
|
|
1258
1289
|
private syncVideoElements;
|
|
1259
1290
|
/**
|
|
@@ -1266,6 +1297,8 @@ export declare class LocalCompositeRecorder {
|
|
|
1266
1297
|
* 绘制单个视频槽位。
|
|
1267
1298
|
*
|
|
1268
1299
|
* contain 会完整显示视频,cover 会填满槽位并裁剪溢出区域。
|
|
1300
|
+
* 移动端竖屏采集的视频携带旋转角度,这里会按角度对 canvas 做等价旋转/镜像,
|
|
1301
|
+
* 与正常播放路径(PlayView.freshTransform 的 CSS transform)保持一致,避免录像横屏。
|
|
1269
1302
|
*/
|
|
1270
1303
|
private drawVideo;
|
|
1271
1304
|
/**
|
package/srtc.d.ts
CHANGED
|
@@ -1133,6 +1133,23 @@ export declare class LocalCameraTrack extends LocalVideoTrack {
|
|
|
1133
1133
|
* @returns
|
|
1134
1134
|
*/
|
|
1135
1135
|
changeDeviceId(deviceId: string): Promise<void>;
|
|
1136
|
+
/**
|
|
1137
|
+
* 是否前置摄像头。供本地预览镜像判断使用。
|
|
1138
|
+
* 采集时显式指定的 facingMode 最可靠;未指定时按前置处理(对齐浏览器/LiveKit 的默认:
|
|
1139
|
+
* 拿不到朝向时按"自拍"看待,笔记本内置摄像头即属此类)。
|
|
1140
|
+
*/
|
|
1141
|
+
isFrontFacing(): boolean;
|
|
1142
|
+
/**
|
|
1143
|
+
* 设置镜像开关。前置摄像头默认开启,可在此调整;
|
|
1144
|
+
* 后置摄像头不支持镜像,调用无任何反应(满足"后置操作无反应")。
|
|
1145
|
+
* @param enabled 是否开启镜像
|
|
1146
|
+
*/
|
|
1147
|
+
setMirror(enabled: boolean): void;
|
|
1148
|
+
/**
|
|
1149
|
+
* 当前是否处于镜像状态 = 前置摄像头 且 镜像开关开启。
|
|
1150
|
+
* 后置摄像头恒为 false。渲染层据此决定是否水平翻转。
|
|
1151
|
+
*/
|
|
1152
|
+
isMirrored(): boolean;
|
|
1136
1153
|
/**
|
|
1137
1154
|
* 切换摄像头朝向(仅手机)
|
|
1138
1155
|
* @returns
|
|
@@ -1236,6 +1253,13 @@ export declare class LocalCompositeRecorder {
|
|
|
1236
1253
|
* 从原生 MediaStreamTrack 或 SDK Track 中取出当前实际媒体轨。
|
|
1237
1254
|
*/
|
|
1238
1255
|
private resolveMediaStreamTrack;
|
|
1256
|
+
/**
|
|
1257
|
+
* 读取 SDK Track 的视频旋转角度(FourCC)。
|
|
1258
|
+
*
|
|
1259
|
+
* 原生 MediaStreamTrack 不携带旋转信息,按未旋转(ANGLE_UP)处理。
|
|
1260
|
+
* 用于让录制 canvas 与正常播放路径(CSS transform)的旋转表现保持一致。
|
|
1261
|
+
*/
|
|
1262
|
+
private resolveTrackAngle;
|
|
1239
1263
|
/**
|
|
1240
1264
|
* 判断是否为可监听 MSTRACK_REPLACED 的 SDK Track。
|
|
1241
1265
|
*/
|
|
@@ -1254,6 +1278,13 @@ export declare class LocalCompositeRecorder {
|
|
|
1254
1278
|
* 同步视频解码元素。
|
|
1255
1279
|
*
|
|
1256
1280
|
* 每个视频 track 都需要一个隐藏 HTMLVideoElement 作为 canvas.drawImage 的帧来源。
|
|
1281
|
+
* 这里以底层 MediaStreamTrack「对象引用」为 key 做复用:同一个 track 即使被多个槽位
|
|
1282
|
+
* 引用(例如大小窗布局下同一成员同时出现在大窗和小窗),也只创建一个解码 video 共享。
|
|
1283
|
+
* 否则同一个远端 track 被多个独立 video 同时播放会产生竞态,偶发其中一个 video
|
|
1284
|
+
* 取不到帧(videoWidth=0)导致对应槽位黑屏。
|
|
1285
|
+
*
|
|
1286
|
+
* 注意:不能用 track.id 字符串做 key——远端 track 的 id 全局不保证唯一,
|
|
1287
|
+
* 不同用户可能碰撞,会导致多个槽位错误共享同一路画面(“都变成同一个人”)。
|
|
1257
1288
|
*/
|
|
1258
1289
|
private syncVideoElements;
|
|
1259
1290
|
/**
|
|
@@ -1266,6 +1297,8 @@ export declare class LocalCompositeRecorder {
|
|
|
1266
1297
|
* 绘制单个视频槽位。
|
|
1267
1298
|
*
|
|
1268
1299
|
* contain 会完整显示视频,cover 会填满槽位并裁剪溢出区域。
|
|
1300
|
+
* 移动端竖屏采集的视频携带旋转角度,这里会按角度对 canvas 做等价旋转/镜像,
|
|
1301
|
+
* 与正常播放路径(PlayView.freshTransform 的 CSS transform)保持一致,避免录像横屏。
|
|
1269
1302
|
*/
|
|
1270
1303
|
private drawVideo;
|
|
1271
1304
|
/**
|