@wetspace/wetrtc 3.0.2 → 4.0.0

package/dist/es/index.js

@@ -0,0 +1,48 @@
+import { WetRTC } from "./wetrtc";
+import { SignalManager } from "./signal/signal-manager";
+import { MediaManager } from "./media/media-manager";
+import { DataManager } from "./data/data-manager";
+import { StatsMonitor } from "./stats/stats-monitor";
+import { ConnectionStateMachine } from "./fsm";
+import { DisposableStack } from "./disposable";
+import {
+  applyVideoTrackContentHint,
+  applyVideoSenderEncoding,
+  applyReceiverPlayoutDelay,
+  applyVideoEncodingToConnection
+} from "./media/video-encoding";
+import {
+  applyAudioSenderEncoding,
+  applyAudioEncodingToConnection
+} from "./media/audio-encoding";
+import {
+  sortVideoCodecsH264First,
+  applyH264CodecPreference,
+  applyH264CodecPreferences,
+  sortAudioCodecsOpusFirst,
+  applyOpusCodecPreference,
+  applyOpusCodecPreferences
+} from "./media/codec-preference";
+export {
+  ConnectionStateMachine,
+  DataManager,
+  DisposableStack,
+  MediaManager,
+  SignalManager,
+  StatsMonitor,
+  WetRTC,
+  applyAudioEncodingToConnection,
+  applyAudioSenderEncoding,
+  applyH264CodecPreference,
+  applyH264CodecPreferences,
+  applyOpusCodecPreference,
+  applyOpusCodecPreferences,
+  applyReceiverPlayoutDelay,
+  applyVideoEncodingToConnection,
+  applyVideoSenderEncoding,
+  applyVideoTrackContentHint,
+  sortAudioCodecsOpusFirst,
+  sortVideoCodecsH264First
+};
+
+//# sourceMappingURL=index.js.map

package/dist/es/index.js.map

@@ -0,0 +1 @@
+{"version":3,"mappings":"AAAA,SAAS,cAAc;AACvB,SAAS,qBAAqB;AAC9B,SAAS,oBAAoB;AAC7B,SAAS,mBAAmB;AAC5B,SAAS,oBAAoB;AAC7B,SAAS,8BAA8B;AAEvC,SAAS,uBAAyC;AAmBlD;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP;AAAA,EACE;AAAA,EACA;AAAA,OACK;AACP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK","names":[],"ignoreList":[],"sources":["../../src/index.ts"],"sourcesContent":["export { WetRTC } from './wetrtc';\r\nexport { SignalManager } from './signal/signal-manager';\r\nexport { MediaManager } from './media/media-manager';\r\nexport { DataManager } from './data/data-manager';\r\nexport { StatsMonitor } from './stats/stats-monitor';\r\nexport { ConnectionStateMachine } from './fsm';\r\nexport type { ConnectionState } from './fsm';\r\nexport { DisposableStack, type IDisposable } from './disposable';\r\n\r\nexport type { WetRTCConfig } from './wetrtc';\r\nexport type { SignalChannel, SignalMessage } from './signal/types';\r\nexport type { SignalConfig } from './signal/signal-manager';\r\nexport type {\r\n  DeviceInfo,\r\n  DisplayMediaOptions,\r\n  UserMediaOptions,\r\n  MediaConstraints,\r\n} from './media/types';\r\nexport type { VideoEncodingOptions } from './media/video-encoding';\r\nexport type { AudioEncodingOptions } from './media/audio-encoding';\r\nexport type {\r\n  PreferredVideoCodec,\r\n  PreferredAudioCodec,\r\n  VideoRtpCodec,\r\n  AudioRtpCodec,\r\n} from './media/codec-preference';\r\nexport {\r\n  applyVideoTrackContentHint,\r\n  applyVideoSenderEncoding,\r\n  applyReceiverPlayoutDelay,\r\n  applyVideoEncodingToConnection,\r\n} from './media/video-encoding';\r\nexport {\r\n  applyAudioSenderEncoding,\r\n  applyAudioEncodingToConnection,\r\n} from './media/audio-encoding';\r\nexport {\r\n  sortVideoCodecsH264First,\r\n  applyH264CodecPreference,\r\n  applyH264CodecPreferences,\r\n  sortAudioCodecsOpusFirst,\r\n  applyOpusCodecPreference,\r\n  applyOpusCodecPreferences,\r\n} from './media/codec-preference';\r\nexport type {\r\n  DataChannelOptions,\r\n  DataChannelConfig,\r\n  FileTransferOptions,\r\n  FileMeta,\r\n} from './data/types';\r\nexport type {\r\n  StatsSnapshot,\r\n  DiagnosticReport,\r\n  StatsMonitorOptions,\r\n} from './stats/types';\r\nexport type {\r\n  WetRTCEvent,\r\n  WetRTCEventMap,\r\n  WetRTCError,\r\n  WetRTCErrorCode,\r\n} from './utils/types';//# sourceMappingURL=data:application/json;charset=utf-8;base64,eyJ2ZXJzaW9uIjozLCJtYXBwaW5ncyI6IiIsIm5hbWVzIjpbXSwiaWdub3JlTGlzdCI6W10sInNvdXJjZXMiOltdLCJzb3VyY2VzQ29udGVudCI6W119"]}

package/dist/es/media/audio-encoding.d.ts

@@ -0,0 +1,10 @@
+export interface AudioEncodingOptions {
+    /** 最大码率 (bps)，语音常用 32_000–64_000，音乐/系统声可更高 */
+    maxBitrate?: number;
+    priority?: RTCPriorityType;
+    networkPriority?: RTCPriorityType;
+}
+/** @returns 是否成功调用 setParameters（协商完成前失败属正常，可在 connected 后重试） */
+export declare function applyAudioSenderEncoding(sender: RTCRtpSender, options: AudioEncodingOptions): Promise<boolean>;
+export declare function applyAudioEncodingToConnection(pc: RTCPeerConnection, options: AudioEncodingOptions): Promise<boolean>;
+//# sourceMappingURL=audio-encoding.d.ts.map

package/dist/es/media/audio-encoding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio-encoding.d.ts","sourceRoot":"","sources":["../../../src/media/audio-encoding.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,oBAAoB;IACnC,8CAA8C;IAC9C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,eAAe,CAAC,EAAE,eAAe,CAAC;CACnC;AAED,iEAAiE;AACjE,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,OAAO,CAAC,CA6BlB;AAED,wBAAsB,8BAA8B,CAClD,EAAE,EAAE,iBAAiB,EACrB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,OAAO,CAAC,CAQlB"}

package/dist/es/media/audio-encoding.js

