Free, open-source screen sharing for private live streams with friends. Watch together in a browser or self-host Piik. 免费开源的私密屏幕共享,支持游戏直播、一起看电影与自部署。
import type {
ClientMessage,
MediaRoutePhase,
ParticipantRouteAssignment,
PreparedRouteCandidate,
} from "../../shared/protocol";
export type RouteUpdateInput =
| {
revision: number;
phase: "prepare";
assignment: ParticipantRouteAssignment;
candidate: PreparedRouteCandidate;
}
| {
revision: number;
phase: "active";
assignment: ParticipantRouteAssignment;
};
export interface RouteOperationToken {
revision: number;
generation: number;
}
export type RouteUpdateResult = "accepted" | "duplicate" | "stale";
export type PeerSignalOwner = "pending" | "active";
export function exactPeerSignalOwner(
connectionId: string,
pendingConnectionId: string | null,
activeConnectionId: string | null,
): PeerSignalOwner | null {
if (connectionId === pendingConnectionId) {
return "pending";
}
return connectionId === activeConnectionId ? "active" : null;
}
export class MediaRouteTransition {
private revision = -1;
private phase: MediaRoutePhase | null = null;
private plannedAssignment: ParticipantRouteAssignment | null = null;
private activeAssignment: ParticipantRouteAssignment | null = null;
// Preparation advances the operation without replacing committed authority.
private activeToken: RouteOperationToken | null = null;
private mediaAssignment: ParticipantRouteAssignment | null = null;
private preparedCandidate: PreparedRouteCandidate | null = null;
private generation = 0;
accept(update: RouteUpdateInput): RouteUpdateResult {
if (update.revision < this.revision) {
return "stale";
}
if (update.revision === this.revision) {
if (
!this.plannedAssignment ||
!sameAssignment(this.plannedAssignment, update.assignment) ||
(this.phase === "prepare" &&
update.phase === "prepare" &&
!sameCandidate(this.preparedCandidate, update.candidate)) ||
(this.phase === "active" && update.phase === "prepare")
) {
return "stale";
}
if (this.phase === update.phase) {
return "duplicate";
}
}
this.revision = update.revision;
this.phase = update.phase;
this.plannedAssignment = cloneAssignment(update.assignment);
this.preparedCandidate =
update.phase === "prepare" ? cloneCandidate(update.candidate) : null;
this.generation += 1;
if (update.phase === "active") {
this.activeAssignment = cloneAssignment(update.assignment);
this.activeToken = { revision: update.revision, generation: this.generation };
}
return "accepted";
}
acceptsConfig(revision: number): boolean {
return revision === this.revision && this.phase !== null;
}
token(): RouteOperationToken | null {
if (this.revision < 0 || this.phase === null) {
return null;
}
return { revision: this.revision, generation: this.generation };
}
owns(token: RouteOperationToken, phase?: MediaRoutePhase): boolean {
return (
token.revision === this.revision &&
token.generation === this.generation &&
(phase === undefined || this.phase === phase)
);
}
markMediaActive(token: RouteOperationToken): boolean {
if (!this.ownsActive(token) || !this.activeAssignment) {
return false;
}
this.mediaAssignment = cloneAssignment(this.activeAssignment);
return true;
}
getRevision(): number | null {
return this.revision < 0 ? null : this.revision;
}
getPhase(): MediaRoutePhase | null {
return this.phase;
}
getPlannedAssignment(): ParticipantRouteAssignment | null {
return this.plannedAssignment
? cloneAssignment(this.plannedAssignment)
: null;
}
getActiveAssignment(): ParticipantRouteAssignment | null {
return this.activeAssignment ? cloneAssignment(this.activeAssignment) : null;
}
getActiveRevision(): number | null {
return this.activeToken?.revision ?? null;
}
getActiveToken(): RouteOperationToken | null {
return this.activeToken ? { ...this.activeToken } : null;
}
ownsActive(token: RouteOperationToken): boolean {
return token.revision === this.activeToken?.revision &&
token.generation === this.activeToken.generation;
}
getMediaAssignment(): ParticipantRouteAssignment | null {
return this.mediaAssignment ? cloneAssignment(this.mediaAssignment) : null;
}
getPreparedCandidate(): PreparedRouteCandidate | null {
return this.preparedCandidate
? cloneCandidate(this.preparedCandidate)
: null;
}
reset(): void {
this.revision = -1;
this.phase = null;
this.plannedAssignment = null;
this.activeAssignment = null;
this.activeToken = null;
this.mediaAssignment = null;
this.preparedCandidate = null;
this.generation += 1;
}
}
function sameCandidate(
left: PreparedRouteCandidate | null,
right: PreparedRouteCandidate,
): boolean {
return (
left?.childPeerId === right.childPeerId &&
left.connectionId === right.connectionId &&
left.transport === right.transport &&
left.qualityProbe === right.qualityProbe
);
}
function cloneCandidate(
candidate: PreparedRouteCandidate,
): PreparedRouteCandidate {
return { ...candidate };
}
export function reportActivePeerRouteFailure(
route: MediaRouteTransition,
parentPeerId: string,
connectionId: string,
send: (message: ClientMessage) => boolean,
): boolean {
const assignment = route.getActiveAssignment();
const revision = route.getActiveRevision();
if (
revision === null ||
assignment?.upstream.kind !== "peer" ||
assignment.upstream.peerId !== parentPeerId
) {
return true;
}
return send({
type: "route-failed",
revision,
phase: "active",
connectionId,
});
}
function sameAssignment(
left: ParticipantRouteAssignment,
right: ParticipantRouteAssignment,
): boolean {
const rightChildren = new Set(right.childPeerIds);
return (
left.upstream.kind === right.upstream.kind &&
(left.upstream.kind !== "peer" ||
(right.upstream.kind === "peer" &&
left.upstream.peerId === right.upstream.peerId)) &&
left.sfuPublicationGeneration === right.sfuPublicationGeneration &&
left.childPeerIds.length === right.childPeerIds.length &&
left.childPeerIds.every((peerId) => rightChildren.has(peerId))
);
}
function cloneAssignment(
assignment: ParticipantRouteAssignment,
): ParticipantRouteAssignment {
return {
upstream:
assignment.upstream.kind === "peer"
? { kind: "peer", peerId: assignment.upstream.peerId }
: { kind: assignment.upstream.kind },
childPeerIds: [...assignment.childPeerIds],
sfuPublicationGeneration: assignment.sfuPublicationGeneration,
};
}