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): stabilize current route presentation (#263)

AAA684e4d1d15c2
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 fd1f85a0..98492c72 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"
@@ -158,7 +158,7 @@ accepted 的唯一 wire 是 `screener-v12`,不做版本协商、旧 parser、
| 1080p30 | 1920x1080、30 fps | 5 Mbps/peer |
| 720p30 | 1280x720、30 fps | 3 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"`。三档推荐质量与折叠高级区初始值统一采用 `degradationPreference = "balanced"`,并允许显式选择 clarity-first 或 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 选择,并提供离散的 `64 kbps 省流 | 128 kbps 音乐默认 | 256 kbps 极高音质` 屏幕音频 sender ceiling。音频 ceiling 可在直播中串行更新。这些设置只是 ceiling 和浏览器偏好,不保证实际分辨率、帧率、码率或声道。
每次 `setParameters()` 都必须从当次 `getParameters()` 派生更新,然后读回 requested/applied `maxBitrate`、`maxFramerate`、`scaleResolutionDownBy` 和 degradation preference。浏览器负责具体降级,实际结果由 stats 观测;拒绝或浏览器改写必须进入可见状态,不能只写 `console.warn`。
@@ -274,7 +274,7 @@ media-proof 和 bounded-recovery 不变量的 scoped code 与 tests。
accepted `screener-v12` 的 Host/Viewer 产品 UI 不提供连接诊断文件下载。现有 periodic stats 只驱动当前页面的折叠连接详情、typed failure 与 accepted exact-edge stall;原始 stats、地址和身份不上传。authenticated Host 自动验收仍可按需请求一次 `route-diagnostic-snapshot`;服务端当场读取 current graph/operation 与 bounded latest timing records,不连续推送、不保留事件环、不建立第二张 graph。snapshot 使用临时 ordinal 和封闭 outcome bucket,不含 raw identity、address、candidate、credential 或 error,也不形成 route authority。
-Host 与 relay Viewer 复用同一个纯 presentation reducer 保存远端 `ViewerQualityEvidence`。代际 identity 是 exact route identity(room/share、viewer/parent、assignment/connection、route revision 和当前可用的 media-binding generation,及适用时 publication generation);只有同 identity 且 sequence 严格递增才可承接旧字段,其他输入从新 evidence 重建。每个非空 metric 保存自己的本地观测时间并在五秒边界清空,页面 timer 总是指向最早边界;整块详情不因某个采样缺字段而卸载。`new`/`connecting`/`disconnected` 保留同 identity shell 但立即标为非 fresh,`failed`/`closed` 或 route identity 变化清空。任何依赖当前状态的消费者只读取 fresh presentation;该层不新增 wire 字段或服务端 route authority。
+Host 与 relay Viewer 复用同一个纯 presentation reducer 保存远端 `ViewerQualityEvidence`。代际 identity 是 exact route identity(room/share、viewer/parent、assignment/connection、route revision 和当前可用的 media-binding generation,及适用时 publication generation);只有同 identity 且 sequence 严格递增才可承接每个字段最后一次真实非空观测,其他输入从新 evidence 重建。五秒 freshness 只控制 evidence 能否证明当前连接,采样缺字段或短暂超时不把展示字段归零。`new`/`connecting`/`disconnected` 保留同 identity shell 但立即标为非 fresh,`failed`/`closed` 或 route identity 变化清空。任何依赖当前状态的消费者只读取 fresh presentation;该层不新增 wire 字段或服务端 route authority。
质量诊断必须能按顺序区分:捕获源设置、sender 实际参数、CPU 或带宽 `qualityLimitationReason`、当前 peer/SFU 路径、outbound 与 inbound 差异,以及接收端 dropped/freeze。当前有界实现显示 sender 参数的 requested/applied 读回;同一个非 `none` 原生 `qualityLimitationReason` 连续出现三个采样周期后显示单条原因提示,原因变化、缺失或恢复为 `none` 即重新计数。这只是去抖后的观察,不组合评分、不触发调档或迁移。完整跨路径分类仍由后续真实矩阵验收;首轮使用浏览器 WebRTC internals 导出和一份脱敏 run manifest,不新增服务端遥测。
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 a180a6d2..e168e2a2 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,13 +27,13 @@ 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/码率组合。三档与高级设置初始值统一采用 `balanced`(平衡),`maintain-resolution`(清晰优先)、`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、综合评分或周期性全房间调档。
+- 质量控制:推荐档位始终只有 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、综合评分或周期性全房间调档。
- 路径隔离表示: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。
- 同一 operation 的一个总 deadline 只按实际存在的 `direct | sfu` 语义阶段等分,不配置每个 candidate 的 magic timeout。阶段内的硬失败继续推进 cursor;silent ICE 到达 direct 阶段边界时跳过剩余 direct tuple,必须把派生份额留给 SFU。20 名 Viewer 同时加入时,每名 child 的 operation deadline 不会被人数除分,但单一 room-serial operation 可能形成线性排队尾延迟;在接受另一种并发模型前,只测量 queue wait、candidate start、first decoded frame 与 final route 的 p50/p95/max,不用 NAT 猜测、TCP probe 或 magic timeout 绕过排队。
- 可观测性:按目标 RTP transport 与不透明连接/ICE 代次关联 selected path、`iceGatheringState`/ICE/connection state、事件推导的建立时长、generation-baselined pair-change delta,以及 RTT、RTP 丢包率、抖动、码率、帧率、编码耗时和受限原因。候选、route decision、队列时序与错误的 wire 和日志使用封闭 schema 和 code bucket,禁止 raw SDP、candidate、地址、URL、`errorText`、真实 peer/parent/session/connection identity 或网络标识。Host 与 Viewer 产品 UI 不提供连接诊断文件下载;本地折叠详情只显示当前页面直接观测到的连接事实。现有 Host-only bounded route snapshot 保留给自动验收,不连续推送、不进入产品 UI、也不形成 route authority。只有创建该 `RTCPeerConnection` 的本机可显示浏览器对 selected local/remote candidate 实际暴露的地址与端口;该值不上传、不持久化、不用于地理/NAT 推断,缺失或被隐私保护时显示未知。
-- 渐进式诊断:分享者和观看者默认只看到房间、画面、核心状态和常用控制;Host 对每名 Viewer 使用同一种卡片,不按 direct、Peer 转发或 SFU 分组。卡片只把本机连接或当前 Viewer 接收证据称为“已连接”,其余状态保持中性的“线路分配中”或具体连接状态,不把 active assignment 当作连接成功。展开连接详情也只在当前媒体证据成立后显示绿色 `P2P` 或黄色 `SFU fallback`;一级只保留分辨率、帧率、码率和丢包等一眼可读的实际画面结果,二级只显示当前确有值且能解释网络、编解码或播放质量的指标。固定的 VP8/Opus 不常驻展示,只在实际协商偏离产品合同时提示;候选地址、候选对 ID、STUN 计数、RID、fmtp 和其他浏览器内部标识不进入产品 UI。Host/Peer/SFU 的精确上下游与分支结构只由独立权威拓扑视图表达,不在卡片内重复。远端 Viewer evidence 的详情 shell 在同一 viewer/upstream/connection/route identity 内保持稳定;非空字段从各自最后一次实际观测起精确保留五秒,`connecting`/`disconnected` 只降为非 fresh,`failed`/`closed`、identity/session/share/route 变化或非单调 sequence 则清空/换代。非 fresh evidence 不得继续证明“已连接”或被其他 current-state 消费者使用。隐藏诊断不能隐藏失败原因、音频缺失、持续画质受限、编码合同偏离或需要用户操作的告警。
+- 渐进式诊断:分享者和观看者默认只看到房间、画面、核心状态和常用控制;Host 对每名 Viewer 使用同一种卡片,不按 direct、Peer 转发或 SFU 分组。卡片只把本机连接或当前 Viewer 接收证据称为“已连接”,其余状态保持中性的“线路分配中”或具体连接状态,不把 active assignment 当作连接成功。展开连接详情也只在当前媒体证据成立后显示绿色 `P2P` 或黄色 `SFU fallback`;一级只保留分辨率、帧率、码率和丢包等一眼可读的实际画面结果,二级只显示当前确有值且能解释网络、编解码或播放质量的指标。固定的 VP8/Opus 不常驻展示,只在实际协商偏离产品合同时提示;候选地址、候选对 ID、STUN 计数、RID、fmtp 和其他浏览器内部标识不进入产品 UI。Host/Peer/SFU 的精确上下游与分支结构只由独立权威拓扑视图表达,不在卡片内重复。远端 Viewer evidence 的详情 shell 在同一 viewer/upstream/connection/route identity 内保持稳定并保留每个字段最后一次真实非空观测;五秒 freshness 只决定 evidence 能否继续证明“已连接”,`connecting`/`disconnected` 立即降为非 fresh,`failed`/`closed`、identity/session/share/route 变化或非单调 sequence 则清空/换代。隐藏诊断不能隐藏失败原因、音频缺失、持续画质受限、编码合同偏离或需要用户操作的告警。
- 站点访问:生产部署必须配置独立的 `SITE_ACCESS_PASSWORD` 控制建房、Host 信令角色和所有 code-only Viewer 入口;只有本地开发/测试可显式关闭。非空值接受 8 至 128 个可见 ASCII bytes,不能复用 LiveKit、TLS 或其他部署 secret。`POST /api/site-access` 验证成功签发 12 小时、无服务端会话状态的 HttpOnly、`SameSite=Strict` site-access cookie。有效 room-scoped fragment grant 可绕过站点 gate 直接进入对应房间;其余 `/r/{code}` 和 `/join` 必须先持有效 site-access cookie,之后才检查房间是否存在与 `open | private` code-only policy。未分配、已回收或已过期的 code 返回 `ROOM_NOT_FOUND`;现存私密房间的无密码、缺失或错误密码及容量拒绝继续使用 `ROOM_ACCESS_DENIED`。建房 HTTP 只认该 cookie。已移除的旧环境变量、endpoint 和 cookie 不保留兼容。不引入账号、JWT、服务端 session Map 或通用 logout。
- 房间级观看授权:新房间总是生成一个 128-bit 随机、22 字符 base64url、可 rotate/revoke 的 room-scoped Viewer grant;服务端内存只在该 exact room incarnation 保存完整 grant 的 SHA-256 摘要。grant 没有独立到期时间或内嵌 room/expiry 字段,与房间同寿,并在房间回收、进程重启、rotate 或 revoke 时失效;同号新房间使用新摘要,旧链接不能进入。浏览器从 URL fragment 严格读取 grant 后,只写该房间的 `sessionStorage` 并立即用 `history.replaceState` 清除 fragment;刷新和页面内重连可继续。code-only 入口独立采用 `open | private`,默认 `open` 且无房间密码;`private` 可不设密码并拒绝全部 code-only 尝试,设置密码后只接受匹配值。所有 code-only 尝试先通过站点访问。grant 不得进入 `localStorage`、cookie、query、WebSocket URL、Referrer、日志或错误。Host 可独立 rotate/revoke grant、改变 code-only policy 或设置/移除密码;授权变化必须先提交新的内存代次,再清除 Viewer grace/路由、终止旧代次信令和媒体并断开受影响 Viewer。
- 易失房间状态:服务器只在一个有界内存 RoomStore 中保存房间码、租期、Host token/Viewer grant 摘要、code-only policy、可选 48-byte 房间密码校验材料、参与者和控制状态。`ROOM_LEASE_SECONDS` 默认 `86400`;Host 正在分享时不回收,停止分享或 Host 断开后开始 dormant lease,同一 Host token 在期限内重新分享即续租,Viewer 活动不续租,过期后释放号码。应用进程重启时全部房间、租约、邀请和密码状态直接失效;不使用 SQLite、`ROOM_DATABASE_PATH`、schema migration、账号、用户表或服务器 session 表。
@@ -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/码率组合,初始值采用 `balanced` 与 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 套到电影或游戏音频。
+- 质量控制扩展:推荐档位仍是默认入口且只保留 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 套到电影或游戏音频。
- 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。服务端只在有界房间内存中保存严格校验的质量设置,不写入持久存储。
diff --git a/src/client/components/status-badge-model.ts b/src/client/components/status-badge-model.ts
index d7896121..c9cd0092 100644
--- a/src/client/components/status-badge-model.ts
+++ b/src/client/components/status-badge-model.ts
@@ -56,3 +56,24 @@ export function viewerRouteEvidence(
}
return { route: null, evidence: null };
}
+
+export function viewerReconnectRoute(
+ upstream: ParticipantRouteAssignment["upstream"] | null,
+ peer: PeerSnapshot | null,
+ sfu: {
+ connectionState: "connected" | "reconnecting";
+ metrics: ConnectionMetrics | null;
+ } | null,
+ peerIdentity: { parentPeerId: string; connectionId: string } | null,
+): PresentedMediaRoute | null {
+ const route = viewerRouteEvidence(upstream, peer, sfu).route;
+ if (route === "sfu") {
+ return "sfu";
+ }
+ return route === "p2p" &&
+ peer !== null &&
+ peerIdentity?.parentPeerId === peer.peerId &&
+ peerIdentity.connectionId === peer.connectionId
+ ? "p2p"
+ : null;
+}
diff --git a/src/client/media/viewer-presentation.ts b/src/client/media/viewer-presentation.ts
index 86fa2f96..9f95ad2b 100644
--- a/src/client/media/viewer-presentation.ts
+++ b/src/client/media/viewer-presentation.ts
@@ -88,7 +88,6 @@ export interface ViewerPresentationState {
retainedFrame: boolean;
autoplayBlockedGeneration: number | null;
failure: ViewerFailureCode | null;
- retryAvailable: boolean;
}
export type ViewerPresentationAction =
@@ -122,19 +121,18 @@ export type ViewerPresentationAction =
| { type: "playback-failed"; generation: number; revision: number }
| { type: "media-invalidated"; revision: number }
| { type: "media-cleared" }
+ | { type: "sharing-stopped" }
| {
type: "failure";
failure: ViewerFailureCode | null;
revision?: number;
- }
- | { type: "retry-available"; available: boolean };
+ };
export interface ViewerPresentation {
stage: ViewerStage;
message: string;
notice: string | null;
overlay: "none" | "status" | "blocking";
- retryAvailable: boolean;
hasCurrentFrame: boolean;
hasRetainedFrame: boolean;
failureCode: ViewerFailureCode | null;
@@ -152,7 +150,6 @@ export const INITIAL_VIEWER_PRESENTATION_STATE: ViewerPresentationState = {
retainedFrame: false,
autoplayBlockedGeneration: null,
failure: null,
- retryAvailable: false,
};
export function reduceViewerPresentation(
@@ -366,6 +363,19 @@ export function reduceViewerPresentation(
retainedFrame: false,
autoplayBlockedGeneration: null,
};
+ case "sharing-stopped":
+ return {
+ ...state,
+ host: "stopped",
+ revision: null,
+ route: null,
+ routeStatus: null,
+ connection: "idle",
+ media: null,
+ retainedFrame: false,
+ autoplayBlockedGeneration: null,
+ failure: "HOST_STOPPED",
+ };
case "failure":
if (
action.revision !== undefined &&
@@ -389,8 +399,6 @@ export function reduceViewerPresentation(
: state.autoplayBlockedGeneration,
failure: action.failure,
};
- case "retry-available":
- return { ...state, retryAvailable: action.available };
}
}
@@ -663,8 +671,6 @@ function presentation(
message,
notice: null,
overlay,
- retryAvailable:
- state.access === "ready" && state.host !== "paused" && state.retryAvailable,
hasCurrentFrame: hasCurrentFrame(state),
hasRetainedFrame: state.retainedFrame,
failureCode: state.failure,
diff --git a/src/client/media/viewer-quality-evidence.ts b/src/client/media/viewer-quality-evidence.ts
index b8c54ddd..8f06d2d4 100644
--- a/src/client/media/viewer-quality-evidence.ts
+++ b/src/client/media/viewer-quality-evidence.ts
@@ -34,7 +34,6 @@ export interface ViewerQualityEvidencePresentation {
evidence: ViewerQualityEvidence;
fresh: boolean;
receivedAtMs: number;
- observedAtMs: Partial<Record<ViewerQualityEvidenceMetric, number>>;
}
type ViewerQualityEvidenceWindow = Pick<
@@ -317,20 +316,14 @@ export function presentViewerQualityEvidence(
? refreshViewerQualityEvidencePresentation(previous, nowMs)
: null;
const metrics = { ...evidence.metrics };
- const observedAtMs: Partial<
- Record<ViewerQualityEvidenceMetric, number>
- > = {};
for (const metric of viewerQualityEvidenceMetricKeys(evidence.metrics)) {
- if (evidence.metrics[metric] !== null) {
- observedAtMs[metric] = nowMs;
- } else if (
+ if (
+ evidence.metrics[metric] === null &&
current !== null &&
- current.evidence.metrics[metric] !== null &&
- current.observedAtMs[metric] !== undefined
+ current.evidence.metrics[metric] !== null
) {
metrics[metric] = current.evidence.metrics[metric] as never;
- observedAtMs[metric] = current.observedAtMs[metric];
}
}
@@ -338,7 +331,6 @@ export function presentViewerQualityEvidence(
evidence: { ...evidence, metrics },
fresh: true,
receivedAtMs: nowMs,
- observedAtMs,
};
}
@@ -346,67 +338,23 @@ export function refreshViewerQualityEvidencePresentation(
presentation: ViewerQualityEvidencePresentation,
nowMs: number = Date.now(),
): ViewerQualityEvidencePresentation {
- let metrics = presentation.evidence.metrics;
- let observedAtMs = presentation.observedAtMs;
- let changed = false;
-
- for (const metric of viewerQualityEvidenceMetricKeys(metrics)) {
- const observedAt = observedAtMs[metric];
- if (
- metrics[metric] !== null &&
- observedAt !== undefined &&
- nowMs >= observedAt + VIEWER_QUALITY_EVIDENCE_EXPIRY_MS
- ) {
- if (!changed) {
- metrics = { ...metrics };
- observedAtMs = { ...observedAtMs };
- changed = true;
- }
- metrics[metric] = null as never;
- delete observedAtMs[metric];
- }
- }
-
const fresh =
nowMs < presentation.receivedAtMs + VIEWER_QUALITY_EVIDENCE_EXPIRY_MS;
- if (!changed && fresh === presentation.fresh) {
+ if (fresh === presentation.fresh) {
return presentation;
}
- return {
- ...presentation,
- evidence: changed
- ? { ...presentation.evidence, metrics }
- : presentation.evidence,
- fresh,
- observedAtMs,
- };
+ return { ...presentation, fresh };
}
export function nextViewerQualityEvidencePresentationExpiryAt(
presentation: ViewerQualityEvidencePresentation,
nowMs: number = Date.now(),
): number | null {
- let nextExpiryAt = presentation.fresh
- ? presentation.receivedAtMs + VIEWER_QUALITY_EVIDENCE_EXPIRY_MS
- : Number.POSITIVE_INFINITY;
-
- for (const metric of viewerQualityEvidenceMetricKeys(
- presentation.evidence.metrics,
- )) {
- const observedAt = presentation.observedAtMs[metric];
- if (
- presentation.evidence.metrics[metric] !== null &&
- observedAt !== undefined
- ) {
- nextExpiryAt = Math.min(
- nextExpiryAt,
- observedAt + VIEWER_QUALITY_EVIDENCE_EXPIRY_MS,
- );
- }
- }
-
- return Number.isFinite(nextExpiryAt)
- ? Math.max(nowMs, nextExpiryAt)
+ return presentation.fresh
+ ? Math.max(
+ nowMs,
+ presentation.receivedAtMs + VIEWER_QUALITY_EVIDENCE_EXPIRY_MS,
+ )
: null;
}
diff --git a/src/client/pages/ViewerPage.tsx b/src/client/pages/ViewerPage.tsx
index d15d1fa6..8145a5a3 100644
--- a/src/client/pages/ViewerPage.tsx
+++ b/src/client/pages/ViewerPage.tsx
@@ -31,7 +31,10 @@ import {
} from "../components/StatusBadge";
import { StatsGrid } from "../components/StatsGrid";
import { TopologyView } from "../components/TopologyView";
-import { viewerRouteEvidence } from "../components/status-badge-model";
+import {
+ viewerReconnectRoute,
+ viewerRouteEvidence,
+} from "../components/status-badge-model";
import { readDisplayName, saveDisplayName } from "../lib/display-name";
import { clearViewerGrant, getStableClientId } from "../lib/session";
import { SignalingClient } from "../lib/signaling";
@@ -196,6 +199,15 @@ export function ViewerPage({ roomId, viewerGrant }: ViewerPageProps) {
peerSnapshot,
sfuUpstream,
);
+ const peerConnectionIdentity = peerRef.current?.getConnectionIdentity() ?? null;
+ const reconnectRoute = viewerReconnectRoute(
+ assignedRoute?.upstream ?? null,
+ peerSnapshot,
+ sfuUpstream,
+ peerConnectionIdentity,
+ );
+ const reconnectAvailable =
+ signalStatus === "connected" && reconnectRoute !== null;
const routeConnectionState =
routePresentation.evidence?.connectionState ??
(hostOnline ? "routing" : "waiting");
@@ -1355,7 +1367,7 @@ export function ViewerPage({ roomId, viewerGrant }: ViewerPageProps) {
clearPeerState(true);
clearHostPresence();
setHostOnline(false);
- dispatchPresentation({ type: "host", host: "stopped" });
+ dispatchPresentation({ type: "sharing-stopped" });
return;
}
if (message.type === "viewer-grant-revoked") {
@@ -1558,28 +1570,16 @@ export function ViewerPage({ roomId, viewerGrant }: ViewerPageProps) {
}
}, [presentation.overlay]);
- useEffect(() => {
- dispatchPresentation({
- type: "retry-available",
- available: Boolean(
- signalStatus === "connected" &&
- (peerSnapshot ||
- (assignedRoute?.phase === "active" &&
- assignedRoute.upstream.kind === "sfu")),
- ),
- });
- }, [assignedRoute, peerSnapshot, signalStatus]);
-
function retryConnection(): void {
const requested =
- assignedRoute?.phase === "active" &&
- assignedRoute.upstream.kind === "sfu"
+ reconnectRoute === "sfu"
? signalRef.current?.reconnect() === true
- : peerRef.current?.requestRecovery(true) === true;
+ : reconnectRoute === "p2p" &&
+ peerRef.current?.requestRecovery(true) === true;
if (requested) {
dispatchPresentation({
type: "connection",
- revision: assignedRoute?.revision ?? 0,
+ revision: presentationState.revision ?? assignedRoute?.revision ?? 0,
connection: "reconnecting",
});
}
@@ -1879,7 +1879,7 @@ export function ViewerPage({ roomId, viewerGrant }: ViewerPageProps) {
className="icon-button viewer-status-action"
title="重新连接媒体"
aria-label="重新连接媒体"
- disabled={!presentation.retryAvailable}
+ disabled={!reconnectAvailable}
onClick={retryConnection}
>
<RefreshCw size={18} />
diff --git a/src/shared/protocol.ts b/src/shared/protocol.ts
index e11d372a..fc191554 100644
--- a/src/shared/protocol.ts
+++ b/src/shared/protocol.ts
@@ -208,7 +208,7 @@ export const DEFAULT_QUALITY_SETTINGS = {
resolution: "1080p",
maxFramerate: 30,
maxBitrate: 5_000_000,
- degradationPreference: "balanced",
+ degradationPreference: "maintain-resolution",
screenAudioQuality: "music",
} as const satisfies QualitySettings;
diff --git a/tests/quality.test.ts b/tests/quality.test.ts
index 0bf6e0cc..0302a7f7 100644
--- a/tests/quality.test.ts
+++ b/tests/quality.test.ts
@@ -109,13 +109,12 @@ describe("realtime quality controls", () => {
});
});
- it("defaults every recommended profile to balanced degradation", () => {
- expect(
- Object.values(QUALITY_PROFILES).every(
- (profile) =>
- profile.degradationPreference === "balanced",
- ),
- ).toBe(true);
+ it("defaults 1080p30 to clarity without changing the other presets", () => {
+ expect(QUALITY_PROFILES["1080p30"].degradationPreference).toBe(
+ "maintain-resolution",
+ );
+ expect(QUALITY_PROFILES["1080p60"].degradationPreference).toBe("balanced");
+ expect(QUALITY_PROFILES["720p30"].degradationPreference).toBe("balanced");
});
it("keeps audio selection orthogonal while defaulting old settings to music", () => {
diff --git a/tests/status-badge.test.ts b/tests/status-badge.test.ts
index 73f99f66..47d45f5b 100644
--- a/tests/status-badge.test.ts
+++ b/tests/status-badge.test.ts
@@ -4,6 +4,7 @@ import {
hasPeerRouteEvidence,
MEDIA_ROUTE_PRESENTATION,
ROUTING_STATUS_PRESENTATION,
+ viewerReconnectRoute,
viewerRouteEvidence,
} from "../src/client/components/status-badge-model.ts";
import { EMPTY_METRICS, type PeerSnapshot } from "../src/client/types.ts";
@@ -88,4 +89,37 @@ describe("route status badges", () => {
).toBe("p2p");
});
+ it("reconnects only the exact transport with current media evidence", () => {
+ const identity = {
+ parentPeerId: peerSnapshot.peerId,
+ connectionId: peerSnapshot.connectionId,
+ };
+ expect(
+ viewerReconnectRoute(
+ { kind: "peer", peerId: peerSnapshot.peerId },
+ peerSnapshot,
+ null,
+ identity,
+ ),
+ ).toBe("p2p");
+ expect(
+ viewerReconnectRoute(
+ { kind: "peer", peerId: peerSnapshot.peerId },
+ peerSnapshot,
+ null,
+ { ...identity, connectionId: "connection-replaced" },
+ ),
+ ).toBeNull();
+
+ const sfu = { connectionState: "connected" as const, metrics: null };
+ expect(
+ viewerReconnectRoute(
+ { kind: "peer", peerId: "pending-parent" },
+ peerSnapshot,
+ sfu,
+ null,
+ ),
+ ).toBe("sfu");
+ });
+
});
diff --git a/tests/viewer-presentation.test.ts b/tests/viewer-presentation.test.ts
index f74d239e..2b580557 100644
--- a/tests/viewer-presentation.test.ts
+++ b/tests/viewer-presentation.test.ts
@@ -11,10 +11,14 @@ import {
function apply(
...actions: readonly ViewerPresentationAction[]
): ViewerPresentationState {
- return actions.reduce(
- reduceViewerPresentation,
- INITIAL_VIEWER_PRESENTATION_STATE,
- );
+ return applyFrom(INITIAL_VIEWER_PRESENTATION_STATE, ...actions);
+}
+
+function applyFrom(
+ state: ViewerPresentationState,
+ ...actions: readonly ViewerPresentationAction[]
+): ViewerPresentationState {
+ return actions.reduce(reduceViewerPresentation, state);
}
describe("Viewer presentation reducer", () => {
@@ -376,7 +380,6 @@ describe("Viewer presentation reducer", () => {
expect(deriveViewerPresentation(denied)).toMatchObject({
stage: "access-denied",
message: "当前无法通过房间号加入",
- retryAvailable: false,
});
const notFound = reduceViewerPresentation(failed, {
@@ -387,7 +390,40 @@ describe("Viewer presentation reducer", () => {
expect(deriveViewerPresentation(notFound)).toMatchObject({
stage: "room-not-found",
message: "房间不存在或已过期",
- retryAvailable: false,
+ });
+ });
+
+ it("starts a fresh route revision namespace after sharing stops", () => {
+ const previousShare = apply(
+ { type: "access", access: "ready" },
+ { type: "host", host: "online" },
+ { type: "route", revision: 8, phase: "active", kind: "p2p" },
+ { type: "media-bound", generation: 2, revision: 8 },
+ { type: "frame-presented", generation: 2, revision: 8 },
+ );
+ const stopped = reduceViewerPresentation(previousShare, {
+ type: "sharing-stopped",
+ });
+ expect(stopped).toMatchObject({
+ host: "stopped",
+ revision: null,
+ route: null,
+ connection: "idle",
+ media: null,
+ retainedFrame: false,
+ failure: "HOST_STOPPED",
+ });
+
+ const restarted = applyFrom(stopped,
+ { type: "host", host: "online" },
+ { type: "route", revision: 1, phase: "prepare", kind: "p2p" },
+ { type: "media-bound", generation: 3, revision: 1 },
+ { type: "frame-presented", generation: 3, revision: 1 },
+ );
+ expect(deriveViewerPresentation(restarted)).toMatchObject({
+ stage: "playing",
+ message: "正在播放",
+ overlay: "none",
});
});
});
diff --git a/tests/viewer-quality-evidence.test.ts b/tests/viewer-quality-evidence.test.ts
index 3f92be5e..46d7722e 100644
--- a/tests/viewer-quality-evidence.test.ts
+++ b/tests/viewer-quality-evidence.test.ts
@@ -417,7 +417,7 @@ describe("viewer quality evidence", () => {
});
});
- it("expires retained fields independently at their exact observation deadline", () => {
+ it("keeps last observed fields when freshness expires", () => {
const first = presentViewerQualityEvidence(
null,
serverEvidence({ sequence: 4 }),
@@ -440,42 +440,23 @@ describe("viewer quality evidence", () => {
expect(second.evidence.metrics.codec).toBe("video/H264");
expect(second.evidence.metrics.bitrateKbps).toBe(6_000);
expect(nextViewerQualityEvidencePresentationExpiryAt(second, 2_000)).toBe(
- 5_000,
+ 7_000,
);
expect(
refreshViewerQualityEvidencePresentation(second, 4_999).evidence.metrics
.codec,
).toBe("video/H264");
- const atFirstDeadline = refreshViewerQualityEvidencePresentation(
- second,
- 5_000,
- );
- expect(atFirstDeadline).toMatchObject({ fresh: true });
- expect(atFirstDeadline.evidence.metrics).toMatchObject({
- codec: null,
- codecProfile: null,
- codecParameters: null,
- bitrateKbps: 6_000,
- });
- expect(
- nextViewerQualityEvidencePresentationExpiryAt(atFirstDeadline, 5_000),
- ).toBe(7_000);
-
const expired = refreshViewerQualityEvidencePresentation(second, 7_000);
expect(expired.fresh).toBe(false);
- expect(Object.values(expired.evidence.metrics)).toEqual(
- expect.arrayContaining([null]),
- );
- expect(
- Object.values(expired.evidence.metrics).every((value) => value === null),
- ).toBe(true);
+ expect(expired.evidence.metrics.codec).toBe("video/H264");
+ expect(expired.evidence.metrics.bitrateKbps).toBe(6_000);
expect(
nextViewerQualityEvidencePresentationExpiryAt(expired, 7_000),
).toBeNull();
});
- it("does not extend a retained field when later samples still omit it", () => {
+ it("retains omitted fields while the evidence identity continues", () => {
const first = presentViewerQualityEvidence(
null,
serverEvidence({ sequence: 1 }),
@@ -508,12 +489,12 @@ describe("viewer quality evidence", () => {
expect(third.evidence.metrics.codec).toBe("video/H264");
expect(nextViewerQualityEvidencePresentationExpiryAt(third, 4_000)).toBe(
- 5_000,
+ 9_000,
);
expect(
- refreshViewerQualityEvidencePresentation(third, 5_000).evidence.metrics
+ refreshViewerQualityEvidencePresentation(third, 9_000).evidence.metrics
.codec,
- ).toBeNull();
+ ).toBe("video/H264");
});
it("resets retained fields on identity or non-monotonic sequence changes", () => {