@@ -0,0 +1,41 @@
+import { isExpectedSetParametersError } from "./encoding-utils";
+async function applyAudioSenderEncoding(sender, options) {
+  const track = sender.track;
+  if (!track || track.kind !== "audio")
+    return false;
+  const params = sender.getParameters();
+  if (!params.encodings?.length) {
+    params.encodings = [{}];
+  }
+  const encoding = params.encodings[0];
+  if (options.maxBitrate != null) {
+    encoding.maxBitrate = options.maxBitrate;
+  }
+  if (options.priority != null) {
+    encoding.priority = options.priority;
+  }
+  if (options.networkPriority != null) {
+    encoding.networkPriority = options.networkPriority;
+  }
+  try {
+    await sender.setParameters(params);
+    return true;
+  } catch (err) {
+    if (isExpectedSetParametersError(err)) {
+      return false;
+    }
+    throw err;
+  }
+}
+async function applyAudioEncodingToConnection(pc, options) {
+  const results = await Promise.all(
+    pc.getSenders().filter((sender) => sender.track?.kind === "audio").map((sender) => applyAudioSenderEncoding(sender, options))
+  );
+  return results.some(Boolean);
+}
+export {
+  applyAudioEncodingToConnection,
+  applyAudioSenderEncoding
+};
+
+//# sourceMappingURL=audio-encoding.js.map

package/dist/es/media/audio-encoding.js.map

@@ -0,0 +1 @@
+{"version":3,"mappings":"AAAA,SAAS,oCAAoC;AAU7C,eAAsB,yBACpB,QACA,SACkB;AAClB,QAAM,QAAQ,OAAO;AACrB,MAAI,CAAC,SAAS,MAAM,SAAS;AAAS,WAAO;AAE7C,QAAM,SAAS,OAAO,cAAc;AACpC,MAAI,CAAC,OAAO,WAAW,QAAQ;AAC7B,WAAO,YAAY,CAAC,CAAC,CAAC;AAAA,EACxB;AAEA,QAAM,WAAW,OAAO,UAAU,CAAC;AACnC,MAAI,QAAQ,cAAc,MAAM;AAC9B,aAAS,aAAa,QAAQ;AAAA,EAChC;AACA,MAAI,QAAQ,YAAY,MAAM;AAC5B,aAAS,WAAW,QAAQ;AAAA,EAC9B;AACA,MAAI,QAAQ,mBAAmB,MAAM;AACnC,aAAS,kBAAkB,QAAQ;AAAA,EACrC;AAEA,MAAI;AACF,UAAM,OAAO,cAAc,MAAM;AACjC,WAAO;AAAA,EACT,SAAS,KAAK;AACZ,QAAI,6BAA6B,GAAG,GAAG;AACrC,aAAO;AAAA,IACT;AACA,UAAM;AAAA,EACR;AACF;AAEA,eAAsB,+BACpB,IACA,SACkB;AAClB,QAAM,UAAU,MAAM,QAAQ;AAAA,IAC5B,GACG,WAAW,EACX,OAAO,CAAC,WAAW,OAAO,OAAO,SAAS,OAAO,EACjD,IAAI,CAAC,WAAW,yBAAyB,QAAQ,OAAO,CAAC;AAAA,EAC9D;AACA,SAAO,QAAQ,KAAK,OAAO;AAC7B","names":[],"ignoreList":[],"sources":["../../../src/media/audio-encoding.ts"],"sourcesContent":["import { isExpectedSetParametersError } from './encoding-utils';\r\n\r\nexport interface AudioEncodingOptions {\r\n  /** 最大码率 (bps)，语音常用 32_000–64_000，音乐/系统声可更高 */\r\n  maxBitrate?: number;\r\n  priority?: RTCPriorityType;\r\n  networkPriority?: RTCPriorityType;\r\n}\r\n\r\n/** @returns 是否成功调用 setParameters（协商完成前失败属正常，可在 connected 后重试） */\r\nexport async function applyAudioSenderEncoding(\r\n  sender: RTCRtpSender,\r\n  options: AudioEncodingOptions,\r\n): Promise<boolean> {\r\n  const track = sender.track;\r\n  if (!track || track.kind !== 'audio') return false;\r\n\r\n  const params = sender.getParameters();\r\n  if (!params.encodings?.length) {\r\n    params.encodings = [{}];\r\n  }\r\n\r\n  const encoding = params.encodings[0];\r\n  if (options.maxBitrate != null) {\r\n    encoding.maxBitrate = options.maxBitrate;\r\n  }\r\n  if (options.priority != null) {\r\n    encoding.priority = options.priority;\r\n  }\r\n  if (options.networkPriority != null) {\r\n    encoding.networkPriority = options.networkPriority;\r\n  }\r\n\r\n  try {\r\n    await sender.setParameters(params);\r\n    return true;\r\n  } catch (err) {\r\n    if (isExpectedSetParametersError(err)) {\r\n      return false;\r\n    }\r\n    throw err;\r\n  }\r\n}\r\n\r\nexport async function applyAudioEncodingToConnection(\r\n  pc: RTCPeerConnection,\r\n  options: AudioEncodingOptions,\r\n): Promise<boolean> {\r\n  const results = await Promise.all(\r\n    pc\r\n      .getSenders()\r\n      .filter((sender) => sender.track?.kind === 'audio')\r\n      .map((sender) => applyAudioSenderEncoding(sender, options)),\r\n  );\r\n  return results.some(Boolean);\r\n}\r\n//# sourceMappingURL=data:application/json;charset=utf-8;base64,eyJ2ZXJzaW9uIjozLCJtYXBwaW5ncyI6IiIsIm5hbWVzIjpbXSwiaWdub3JlTGlzdCI6W10sInNvdXJjZXMiOltdLCJzb3VyY2VzQ29udGVudCI6W119"]}

package/dist/es/media/codec-preference.d.ts

@@ -0,0 +1,11 @@
+export type PreferredVideoCodec = 'auto' | 'h264';
+export type PreferredAudioCodec = 'auto' | 'opus';
+export type VideoRtpCodec = NonNullable<ReturnType<typeof RTCRtpReceiver.getCapabilities>>['codecs'][number];
+export type AudioRtpCodec = NonNullable<ReturnType<typeof RTCRtpReceiver.getCapabilities>>['codecs'][number];
+export declare function sortVideoCodecsH264First(codecs: VideoRtpCodec[]): VideoRtpCodec[];
+export declare function applyH264CodecPreference(transceiver: RTCRtpTransceiver): boolean;
+export declare function applyH264CodecPreferences(pc: RTCPeerConnection): void;
+export declare function sortAudioCodecsOpusFirst(codecs: AudioRtpCodec[]): AudioRtpCodec[];
+export declare function applyOpusCodecPreference(transceiver: RTCRtpTransceiver): boolean;
+export declare function applyOpusCodecPreferences(pc: RTCPeerConnection): void;
+//# sourceMappingURL=codec-preference.d.ts.map

