Free, open-source screen sharing for private live streams with friends. Watch together in a browser or self-host Piik. 免费开源的私密屏幕共享,支持游戏直播、一起看电影与自部署。
import { parse } from "sdp-transform";
export type BrowserVideoCodec = "h264" | "vp8";
export type BrowserVideoCodecMode = "vp8" | "auto" | "h264";
export interface BrowserVideoCodecPreference {
primary: BrowserVideoCodec;
vp8Fallback: boolean;
}
export const VP8_ONLY_VIDEO_CODEC: BrowserVideoCodecPreference = {
primary: "vp8",
vp8Fallback: false,
};
export function automaticVideoCodecPreference(
codec: BrowserVideoCodec,
): BrowserVideoCodecPreference {
return { primary: codec, vp8Fallback: codec === "h264" };
}
export function manualVideoCodecPreference(
codec: BrowserVideoCodec,
): BrowserVideoCodecPreference {
return { primary: codec, vp8Fallback: false };
}
const REPAIR_CODEC_MIME_TYPES = new Set([
"video/rtx",
"video/red",
"video/ulpfec",
"video/flexfec-03",
]);
function videoCapabilities(): RTCRtpCodec[] {
return RTCRtpSender.getCapabilities?.("video")?.codecs ?? [];
}
function vp8Codecs(codecs: readonly RTCRtpCodec[]): RTCRtpCodec[] {
return codecs.filter(
({ mimeType }) => mimeType.toLowerCase() === "video/vp8",
);
}
function h264ModeOneCodecs(codecs: readonly RTCRtpCodec[]): RTCRtpCodec[] {
return codecs.filter(({ mimeType, sdpFmtpLine }) => {
if (mimeType.toLowerCase() !== "video/h264") {
return false;
}
return (
!sdpFmtpLine ||
/(?:^|;)\s*packetization-mode=1(?:;|$)/i.test(sdpFmtpLine)
);
});
}
function repairCodecs(codecs: readonly RTCRtpCodec[]): RTCRtpCodec[] {
return codecs.filter(({ mimeType }) =>
REPAIR_CODEC_MIME_TYPES.has(mimeType.toLowerCase()),
);
}
function applyCodecs(
transceiver: RTCRtpTransceiver,
codecs: RTCRtpCodec[],
): boolean {
if (typeof transceiver.setCodecPreferences !== "function") {
return false;
}
try {
transceiver.setCodecPreferences(codecs);
return true;
} catch {
return false;
}
}
export function applyVideoCodecPreference(
transceiver: RTCRtpTransceiver,
preference: BrowserVideoCodecPreference,
): boolean {
if (typeof RTCRtpSender === "undefined") {
return false;
}
const codecs = videoCapabilities();
const vp8 = vp8Codecs(codecs);
if (
(preference.primary === "vp8" || preference.vp8Fallback) &&
vp8.length === 0
) {
return false;
}
const h264 =
preference.primary === "h264" ? h264ModeOneCodecs(codecs) : [];
if (preference.primary === "h264" && h264.length === 0) {
return false;
}
return applyCodecs(transceiver, [
...h264,
...(preference.primary === "vp8" || preference.vp8Fallback ? vp8 : []),
...repairCodecs(codecs),
]);
}
export function applyH264ProbeCodec(
transceiver: RTCRtpTransceiver,
): boolean {
if (typeof RTCRtpSender === "undefined") {
return false;
}
const codecs = videoCapabilities();
const h264 = h264ModeOneCodecs(codecs);
return h264.length > 0 &&
applyCodecs(transceiver, [...h264, ...repairCodecs(codecs)]);
}
/** Remove only attributes of codecs excluded from a locally generated offer.
* Firefox can retain them after setCodecPreferences (Mozilla bug 1909443),
* making the whole offer unparseable in Chromium. Do not rewrite codec choices,
* valid feedback, unknown attributes or answers with asymmetric payload types.
*/
export function normalizeVideoOfferSdp(sdp: string): string {
let payloads: Set<number> | null = null;
let changed = false;
const lines = sdp.split(/\r?\n/).filter(line => {
if (line.startsWith("m=")) {
const fields = line.trim().split(/\s+/);
payloads = fields[0] === "m=video" && fields.length >= 4
? new Set(fields.slice(3).map(Number)) : null;
}
const attribute = /^a=(?:fmtp|rtcp-fb):(\d+)(?:\s|$)/.exec(line);
if (payloads && attribute && !payloads.has(Number(attribute[1]))) {
changed = true;
return false;
}
return true;
});
return changed ? lines.join(sdp.includes("\r\n") ? "\r\n" : "\n") : sdp;
}
export class VideoReceiveRejectedError extends Error {
constructor() { super("Browser rejected the offered video"); }
}
// JSEP rejects a media section with port zero. Let the Browser negotiate codecs;
// reject only an answer that explicitly declines every offered sending video.
export function requireReceivingVideo(
offer: RTCSessionDescriptionInit,
answer: RTCSessionDescriptionInit,
): void {
if (offer.type !== "offer" || answer.type !== "answer" || !offer.sdp || !answer.sdp) return;
const remote = parse(offer.sdp), local = parse(answer.sdp);
const sendingVideo = remote.media.flatMap((media, index) => {
const direction = media.direction ?? remote.direction;
return media.type === "video" && (media.port !== 0 || media.bundleOnly !== undefined) &&
direction !== "inactive" && direction !== "recvonly" ? [index] : [];
});
if (sendingVideo.length > 0 && sendingVideo.every(index =>
local.media[index]?.type === "video" && local.media[index]?.port === 0,
)) throw new VideoReceiveRejectedError();
}