更新日志

​

最新版本

npm info @seastart/srtc-web-sdk version

​

历史版本记录

版本更新日志持续完善中，如需了解具体版本变更，请联系技术支持。

​

近期更新

​

v0.7.0 - 2026-09-30

​

破坏性变更

• 错误码全面重排：SDK 自身的报错按跨端统一码表分配低 3 位码，不再大多落在 106000。请按 code / baseCode 判断，不要按文案判断
• 报错文案改为英文：SDK 自身报错的 message / msg 全部改为英文，只给开发者和日志看；给终端用户的提示请按错误码自行映射（错误码页有「建议给用户的提示」列）
• SdkError 改为继承 Error（有 message、name、stack，e instanceof Error 成立，msg 保留兼容）；新增 baseCode（低 3 位语义码）；包里导出 SdkError 与 ErrorCode
• HTTP 非 200 / 网络请求失败统一抛 SdkError(106006)，HTTP 状态放在 message 里（原为不带码的 Error，如 "500:..."）
• 采集失败（startCapture、请求设备权限）由浏览器原始异常改为带码的 SdkError：name 与 message 保留浏览器原值（如 NotAllowedError），原始异常在 cause，按 e.name 判断的存量代码照常生效
• 接口 HTTP 200 但响应体没有 code 字段时，以前按服务端业务错误处理（心跳直接离开频道），现在视为响应解析失败 106011、继续重试；响应体不是 JSON 同为 106011
• 已离开（或正在离开）的频道上调用 publishLocalTrack、subscribeRemote* 抛 106001（Channel has been left）；unpublishLocalTrack / unsubscribeRemoteTrack 离开频道后仍静默成功

​

新增

• 初始化参数 language（如 zh-CN、en；不传则跟随 navigator.language，取不到为 zh）：SDK 请求服务端时带 Accept-Language，服务端业务错误（1000–99999）的文案随之返回中文或英文。SDK 自身的报错固定为英文，不受它影响。见 类型定义 · SdkInitParams
• 自动播放被拦截时的提示框内置中 / 英两套文案（按 language 选择），可用初始化参数 autoPlayDialogText 覆盖；disableAutoPlayDialog 行为不变

​

修复

• 自动播放提示框不再拼接轨道 desc、改用纯文本构建，修复远端 desc 可注入 HTML 的问题

​

变更

• 轨道 toString() 前缀改为类名风格（如 LocalCameraTrack[...]），日志中的轨道名随之变为英文；连接质量评估 QualityEvaluation.reasons 改为英文（用于诊断，不是契约）
• npm 页面说明改为中英双语，许可证改为专有（UNLICENSED）

​

旧码 → 新码对照

​

v0.6.3 - 2026-09-23

• fix: 本地混音改为直连 AudioContext 出声，修复 Web 端接收音频发钝
• fix: 混音内部用于激活远端轨的隐藏音频元素补上静音并保留引用，避免被回收后混音偶发无声
• feat: RemoteAudioTrack 补齐 setJitterBufferTarget / getJitterBufferTarget（此前仅视频轨支持）

​

v0.6.2 - 2026-09-02

• fix(channel): 同一 desc 重复发布直接抛错，堵住关不掉的幽灵轨
• fix: 默认频道判定不再只靠对象身份，避免实例被响应式代理时事件全丢
• fix: 业务错误不再被吞成「调用被取消」，重连遇容量不足可自愈

​

v0.6.1 - 2026-08-06

• fix: Channel 直订远端轨事件丢失（muted/ended/pip 等不通知）；channel.subscribeRemote* 返回平台化类型（RemoteVideoTrack 等），无需再断言

​

v0.6.0 - 2026-08-05

• feat!: 引擎+多频道模型：join 返回 Channel，支持同时加入多个频道

​

v0.5.7 - 2026-07-21

• feat: 本地录制摄像头关闭时在格子中央显示圆形头像，头像加载失败或跨域被拒时回退为昵称首字母灰底圆

​

v0.5.6 - 2026-06-16

• feat: 视频支持前置摄像头镜像，前置默认开启且可由用户调整
• feat: DeepFilterNet 降噪插件

​

v0.5.4 - 2026-06-03

• feat: 新增音视频处理器插件机制
• feat: 新增wasm降噪插件

​

v0.5.3 - 2026-05-08

• feat: add local composite recorder (47a20b0)
• chore: 共享屏幕默认配置优化 (f079eeb)

​

v0.5.1 - 2026-04-27

• fix: 视频卡顿 (b7a36c2)
• feat: RemoteVideoTrack支持设置jitterBufferTarget(抗抖动目标延迟) (6aed177)

​

v0.5.0 - 2026-04-23

• feat: seastart引擎接入服务端下发质量报告
• feat: 频道事件系统类型安全改造，支持判别联合及自动类型收窄
• feat: seastart引擎Active speaker（说话中的用户）接入
• feat: 新增自适应流功能，支持根据播放窗口状态自动切换 simulcast 层，支持 SFU 下行切层通知及主动切层请求

​

v0.4.4 - 2026-04-18

• feat: simulcast 联播支持及 SFU 订阅层切换优化 (781f520)
• Web 视频轨道新增画中画与独立窗口能力：enterPictureInPicture、exitPictureInPicture、popOutToWindow、closePopOutWindow
• 新增频道事件：TRACK_PIP_ENTER、TRACK_PIP_EXIT、TRACK_POPOUT_OPEN、TRACK_POPOUT_CLOSE
• PipOptions、PopOutOptions 新增 hideOriginView 选项，默认 true