package/dist/es/media/codec-preference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codec-preference.d.ts","sourceRoot":"","sources":["../../../src/media/codec-preference.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,MAAM,CAAC;AAClD,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,MAAM,CAAC;AAElD,MAAM,MAAM,aAAa,GAAG,WAAW,CACrC,UAAU,CAAC,OAAO,cAAc,CAAC,eAAe,CAAC,CAClD,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC;AAEpB,MAAM,MAAM,aAAa,GAAG,WAAW,CACrC,UAAU,CAAC,OAAO,cAAc,CAAC,eAAe,CAAC,CAClD,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC;AAEpB,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,aAAa,EAAE,CAmBjF;AAED,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,iBAAiB,GAAG,OAAO,CAUhF;AAED,wBAAgB,yBAAyB,CAAC,EAAE,EAAE,iBAAiB,GAAG,IAAI,CAQrE;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,aAAa,EAAE,CAajF;AAED,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,iBAAiB,GAAG,OAAO,CAUhF;AAED,wBAAgB,yBAAyB,CAAC,EAAE,EAAE,iBAAiB,GAAG,IAAI,CAQrE"}

package/dist/es/media/codec-preference.js

@@ -0,0 +1,77 @@
+function sortVideoCodecsH264First(codecs) {
+  const h264 = [];
+  const rest = [];
+  for (const codec of codecs) {
+    if (codec.mimeType.toLowerCase() === "video/h264") {
+      h264.push(codec);
+    } else {
+      rest.push(codec);
+    }
+  }
+  h264.sort((a, b) => {
+    const aPkt = a.sdpFmtpLine?.includes("packetization-mode=1") ? 0 : 1;
+    const bPkt = b.sdpFmtpLine?.includes("packetization-mode=1") ? 0 : 1;
+    return aPkt - bPkt;
+  });
+  return [...h264, ...rest];
+}
+function applyH264CodecPreference(transceiver) {
+  const caps = RTCRtpReceiver.getCapabilities("video");
+  if (!caps?.codecs?.length)
+    return false;
+  try {
+    transceiver.setCodecPreferences(sortVideoCodecsH264First(caps.codecs));
+    return true;
+  } catch {
+    return false;
+  }
+}
+function applyH264CodecPreferences(pc) {
+  for (const transceiver of pc.getTransceivers()) {
+    const kind = transceiver.sender.track?.kind ?? transceiver.receiver.track?.kind;
+    if (kind === "video") {
+      applyH264CodecPreference(transceiver);
+    }
+  }
+}
+function sortAudioCodecsOpusFirst(codecs) {
+  const opus = [];
+  const rest = [];
+  for (const codec of codecs) {
+    if (codec.mimeType.toLowerCase() === "audio/opus") {
+      opus.push(codec);
+    } else {
+      rest.push(codec);
+    }
+  }
+  return [...opus, ...rest];
+}
+function applyOpusCodecPreference(transceiver) {
+  const caps = RTCRtpReceiver.getCapabilities("audio");
+  if (!caps?.codecs?.length)
+    return false;
+  try {
+    transceiver.setCodecPreferences(sortAudioCodecsOpusFirst(caps.codecs));
+    return true;
+  } catch {
+    return false;
+  }
+}
+function applyOpusCodecPreferences(pc) {
+  for (const transceiver of pc.getTransceivers()) {
+    const kind = transceiver.sender.track?.kind ?? transceiver.receiver.track?.kind;
+    if (kind === "audio") {
+      applyOpusCodecPreference(transceiver);
+    }
+  }
+}
+export {
+  applyH264CodecPreference,
+  applyH264CodecPreferences,
+  applyOpusCodecPreference,
+  applyOpusCodecPreferences,
+  sortAudioCodecsOpusFirst,
+  sortVideoCodecsH264First
+};
+
+//# sourceMappingURL=codec-preference.js.map

package/dist/es/media/codec-preference.js.map

