@seastart/srtc-web-sdk 0.5.4 → 0.5.5

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,10 @@
2
2
 
3
3
  本文档记录 web SDK 各版本的改动点。遵循 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/) 风格。
4
4
 
5
+ ## v0.5.5 - 2026-06-08
6
+
7
+ - fix: 本地录制移动端画面横屏及大小窗成员黑屏修复 (b979814)
8
+
5
9
  ## v0.5.4 - 2026-06-03
6
10
 
7
11
  - feat: 新增音视频处理器插件机制
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@seastart/srtc-web-sdk",
3
- "version": "0.5.4",
3
+ "version": "0.5.5",
4
4
  "description": "srtc sdk for web",
5
5
  "main": "srtc.js",
6
6
  "module": "srtc.mjs",
package/srtc.d.mts CHANGED
@@ -1236,6 +1236,13 @@ export declare class LocalCompositeRecorder {
1236
1236
  * 从原生 MediaStreamTrack 或 SDK Track 中取出当前实际媒体轨。
1237
1237
  */
1238
1238
  private resolveMediaStreamTrack;
1239
+ /**
1240
+ * 读取 SDK Track 的视频旋转角度(FourCC)。
1241
+ *
1242
+ * 原生 MediaStreamTrack 不携带旋转信息,按未旋转(ANGLE_UP)处理。
1243
+ * 用于让录制 canvas 与正常播放路径(CSS transform)的旋转表现保持一致。
1244
+ */
1245
+ private resolveTrackAngle;
1239
1246
  /**
1240
1247
  * 判断是否为可监听 MSTRACK_REPLACED 的 SDK Track。
1241
1248
  */
@@ -1254,6 +1261,13 @@ export declare class LocalCompositeRecorder {
1254
1261
  * 同步视频解码元素。
1255
1262
  *
1256
1263
  * 每个视频 track 都需要一个隐藏 HTMLVideoElement 作为 canvas.drawImage 的帧来源。
1264
+ * 这里以底层 MediaStreamTrack「对象引用」为 key 做复用:同一个 track 即使被多个槽位
1265
+ * 引用(例如大小窗布局下同一成员同时出现在大窗和小窗),也只创建一个解码 video 共享。
1266
+ * 否则同一个远端 track 被多个独立 video 同时播放会产生竞态,偶发其中一个 video
1267
+ * 取不到帧(videoWidth=0)导致对应槽位黑屏。
1268
+ *
1269
+ * 注意:不能用 track.id 字符串做 key——远端 track 的 id 全局不保证唯一,
1270
+ * 不同用户可能碰撞,会导致多个槽位错误共享同一路画面(“都变成同一个人”)。
1257
1271
  */
1258
1272
  private syncVideoElements;
1259
1273
  /**
@@ -1266,6 +1280,8 @@ export declare class LocalCompositeRecorder {
1266
1280
  * 绘制单个视频槽位。
1267
1281
  *
1268
1282
  * contain 会完整显示视频,cover 会填满槽位并裁剪溢出区域。
1283
+ * 移动端竖屏采集的视频携带旋转角度,这里会按角度对 canvas 做等价旋转/镜像,
1284
+ * 与正常播放路径(PlayView.freshTransform 的 CSS transform)保持一致,避免录像横屏。
1269
1285
  */
1270
1286
  private drawVideo;
1271
1287
  /**
package/srtc.d.ts CHANGED
@@ -1236,6 +1236,13 @@ export declare class LocalCompositeRecorder {
1236
1236
  * 从原生 MediaStreamTrack 或 SDK Track 中取出当前实际媒体轨。
1237
1237
  */
1238
1238
  private resolveMediaStreamTrack;
1239
+ /**
1240
+ * 读取 SDK Track 的视频旋转角度(FourCC)。
1241
+ *
1242
+ * 原生 MediaStreamTrack 不携带旋转信息,按未旋转(ANGLE_UP)处理。
1243
+ * 用于让录制 canvas 与正常播放路径(CSS transform)的旋转表现保持一致。
1244
+ */
1245
+ private resolveTrackAngle;
1239
1246
  /**
1240
1247
  * 判断是否为可监听 MSTRACK_REPLACED 的 SDK Track。
1241
1248
  */
@@ -1254,6 +1261,13 @@ export declare class LocalCompositeRecorder {
1254
1261
  * 同步视频解码元素。
1255
1262
  *
1256
1263
  * 每个视频 track 都需要一个隐藏 HTMLVideoElement 作为 canvas.drawImage 的帧来源。
1264
+ * 这里以底层 MediaStreamTrack「对象引用」为 key 做复用:同一个 track 即使被多个槽位
1265
+ * 引用(例如大小窗布局下同一成员同时出现在大窗和小窗),也只创建一个解码 video 共享。
1266
+ * 否则同一个远端 track 被多个独立 video 同时播放会产生竞态,偶发其中一个 video
1267
+ * 取不到帧(videoWidth=0)导致对应槽位黑屏。
1268
+ *
1269
+ * 注意:不能用 track.id 字符串做 key——远端 track 的 id 全局不保证唯一,
1270
+ * 不同用户可能碰撞,会导致多个槽位错误共享同一路画面(“都变成同一个人”)。
1257
1271
  */
1258
1272
  private syncVideoElements;
1259
1273
  /**
@@ -1266,6 +1280,8 @@ export declare class LocalCompositeRecorder {
1266
1280
  * 绘制单个视频槽位。
1267
1281
  *
1268
1282
  * contain 会完整显示视频,cover 会填满槽位并裁剪溢出区域。
1283
+ * 移动端竖屏采集的视频携带旋转角度,这里会按角度对 canvas 做等价旋转/镜像,
1284
+ * 与正常播放路径(PlayView.freshTransform 的 CSS transform)保持一致,避免录像横屏。
1269
1285
  */
1270
1286
  private drawVideo;
1271
1287
  /**