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(media): bound H264 diagnostic evidence (#206)

AAAba623c67e6e8
diff --git a/docs/research/realtime-quality-adaptation.md b/docs/research/realtime-quality-adaptation.md
index 491f313c..c939d672 100644
--- a/docs/research/realtime-quality-adaptation.md
+++ b/docs/research/realtime-quality-adaptation.md
@@ -220,20 +220,27 @@ does not prove shared encode: separate browser PeerConnections may construct
separate encoders, and the SFU still publishes only the configured `q,h`
representations.
-The retained diagnostic keeps lifecycle and codec experiments orthogonal.
-Lifecycle runs fix `automatic`; each independently recreated affected state runs
-exactly one of observe, preview cycle, Host-peer rebuild, capture replacement,
-or Host reload. Codec A/B uses fresh Host/share/PeerConnection sessions for
-automatic, H.264, and VP8 and rejects an actual-codec mismatch. Quality claims
-require a headed run with the same real game, browser/driver, capture surface,
-and one wired direct Viewer. Capture A, sender B, and Viewer C samples must share
-the current generation and overlapping windows; identity polling must not
-advance their accumulators. Record actual codec/profile, configured/source/send/
-receive FPS, interval encoded frames/encode time, limitation reason, game FPS,
-and process-scoped GPU evidence. Missing implementation or power-efficiency
-fields remain unknown. No H.264 root cause or policy change is accepted until
-the controlled sample distinguishes capture starvation, software fallback,
-hardware queue/driver pressure, and congestion.
+The repository diagnostic is a mechanical single-machine preflight, not a
+quality runner. Lifecycle runs fix `automatic`; each fresh run performs exactly
+one of observe, preview cycle, Host-peer rebuild, capture replacement, or Host
+reload, keeps the actual codec/profile/parameters stable across that action, and
+rechecks the action budget after its two current-generation evidence windows.
+Codec preflight uses fresh Host/share/PeerConnection sessions for automatic,
+H.264, and VP8 and rejects an actual-codec mismatch. Reports retain only
+allowlisted failure stages and sanitized identifiers.
+
+Quality diagnosis remains a separately orchestrated headed matrix with the same
+real game, browser/driver, capture surface, and one external wired direct Viewer;
+the local loopback preflight cannot satisfy it. Capture A, sender B, and Viewer C
+samples must share the current generation and overlapping windows; identity
+polling must not advance their accumulators. Record actual codec/profile,
+configured/source/send/receive FPS, interval encoded frames/encode time,
+limitation reason, game FPS, and process-scoped GPU evidence. Missing
+implementation or power-efficiency fields remain unknown. Add a remote runner
+adapter only when that matrix has a current automated consumer. No H.264 root
+cause or policy change is accepted until the controlled sample distinguishes
+capture starvation, software fallback, hardware queue/driver pressure, and
+congestion.
Open-source distribution is not itself a patent-license exemption. This Web
change only requests a codec already implemented by the browser/LiveKit path and