@@ -0,0 +1 @@
+{"version":3,"mappings":"AAWO,SAAS,yBAAyB,QAA0C;AACjF,QAAM,OAAwB,CAAC;AAC/B,QAAM,OAAwB,CAAC;AAE/B,aAAW,SAAS,QAAQ;AAC1B,QAAI,MAAM,SAAS,YAAY,MAAM,cAAc;AACjD,WAAK,KAAK,KAAK;AAAA,IACjB,OAAO;AACL,WAAK,KAAK,KAAK;AAAA,IACjB;AAAA,EACF;AAEA,OAAK,KAAK,CAAC,GAAG,MAAM;AAClB,UAAM,OAAO,EAAE,aAAa,SAAS,sBAAsB,IAAI,IAAI;AACnE,UAAM,OAAO,EAAE,aAAa,SAAS,sBAAsB,IAAI,IAAI;AACnE,WAAO,OAAO;AAAA,EAChB,CAAC;AAED,SAAO,CAAC,GAAG,MAAM,GAAG,IAAI;AAC1B;AAEO,SAAS,yBAAyB,aAAyC;AAChF,QAAM,OAAO,eAAe,gBAAgB,OAAO;AACnD,MAAI,CAAC,MAAM,QAAQ;AAAQ,WAAO;AAElC,MAAI;AACF,gBAAY,oBAAoB,yBAAyB,KAAK,MAAM,CAAC;AACrE,WAAO;AAAA,EACT,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAEO,SAAS,0BAA0B,IAA6B;AACrE,aAAW,eAAe,GAAG,gBAAgB,GAAG;AAC9C,UAAM,OACJ,YAAY,OAAO,OAAO,QAAQ,YAAY,SAAS,OAAO;AAChE,QAAI,SAAS,SAAS;AACpB,+BAAyB,WAAW;AAAA,IACtC;AAAA,EACF;AACF;AAEO,SAAS,yBAAyB,QAA0C;AACjF,QAAM,OAAwB,CAAC;AAC/B,QAAM,OAAwB,CAAC;AAE/B,aAAW,SAAS,QAAQ;AAC1B,QAAI,MAAM,SAAS,YAAY,MAAM,cAAc;AACjD,WAAK,KAAK,KAAK;AAAA,IACjB,OAAO;AACL,WAAK,KAAK,KAAK;AAAA,IACjB;AAAA,EACF;AAEA,SAAO,CAAC,GAAG,MAAM,GAAG,IAAI;AAC1B;AAEO,SAAS,yBAAyB,aAAyC;AAChF,QAAM,OAAO,eAAe,gBAAgB,OAAO;AACnD,MAAI,CAAC,MAAM,QAAQ;AAAQ,WAAO;AAElC,MAAI;AACF,gBAAY,oBAAoB,yBAAyB,KAAK,MAAM,CAAC;AACrE,WAAO;AAAA,EACT,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAEO,SAAS,0BAA0B,IAA6B;AACrE,aAAW,eAAe,GAAG,gBAAgB,GAAG;AAC9C,UAAM,OACJ,YAAY,OAAO,OAAO,QAAQ,YAAY,SAAS,OAAO;AAChE,QAAI,SAAS,SAAS;AACpB,+BAAyB,WAAW;AAAA,IACtC;AAAA,EACF;AACF","names":[],"ignoreList":[],"sources":["../../../src/media/codec-preference.ts"],"sourcesContent":["export type PreferredVideoCodec = 'auto' | 'h264';\r\nexport type PreferredAudioCodec = 'auto' | 'opus';\r\n\r\nexport type VideoRtpCodec = NonNullable<\r\n  ReturnType<typeof RTCRtpReceiver.getCapabilities>\r\n>['codecs'][number];\r\n\r\nexport type AudioRtpCodec = NonNullable<\r\n  ReturnType<typeof RTCRtpReceiver.getCapabilities>\r\n>['codecs'][number];\r\n\r\nexport function sortVideoCodecsH264First(codecs: VideoRtpCodec[]): VideoRtpCodec[] {\r\n  const h264: VideoRtpCodec[] = [];\r\n  const rest: VideoRtpCodec[] = [];\r\n\r\n  for (const codec of codecs) {\r\n    if (codec.mimeType.toLowerCase() === 'video/h264') {\r\n      h264.push(codec);\r\n    } else {\r\n      rest.push(codec);\r\n    }\r\n  }\r\n\r\n  h264.sort((a, b) => {\r\n    const aPkt = a.sdpFmtpLine?.includes('packetization-mode=1') ? 0 : 1;\r\n    const bPkt = b.sdpFmtpLine?.includes('packetization-mode=1') ? 0 : 1;\r\n    return aPkt - bPkt;\r\n  });\r\n\r\n  return [...h264, ...rest];\r\n}\r\n\r\nexport function applyH264CodecPreference(transceiver: RTCRtpTransceiver): boolean {\r\n  const caps = RTCRtpReceiver.getCapabilities('video');\r\n  if (!caps?.codecs?.length) return false;\r\n\r\n  try {\r\n    transceiver.setCodecPreferences(sortVideoCodecsH264First(caps.codecs));\r\n    return true;\r\n  } catch {\r\n    return false;\r\n  }\r\n}\r\n\r\nexport function applyH264CodecPreferences(pc: RTCPeerConnection): void {\r\n  for (const transceiver of pc.getTransceivers()) {\r\n    const kind =\r\n      transceiver.sender.track?.kind ?? transceiver.receiver.track?.kind;\r\n    if (kind === 'video') {\r\n      applyH264CodecPreference(transceiver);\r\n    }\r\n  }\r\n}\r\n\r\nexport function sortAudioCodecsOpusFirst(codecs: AudioRtpCodec[]): AudioRtpCodec[] {\r\n  const opus: AudioRtpCodec[] = [];\r\n  const rest: AudioRtpCodec[] = [];\r\n\r\n  for (const codec of codecs) {\r\n    if (codec.mimeType.toLowerCase() === 'audio/opus') {\r\n      opus.push(codec);\r\n    } else {\r\n      rest.push(codec);\r\n    }\r\n  }\r\n\r\n  return [...opus, ...rest];\r\n}\r\n\r\nexport function applyOpusCodecPreference(transceiver: RTCRtpTransceiver): boolean {\r\n  const caps = RTCRtpReceiver.getCapabilities('audio');\r\n  if (!caps?.codecs?.length) return false;\r\n\r\n  try {\r\n    transceiver.setCodecPreferences(sortAudioCodecsOpusFirst(caps.codecs));\r\n    return true;\r\n  } catch {\r\n    return false;\r\n  }\r\n}\r\n\r\nexport function applyOpusCodecPreferences(pc: RTCPeerConnection): void {\r\n  for (const transceiver of pc.getTransceivers()) {\r\n    const kind =\r\n      transceiver.sender.track?.kind ?? transceiver.receiver.track?.kind;\r\n    if (kind === 'audio') {\r\n      applyOpusCodecPreference(transceiver);\r\n    }\r\n  }\r\n}\r\n"]}

package/dist/es/media/encoding-utils.d.ts

@@ -0,0 +1,2 @@
+export declare function isExpectedSetParametersError(err: unknown): boolean;
+//# sourceMappingURL=encoding-utils.d.ts.map

package/dist/es/media/encoding-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"encoding-utils.d.ts","sourceRoot":"","sources":["../../../src/media/encoding-utils.ts"],"names":[],"mappings":"AAAA,wBAAgB,4BAA4B,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAKlE"}

package/dist/es/media/encoding-utils.js

@@ -0,0 +1,8 @@
+function isExpectedSetParametersError(err) {
+  return err instanceof DOMException && (err.name === "InvalidModificationError" || err.name === "InvalidStateError");
+}
+export {
+  isExpectedSetParametersError
+};
+
+//# sourceMappingURL=encoding-utils.js.map

package/dist/es/media/encoding-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"mappings":"AAAO,SAAS,6BAA6B,KAAuB;AAClE,SACE,eAAe,iBACd,IAAI,SAAS,8BAA8B,IAAI,SAAS;AAE7D","names":[],"ignoreList":[],"sources":["../../../src/media/encoding-utils.ts"],"sourcesContent":["export function isExpectedSetParametersError(err: unknown): boolean {\r\n  return (\r\n    err instanceof DOMException &&\r\n    (err.name === 'InvalidModificationError' || err.name === 'InvalidStateError')\r\n  );\r\n}\r\n"]}

package/dist/es/media/media-manager.d.ts

@@ -0,0 +1,39 @@
+import type { IDisposable } from '../disposable';
+import type { DisplayMediaOptions, UserMediaOptions } from './types';
+export type { DisplayMediaOptions, UserMediaOptions } from './types';
+interface DeviceInfo {
+    deviceId: string;
+    groupId: string;
+    kind: MediaDeviceKind;
+    label: string;
+}
+/**
+ * 媒体管理器 — 设备枚举、媒体流获取、track 操作
+ */
+export declare class MediaManager implements IDisposable {
+    private logger;
+    private localStream;
+    private remoteStreams;
+    private tracks;
+    constructor();
+    enumerateDevices(kind?: MediaDeviceKind): Promise<DeviceInfo[]>;
+    getUserMedia(constraints: UserMediaOptions): Promise<MediaStream>;
+    getDisplayMedia(options?: DisplayMediaOptions): Promise<MediaStream>;
+    /** 枚举设备 */
+    static enumerateDevices(kind?: MediaDeviceKind): Promise<DeviceInfo[]>;
+    /** 获取用户媒体（摄像头/麦克风） */
+    static getUserMedia(constraints: UserMediaOptions): Promise<MediaStream>;
+    /** 获取屏幕流（支持 Electron desktopCapturer sourceId） */
+    static getDisplayMedia(options?: DisplayMediaOptions): Promise<MediaStream>;
+    setLocalStream(stream: MediaStream): void;
+    getLocalStream(): MediaStream | null;
+    addTrack(track: MediaStreamTrack, stream: MediaStream): void;
+    removeTrack(track: MediaStreamTrack): void;
+    replaceTrack(oldTrack: MediaStreamTrack, newTrack: MediaStreamTrack): void;
+    getLocalTracks(kind?: 'audio' | 'video'): MediaStreamTrack[];
+    addRemoteStream(stream: MediaStream): void;
+    getRemoteStreams(): ReadonlyMap<string, MediaStream>;
+    dispose(): void;
+}
+export type { DeviceInfo };
+//# sourceMappingURL=media-manager.d.ts.map

