Free, open-source screen sharing for private live streams with friends. Watch together in a browser or self-host Piik. 免费开源的私密屏幕共享,支持游戏直播、一起看电影与自部署。
import { PERSISTENT_NATIVE_EDGE_DEGRADED_WINDOWS } from "../../shared/protocol";
import type { ConnectionMetrics } from "../types";
interface DeliveredVideoSample {
timestampMs: number;
windowMs: number;
pixels: number;
framesDecoded: number;
bitrateKbps: number | null;
}
function deliveredNothingSample(
metrics: ConnectionMetrics,
): DeliveredVideoSample | null {
const { sampleTimestampMs, sampleWindowMs, intervalFramesDecoded } = metrics;
if (
sampleTimestampMs === null ||
sampleWindowMs === null ||
!Number.isFinite(sampleTimestampMs) ||
!Number.isFinite(sampleWindowMs) ||
sampleWindowMs < 1_000 ||
sampleWindowMs > 5_000 ||
intervalFramesDecoded !== 0
) {
return null;
}
return {
timestampMs: sampleTimestampMs,
windowMs: sampleWindowMs,
pixels: 0,
framesDecoded: 0,
bitrateKbps: 0,
};
}
function deliveredVideoSample(
metrics: ConnectionMetrics,
): DeliveredVideoSample | null {
const {
sampleTimestampMs,
sampleWindowMs,
frameWidth,
frameHeight,
bitrateKbps,
intervalFramesDecoded,
} = metrics;
if (
sampleTimestampMs === null ||
sampleWindowMs === null ||
frameWidth === null ||
frameHeight === null ||
intervalFramesDecoded === null ||
!Number.isFinite(sampleTimestampMs) ||
!Number.isFinite(sampleWindowMs) ||
!Number.isFinite(frameWidth) ||
!Number.isFinite(frameHeight) ||
!Number.isFinite(intervalFramesDecoded) ||
frameWidth <= 0 ||
frameHeight <= 0 ||
sampleWindowMs < 1_000 ||
sampleWindowMs > 5_000 ||
intervalFramesDecoded <= 0
) {
return null;
}
return {
timestampMs: sampleTimestampMs,
windowMs: sampleWindowMs,
pixels: frameWidth * frameHeight,
framesDecoded: intervalFramesDecoded,
bitrateKbps:
typeof bitrateKbps === "number" &&
Number.isFinite(bitrateKbps) &&
bitrateKbps > 0
? bitrateKbps
: null,
};
}
function comparableSamples(
current: ConnectionMetrics,
candidate: ConnectionMetrics,
): [DeliveredVideoSample, DeliveredVideoSample] | null {
// A dead incumbent is comparable only when the candidate actually delivers.
const currentVideo =
deliveredVideoSample(current) ?? deliveredNothingSample(current);
const candidateVideo = deliveredVideoSample(candidate);
if (
!currentVideo ||
!candidateVideo ||
Math.max(
currentVideo.timestampMs - currentVideo.windowMs,
candidateVideo.timestampMs - candidateVideo.windowMs,
) >= Math.min(currentVideo.timestampMs, candidateVideo.timestampMs) ||
candidate.intervalFreezeCount === null ||
candidate.intervalFreezeDurationMs === null ||
candidate.intervalPauseCount === null ||
candidate.intervalPauseDurationMs === null
) {
return null;
}
return [currentVideo, candidateVideo];
}
function frameRateDoesNotRegress(
current: DeliveredVideoSample,
candidate: DeliveredVideoSample,
): boolean {
return frameCountDeficit(
current.framesDecoded, current.windowMs,
candidate.framesDecoded, candidate.windowMs,
) <= 1;
}
function frameCountDeficit(
currentFrames: number, currentWindowMs: number,
candidateFrames: number, candidateWindowMs: number,
): number {
// Normalize discrete counters to one window; a boundary frame is not a rate change.
return Math.round(currentFrames * candidateWindowMs / currentWindowMs) - candidateFrames;
}
export function sfuCandidateDoesNotRegress(
current: ConnectionMetrics,
candidate: ConnectionMetrics,
): boolean | null {
const samples = comparableSamples(current, candidate);
if (!samples) return null;
const [currentVideo, candidateVideo] = samples;
if (
currentVideo.bitrateKbps === null ||
candidateVideo.bitrateKbps === null
) {
return null;
}
return (
candidate.intervalFreezeCount === 0 &&
candidate.intervalFreezeDurationMs === 0 &&
candidate.intervalPauseCount === 0 &&
candidate.intervalPauseDurationMs === 0 &&
candidateVideo.pixels >= currentVideo.pixels &&
frameRateDoesNotRegress(currentVideo, candidateVideo) &&
candidateVideo.bitrateKbps >= currentVideo.bitrateKbps
);
}
export function p2pCandidateDoesNotRegress(
current: ConnectionMetrics,
candidate: ConnectionMetrics,
): boolean | null {
const samples = comparableSamples(current, candidate);
if (!samples) return null;
const [currentVideo, candidateVideo] = samples;
return (
candidate.intervalFreezeCount === 0 &&
candidate.intervalFreezeDurationMs === 0 &&
candidate.intervalPauseCount === 0 &&
candidate.intervalPauseDurationMs === 0 &&
candidateVideo.pixels >= currentVideo.pixels &&
frameRateDoesNotRegress(currentVideo, candidateVideo)
);
}
class ConsecutiveCandidateQualityProbe {
private lastCandidateTimestampMs: number | null = null;
private lastCurrentTimestampMs: number | null = null;
private consecutiveApprovedWindows = 0;
private consecutiveRejectedWindows = 0;
private consecutiveFrameDeficit = 0;
constructor(
private readonly compare: (
current: ConnectionMetrics,
candidate: ConnectionMetrics,
) => boolean | null,
) {}
observe(
current: ConnectionMetrics | null,
candidate: ConnectionMetrics,
): CandidateQualityProbeResult {
const candidateTimestampMs = candidate.sampleTimestampMs;
if (
candidateTimestampMs === null ||
!Number.isFinite(candidateTimestampMs)
) {
this.resetRuns();
return "pending";
}
if (candidateTimestampMs === this.lastCandidateTimestampMs) {
return "pending";
}
if (
this.lastCandidateTimestampMs !== null &&
candidateTimestampMs < this.lastCandidateTimestampMs
) {
this.resetRuns();
return "pending";
}
this.lastCandidateTimestampMs = candidateTimestampMs;
if (
!current ||
current.sampleTimestampMs === null ||
!Number.isFinite(current.sampleTimestampMs) ||
(this.lastCurrentTimestampMs !== null &&
current.sampleTimestampMs <= this.lastCurrentTimestampMs)
) {
this.resetRuns();
return "pending";
}
this.lastCurrentTimestampMs = current.sampleTimestampMs;
const approved = this.compare(current, candidate);
if (approved === null) {
this.resetRuns();
return "pending";
}
if (approved) {
// The whole proof run shares one frame of resolution, not one per window.
this.consecutiveFrameDeficit += frameCountDeficit(
current.intervalFramesDecoded!, current.sampleWindowMs!,
candidate.intervalFramesDecoded!, candidate.sampleWindowMs!,
);
if (this.consecutiveFrameDeficit > 1) {
this.resetRuns();
return "pending";
}
this.consecutiveApprovedWindows += 1;
this.consecutiveRejectedWindows = 0;
return this.consecutiveApprovedWindows >= PERSISTENT_NATIVE_EDGE_DEGRADED_WINDOWS
? "approved"
: "pending";
}
this.consecutiveApprovedWindows = 0;
this.consecutiveFrameDeficit = 0;
this.consecutiveRejectedWindows += 1;
return this.consecutiveRejectedWindows >=
PERSISTENT_NATIVE_EDGE_DEGRADED_WINDOWS
? "rejected"
: "pending";
}
reset(): void {
this.lastCandidateTimestampMs = null;
this.lastCurrentTimestampMs = null;
this.resetRuns();
}
private resetRuns(): void {
this.consecutiveApprovedWindows = 0;
this.consecutiveRejectedWindows = 0;
this.consecutiveFrameDeficit = 0;
}
}
export type CandidateQualityProbeResult =
| "pending"
| "approved"
| "rejected";
export class SfuQualityProbe extends ConsecutiveCandidateQualityProbe {
constructor() {
super(sfuCandidateDoesNotRegress);
}
}
export class P2pQualityProbe extends ConsecutiveCandidateQualityProbe {
constructor() {
super(p2pCandidateDoesNotRegress);
}
}