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. 免费开源的私密屏幕共享,支持游戏直播、一起看电影与自部署。

docs: align quality shadow with browser evidence (#277)

AAAa25ef5a166ea
diff --git a/docs/adr/0005-automatic-hybrid-media-routing.md b/docs/adr/0005-automatic-hybrid-media-routing.md
index ddb979dd..ad6737ad 100644
--- a/docs/adr/0005-automatic-hybrid-media-routing.md
+++ b/docs/adr/0005-automatic-hybrid-media-routing.md
@@ -284,11 +284,13 @@ second mutable graph.
route score, alternative-parent probe, hysteresis loop, or periodic
quality-driven reparenting.
- Quality selection begins with one evidence-only shadow phase inside this same
- controller. A Viewer reports standard rendered-frame, freeze and pause deltas
- only while its exact current route is connected, the page is visible and not
+ controller. A Viewer reports standard freeze and pause deltas with continuing
+ decoded-frame progress only while its exact current route is connected, the page is visible and not
suspended, the Host is not paused, the native video is playing, and a current
- composited frame has already been proved. A strictly monotonic presentation
- epoch fences every eligibility change; its first stats sample establishes a
+ composited frame has already been proved. Current target Chromium does not
+ expose the W3C `framesRendered` member, so it is not a wire requirement; the
+ freeze/pause counters themselves remain renderer-derived. A strictly monotonic
+ presentation epoch fences every eligibility change; its first stats sample establishes a
baseline and is not evidence. The server then revalidates the authenticated
Viewer session, exact committed upstream and connection before the controller
keeps one bounded current-epoch aggregate per child. Missing stats remain
diff --git a/docs/research/realtime-quality-adaptation.md b/docs/research/realtime-quality-adaptation.md
index 819e947a..ded6dd72 100644
--- a/docs/research/realtime-quality-adaptation.md
+++ b/docs/research/realtime-quality-adaptation.md
@@ -375,13 +375,17 @@ ingress degradation reparents that relay while retaining its subtree; one
child's degradation moves only that child.
The accepted first stage is shadow evaluation only. Viewer evidence adds the
-standard cumulative-renderer deltas `framesRendered`, `freezeCount`,
-`totalFreezesDuration`, `pauseCount` and `totalPausesDuration`. W3C already
+standard cumulative-renderer deltas `freezeCount`, `totalFreezesDuration`,
+`pauseCount` and `totalPausesDuration` and requires continuing
+`framesDecoded` progress. W3C already
defines a freeze relative to the last 30 rendered frames, so this phase invents
no FPS, bitrate, loss or latency threshold. A recovered freeze or pause updates
its duration only after a later frame is rendered, so a valid delta may exceed
-the adjacent report window and must not be clipped. A missing member is unknown;
-only windows containing all five rendered metrics enter the aggregate.
+the adjacent report window and must not be clipped. Current target Chromium
+does not map W3C `framesRendered` into `RTCInboundRtpStreamStats`, so synthetic
+fixtures must not make it a product dependency. A missing member is unknown;
+only windows containing decoded progress and all four freeze/pause metrics enter
+the aggregate.
Presentation eligibility binds visible/not-suspended page state, non-paused
Host authority, native video play state, current composited-frame proof and the
diff --git a/docs/status.md b/docs/status.md
index ea3a993e..6679c49c 100644
--- a/docs/status.md
+++ b/docs/status.md
@@ -62,9 +62,9 @@ This is the current execution index. Git history owns completed timelines;
## Current Milestone
-1. Implement presentation-authoritative rendered freeze/pause evidence and the
- controller-owned shadow aggregate; collect production samples without active
- route changes.
+1. Implement presentation-authoritative freeze/pause evidence with decoded
+ progress and the controller-owned shadow aggregate; collect production
+ samples without active route changes.
2. Finish the Android Chrome and iOS Safari Viewer lifecycle matrix.
3. Finish representative public-network direct, peer-relay, SFU, recovery,
Pause/Resume, screen-audio, real-game A/V, and all-UDP-blocked acceptance
diff --git a/docs/todo.md b/docs/todo.md
index 6dcdc26b..b49f220e 100644
--- a/docs/todo.md
+++ b/docs/todo.md
@@ -8,8 +8,9 @@ later topic is not implementation authority by itself.
## Now
1. **Quality-route evidence and shadow calibration.** Make current Viewer
- quality evidence presentation-authoritative with standard rendered freeze and
- pause deltas, exact presentation epochs and baseline fencing. Keep one bounded
+ quality evidence presentation-authoritative with standard freeze/pause
+ deltas, continuing decoded progress, exact presentation epochs and baseline
+ fencing. Keep one bounded
current-epoch aggregate per exact child in the existing room controller and
expose it only through the Host acceptance snapshot. It must not alter facts,
capacity, routes or SFU usage. Collect annotated production samples before