package/dist/es/media/media-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-manager.d.ts","sourceRoot":"","sources":["../../../src/media/media-manager.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAErE,YAAY,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAErE,UAAU,UAAU;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,eAAe,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,qBAAa,YAAa,YAAW,WAAW;IAC9C,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,WAAW,CAA4B;IAC/C,OAAO,CAAC,aAAa,CAAkC;IACvD,OAAO,CAAC,MAAM,CAAuC;;IAQrD,gBAAgB,CAAC,IAAI,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAI/D,YAAY,CAAC,WAAW,EAAE,gBAAgB,GAAG,OAAO,CAAC,WAAW,CAAC;IAIjE,eAAe,CAAC,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,WAAW,CAAC;IAMpE,WAAW;WACE,gBAAgB,CAAC,IAAI,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAc5E,sBAAsB;WACT,YAAY,CACvB,WAAW,EAAE,gBAAgB,GAC5B,OAAO,CAAC,WAAW,CAAC;IAIvB,kDAAkD;WACrC,eAAe,CAC1B,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,WAAW,CAAC;IA8BvB,cAAc,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IAOzC,cAAc,IAAI,WAAW,GAAG,IAAI;IAIpC,QAAQ,CAAC,KAAK,EAAE,gBAAgB,EAAE,MAAM,EAAE,WAAW,GAAG,IAAI;IAM5D,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI;IAM1C,YAAY,CACV,QAAQ,EAAE,gBAAgB,EAC1B,QAAQ,EAAE,gBAAgB,GACzB,IAAI;IAQP,cAAc,CAAC,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,gBAAgB,EAAE;IAQ5D,eAAe,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IAI1C,gBAAgB,IAAI,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC;IAIpD,OAAO,IAAI,IAAI;CAShB;AAED,YAAY,EAAE,UAAU,EAAE,CAAC"}

package/dist/es/media/media-manager.js

@@ -0,0 +1,121 @@
+import { createLogger } from "../utils/types";
+class MediaManager {
+  constructor() {
+    this.localStream = null;
+    this.remoteStreams = /* @__PURE__ */ new Map();
+    this.tracks = /* @__PURE__ */ new Map();
+    this.logger = createLogger();
+  }
+  // ── 实例方法（委托 static，与文档 rtc.media.* 一致） ──
+  enumerateDevices(kind) {
+    return MediaManager.enumerateDevices(kind);
+  }
+  getUserMedia(constraints) {
+    return MediaManager.getUserMedia(constraints);
+  }
+  getDisplayMedia(options) {
+    return MediaManager.getDisplayMedia(options);
+  }
+  // ── 静态工具 ──
+  /** 枚举设备 */
+  static async enumerateDevices(kind) {
+    const devices = await navigator.mediaDevices.enumerateDevices();
+    let filtered = devices;
+    if (kind) {
+      filtered = devices.filter((d) => d.kind === kind);
+    }
+    return filtered.map((d) => ({
+      deviceId: d.deviceId,
+      groupId: d.groupId,
+      kind: d.kind,
+      label: d.label || `Unknown ${d.kind}`
+    }));
+  }
+  /** 获取用户媒体（摄像头/麦克风） */
+  static async getUserMedia(constraints) {
+    return navigator.mediaDevices.getUserMedia(constraints);
+  }
+  /** 获取屏幕流（支持 Electron desktopCapturer sourceId） */
+  static async getDisplayMedia(options) {
+    const baseConstraints = {
+      video: true,
+      audio: options?.audio ?? false
+    };
+    if (options?.sourceId) {
+      baseConstraints.video = {
+        // @ts-expect-error Electron desktopCapturer constraints
+        mandatory: {
+          chromeMediaSource: "desktop",
+          chromeMediaSourceId: options.sourceId
+        }
+      };
+    } else if (options?.width || options?.height || options?.frameRate) {
+      const video = {};
+      if (options.width)
+        video.width = options.width;
+      if (options.height)
+        video.height = options.height;
+      if (options.frameRate)
+        video.frameRate = options.frameRate;
+      baseConstraints.video = video;
+    }
+    if (navigator.mediaDevices.getDisplayMedia) {
+      return navigator.mediaDevices.getDisplayMedia(baseConstraints);
+    }
+    return navigator.mediaDevices.getUserMedia(baseConstraints);
+  }
+  // ── 本地流管理 ──
+  setLocalStream(stream) {
+    this.localStream = stream;
+    for (const track of stream.getTracks()) {
+      this.tracks.set(track.id, track);
+    }
+  }
+  getLocalStream() {
+    return this.localStream;
+  }
+  addTrack(track, stream) {
+    stream.addTrack(track);
+    this.localStream = stream;
+    this.tracks.set(track.id, track);
+  }
+  removeTrack(track) {
+    track.stop();
+    this.tracks.delete(track.id);
+    this.localStream?.removeTrack(track);
+  }
+  replaceTrack(oldTrack, newTrack) {
+    oldTrack.stop();
+    this.tracks.delete(oldTrack.id);
+    this.tracks.set(newTrack.id, newTrack);
+    this.localStream?.removeTrack(oldTrack);
+    this.localStream?.addTrack(newTrack);
+  }
+  getLocalTracks(kind) {
+    const tracks = Array.from(this.tracks.values());
+    if (!kind)
+      return tracks;
+    return tracks.filter((t) => t.kind === kind);
+  }
+  // ── 远程流管理 ──
+  addRemoteStream(stream) {
+    this.remoteStreams.set(stream.id, stream);
+  }
+  getRemoteStreams() {
+    return this.remoteStreams;
+  }
+  dispose() {
+    for (const track of this.tracks.values()) {
+      track.stop();
+    }
+    this.tracks.clear();
+    this.localStream = null;
+    this.remoteStreams.clear();
+    this.logger.info("MediaManager disposed");
+  }
+}
+export {
+  MediaManager
+};
+
+//# sourceMappingURL=media-manager.js.map

