Free, open-source screen sharing for private live streams with friends. Watch together in a browser or self-host Piik. 免费开源的私密屏幕共享,支持游戏直播、一起看电影与自部署。
import { describe, expect, it } from "vitest";
import { parse } from "sdp-transform";
import { preferRoomVoiceAudio, preferScreenAudioStereo } from "../src/client/webrtc/opus-receive-sdp.ts";
function answerSdp(opusFmtp: string | null = "minptime=10;useinbandfec=1"): string {
return [
"v=0",
"o=- 1 1 IN IP4 127.0.0.1",
"s=-",
"t=0 0",
"m=audio 9 UDP/TLS/RTP/SAVPF 111 0",
"c=IN IP4 0.0.0.0",
"a=rtpmap:111 opus/48000/2",
...(opusFmtp === null ? [] : [`a=fmtp:111 ${opusFmtp}`]),
"a=rtpmap:0 PCMU/8000",
"a=recvonly",
"m=video 9 UDP/TLS/RTP/SAVPF 96",
"c=IN IP4 0.0.0.0",
"a=rtpmap:96 H264/90000",
"a=fmtp:96 packetization-mode=1;profile-level-id=42e01f",
"a=recvonly",
"",
].join("\r\n");
}
describe("preferScreenAudioStereo", () => {
it("lets all voice media sections negotiate mono bitrate without changing picture SDP", () => {
const sdp = answerSdp() + answerSdp().slice(answerSdp().indexOf("m=audio"));
const offered = preferRoomVoiceAudio({ type: "offer", sdp });
const sections = parse(offered.sdp!).media;
expect(sections.filter(media => media.type === "audio").map(media => media.fmtp[0]?.config))
.toEqual(Array(2).fill("minptime=10;useinbandfec=1;stereo=0;maxaveragebitrate=510000"));
expect(sections.filter(media => media.type === "video")).toEqual(parse(sdp).media.filter(media => media.type === "video"));
expect(preferRoomVoiceAudio(offered)).toEqual(offered);
});
it("adds exact stereo and bitrate tokens without changing FEC or video fmtp", () => {
const result = preferScreenAudioStereo({
type: "answer",
sdp: answerSdp("minptime=10;useinbandfec=1;x-stereo=keep"),
});
const session = parse(result.sdp!);
expect(session.media[0]?.fmtp).toContainEqual({
payload: 111,
config:
"minptime=10;useinbandfec=1;x-stereo=keep;stereo=1;maxaveragebitrate=510000",
});
expect(session.media[1]?.fmtp).toEqual([
{ payload: 96, config: "packetization-mode=1;profile-level-id=42e01f" },
]);
expect(preferScreenAudioStereo(result)).toEqual(result);
});
it("replaces only exact stereo and bitrate tokens", () => {
const result = preferScreenAudioStereo({
type: "answer",
sdp: answerSdp(
"stereo=0;x-stereo=0;maxaveragebitrate=64000;x-maxaveragebitrate=keep",
),
});
expect(parse(result.sdp!).media[0]?.fmtp[0]?.config).toBe(
"stereo=1;x-stereo=0;maxaveragebitrate=510000;x-maxaveragebitrate=keep",
);
});
it("creates the Opus fmtp row when it is absent", () => {
const result = preferScreenAudioStereo({
type: "answer",
sdp: answerSdp(null),
});
expect(parse(result.sdp!).media[0]?.fmtp).toContainEqual({
payload: 111,
config: "stereo=1;maxaveragebitrate=510000",
});
});
it("ignores a rejected audio section", () => {
const rejected = [
"m=audio 0 UDP/TLS/RTP/SAVPF 112",
"a=rtpmap:112 opus/48000/2",
"a=fmtp:112 stereo=0",
].join("\r\n");
const result = preferScreenAudioStereo({
type: "answer",
sdp: answerSdp().replace("m=audio 9", `${rejected}\r\nm=audio 9`),
});
const audio = parse(result.sdp!).media.filter((media) => media.type === "audio");
expect(audio[0]?.fmtp[0]?.config).toBe("stereo=0");
expect(audio[1]?.fmtp[0]?.config).toContain("stereo=1");
expect(audio[1]?.fmtp[0]?.config).toContain("maxaveragebitrate=510000");
});
it.each([
["empty", { type: "answer", sdp: "" }],
["malformed", { type: "answer", sdp: "not SDP" }],
["parser exception", { type: "answer", sdp: { trim: () => "x" } as unknown as string }],
["not an answer", { type: "offer", sdp: answerSdp() }],
[
"missing Opus",
{ type: "answer", sdp: answerSdp().replace("opus/48000/2", "ISAC/16000") },
],
[
"multiple active audio sections",
{ type: "answer", sdp: `${answerSdp()}m=audio 9 RTP/AVP 0\r\n` },
],
[
"duplicate Opus fmtp rows",
{
type: "answer",
sdp: answerSdp().replace(
"a=fmtp:111 minptime=10;useinbandfec=1",
"a=fmtp:111 minptime=10\r\na=fmtp:111 useinbandfec=1",
),
},
],
[
"duplicate target parameter",
{
type: "answer",
sdp: answerSdp(
"stereo=0;maxaveragebitrate=64000;MAXAVERAGEBITRATE=96000",
),
},
],
] as const)("returns the original answer for %s", (_case, answer) => {
const result = preferScreenAudioStereo(answer);
expect(result).toBe(answer);
expect(result.sdp).toBe(answer.sdp);
});
});