Skip to content

armgit / Piik

Public Imported from GitHub
0

Free, open-source screen sharing for private live streams with friends. Watch together in a browser or self-host Piik. 免费开源的私密屏幕共享,支持游戏直播、一起看电影与自部署。

fix(media): align quality presets (#264)

AAA7727054581d4
diff --git a/docs/project-memory.md b/docs/project-memory.md
index 5ddc6f2c..0bc4557a 100644
--- a/docs/project-memory.md
+++ b/docs/project-memory.md
@@ -68,7 +68,7 @@ Last updated: 2026-08-25
- Browser video is VP8 only. Display video uses `contentHint = "motion"` and
display audio uses `contentHint = "music"`. Codec UI/state/wire, backup media
codecs, and runtime codec switching do not exist.
-- Recommended profiles remain exactly `1080p60`, `1080p30`, and `720p30`, with
+- Recommended profiles remain exactly `720p30`, `1080p30`, and `1080p60`, with
`1080p30` default. `480p` is only an advanced `854x480` resolution choice;
advanced FPS and bitrate remain independent.
- WebRTC owns direct/peer media adaptation. The Host reapplies the selected video
@@ -77,9 +77,9 @@ Last updated: 2026-08-25
layers. Pinned LiveKit defaults own representations, Dynacast owns aggregate
demand, and server send-side BWE owns subscriber forwarding. AdaptiveStream
stays disabled because any Viewer may relay its received track.
-- Screen audio requests capture by default and offers live 64/128/256 kbps
- sender ceilings with 128 default. Peer answers request Opus stereo with a
- 256 kbps receive maximum. SFU publication uses stereo, DTX off, and RED off;
+- Screen audio requests capture by default and offers live 96/128/192 kbps
+ sender ceilings with 96 default. Peer answers request Opus stereo with a
+ 192 kbps receive maximum. SFU publication uses stereo, DTX off, and RED off;
disabling RED accepts reduced burst-loss resilience in exchange for bounded
publisher traffic.
- Configured resolution, FPS, bitrate, preference, codec, and audio ceiling are
diff --git a/docs/research/browser-screen-audio-quality.md b/docs/research/browser-screen-audio-quality.md
index 753c969b..9e4cef21 100644
--- a/docs/research/browser-screen-audio-quality.md
+++ b/docs/research/browser-screen-audio-quality.md
@@ -16,8 +16,8 @@ stereo and disables echo cancellation, noise suppression, automatic gain, and
voice isolation where the browser supports those constraints. These are
preferences and readback fields, not portable fidelity guarantees.
-The only user-facing audio-quality choices are sender ceilings of 64, 128, and
-256 kbps, with 128 kbps as the default. They update live on current P2P,
+The only user-facing audio-quality choices are sender ceilings of 96, 128, and
+192 kbps, with 96 kbps as the default. They update live on current P2P,
Browser-relay, and SFU senders and apply to future senders. Actual RTP traffic
can remain below a ceiling because of content and congestion, and includes
transport behavior not represented by the selected number.
@@ -26,11 +26,11 @@ transport behavior not represented by the selected number.
Direct and Browser-relay Viewer answers use one structured `sdp-transform`
operation on the single active Opus audio section. It idempotently requests
-`stereo=1` and `maxaveragebitrate=256000`, preserving every unrelated codec,
+`stereo=1` and `maxaveragebitrate=192000`, preserving every unrelated codec,
format parameter, media section, and session attribute. Missing, ambiguous, or
malformed targets return the browser-generated answer unchanged.
-The 256 kbps receive maximum permits every sender ceiling; it is not a current
+The 192 kbps receive maximum permits every sender ceiling; it is not a current
target or minimum. Screener does not set `sprop-stereo`, rewrite FEC, force a
sample rate, or add broad string/regular-expression SDP mutation.
@@ -41,8 +41,9 @@ room-wide atomic convergence.
## LiveKit Contract
-The SFU publisher maps the three ceilings to pinned LiveKit stereo music presets
-or an explicit 256 kbps preset. Every SFU audio publication uses:
+The SFU publisher maps 96 and 128 kbps to pinned LiveKit music presets and uses
+an explicit 192 kbps preset for the highest ceiling. Every SFU audio publication
+uses:
- `forceStereo: true`;
- `dtx: false`; and
@@ -81,9 +82,10 @@ identity, so stale asynchronous samples cannot overwrite the new route.
## Evidence Boundary
Chrome 151 production gates exercised direct Host children, a Browser-relay
-child, and an SFU subscriber with generated screen audio. Video and decoded
-audio energy advanced at all three 64/128/256 kbps ceilings and after source
-replacement. Direct and Browser-relay traffic tracked the selected ceiling;
+child, and an SFU subscriber with generated screen audio. Under the preceding
+64/128/256 kbps contract, video and decoded audio energy advanced at all three
+ceilings and after source replacement. Direct and Browser-relay traffic tracked
+the selected ceiling;
the then-enabled SFU RED path explained the approximately doubled SFU audio
payload.
diff --git a/docs/status.md b/docs/status.md
index 8fa8f1a2..f0ab20c5 100644
--- a/docs/status.md
+++ b/docs/status.md
@@ -30,7 +30,7 @@ This is the current execution index. Git history owns completed timelines;
The SFU publisher leaves representation construction to pinned LiveKit,
enables Dynacast, uses server send-side BWE, keeps AdaptiveStream disabled,
and configures no external ICE servers on Browser SFU PCs.
-- Screen audio provides live 64/128/256 kbps ceilings with 128 default. SFU
+- Screen audio provides live 96/128/192 kbps ceilings with 96 default. SFU
publication uses stereo, DTX off, and RED off. Early autoplay presentation is
gated by current media connection state.
diff --git "a/docs/\346\226\271\346\241\210\350\256\276\350\256\241.md" "b/docs/\346\226\271\346\241\210\350\256\276\350\256\241.md"
index 98492c72..a1365e1f 100644
--- "a/docs/\346\226\271\346\241\210\350\256\276\350\256\241.md"
+++ "b/docs/\346\226\271\346\241\210\350\256\276\350\256\241.md"
@@ -2,7 +2,7 @@
## 2026-08-18 14:45
-状态:production 与 canonical application/runtime tree 使用严格 `screener-v12`。Browser 视频固定 VP8 并使用 `contentHint = "motion"`,音频使用 `music`;codec UI/state/wire、自定义 SFU layer list与应用媒体质量 controller 均不存在。SFU 由 pinned LiveKit 默认 representations、Dynacast、server send-side BWE 和 disabled AdaptiveStream 拥有质量适配;screen audio 使用 64/128/256 kbps ceiling、stereo、DTX off 与 RED off。Viewer 页面恢复、原生控件和当前线路重连已进入 source 与 production,精确执行状态由 `docs/status.md` 持有。
+状态:production 与 canonical application/runtime tree 使用严格 `screener-v12`。Browser 视频固定 VP8 并使用 `contentHint = "motion"`,音频使用 `music`;codec UI/state/wire、自定义 SFU layer list与应用媒体质量 controller 均不存在。SFU 由 pinned LiveKit 默认 representations、Dynacast、server send-side BWE 和 disabled AdaptiveStream 拥有质量适配;screen audio 使用 96/128/192 kbps ceiling、stereo、DTX off 与 RED off。Viewer 页面恢复、原生控件和当前线路重连已进入 source 与 production,精确执行状态由 `docs/status.md` 持有。
## 目标与边界
@@ -154,11 +154,11 @@ accepted 的唯一 wire 是 `screener-v12`,不做版本协商、旧 parser、
| 档位 | 约束目标 | 初始码率上限 |
| --- | --- | ---: |
-| 1080p60 | 1920x1080、60 fps | 8 Mbps/peer |
-| 1080p30 | 1920x1080、30 fps | 5 Mbps/peer |
| 720p30 | 1280x720、30 fps | 3 Mbps/peer |
+| 1080p30 | 1920x1080、30 fps | 5 Mbps/peer |
+| 1080p60 | 1920x1080、60 fps | 8 Mbps/peer |
-浏览器可返回更低设置,界面以 `track.getSettings()` 显示实际捕获结果。推荐区始终只有表中的三档并默认选择中档 `1080p30`;高级分辨率额外提供 `480p`(854x480)、720p、1080p 与 1440p,FPS 继续独立接受 15 至 60 整数,码率继续独立接受 2 至 12 Mbps,因此不建立第四个推荐档或 `480p` preset ID。视频 track 使用标准 `contentHint = "motion"` 表达游戏动态意图;返回的音频 track 使用 `contentHint = "music"`。默认 `1080p30` 与折叠高级区初始值采用 `degradationPreference = "maintain-resolution"`,1080p60 与 720p30 推荐档采用 `balanced`,并允许显式选择 balanced 或 fluid。“分享高级设置”不提供 codec 选择,并提供离散的 `64 kbps 省流 | 128 kbps 音乐默认 | 256 kbps 极高音质` 屏幕音频 sender ceiling。音频 ceiling 可在直播中串行更新。这些设置只是 ceiling 和浏览器偏好,不保证实际分辨率、帧率、码率或声道。
+浏览器可返回更低设置,界面以 `track.getSettings()` 显示实际捕获结果。推荐区始终只有表中的三档并默认选择中档 `1080p30`;高级分辨率额外提供 `480p`(854x480)、720p、1080p 与 1440p,FPS 继续独立接受 15 至 60 整数,码率继续独立接受 2 至 12 Mbps,因此不建立第四个推荐档或 `480p` preset ID。视频 track 使用标准 `contentHint = "motion"` 表达游戏动态意图;返回的音频 track 使用 `contentHint = "music"`。默认 `1080p30` 与折叠高级区初始值采用 `degradationPreference = "maintain-resolution"`,1080p60 与 720p30 推荐档采用 `balanced`,并允许显式选择 balanced 或 fluid。“分享高级设置”不提供 codec 选择,并提供离散的 `96 kbps 普通默认 | 128 kbps 音乐 | 192 kbps 保真` 屏幕音频 sender ceiling。音频 ceiling 可在直播中串行更新。这些设置只是 ceiling 和浏览器偏好,不保证实际分辨率、帧率、码率或声道。
每次 `setParameters()` 都必须从当次 `getParameters()` 派生更新,然后读回 requested/applied `maxBitrate`、`maxFramerate`、`scaleResolutionDownBy` 和 degradation preference。浏览器负责具体降级,实际结果由 stats 观测;拒绝或浏览器改写必须进入可见状态,不能只写 `console.warn`。
@@ -178,11 +178,11 @@ Host 本地预览直接绑定现有 capture stream,不创建 viewer、`RTCPeer
codec 与 content-hint 依据由研究文档持有。`motion` 会改变 Chromium/libwebrtc 的适配取舍并可能空间降级以保留游戏动态;它是标准内容意图,不是分辨率或帧率保证。产品不再用 unset hint 固定 screen-classified 行为,也不围绕某次测量实现应用缩放器。普通 AMD H.264 MFT 的浏览器码控仍丢帧,而诊断性 Desktop SW BRC 可恢复约 30 fps,说明问题不等于硬件编码器本身的吞吐上限;网页没有启用该浏览器进程开关或选择具体 GPU/MFT 的 API。实际 codec 与 encoder 字段只用于诊断,不触发 codec 切换。VP8 hardware acceleration 需要后续按目标浏览器和真实游戏负载单独取证;本设计不假定其存在,也不增加替代 codec 或自定义编码路径。
-`track.getSettings()` 中存在的 EC/NS/AGC/voice-isolation、`channelCount` 和 `sampleRate` 只能作为当前捕获观测;缺失字段保持未知,Opus 协商仍是独立事实。每个 Web Host 或浏览器 relay 的实际音频 sender 在首次绑定和换源后通过标准 `RTCRtpSender.setParameters()` 请求并读回当前 64/128/256 kbps ceiling;这只是上限,浏览器 WebRTC 拥塞控制仍可降低实际流量,不新增应用层音频降级器。128 kbps 保持默认,因为 RFC 7587 将 20 ms full-band stereo music 的建议区间列为 64--128 kbps,pinned LiveKit 2.22.0 也把 128 kbps 命名为 `musicHighQualityStereo`;256 kbps 是用户显式选择的较高上限,不是质量保证。Peer answer 声明 `stereo=1;maxaveragebitrate=256000`,让同一接收协商覆盖所有三档,实际 sender ceiling 仍由所选档位约束;普通 PC synthetic 不用于标定参数、听感或性能。
+`track.getSettings()` 中存在的 EC/NS/AGC/voice-isolation、`channelCount` 和 `sampleRate` 只能作为当前捕获观测;缺失字段保持未知,Opus 协商仍是独立事实。每个 Web Host 或浏览器 relay 的实际音频 sender 在首次绑定和换源后通过标准 `RTCRtpSender.setParameters()` 请求并读回当前 96/128/192 kbps ceiling;这只是上限,浏览器 WebRTC 拥塞控制仍可降低实际流量,不新增应用层音频降级器。96 kbps 普通是默认 ceiling;128 kbps 音乐和 192 kbps 保真由用户显式选择,均不是最低码率或质量保证。Peer answer 声明 `stereo=1;maxaveragebitrate=192000`,让同一接收协商覆盖所有三档,实际 sender ceiling 仍由所选档位约束;普通 PC synthetic 不用于标定参数、听感或性能。
-Web peer 的最小 stereo 契约只改 Viewer 生成的 answer。实现把 MIT `sdp-transform` 2.15.0 与 `@types/sdp-transform` 声明为 root direct dependencies,不依赖 LiveKit 的 transitive install,也不用字符串或正则拼接 SDP。Helper 仅在解析出唯一非 rejected audio media、通过结构化 `rtp` entry 找到唯一 Opus payload 时,才在该 payload 的 fmtp 幂等 upsert `stereo=1` 与 `maxaveragebitrate=256000`;随后 `ViewerPeer` 把同一个结果交给 `setLocalDescription()` 和 signaling。首次连接、ICE restart、同 parent rebuild与浏览器 relay child 都走该边界。空 SDP、无或歧义 Opus、多个有效 audio、重复目标参数、畸形 fmtp、parse/write 异常都按对象 identity 返回浏览器原 answer,保住仍可继续的 mono/video edge,不发送半修改 SDP。RFC 7587 说明这两个值都是可选的单向 receiver parameters;`maxaveragebitrate` 是 maximum 而非最低保证,实际发送仍可随拥塞下降。当前 libwebrtc 把缺省 full-band stereo codec bitrate 配成 64 kbps,而 `RTCRtpSender.maxBitrate` 只限制上界;本接收上限允许三档,实际发送预算仍由 64/128/256 kbps sender ceiling 与拥塞共同决定。`sprop-stereo` 只是 sender likelihood hint,`usedtx` 缺省已是 0,本 slice 不增加二者,也不改浏览器协商的 `useinbandfec`。
+Web peer 的最小 stereo 契约只改 Viewer 生成的 answer。实现把 MIT `sdp-transform` 2.15.0 与 `@types/sdp-transform` 声明为 root direct dependencies,不依赖 LiveKit 的 transitive install,也不用字符串或正则拼接 SDP。Helper 仅在解析出唯一非 rejected audio media、通过结构化 `rtp` entry 找到唯一 Opus payload 时,才在该 payload 的 fmtp 幂等 upsert `stereo=1` 与 `maxaveragebitrate=192000`;随后 `ViewerPeer` 把同一个结果交给 `setLocalDescription()` 和 signaling。首次连接、ICE restart、同 parent rebuild与浏览器 relay child 都走该边界。空 SDP、无或歧义 Opus、多个有效 audio、重复目标参数、畸形 fmtp、parse/write 异常都按对象 identity 返回浏览器原 answer,保住仍可继续的 mono/video edge,不发送半修改 SDP。RFC 7587 说明这两个值都是可选的单向 receiver parameters;`maxaveragebitrate` 是 maximum 而非最低保证,实际发送仍可随拥塞下降。当前 libwebrtc 把缺省 full-band stereo codec bitrate 配成 64 kbps,而 `RTCRtpSender.maxBitrate` 只限制上界;本接收上限允许三档,实际发送预算仍由 96/128/192 kbps sender ceiling 与拥塞共同决定。`sprop-stereo` 只是 sender likelihood hint,`usedtx` 缺省已是 0,本 slice 不增加二者,也不改浏览器协商的 `useinbandfec`。
-SFU publisher 将 64 kbps 映射到 `AudioPresets.musicStereo`、128 kbps 映射到 `musicHighQualityStereo`,256 kbps 使用显式 `maxBitrate`;三者都使用 `forceStereo: true`、`dtx: false` 与 `red: false`。RED 与 Opus in-band FEC 是不同修复机制;关闭 RED 降低冗余流量并接受其弱网恢复退让,不声称禁用或替代 Opus FEC。直播中只改变档位时,不重新协商 Opus 或 republish;服务端沿现有 quality wire 保存 last-wins desired profile,各客户端 sender-mutation queue 从 fresh parameters 更新当前 P2P、relay 和 SFU audio sender并立即 readback,过期 completion 不覆盖新值,未来 sender 读取最新 desired profile。应用失败保留该 sender 的旧 applied 值和媒体并显示告警;无远端 applied 回执时 Host 不宣称全房原子收敛。Viewer 继续在同一个持久 `MediaStream`/媒体元素中增删 screen video/audio track;不新建 audio element、Web Audio mix/resample graph、第二 audio representation 或独立音频时钟。详细证据见 `docs/research/browser-screen-audio-quality.md`。
+SFU publisher 将 96 kbps 映射到 `AudioPresets.musicHighQuality`、128 kbps 映射到 `musicHighQualityStereo`,192 kbps 使用显式 `maxBitrate`;三者都使用 `forceStereo: true`、`dtx: false` 与 `red: false`。RED 与 Opus in-band FEC 是不同修复机制;关闭 RED 降低冗余流量并接受其弱网恢复退让,不声称禁用或替代 Opus FEC。直播中只改变档位时,不重新协商 Opus 或 republish;服务端沿现有 quality wire 保存 last-wins desired profile,各客户端 sender-mutation queue 从 fresh parameters 更新当前 P2P、relay 和 SFU audio sender并立即 readback,过期 completion 不覆盖新值,未来 sender 读取最新 desired profile。应用失败保留该 sender 的旧 applied 值和媒体并显示告警;无远端 applied 回执时 Host 不宣称全房原子收敛。Viewer 继续在同一个持久 `MediaStream`/媒体元素中增删 screen video/audio track;不新建 audio element、Web Audio mix/resample graph、第二 audio representation 或独立音频时钟。详细证据见 `docs/research/browser-screen-audio-quality.md`。
Viewer 本地连接详情只从当前 route 的唯一 inbound screen video/audio stats 读取同步证据:`audio estimatedPlayoutTimestamp - video estimatedPlayoutTimestamp` 表示当前发送端时间线差;音视频 jitter-buffer delay 取相邻窗口累计 delay/count 的比值;音频 concealment 取相邻窗口 concealed/total sample 与 event 增量。每个媒体种类用 stats id、SSRC 和 track identifier 共同守住区间身份,换流或累计计数回退时先重新基线,字段缺失或分母为零时保持未知。该证据不进入 signaling、质量上报或持久化,也不设置 `jitterBufferTarget`、Web Audio 或任何媒体控制参数;真实同步仍由同一持久 `MediaStream`/媒体元素和 WebRTC playout 负责。
diff --git "a/docs/\351\234\200\346\261\202\347\220\206\350\247\243.md" "b/docs/\351\234\200\346\261\202\347\220\206\350\247\243.md"
index e168e2a2..cdfb5b7e 100644
--- "a/docs/\351\234\200\346\261\202\347\220\206\350\247\243.md"
+++ "b/docs/\351\234\200\346\261\202\347\220\206\350\247\243.md"
@@ -27,7 +27,7 @@ SFU 的 publication、subscription、server-resource accounting、临时 overlap
- 端点发送容量:所有非服务器端点使用同一个服务端权威稳态 outbound media-copy capacity,由唯一部署项 `ENDPOINT_MEDIA_COPY_CAPACITY` 配置,默认 `2` 且只接受 `1`、`2` 或 `3`;不读取旧键或保留第二套 tier。peer child 或 Host 的唯一 SFU publication 各消耗一份,上游接收不消耗该预算。客户端只能声明不高于部署值的可用容量,角色、浏览器、UA、设备类型和页面可见性不产生不同上限。服务端在每次 `authenticated` 权威快照中返回最终 `endpointMediaCopyCapacity`;普通非 peer-assisted 模式也只授权稳定加入顺序中的至多 `C` 个 Host child,超额 Viewer 保持入房等待并在槽位释放后提升,信令不能绕过该集合。Browser Host 与 Viewer 严格校验该值并用它约束稳态 assignment;并行产生媒体的 candidate 必须持有唯一 `TransitionOverlapSlot`,active+pending 物理 copy 只可达到 `min(C + 1, 3)` 并在 commit/abort 后释放。`C=3` 满载时必须先收到 active bounded-gap retirement 再 prepare,绝不产生第四份 copy。SFU subscriber egress 由独立 server admission 记账。当前不兼容房间合同以单一 release 原子升级;缺失/非法 cap、旧 wire 与 executable sender都在取得room/route authority前fail closed。
- P2P 优先:每条普通逻辑媒体边先尝试 direct/peer UDP,服务器不得默认中转可直连媒体。更多观看者优先沿满足统一端点容量的无环 peer 图分布;每名 Viewer 同时至多一个 active upstream,失败时只影响需要重选的 child。任何 source-reachable endpoint 在 effective capacity 有空位时都可作为 parent candidate;Peer-fed 与 SFU-fed endpoint 使用同一个 provisional-child transaction,并在 candidate child 解码出第一帧新画面后独立提交该 edge。Host 已满且首次需要 SFU 时,同一 reconcile 将 affected Host direct child(若无则稳定顺序中最新的 connected Host direct child)作为本次 child operation,创建唯一 Host publication 并把该 child 变为首个 SFU subscriber,subtree 不动;publication 取代释放的 Host peer slot,下一次扫描再处理原受限 Viewer,不建立 bootstrap 状态机。
- NAT 与传输边界:STUN 必须可用,所有 ordinary peer `RTCPeerConnection` 只接收 STUN ICE servers。Browser LiveKit publisher/subscriber PC 必须显式使用空 `iceServers`,保留 LiveKit signaling 交付的授权 SFU UDP candidates,并由标准 ICE 选择 nominated non-relay pair;不得把 ordinary-peer STUN、LiveKit join response 中的 STUN 或默认公共 STUN混入该 PC,也不得把某一种 candidate type 或数量写成成功条件。部署 STUN 仍供 ordinary peers 和 LiveKit server-side 公网地址发现使用。浏览器 ICE connectivity checks 是 direct UDP 可达性的权威;Screener 不合成 remote candidate、不预测端口、不分类 NAT,也不使用 TCP 探测推断 UDP 媒体可达性。所有恢复和候选授权必须绑定 authenticated room/endpoint session、share generation、base/pending route revision 与 candidate connection identity;成功即停止,失败、超时或绑定失效即撤销,direct 阶段耗尽后在同一 operation deadline 内进入 SFU/UDP,全部可用路径耗尽后明确等待或失败。已接受的完整顺序只有保持或尝试 direct/STUN peers,再复用或建立 direct-ingress Host publication/SFU subscription。Screener 不配置 TURN、ICE/TCP、media TCP 或 TLS-relayed media;当前 LiveKit 也保持 UDP-only。未来若真实严格防火墙矩阵证明需要另一种传输,必须把它作为 LiveKit 内部能力重新决策,不能增加第三种应用 route candidate。LiveKit join JWT 仅按协议进入不得记录的 WebSocket request target;HTTPS/WSS 继续独立使用 TLS/TCP。
-- 质量控制:推荐档位始终只有 1080p60(8 Mbps)、1080p30(5 Mbps)、720p30(3 Mbps)三档,默认选择中档 `1080p30`。高级设置的分辨率选项增加 `480p`(854x480),其 FPS 与码率仍由高级控件独立选择;不增加 `480p` 推荐档、preset ID 或固定的 480p FPS/码率组合。默认 `1080p30` 与高级设置初始值采用 `maintain-resolution`(清晰优先),1080p60、720p30 继续采用 `balanced`(平衡),`maintain-framerate`(流畅优先)保留为显式选择。Browser 视频固定使用 VP8;界面、质量状态和 wire 不提供 codec 选择或切换。分享期间可直接换视频档位和 64/128/256 kbps 音频 sender ceiling,不重新选择来源或重建健康连接。Peer-assisted relay 与已配置的 SFU 必须接收同一个严格校验的房间级权威设置,覆盖当前和以后建立的 sender;普通 P2P 信令结构保持不变。任何设置都只是浏览器上限和偏好,具体降级由 WebRTC/LiveKit 决定;必须读回实际 sender 参数并通过 stats 观测结果、显示参数拒绝、改写和持续受限原因。Host 资源不足时由 Host 主动选择较低的现有档位。Screener 不设置自定义 SFU layer list、动态 FPS、综合评分或周期性全房间调档。
+- 质量控制:推荐档位始终只有 720p30(3 Mbps)、1080p30(5 Mbps)、1080p60(8 Mbps)三档,默认选择中档 `1080p30`。高级设置的分辨率选项增加 `480p`(854x480),其 FPS 与码率仍由高级控件独立选择;不增加 `480p` 推荐档、preset ID 或固定的 480p FPS/码率组合。默认 `1080p30` 与高级设置初始值采用 `maintain-resolution`(清晰优先),1080p60、720p30 继续采用 `balanced`(平衡),`maintain-framerate`(流畅优先)保留为显式选择。Browser 视频固定使用 VP8;界面、质量状态和 wire 不提供 codec 选择或切换。分享期间可直接换视频档位和 96/128/192 kbps 音频 sender ceiling,不重新选择来源或重建健康连接。Peer-assisted relay 与已配置的 SFU 必须接收同一个严格校验的房间级权威设置,覆盖当前和以后建立的 sender;普通 P2P 信令结构保持不变。任何设置都只是浏览器上限和偏好,具体降级由 WebRTC/LiveKit 决定;必须读回实际 sender 参数并通过 stats 观测结果、显示参数拒绝、改写和持续受限原因。Host 资源不足时由 Host 主动选择较低的现有档位。Screener 不设置自定义 SFU layer list、动态 FPS、综合评分或周期性全房间调档。
- 路径隔离表示:direct/peer 继续使用每条 PeerConnection 独立的 stock WebRTC GCC,不把 Viewer 反馈合成全房目标。Browser Host 的唯一 SFU publication 不设置 `screenShareSimulcastLayers`,由锁定的 LiveKit client 默认行为拥有 VP8 screen-share representations、source replacement 与 republish;LiveKit Dynacast 和启用 send-side BWE 的 server stream allocator 负责需求聚合与每个 subscriber 的实际下行层。Screener 不实现质量评分、带宽估计、周期调档或应用媒体层 selector。所有当前 Viewer 都可能承担 peer children,因此 subscriber 保持 `adaptiveStream: false`,不得让本地元素尺寸或可见性控制 relay ingress。表示选择不改变拓扑、端点容量或路由失效权威。
- 路由失效输入:应用不推断 parent-wide 质量,也不计算综合分数。当前 authenticated child 只在 PeerConnection `failed/closed`,或非权威暂停时现有 periodic stats 在统一 deadline 内没有新 decoded frame 时,使自己的 exact edge 失效并唤醒同一个 reconcile。decoded progress 只保存 route-keyed `lastDecodedAt`,route/connection变化或新帧重置、暂停抑制,同一 edge只报告一次,不增加轮询器。Active SFU route 暂时没有 video track、stats report 为空或 stats 读取失败时,现有采样 cadence 仍把该次作为无 decoded progress 推进 deadline;它不得停表、伪造连接指标或立即判定 edge 失效,只有 route 停用或 teardown 才停止该 cadence。该 operation 把失败的 exact direct parent 在当前 fact version 直接视为已尝试,先选择其他 direct parent,再进入有界 SFU suffix;新的外部事实才允许原 direct tuple 重新进入。Track availability、低码率、低 FPS、模糊、sender/viewer stats 与 SFU layer只用于stock WebRTC/LiveKit恢复和诊断。relay自身ingress失效时,它作为child换父并保留subtree;disconnect或effective downstream capacity降低只让direct/overflow children逐个走同一事务。
- 断线恢复:临时网络变化先交给 WebRTC/LiveKit 的 ICE、consent、重连和流状态。Direct edge 可在 exact current parent/child sessions 内采用 framework rebuild 的新 connection ID而不改变topology。应用只在上述exact edge失效后运行一次有界reconcile;任一步成功即停止。候选耗尽时hard-invalid、confirmed-departed或overflow edge被退休并进入明确waiting,healthy bootstrap edge保留。所有异步结果受authenticated session、share generation、base/pending route revision与candidate connection identity约束,未受影响分支保持sticky。权威暂停abort未提交candidate、保留active graph、抑制stall,并在resume后重新reconcile。
@@ -46,7 +46,7 @@ SFU 的 publication、subscription、server-resource accounting、临时 overlap
- 统一自动路由:旗舰部署开启 `PEER_ASSISTED_MEDIA` 后,每个房间使用一个服务端 route controller,独占 committed graph、一个 pending child operation 和 event-driven reconcile。运行时只增加一个串行pump、一个operation deadline timer与typed resource lifecycle task,不维护另一份graph。operation持有candidate list/cursor、一个current candidate/资源预留、fact version和一个总deadline。committed graph必须无环、source-reachable,且每名Viewer同时至多一个active upstream。加入、容量变化、节点离开、exact edge `failed/closed`,以及非暂停decoded-frame stall都只唤醒同一个reconcile;其余健康分支保持sticky。候选按当前身份、source reachability、无环、effective capacity与sender transition硬过滤,再按结果深度、剩余sender slots、稳定加入顺序和peer identity排序;因此 Host root退出后新释放的Host槽位比已有root的更深槽位优先,但健康旧边不因周期性平衡而迁移。server admission在执行当前cursor时独立reserve。candidate child首帧ready触发`settleReady(commitAdmissionSync)`,成功prepare `P`提交active `P`;失败释放资源并用同一monotonic allocator广播`R>P` rollback,cursor推进但总deadline不重置。bounded-gap先preflight server resource,再retire producer、按新graph重算未尝试suffix,并在切断healthy edge时追加一个普通restore candidate。relay自身ingress失效时作为child换父并保留subtree;relay disconnect/cap降低让overflow children逐个走同一事务,childless后删除。房间admission和无环约束最大深度,不设独立hard cap。普通peer始终STUN-only,SFU使用独立admission。
- 观看端连接反馈:Viewer 舞台从鉴权到首帧使用一个由现有权威状态推导的稳定阶段反馈,至少区分等待分享、分配线路、建立 P2P、连接 SFU、等待首帧、浏览器阻止自动播放、恢复连接和有界失败。阶段不是进度百分比,也不产生 route authority;只有当前 video element 实际提交首帧后才显示正在播放。Autoplay rejection 通过原生媒体 controls 恢复;连接中不显示虚假的播放动作。手动“重新连接媒体”只重建当前 exact route:P2P 使用同一 parent,SFU 使用同一 publication/subscription,不触发主动换父、质量选优或 P2P/SFU 重选;真实恢复耗尽后才进入既有 route-failure operation。make-before-break 或仍有可见旧帧时保留画面并叠加恢复状态,不为显示反馈主动清空健康 media element。页面从冻结/隐藏恢复时先重置 decoded-stall wall-clock baseline 并重新证明当前代画面,冻结时间本身不得成为立即换路依据。Host 离线本身不使仍健康的媒体失效;exact upstream 硬失败或 route terminal failure 必须使 current frame proof 失效,已证明画面至多降为 retained background,不能遮蔽离线或有界失败。已接受的 `screener-v12` 服务端补充消息是 strict、current-revision-fenced `route-status` union,且只允许 `waiting/sfu-admission` 与 `failed/route-exhausted` 两种配对;它不携带 raw text、身份、candidate 或 retry hint,prepare/active、access、Host、signal、media 与 autoplay 继续由各自权威输入派生。
-- 质量控制扩展:推荐档位仍是默认入口且只保留 1080p60/1080p30/720p30 三档,当前页面初始 desired state 选择清晰优先的 1080p30 且不写 `localStorage`;“分享高级设置”允许 480p(854x480)/720p/1080p/1440p 分辨率 ceiling、15 至 60 的整数 FPS ceiling、2 至 12 Mbps 视频码率 ceiling、清晰/平衡/流畅三种偏好,以及离散的 `64 kbps 省流 | 128 kbps 音乐默认 | 256 kbps 极高音质` 屏幕音频 sender ceiling;480p 不形成推荐档或固定 FPS/码率组合,音频初始值为 128 kbps。视频档位和音频档位可在直播中显式应用。所有当前及以后建立的 Web Host、Browser relay 与 SFU sender 都读取最新 desired 档位,并各自在 fresh sender parameters 上应用和读回 endpoint-local applied 值;实际码率仍由浏览器拥塞控制和 stats 决定。Peer 只在唯一明确的 active Opus audio 上做结构化、幂等的 Viewer answer `stereo=1;maxaveragebitrate=256000` 变换,使同一接收上限覆盖三档;非目标形态或 parser/writer 异常必须原样保留浏览器 answer,不得阻断可继续的 mono/video edge。不得用宽泛字符串/正则改 SDP,也不得改写浏览器协商的 FEC。SFU 将三档映射到 pinned SDK 的 music stereo preset 或显式 256 kbps ceiling,统一设置 `forceStereo = true`、`dtx = false` 与 `red = false`。不得暴露任意码率、声道、采样率、audio codec、stereo、DTX、RED 或 FEC 控件;256 kbps 只是显式较高上限,不是无损、高保真或最低码率保证。实际质量持续低于所选上限时必须显示可解释的限制原因;在真实拥塞、编码器和接收端证据完成前,不把任一组合称为“完美平衡”。未来 microphone voice 若进入范围,必须是独立 track/处理链,不能把 AEC/降噪/DTX 套到电影或游戏音频。
+- 质量控制扩展:推荐档位仍是默认入口且只保留 720p30/1080p30/1080p60 三档,当前页面初始 desired state 选择清晰优先的 1080p30 且不写 `localStorage`;“分享高级设置”允许 480p(854x480)/720p/1080p/1440p 分辨率 ceiling、15 至 60 的整数 FPS ceiling、2 至 12 Mbps 视频码率 ceiling、清晰/平衡/流畅三种偏好,以及离散的 `96 kbps 普通默认 | 128 kbps 音乐 | 192 kbps 保真` 屏幕音频 sender ceiling;480p 不形成推荐档或固定 FPS/码率组合,音频初始值为 96 kbps。视频档位和音频档位可在直播中显式应用。所有当前及以后建立的 Web Host、Browser relay 与 SFU sender 都读取最新 desired 档位,并各自在 fresh sender parameters 上应用和读回 endpoint-local applied 值;实际码率仍由浏览器拥塞控制和 stats 决定。Peer 只在唯一明确的 active Opus audio 上做结构化、幂等的 Viewer answer `stereo=1;maxaveragebitrate=192000` 变换,使同一接收上限覆盖三档;非目标形态或 parser/writer 异常必须原样保留浏览器 answer,不得阻断可继续的 mono/video edge。不得用宽泛字符串/正则改 SDP,也不得改写浏览器协商的 FEC。SFU 将 96/128 kbps 映射到 pinned SDK music preset,192 kbps 使用显式 ceiling,统一设置 `forceStereo = true`、`dtx = false` 与 `red = false`。不得暴露任意码率、声道、采样率、audio codec、stereo、DTX、RED 或 FEC 控件;192 kbps 只是显式较高上限,不是无损、高保真或最低码率保证。实际质量持续低于所选上限时必须显示可解释的限制原因;在真实拥塞、编码器和接收端证据完成前,不把任一组合称为“完美平衡”。未来 microphone voice 若进入范围,必须是独立 track/处理链,不能把 AEC/降噪/DTX 套到电影或游戏音频。
- SFU 质量设置生命周期:直播中修改档位时,浏览器 sender 的 applied readback、LiveKit `LocalVideoTrack` 保存的 degradation preference、track restart options 与 `LocalTrackPublication` 的 republish options 必须作为同一次串行操作更新;任一步失败恢复旧 sender 与旧 SDK 保存态,旧 publication generation 不得回写当前状态。LiveKit full reconnect/republish 不得恢复初次发布的旧偏好。该修复不改变 codec、码率上限、层数或路由,也不能单独解释即时低帧。
- 本地预览性能候选:在相同动态场景中 A/B 测量 Host 动态预览开/关的 CPU、GPU、encode time 和实际 FPS。只有稳定收益且捕获、编码和远端画面不受影响时,才允许直播开始后默认显示静止缩略图或隐藏动态预览并提供按需展开;未测前不宣称收益。
- Peer-assisted 媒体路径:所有非服务器 endpoint 都受同一个服务端权威稳态 outbound media-copy capacity 约束,默认 `2` 且可静态配置为 `1`、`2` 或 `3`;peer child 与 Host publication 都按实际发送副本计数。每名 Viewer 任一时刻只有一个 active upstream,活动媒体图保持无环;只在离散事件中做有界分配或换父。浏览器把收到的标准 remote track 加入独立下游 `RTCPeerConnection` 时会逐跳解码并分别重编码,必须测量而不能称为 shared encode。服务端只在有界房间内存中保存严格校验的质量设置,不写入持久存储。
@@ -167,9 +167,9 @@ SFU 的 publication、subscription、server-resource accounting、临时 overlap
- Given 浏览器未返回系统音轨,When 分享开始,Then 分享者在启播前看到“当前来源没有可共享音频”的提示。
- Given 分享者选择标签页或窗口,When 浏览器支持对应音频捕获,Then picker 提供该来源音频而不扩大为系统混音。Given 分享者选择整个屏幕,When 浏览器支持系统音频,Then picker 提供由用户决定的系统音频开关。应用同时请求 `windowAudio: "window"` 和 `systemAudio: "include"`,不根据 track 存在性伪造来源标签。
- Given 浏览器返回分享音轨,When 开始发布,Then 应用设置标准 `contentHint = "music"` 作为内容意图元数据;该值可读回,但不作为 Opus、码率、声道、采样率、FEC、DTX 或立体声的质量证据。
-- Given Web Host 或浏览器 relay 建立或替换分享音轨,When 对实际音频 sender 应用发送参数,Then 从当次 `getParameters()` 派生所选 `encodings[0].maxBitrate = 64000 | 128000 | 256000`、调用 `setParameters()` 并立即读回,旧配置缺失时按 128000 处理;Given Web Viewer 为含唯一有效 audio/Opus payload 的 offer 生成 answer,Then 用结构化 SDP parser 只 upsert 该 payload 的 `stereo=1` 与 `maxaveragebitrate=256000`,并把同一个结果用于 `setLocalDescription()` 和 signaling。首次连接、ICE restart、同 parent rebuild 和 relay child 都适用;空 SDP、无/歧义 Opus、多个有效 audio、重复目标参数、畸形 fmtp 或 parse/write 异常必须按对象 identity 返回浏览器原 answer 并继续,不能发送部分修改或静默冒充 stereo/实际码率。只有实际 `setLocalDescription()` 失败才进入既有连接错误路径。`sprop-stereo` 与 `usedtx` 不新增,其他 fmtp/FEC/session/media 字段逐项保留。
-- Given 通过 SFU 发布分享音轨,When 构建 LiveKit 2.22.0 publish options,Then 64 kbps 使用 `AudioPresets.musicStereo`、128 kbps 使用 `AudioPresets.musicHighQualityStereo`、256 kbps 使用同等结构的显式 sender ceiling,三档都设置 `forceStereo = true`、`dtx = false` 与 `red = false`;验收同时核对 SDK 选项、applied ceiling、当前 RTP codec/fmtp 与 stats 实际码率,不能从 preset 名称或 `opus/48000/2` 单独推断实际声道内容。
-- Given 分享正在直播或暂停且 Host 选择新的 64/128/256 kbps 音频档位,When 当前 profile mutation 串行执行,Then 服务端以 last-wins 保存并广播最新 desired profile,每个当前 Host、relay 与 SFU audio sender 从 fresh `getParameters()` 派生 `setParameters()` 并立即 readback,过期 completion 不得覆盖新值;以后创建的 sender 使用最新 desired profile。单个端点应用失败时保留媒体与其旧 applied 值、显示可见告警并允许后续更新或重建重试,不得谎称全房已收敛。当前 applied readback 保持 endpoint-local;没有显式回执 wire 就不宣称跨端点原子提交。该操作不改变 Opus、route revision、media-binding generation 或 publication generation,也不创建第二个音频控制环。当前 screen-audio Host 基线是 Chrome/Edge;其他浏览器只有实际 sender readback 成功时才算支持。
+- Given Web Host 或浏览器 relay 建立或替换分享音轨,When 对实际音频 sender 应用发送参数,Then 从当次 `getParameters()` 派生所选 `encodings[0].maxBitrate = 96000 | 128000 | 192000`、调用 `setParameters()` 并立即读回,档位缺失时按 96000 处理;Given Web Viewer 为含唯一有效 audio/Opus payload 的 offer 生成 answer,Then 用结构化 SDP parser 只 upsert 该 payload 的 `stereo=1` 与 `maxaveragebitrate=192000`,并把同一个结果用于 `setLocalDescription()` 和 signaling。首次连接、ICE restart、同 parent rebuild 和 relay child 都适用;空 SDP、无/歧义 Opus、多个有效 audio、重复目标参数、畸形 fmtp 或 parse/write 异常必须按对象 identity 返回浏览器原 answer 并继续,不能发送部分修改或静默冒充 stereo/实际码率。只有实际 `setLocalDescription()` 失败才进入既有连接错误路径。`sprop-stereo` 与 `usedtx` 不新增,其他 fmtp/FEC/session/media 字段逐项保留。
+- Given 通过 SFU 发布分享音轨,When 构建 LiveKit 2.22.0 publish options,Then 96 kbps 使用 `AudioPresets.musicHighQuality`、128 kbps 使用 `AudioPresets.musicHighQualityStereo`、192 kbps 使用同等结构的显式 sender ceiling,三档都设置 `forceStereo = true`、`dtx = false` 与 `red = false`;验收同时核对 SDK 选项、applied ceiling、当前 RTP codec/fmtp 与 stats 实际码率,不能从 preset 名称或 `opus/48000/2` 单独推断实际声道内容。
+- Given 分享正在直播或暂停且 Host 选择新的 96/128/192 kbps 音频档位,When 当前 profile mutation 串行执行,Then 服务端以 last-wins 保存并广播最新 desired profile,每个当前 Host、relay 与 SFU audio sender 从 fresh `getParameters()` 派生 `setParameters()` 并立即 readback,过期 completion 不得覆盖新值;以后创建的 sender 使用最新 desired profile。单个端点应用失败时保留媒体与其旧 applied 值、显示可见告警并允许后续更新或重建重试,不得谎称全房已收敛。当前 applied readback 保持 endpoint-local;没有显式回执 wire 就不宣称跨端点原子提交。该操作不改变 Opus、route revision、media-binding generation 或 publication generation,也不创建第二个音频控制环。当前 screen-audio Host 基线是 Chrome/Edge;其他浏览器只有实际 sender readback 成功时才算支持。
- Given Host 打开已接受的 `screener-v12` 分享设置或更新房间画质,When 查看 UI 或校验消息,Then 不存在 codec selector、codec quality-state/wire 字段或分享生命周期 codec 分支;Browser direct、browser relay 与 SFU publication 始终使用固定 VP8。实际协商 codec 与 encoder 只作为只读诊断显示。
- Given 浏览器返回屏幕音轨,When 产品展示音频状态或未来连接详情,Then 只能把存在性、浏览器实际返回的 track settings、实际协商 codec/fmtp 和实际流量分别标为捕获、协商或观测事实;字段缺失必须显示为未知,且不得从 Opus 的 `48000/2` RTP 声明推断源采样率或实际 stereo。
- Given Web 或后续 native sender 分享电影/视频音频,When 进行产品验收,Then 必须用独立 A/B/C 证据关联 capture audio track/settings、实际 negotiated codec/fmtp、outbound/inbound 实际码率、loss、jitter、concealment、jitter-buffer 与 A/V sync;P2P、浏览器 relay 与 SFU route switch 保持同一持久 Viewer `MediaStream`/媒体元素和 stereo 协商,不新增独立 audio element 或 Web Audio 时钟边界。native sender 必须通过该音质和同步矩阵,且不得把 audio `maxBitrate` ceiling 当作提质证明。
diff --git a/src/client/media/quality.ts b/src/client/media/quality.ts
index dc05bfd3..020fe3eb 100644
--- a/src/client/media/quality.ts
+++ b/src/client/media/quality.ts
@@ -19,27 +19,27 @@ export type {
export type QualityProfile = QualitySettings;
export const QUALITY_PROFILES = {
- "1080p60": {
- resolution: "1080p",
- maxFramerate: 60,
- maxBitrate: 8_000_000,
- degradationPreference: "balanced",
- screenAudioQuality: "music",
- },
- "1080p30": DEFAULT_QUALITY_SETTINGS,
"720p30": {
resolution: "720p",
maxFramerate: 30,
maxBitrate: 3_000_000,
degradationPreference: "balanced",
- screenAudioQuality: "music",
+ screenAudioQuality: "saver",
+ },
+ "1080p30": DEFAULT_QUALITY_SETTINGS,
+ "1080p60": {
+ resolution: "1080p",
+ maxFramerate: 60,
+ maxBitrate: 8_000_000,
+ degradationPreference: "balanced",
+ screenAudioQuality: "saver",
},
} as const satisfies Record<QualityProfileId, QualitySettings>;
export const QUALITY_PROFILE_LABELS = {
- "1080p60": "1080p · 60 帧",
- "1080p30": "1080p · 30 帧",
"720p30": "720p · 30 帧",
+ "1080p30": "1080p · 30 帧",
+ "1080p60": "1080p · 60 帧",
} as const satisfies Record<QualityProfileId, string>;
export const QUALITY_RESOLUTIONS = {
@@ -65,16 +65,16 @@ export const DEGRADATION_PREFERENCE_HINTS = {
} as const satisfies Record<DegradationPreference, string>;
export const SCREEN_AUDIO_QUALITY_LABELS = {
- saver: "清晰",
+ saver: "普通",
music: "音乐",
- "very-high": "高质",
+ "very-high": "保真",
} as const satisfies Record<ScreenAudioQuality, string>;
-export const DEFAULT_SCREEN_AUDIO_QUALITY: ScreenAudioQuality = "music";
+export const DEFAULT_SCREEN_AUDIO_QUALITY: ScreenAudioQuality = "saver";
export const SCREEN_AUDIO_BITRATES = {
- saver: 64_000,
+ saver: 96_000,
music: 128_000,
- "very-high": 256_000,
+ "very-high": 192_000,
} as const satisfies Record<ScreenAudioQuality, number>;
export const SCREEN_AUDIO_RECEIVE_MAX_BITRATE =
SCREEN_AUDIO_BITRATES["very-high"];
diff --git a/src/client/sfu/publisher.ts b/src/client/sfu/publisher.ts
index cf50fc0b..5028fca6 100644
--- a/src/client/sfu/publisher.ts
+++ b/src/client/sfu/publisher.ts
@@ -1233,7 +1233,7 @@ function audioPublishOptions(
const resolvedQuality = resolveScreenAudioQuality(quality);
const audioPreset =
resolvedQuality === "saver"
- ? sdk.AudioPresets.musicStereo
+ ? sdk.AudioPresets.musicHighQuality
: resolvedQuality === "music"
? sdk.AudioPresets.musicHighQualityStereo
: { maxBitrate: screenAudioBitrate(resolvedQuality) };
diff --git a/src/shared/protocol.ts b/src/shared/protocol.ts
index fc191554..fdf57a8c 100644
--- a/src/shared/protocol.ts
+++ b/src/shared/protocol.ts
@@ -164,9 +164,9 @@ export const roleSchema = z.enum(["host", "viewer"]);
export type Role = z.infer<typeof roleSchema>;
export const qualityProfileIdSchema = z.enum([
- "1080p60",
- "1080p30",
"720p30",
+ "1080p30",
+ "1080p60",
]);
export type QualityProfileId = z.infer<typeof qualityProfileIdSchema>;
@@ -209,7 +209,7 @@ export const DEFAULT_QUALITY_SETTINGS = {
maxFramerate: 30,
maxBitrate: 5_000_000,
degradationPreference: "maintain-resolution",
- screenAudioQuality: "music",
+ screenAudioQuality: "saver",
} as const satisfies QualitySettings;
export const relayDownstreamEdgesSchema = z
diff --git a/tests/host-peer-tracks.test.ts b/tests/host-peer-tracks.test.ts
index e8ffd98f..3627ef43 100644
--- a/tests/host-peer-tracks.test.ts
+++ b/tests/host-peer-tracks.test.ts
@@ -590,8 +590,8 @@ describe("HostPeer source replacement", () => {
expect(connection.transceiverInputs).toHaveLength(2);
expect(connection.senders[0]?.setParameters).toHaveBeenCalledTimes(2);
expect(connection.senders[1]?.appliedMaxBitrates).toEqual([
- 256_000,
- 256_000,
+ 192_000,
+ 192_000,
]);
});
@@ -613,7 +613,7 @@ describe("HostPeer source replacement", () => {
),
).resolves.toBe(true);
expect(connection.senders[1]?.track).toBe(nextAudio);
- expect(connection.senders[1]?.appliedMaxBitrates).toEqual([128_000]);
+ expect(connection.senders[1]?.appliedMaxBitrates).toEqual([96_000]);
});
it("stops sending audio without renegotiating when the new source has none", async () => {
@@ -633,7 +633,7 @@ describe("HostPeer source replacement", () => {
).resolves.toBe(true);
expect(connection.senders[1]?.track).toBeNull();
- expect(connection.senders[1]?.appliedMaxBitrates).toEqual([128_000]);
+ expect(connection.senders[1]?.appliedMaxBitrates).toEqual([96_000]);
});
it("updates quality parameters without replacing media tracks", async () => {
@@ -667,12 +667,12 @@ describe("HostPeer source replacement", () => {
expect(connection.senders[0]?.setParameters).toHaveBeenCalledTimes(2);
expect(connection.senders[1]?.setParameters).toHaveBeenCalledTimes(2);
expect(connection.senders[1]?.appliedMaxBitrates).toEqual([
- 128_000,
- 256_000,
+ 96_000,
+ 192_000,
]);
expect(peer.getSnapshot().audioSenderParameters).toEqual({
- requestedMaxBitrate: 256_000,
- appliedMaxBitrate: 256_000,
+ requestedMaxBitrate: 192_000,
+ appliedMaxBitrate: 192_000,
mismatch: false,
});
});
@@ -695,9 +695,9 @@ describe("HostPeer source replacement", () => {
).resolves.toBe(false);
expect(audioSender.track).toBe(audio);
- expect(audioSender.getParameters().encodings[0]?.maxBitrate).toBe(128_000);
+ expect(audioSender.getParameters().encodings[0]?.maxBitrate).toBe(96_000);
expect(peer.getSnapshot().audioSenderParameters?.appliedMaxBitrate).toBe(
- 128_000,
+ 96_000,
);
expect(peer.getSnapshot().qualityWarning).toContain(
"应用音频发送参数失败",
@@ -709,7 +709,7 @@ describe("HostPeer source replacement", () => {
screenAudioQuality: "very-high",
}),
).resolves.toBe(true);
- expect(audioSender.getParameters().encodings[0]?.maxBitrate).toBe(256_000);
+ expect(audioSender.getParameters().encodings[0]?.maxBitrate).toBe(192_000);
expect(peer.getSnapshot().qualityWarning).toBeNull();
});
@@ -721,9 +721,9 @@ describe("HostPeer source replacement", () => {
const audioSender = FakePeerConnection.latest!.senders[1]!;
audioSender.deferNextSetParameters = true;
- const saver = peer.updateProfile({
+ const music = peer.updateProfile({
...QUALITY_PROFILES["720p30"],
- screenAudioQuality: "saver",
+ screenAudioQuality: "music",
});
await vi.waitFor(() =>
expect(audioSender.setParameters).toHaveBeenCalledTimes(2),
@@ -734,15 +734,15 @@ describe("HostPeer source replacement", () => {
});
audioSender.releaseDeferredSetParameters();
- await expect(saver).resolves.toBe(false);
+ await expect(music).resolves.toBe(false);
await expect(veryHigh).resolves.toBe(true);
expect(audioSender.appliedMaxBitrates).toEqual([
+ 96_000,
128_000,
- 64_000,
- 256_000,
+ 192_000,
]);
expect(peer.getSnapshot().audioSenderParameters?.appliedMaxBitrate).toBe(
- 256_000,
+ 192_000,
);
});
@@ -1981,7 +1981,7 @@ describe("ViewerRelay downstream ownership", () => {
);
await vi.waitFor(() =>
expect(FakePeerConnection.latest?.senders[1]?.appliedMaxBitrates).toEqual([
- 64_000,
+ 96_000,
]),
);
const firstConnection = FakePeerConnection.latest!;
@@ -1993,8 +1993,8 @@ describe("ViewerRelay downstream ownership", () => {
}),
).resolves.toBe(true);
expect(firstConnection.senders[1]?.appliedMaxBitrates).toEqual([
- 64_000,
- 256_000,
+ 96_000,
+ 192_000,
]);
relay.setChildren(["second-audio-child"]);
@@ -2003,7 +2003,7 @@ describe("ViewerRelay downstream ownership", () => {
);
await vi.waitFor(() =>
expect(FakePeerConnection.latest?.senders[1]?.appliedMaxBitrates).toEqual([
- 256_000,
+ 192_000,
]),
);
});
diff --git a/tests/quality.test.ts b/tests/quality.test.ts
index 0302a7f7..79abde64 100644
--- a/tests/quality.test.ts
+++ b/tests/quality.test.ts
@@ -41,9 +41,9 @@ afterEach(() => {
describe("realtime quality controls", () => {
it("keeps exactly three recommended profiles with 1080p30 as the default", () => {
expect(Object.keys(QUALITY_PROFILES)).toEqual([
- "1080p60",
- "1080p30",
"720p30",
+ "1080p30",
+ "1080p60",
]);
expect(QUALITY_PROFILES["1080p30"]).toMatchObject({
resolution: "1080p",
@@ -117,18 +117,18 @@ describe("realtime quality controls", () => {
expect(QUALITY_PROFILES["720p30"].degradationPreference).toBe("balanced");
});
- it("keeps audio selection orthogonal while defaulting old settings to music", () => {
- const saver = {
+ it("keeps audio selection orthogonal while defaulting old settings to saver", () => {
+ const music = {
...QUALITY_PROFILES["1080p60"],
- screenAudioQuality: "saver",
+ screenAudioQuality: "music",
} as const;
const {
screenAudioQuality: _screenAudioQuality,
...legacySettings
} = QUALITY_PROFILES["1080p60"];
- expect(matchingQualityProfileId(saver)).toBe("1080p60");
- expect(qualitySettingsEqual(saver, QUALITY_PROFILES["1080p60"])).toBe(false);
+ expect(matchingQualityProfileId(music)).toBe("1080p60");
+ expect(qualitySettingsEqual(music, QUALITY_PROFILES["1080p60"])).toBe(false);
expect(
qualitySettingsEqual(legacySettings, QUALITY_PROFILES["1080p60"]),
).toBe(true);
@@ -224,9 +224,9 @@ describe("realtime quality controls", () => {
});
it.each([
- ["saver", 64_000],
+ ["saver", 96_000],
["music", 128_000],
- ["very-high", 256_000],
+ ["very-high", 192_000],
] as const)("applies and reads back the %s audio ceiling", async (quality, bitrate) => {
let applied = { encodings: [] } as unknown as RTCRtpSendParameters;
const sender = {
@@ -245,7 +245,7 @@ describe("realtime quality controls", () => {
expect(SCREEN_AUDIO_BITRATES[quality]).toBe(bitrate);
});
- it("uses the music ceiling for a legacy setting without an audio preset", async () => {
+ it("uses the saver ceiling for a setting without an audio preset", async () => {
let applied = { encodings: [] } as unknown as RTCRtpSendParameters;
const sender = {
getParameters: () => applied,
@@ -255,8 +255,8 @@ describe("realtime quality controls", () => {
} as unknown as RTCRtpSender;
await expect(configureScreenAudioSender(sender)).resolves.toEqual({
- requestedMaxBitrate: 128_000,
- appliedMaxBitrate: 128_000,
+ requestedMaxBitrate: 96_000,
+ appliedMaxBitrate: 96_000,
mismatch: false,
});
});
@@ -286,7 +286,7 @@ describe("realtime quality controls", () => {
it("does not mutate prior audio parameters when setParameters fails", async () => {
const applied = {
- encodings: [{ maxBitrate: 64_000 }],
+ encodings: [{ maxBitrate: 96_000 }],
} as RTCRtpSendParameters;
const sender = {
getParameters: () => applied,
@@ -298,7 +298,7 @@ describe("realtime quality controls", () => {
await expect(
configureScreenAudioSender(sender, "very-high"),
).rejects.toThrow("rejected");
- expect(applied.encodings[0]?.maxBitrate).toBe(64_000);
+ expect(applied.encodings[0]?.maxBitrate).toBe(96_000);
});
it("reports fields the browser does not retain", async () => {
diff --git a/tests/screen-audio-sdp.test.ts b/tests/screen-audio-sdp.test.ts
index 116c10a8..fb485015 100644
--- a/tests/screen-audio-sdp.test.ts
+++ b/tests/screen-audio-sdp.test.ts
@@ -35,7 +35,7 @@ describe("preferScreenAudioStereo", () => {
expect(session.media[0]?.fmtp).toContainEqual({
payload: 111,
config:
- "minptime=10;useinbandfec=1;x-stereo=keep;stereo=1;maxaveragebitrate=256000",
+ "minptime=10;useinbandfec=1;x-stereo=keep;stereo=1;maxaveragebitrate=192000",
});
expect(session.media[1]?.fmtp).toEqual([
{ payload: 96, config: "packetization-mode=1;profile-level-id=42e01f" },
@@ -52,7 +52,7 @@ describe("preferScreenAudioStereo", () => {
});
expect(parse(result.sdp!).media[0]?.fmtp[0]?.config).toBe(
- "stereo=1;x-stereo=0;maxaveragebitrate=256000;x-maxaveragebitrate=keep",
+ "stereo=1;x-stereo=0;maxaveragebitrate=192000;x-maxaveragebitrate=keep",
);
});
@@ -64,7 +64,7 @@ describe("preferScreenAudioStereo", () => {
expect(parse(result.sdp!).media[0]?.fmtp).toContainEqual({
payload: 111,
- config: "stereo=1;maxaveragebitrate=256000",
+ config: "stereo=1;maxaveragebitrate=192000",
});
});
@@ -82,7 +82,7 @@ describe("preferScreenAudioStereo", () => {
expect(audio[0]?.fmtp[0]?.config).toBe("stereo=0");
expect(audio[1]?.fmtp[0]?.config).toContain("stereo=1");
- expect(audio[1]?.fmtp[0]?.config).toContain("maxaveragebitrate=256000");
+ expect(audio[1]?.fmtp[0]?.config).toContain("maxaveragebitrate=192000");
});
it.each([
diff --git a/tests/sfu-client.test.ts b/tests/sfu-client.test.ts
index 4c1efdb3..35e8ea1b 100644
--- a/tests/sfu-client.test.ts
+++ b/tests/sfu-client.test.ts
@@ -248,6 +248,7 @@ const livekit = vi.hoisted(() => {
const AudioPresets = {
musicStereo: { maxBitrate: 64_000 },
+ musicHighQuality: { maxBitrate: 96_000 },
musicHighQualityStereo: { maxBitrate: 128_000 },
} as const;
@@ -674,7 +675,7 @@ describe("SfuPublisher", () => {
).not.toHaveProperty("simulcast");
expect(room.localParticipant.publishTrack).toHaveBeenNthCalledWith(2, audio, {
source: Track.Source.ScreenShareAudio,
- audioPreset: { maxBitrate: 128_000 },
+ audioPreset: { maxBitrate: 96_000 },
forceStereo: true,
dtx: false,
red: false,
@@ -712,9 +713,9 @@ describe("SfuPublisher", () => {
});
it.each([
- ["saver", 64_000],
+ ["saver", 96_000],
["music", 128_000],
- ["very-high", 256_000],
+ ["very-high", 192_000],
] as const)("maps the %s audio preset to %i bps", async (screenAudioQuality, bitrate) => {
const publisher = new SfuPublisher();
const video = track("video", `video-${screenAudioQuality}`);
@@ -820,24 +821,24 @@ describe("SfuPublisher", () => {
expect(videoPublication.track.sender.setParameters).toHaveBeenCalledOnce();
expect(audioPublication.track.sender.setParameters).toHaveBeenCalledTimes(2);
expect(audioPublication.track.sender.parameters.encodings[0]?.maxBitrate).toBe(
- 256_000,
+ 192_000,
);
expect(audioPublication.options).toMatchObject({
- audioPreset: { maxBitrate: 256_000 },
+ audioPreset: { maxBitrate: 192_000 },
forceStereo: true,
dtx: false,
red: false,
});
expect(publisher.getAudioSenderParameters()).toEqual({
- requestedMaxBitrate: 256_000,
- appliedMaxBitrate: 256_000,
+ requestedMaxBitrate: 192_000,
+ appliedMaxBitrate: 192_000,
mismatch: false,
});
expect(room.localParticipant.publishTrack).toHaveBeenCalledTimes(2);
await room.localParticipant.republishAllTracks();
expect(room.localParticipant.republishedOptions[1]).toMatchObject({
- audioPreset: { maxBitrate: 256_000 },
+ audioPreset: { maxBitrate: 192_000 },
forceStereo: true,
dtx: false,
red: false,
@@ -873,7 +874,7 @@ describe("SfuPublisher", () => {
128_000,
);
expect(audioPublication.options).toMatchObject({
- audioPreset: { maxBitrate: 256_000 },
+ audioPreset: { maxBitrate: 192_000 },
});
expect(videoPublication.track.sender.setParameters).toHaveBeenCalledOnce();
expect(room.disconnect).not.toHaveBeenCalled();
@@ -886,7 +887,7 @@ describe("SfuPublisher", () => {
}),
).resolves.toBe(true);
expect(publisher.getAudioSenderParameters()?.appliedMaxBitrate).toBe(
- 256_000,
+ 192_000,
);
expect(publisher.getQualityWarning()).toBeNull();
});
@@ -956,9 +957,9 @@ describe("SfuPublisher", () => {
await vi.waitFor(() =>
expect(replacementSender.setParameters).toHaveBeenCalledOnce(),
);
- expect(replacementSender.parameters.encodings[0]?.maxBitrate).toBe(256_000);
+ expect(replacementSender.parameters.encodings[0]?.maxBitrate).toBe(192_000);
expect(publisher.getAudioSenderParameters()?.appliedMaxBitrate).toBe(
- 256_000,
+ 192_000,
);
expect(room.localParticipant.republishAllTracks).not.toHaveBeenCalled();
});
@@ -997,10 +998,10 @@ describe("SfuPublisher", () => {
);
expect(audioPublication.track.sender.setParameters).not.toHaveBeenCalled();
expect(audioPublication.track.sender.parameters.encodings[0]?.maxBitrate).toBe(
- 256_000,
+ 192_000,
);
expect(publisher.getAudioSenderParameters()?.appliedMaxBitrate).toBe(
- 256_000,
+ 192_000,
);
expect(publisher.getSenderParameters()).toBeNull();
expect(publisher.getQualityWarning()).toBeNull();
@@ -1393,7 +1394,7 @@ describe("SfuPublisher", () => {
expect(room.localParticipant.publishTrack).toHaveBeenNthCalledWith(2, audio, {
source: Track.Source.ScreenShareAudio,
- audioPreset: { maxBitrate: 256_000 },
+ audioPreset: { maxBitrate: 192_000 },
forceStereo: true,
dtx: false,
red: false,
diff --git a/tests/viewer-peer-generation.test.ts b/tests/viewer-peer-generation.test.ts
index 56235891..f851a493 100644
--- a/tests/viewer-peer-generation.test.ts
+++ b/tests/viewer-peer-generation.test.ts
@@ -296,7 +296,7 @@ describe("ViewerPeer connection generations", () => {
expect(description).toEqual(expect.objectContaining({
type: "answer",
sdp: expect.stringContaining(
- "a=fmtp:111 minptime=10;useinbandfec=1;stereo=1;maxaveragebitrate=256000",
+ "a=fmtp:111 minptime=10;useinbandfec=1;stereo=1;maxaveragebitrate=192000",
),
}));
expect(answers[index]?.description.sdp).toBe(description.sdp);