package/dist/es/media/media-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"mappings":"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","names":[],"ignoreList":[],"sources":["../../../src/media/media-manager.ts"],"sourcesContent":["import { createLogger, type Logger } from '../utils/types';\r\nimport type { IDisposable } from '../disposable';\r\nimport type { DisplayMediaOptions, UserMediaOptions } from './types';\r\n\r\nexport type { DisplayMediaOptions, UserMediaOptions } from './types';\r\n\r\ninterface DeviceInfo {\r\n  deviceId: string;\r\n  groupId: string;\r\n  kind: MediaDeviceKind;\r\n  label: string;\r\n}\r\n\r\n/**\r\n * 媒体管理器 — 设备枚举、媒体流获取、track 操作\r\n */\r\nexport class MediaManager implements IDisposable {\r\n  private logger: Logger;\r\n  private localStream: MediaStream | null = null;\r\n  private remoteStreams = new Map<string, MediaStream>();\r\n  private tracks = new Map<string, MediaStreamTrack>();\r\n\r\n  constructor() {\r\n    this.logger = createLogger();\r\n  }\r\n\r\n  // ── 实例方法（委托 static，与文档 rtc.media.* 一致） ──\r\n\r\n  enumerateDevices(kind?: MediaDeviceKind): Promise<DeviceInfo[]> {\r\n    return MediaManager.enumerateDevices(kind);\r\n  }\r\n\r\n  getUserMedia(constraints: UserMediaOptions): Promise<MediaStream> {\r\n    return MediaManager.getUserMedia(constraints);\r\n  }\r\n\r\n  getDisplayMedia(options?: DisplayMediaOptions): Promise<MediaStream> {\r\n    return MediaManager.getDisplayMedia(options);\r\n  }\r\n\r\n  // ── 静态工具 ──\r\n\r\n  /** 枚举设备 */\r\n  static async enumerateDevices(kind?: MediaDeviceKind): Promise<DeviceInfo[]> {\r\n    const devices = await navigator.mediaDevices.enumerateDevices();\r\n    let filtered = devices;\r\n    if (kind) {\r\n      filtered = devices.filter(d => d.kind === kind);\r\n    }\r\n    return filtered.map(d => ({\r\n      deviceId: d.deviceId,\r\n      groupId: d.groupId,\r\n      kind: d.kind,\r\n      label: d.label || `Unknown ${d.kind}`,\r\n    }));\r\n  }\r\n\r\n  /** 获取用户媒体（摄像头/麦克风） */\r\n  static async getUserMedia(\r\n    constraints: UserMediaOptions,\r\n  ): Promise<MediaStream> {\r\n    return navigator.mediaDevices.getUserMedia(constraints);\r\n  }\r\n\r\n  /** 获取屏幕流（支持 Electron desktopCapturer sourceId） */\r\n  static async getDisplayMedia(\r\n    options?: DisplayMediaOptions,\r\n  ): Promise<MediaStream> {\r\n    const baseConstraints: DisplayMediaStreamOptions = {\r\n      video: true,\r\n      audio: options?.audio ?? false,\r\n    };\r\n\r\n    if (options?.sourceId) {\r\n      baseConstraints.video = {\r\n        // @ts-expect-error Electron desktopCapturer constraints\r\n        mandatory: {\r\n          chromeMediaSource: 'desktop',\r\n          chromeMediaSourceId: options.sourceId,\r\n        },\r\n      };\r\n    } else if (options?.width || options?.height || options?.frameRate) {\r\n      const video: MediaTrackConstraints = {};\r\n      if (options.width) video.width = options.width;\r\n      if (options.height) video.height = options.height;\r\n      if (options.frameRate) video.frameRate = options.frameRate;\r\n      baseConstraints.video = video;\r\n    }\r\n\r\n    if (navigator.mediaDevices.getDisplayMedia) {\r\n      return navigator.mediaDevices.getDisplayMedia(baseConstraints);\r\n    }\r\n    return navigator.mediaDevices.getUserMedia(baseConstraints as MediaStreamConstraints);\r\n  }\r\n\r\n  // ── 本地流管理 ──\r\n\r\n  setLocalStream(stream: MediaStream): void {\r\n    this.localStream = stream;\r\n    for (const track of stream.getTracks()) {\r\n      this.tracks.set(track.id, track);\r\n    }\r\n  }\r\n\r\n  getLocalStream(): MediaStream | null {\r\n    return this.localStream;\r\n  }\r\n\r\n  addTrack(track: MediaStreamTrack, stream: MediaStream): void {\r\n    stream.addTrack(track);\r\n    this.localStream = stream;\r\n    this.tracks.set(track.id, track);\r\n  }\r\n\r\n  removeTrack(track: MediaStreamTrack): void {\r\n    track.stop();\r\n    this.tracks.delete(track.id);\r\n    this.localStream?.removeTrack(track);\r\n  }\r\n\r\n  replaceTrack(\r\n    oldTrack: MediaStreamTrack,\r\n    newTrack: MediaStreamTrack,\r\n  ): void {\r\n    oldTrack.stop();\r\n    this.tracks.delete(oldTrack.id);\r\n    this.tracks.set(newTrack.id, newTrack);\r\n    this.localStream?.removeTrack(oldTrack);\r\n    this.localStream?.addTrack(newTrack);\r\n  }\r\n\r\n  getLocalTracks(kind?: 'audio' | 'video'): MediaStreamTrack[] {\r\n    const tracks = Array.from(this.tracks.values());\r\n    if (!kind) return tracks;\r\n    return tracks.filter(t => t.kind === kind);\r\n  }\r\n\r\n  // ── 远程流管理 ──\r\n\r\n  addRemoteStream(stream: MediaStream): void {\r\n    this.remoteStreams.set(stream.id, stream);\r\n  }\r\n\r\n  getRemoteStreams(): ReadonlyMap<string, MediaStream> {\r\n    return this.remoteStreams;\r\n  }\r\n\r\n  dispose(): void {\r\n    for (const track of this.tracks.values()) {\r\n      track.stop();\r\n    }\r\n    this.tracks.clear();\r\n    this.localStream = null;\r\n    this.remoteStreams.clear();\r\n    this.logger.info('MediaManager disposed');\r\n  }\r\n}\r\n\r\nexport type { DeviceInfo };\r\n//# sourceMappingURL=data:application/json;charset=utf-8;base64,eyJ2ZXJzaW9uIjozLCJtYXBwaW5ncyI6IiIsIm5hbWVzIjpbXSwiaWdub3JlTGlzdCI6W10sInNvdXJjZXMiOltdLCJzb3VyY2VzQ29udGVudCI6W119"]}

package/dist/es/media/types.d.ts

@@ -0,0 +1,25 @@
+export interface DeviceInfo {
+    deviceId: string;
+    groupId: string;
+    kind: MediaDeviceKind;
+    label: string;
+}
+export interface DisplayMediaOptions {
+    /** Electron desktopCapturer sourceId */
+    sourceId?: string;
+    /** 是否捕获系统音频 */
+    audio?: boolean;
+    /** 分辨率约束 */
+    width?: number;
+    height?: number;
+    frameRate?: number;
+}
+export interface UserMediaOptions {
+    audio?: boolean | MediaTrackConstraints;
+    video?: boolean | MediaTrackConstraints;
+}
+export interface MediaConstraints {
+    audio?: boolean | MediaTrackConstraints;
+    video?: boolean | MediaTrackConstraints;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/es/media/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/media/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,eAAe,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,mBAAmB;IAClC,wCAAwC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,YAAY;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE,OAAO,GAAG,qBAAqB,CAAC;IACxC,KAAK,CAAC,EAAE,OAAO,GAAG,qBAAqB,CAAC;CACzC;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE,OAAO,GAAG,qBAAqB,CAAC;IACxC,KAAK,CAAC,EAAE,OAAO,GAAG,qBAAqB,CAAC;CACzC"}

package/dist/es/media/video-encoding.d.ts

@@ -0,0 +1,12 @@
+export interface VideoEncodingOptions {
+    maxFrameRate?: number;
+    maxBitrate?: number;
+    degradationPreference?: RTCDegradationPreference;
+    contentHint?: 'motion' | 'detail' | 'text';
+}
+export declare function applyVideoTrackContentHint(track: MediaStreamTrack, contentHint?: VideoEncodingOptions['contentHint']): void;
+/** @returns 是否成功调用 setParameters（协商完成前失败属正常，可在 connected 后重试） */
+export declare function applyVideoSenderEncoding(sender: RTCRtpSender, options: VideoEncodingOptions): Promise<boolean>;
+export declare function applyReceiverPlayoutDelay(pc: RTCPeerConnection, delaySeconds?: number): void;
+export declare function applyVideoEncodingToConnection(pc: RTCPeerConnection, options: VideoEncodingOptions): Promise<boolean>;
+//# sourceMappingURL=video-encoding.d.ts.map

package/dist/es/media/video-encoding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"video-encoding.d.ts","sourceRoot":"","sources":["../../../src/media/video-encoding.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,oBAAoB;IACnC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qBAAqB,CAAC,EAAE,wBAAwB,CAAC;IACjD,WAAW,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;CAC5C;AAED,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,gBAAgB,EACvB,WAAW,GAAE,oBAAoB,CAAC,aAAa,CAAY,GAC1D,IAAI,CAIN;AAED,iEAAiE;AACjE,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,OAAO,CAAC,CAiClB;AAED,wBAAgB,yBAAyB,CACvC,EAAE,EAAE,iBAAiB,EACrB,YAAY,SAAI,GACf,IAAI,CAON;AAED,wBAAsB,8BAA8B,CAClD,EAAE,EAAE,iBAAiB,EACrB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,OAAO,CAAC,CAQlB"}

package/dist/es/media/video-encoding.js

@@ -0,0 +1,60 @@
+import { isExpectedSetParametersError } from "./encoding-utils";
+function applyVideoTrackContentHint(track, contentHint = "motion") {
+  if (track.kind !== "video")
+    return;
+  if (!("contentHint" in track) || contentHint == null)
+    return;
+  track.contentHint = contentHint;
+}
+async function applyVideoSenderEncoding(sender, options) {
+  const track = sender.track;
+  if (!track || track.kind !== "video")
+    return false;
+  if (options.contentHint) {
+    applyVideoTrackContentHint(track, options.contentHint);
+  }
+  const params = sender.getParameters();
+  if (!params.encodings?.length) {
+    params.encodings = [{}];
+  }
+  const encoding = params.encodings[0];
+  if (options.maxFrameRate != null) {
+    encoding.maxFramerate = options.maxFrameRate;
+  }
+  if (options.maxBitrate != null) {
+    encoding.maxBitrate = options.maxBitrate;
+  }
+  if (options.degradationPreference) {
+    params.degradationPreference = options.degradationPreference;
+  }
+  try {
+    await sender.setParameters(params);
+    return true;
+  } catch (err) {
+    if (isExpectedSetParametersError(err)) {
+      return false;
+    }
+    throw err;
+  }
+}
+function applyReceiverPlayoutDelay(pc, delaySeconds = 0) {
+  for (const receiver of pc.getReceivers()) {
+    if (!("playoutDelayHint" in receiver))
+      continue;
+    receiver.playoutDelayHint = delaySeconds;
+  }
+}
+async function applyVideoEncodingToConnection(pc, options) {
+  const results = await Promise.all(
+    pc.getSenders().filter((sender) => sender.track?.kind === "video").map((sender) => applyVideoSenderEncoding(sender, options))
+  );
+  return results.some(Boolean);
+}
+export {
+  applyReceiverPlayoutDelay,
+  applyVideoEncodingToConnection,
+  applyVideoSenderEncoding,
+  applyVideoTrackContentHint
+};
+
+//# sourceMappingURL=video-encoding.js.map

package/dist/es/media/video-encoding.js.map

@@ -0,0 +1 @@
+{"version":3,"mappings":"AAAA,SAAS,oCAAoC;AAStC,SAAS,2BACd,OACA,cAAmD,UAC7C;AACN,MAAI,MAAM,SAAS;AAAS;AAC5B,MAAI,EAAE,iBAAiB,UAAU,eAAe;AAAM;AACtD,QAAM,cAAc;AACtB;AAGA,eAAsB,yBACpB,QACA,SACkB;AAClB,QAAM,QAAQ,OAAO;AACrB,MAAI,CAAC,SAAS,MAAM,SAAS;AAAS,WAAO;AAE7C,MAAI,QAAQ,aAAa;AACvB,+BAA2B,OAAO,QAAQ,WAAW;AAAA,EACvD;AAEA,QAAM,SAAS,OAAO,cAAc;AACpC,MAAI,CAAC,OAAO,WAAW,QAAQ;AAC7B,WAAO,YAAY,CAAC,CAAC,CAAC;AAAA,EACxB;AAEA,QAAM,WAAW,OAAO,UAAU,CAAC;AACnC,MAAI,QAAQ,gBAAgB,MAAM;AAChC,aAAS,eAAe,QAAQ;AAAA,EAClC;AACA,MAAI,QAAQ,cAAc,MAAM;AAC9B,aAAS,aAAa,QAAQ;AAAA,EAChC;AACA,MAAI,QAAQ,uBAAuB;AACjC,WAAO,wBAAwB,QAAQ;AAAA,EACzC;AAEA,MAAI;AACF,UAAM,OAAO,cAAc,MAAM;AACjC,WAAO;AAAA,EACT,SAAS,KAAK;AACZ,QAAI,6BAA6B,GAAG,GAAG;AACrC,aAAO;AAAA,IACT;AACA,UAAM;AAAA,EACR;AACF;AAEO,SAAS,0BACd,IACA,eAAe,GACT;AACN,aAAW,YAAY,GAAG,aAAa,GAAG;AACxC,QAAI,EAAE,sBAAsB;AAAW;AAEvC,IAAC,SAA2D,mBAC1D;AAAA,EACJ;AACF;AAEA,eAAsB,+BACpB,IACA,SACkB;AAClB,QAAM,UAAU,MAAM,QAAQ;AAAA,IAC5B,GACG,WAAW,EACX,OAAO,CAAC,WAAW,OAAO,OAAO,SAAS,OAAO,EACjD,IAAI,CAAC,WAAW,yBAAyB,QAAQ,OAAO,CAAC;AAAA,EAC9D;AACA,SAAO,QAAQ,KAAK,OAAO;AAC7B","names":[],"ignoreList":[],"sources":["../../../src/media/video-encoding.ts"],"sourcesContent":["import { isExpectedSetParametersError } from './encoding-utils';\r\n\r\nexport interface VideoEncodingOptions {\r\n  maxFrameRate?: number;\r\n  maxBitrate?: number;\r\n  degradationPreference?: RTCDegradationPreference;\r\n  contentHint?: 'motion' | 'detail' | 'text';\r\n}\r\n\r\nexport function applyVideoTrackContentHint(\r\n  track: MediaStreamTrack,\r\n  contentHint: VideoEncodingOptions['contentHint'] = 'motion',\r\n): void {\r\n  if (track.kind !== 'video') return;\r\n  if (!('contentHint' in track) || contentHint == null) return;\r\n  track.contentHint = contentHint;\r\n}\r\n\r\n/** @returns 是否成功调用 setParameters（协商完成前失败属正常，可在 connected 后重试） */\r\nexport async function applyVideoSenderEncoding(\r\n  sender: RTCRtpSender,\r\n  options: VideoEncodingOptions,\r\n): Promise<boolean> {\r\n  const track = sender.track;\r\n  if (!track || track.kind !== 'video') return false;\r\n\r\n  if (options.contentHint) {\r\n    applyVideoTrackContentHint(track, options.contentHint);\r\n  }\r\n\r\n  const params = sender.getParameters();\r\n  if (!params.encodings?.length) {\r\n    params.encodings = [{}];\r\n  }\r\n\r\n  const encoding = params.encodings[0];\r\n  if (options.maxFrameRate != null) {\r\n    encoding.maxFramerate = options.maxFrameRate;\r\n  }\r\n  if (options.maxBitrate != null) {\r\n    encoding.maxBitrate = options.maxBitrate;\r\n  }\r\n  if (options.degradationPreference) {\r\n    params.degradationPreference = options.degradationPreference;\r\n  }\r\n\r\n  try {\r\n    await sender.setParameters(params);\r\n    return true;\r\n  } catch (err) {\r\n    if (isExpectedSetParametersError(err)) {\r\n      return false;\r\n    }\r\n    throw err;\r\n  }\r\n}\r\n\r\nexport function applyReceiverPlayoutDelay(\r\n  pc: RTCPeerConnection,\r\n  delaySeconds = 0,\r\n): void {\r\n  for (const receiver of pc.getReceivers()) {\r\n    if (!('playoutDelayHint' in receiver)) continue;\r\n\r\n    (receiver as RTCRtpReceiver & { playoutDelayHint: number }).playoutDelayHint =\r\n      delaySeconds;\r\n  }\r\n}\r\n\r\nexport async function applyVideoEncodingToConnection(\r\n  pc: RTCPeerConnection,\r\n  options: VideoEncodingOptions,\r\n): Promise<boolean> {\r\n  const results = await Promise.all(\r\n    pc\r\n      .getSenders()\r\n      .filter((sender) => sender.track?.kind === 'video')\r\n      .map((sender) => applyVideoSenderEncoding(sender, options)),\r\n  );\r\n  return results.some(Boolean);\r\n}\r\n//# sourceMappingURL=data:application/json;charset=utf-8;base64,eyJ2ZXJzaW9uIjozLCJtYXBwaW5ncyI6IiIsIm5hbWVzIjpbXSwiaWdub3JlTGlzdCI6W10sInNvdXJjZXMiOltdLCJzb3VyY2VzQ29udGVudCI6W119"]}

package/dist/es/signal/signal-manager.d.ts

@@ -0,0 +1,45 @@
+import type { SignalChannel } from './types';
+import { ConnectionStateMachine } from '../fsm';
+import type { IDisposable } from '../disposable';
+export interface SignalConfig {
+    /** SDP 交换超时 (ms)，默认 30000 */
+    negotiationTimeout?: number;
+    /** ICE 候选收集超时 (ms)，默认 10000 */
+    iceGatheringTimeout?: number;
+}
+/**
+ * 信令管理器 — 负责 SDP / ICE 信令的序列化与协商流程
+ */
+export declare class SignalManager implements IDisposable {
+    private channel;
+    private pc;
+    private fsm;
+    private polite;
+    private config;
+    private logger;
+    private makingOffer;
+    private ignoreOffer;
+    private pendingCandidates;
+    private cleanups;
+    constructor(channel: SignalChannel, pc: RTCPeerConnection, fsm: ConnectionStateMachine, polite: boolean, config?: SignalConfig);
+    /** 切换 PeerConnection（disconnect / reconnect 后 rebind） */
+    setPeerConnection(pc: RTCPeerConnection): void;
+    /** 发起协商（创建 offer） */
+    createOffer(): Promise<void>;
+    /** 接收远端 offer 并创建 answer */
+    handleOffer(sdp: string): Promise<void>;
+    /** 接收远端 answer */
+    handleAnswer(sdp: string): Promise<void>;
+    /** ICE 候选管理 */
+    addIceCandidate(candidate: RTCIceCandidateInit): Promise<void>;
+    dispose(): void;
+    private renegotiateAsOfferer;
+    private renegotiateAsAnswerer;
+    private enterSignaling;
+    private failConnection;
+    private setupListeners;
+    private teardownListeners;
+    private flushPendingCandidates;
+    private withTimeout;
+}
+//# sourceMappingURL=signal-manager.d.ts.map

package/dist/es/signal/signal-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signal-manager.d.ts","sourceRoot":"","sources":["../../../src/signal/signal-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7C,OAAO,EAAE,sBAAsB,EAAE,MAAM,QAAQ,CAAC;AAEhD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD,MAAM,WAAW,YAAY;IAC3B,6BAA6B;IAC7B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,+BAA+B;IAC/B,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAOD;;GAEG;AACH,qBAAa,aAAc,YAAW,WAAW;IAS7C,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,EAAE;IACV,OAAO,CAAC,GAAG;IACX,OAAO,CAAC,MAAM;IAXhB,OAAO,CAAC,MAAM,CAAyB;IACvC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,iBAAiB,CAA6B;IACtD,OAAO,CAAC,QAAQ,CAAsB;gBAG5B,OAAO,EAAE,aAAa,EACtB,EAAE,EAAE,iBAAiB,EACrB,GAAG,EAAE,sBAAsB,EAC3B,MAAM,EAAE,OAAO,EACvB,MAAM,CAAC,EAAE,YAAY;IAOvB,yDAAyD;IACzD,iBAAiB,CAAC,EAAE,EAAE,iBAAiB,GAAG,IAAI;IAS9C,qBAAqB;IACf,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IA8BlC,4BAA4B;IACtB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA6C7C,kBAAkB;IACZ,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAa9C,eAAe;IACT,eAAe,CAAC,SAAS,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAYpE,OAAO,IAAI,IAAI;YAOD,oBAAoB;YAepB,qBAAqB;IAYnC,OAAO,CAAC,cAAc;IAMtB,OAAO,CAAC,cAAc;IAMtB,OAAO,CAAC,cAAc;IAuEtB,OAAO,CAAC,iBAAiB;YAKX,sBAAsB;IASpC,OAAO,CAAC,WAAW;CAQpB"}