@wetspace/wetrtc 3.0.1 → 4.0.0

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

@@ -0,0 +1,66 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var audio_encoding_exports = {};
+__export(audio_encoding_exports, {
+  applyAudioEncodingToConnection: () => applyAudioEncodingToConnection,
+  applyAudioSenderEncoding: () => applyAudioSenderEncoding
+});
+module.exports = __toCommonJS(audio_encoding_exports);
+var import_encoding_utils = require("./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 ((0, import_encoding_utils.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);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  applyAudioEncodingToConnection,
+  applyAudioSenderEncoding
+});
+
+//# sourceMappingURL=audio-encoding.js.map

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

@@ -0,0 +1 @@
+{"version":3,"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,4BAA6C;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,YAAI,oDAA6B,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/lib/media/codec-preference.js

@@ -0,0 +1,106 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var codec_preference_exports = {};
+__export(codec_preference_exports, {
+  applyH264CodecPreference: () => applyH264CodecPreference,
+  applyH264CodecPreferences: () => applyH264CodecPreferences,
+  applyOpusCodecPreference: () => applyOpusCodecPreference,
+  applyOpusCodecPreferences: () => applyOpusCodecPreferences,
+  sortAudioCodecsOpusFirst: () => sortAudioCodecsOpusFirst,
+  sortVideoCodecsH264First: () => sortVideoCodecsH264First
+});
+module.exports = __toCommonJS(codec_preference_exports);
+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);
+    }
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  applyH264CodecPreference,
+  applyH264CodecPreferences,
+  applyOpusCodecPreference,
+  applyOpusCodecPreferences,
+  sortAudioCodecsOpusFirst,
+  sortVideoCodecsH264First
+});
+
+//# sourceMappingURL=codec-preference.js.map

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

@@ -0,0 +1 @@
+{"version":3,"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;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/lib/media/encoding-utils.js

@@ -0,0 +1,32 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var encoding_utils_exports = {};
+__export(encoding_utils_exports, {
+  isExpectedSetParametersError: () => isExpectedSetParametersError
+});
+module.exports = __toCommonJS(encoding_utils_exports);
+function isExpectedSetParametersError(err) {
+  return err instanceof DOMException && (err.name === "InvalidModificationError" || err.name === "InvalidStateError");
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  isExpectedSetParametersError
+});
+
+//# sourceMappingURL=encoding-utils.js.map

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

@@ -0,0 +1 @@
+{"version":3,"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;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/lib/media/media-manager.js

@@ -0,0 +1,145 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var media_manager_exports = {};
+__export(media_manager_exports, {
+  MediaManager: () => MediaManager
+});
+module.exports = __toCommonJS(media_manager_exports);
+var import_types = require("../utils/types");
+class MediaManager {
+  constructor() {
+    this.localStream = null;
+    this.remoteStreams = /* @__PURE__ */ new Map();
+    this.tracks = /* @__PURE__ */ new Map();
+    this.logger = (0, import_types.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");
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  MediaManager
+});
+
+//# sourceMappingURL=media-manager.js.map

package/dist/lib/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/lib/media/types.js

@@ -0,0 +1,18 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var types_exports = {};
+module.exports = __toCommonJS(types_exports);
+
+//# sourceMappingURL=types.js.map

package/dist/lib/media/types.js.map

@@ -0,0 +1 @@
+{"version":3,"mappings":";;;;;;;;;;;;;;AAAA;AAAA","names":[],"ignoreList":[],"sources":["../../../src/media/types.ts"],"sourcesContent":["export interface DeviceInfo {\r\n  deviceId: string;\r\n  groupId: string;\r\n  kind: MediaDeviceKind;\r\n  label: string;\r\n}\r\n\r\nexport interface DisplayMediaOptions {\r\n  /** Electron desktopCapturer sourceId */\r\n  sourceId?: string;\r\n  /** 是否捕获系统音频 */\r\n  audio?: boolean;\r\n  /** 分辨率约束 */\r\n  width?: number;\r\n  height?: number;\r\n  frameRate?: number;\r\n}\r\n\r\nexport interface UserMediaOptions {\r\n  audio?: boolean | MediaTrackConstraints;\r\n  video?: boolean | MediaTrackConstraints;\r\n}\r\n\r\nexport interface MediaConstraints {\r\n  audio?: boolean | MediaTrackConstraints;\r\n  video?: boolean | MediaTrackConstraints;\r\n}"]}

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

@@ -0,0 +1,87 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var video_encoding_exports = {};
+__export(video_encoding_exports, {
+  applyReceiverPlayoutDelay: () => applyReceiverPlayoutDelay,
+  applyVideoEncodingToConnection: () => applyVideoEncodingToConnection,
+  applyVideoSenderEncoding: () => applyVideoSenderEncoding,
+  applyVideoTrackContentHint: () => applyVideoTrackContentHint
+});
+module.exports = __toCommonJS(video_encoding_exports);
+var import_encoding_utils = require("./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 ((0, import_encoding_utils.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);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  applyReceiverPlayoutDelay,
+  applyVideoEncodingToConnection,
+  applyVideoSenderEncoding,
+  applyVideoTrackContentHint
+});
+
+//# sourceMappingURL=video-encoding.js.map

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

@@ -0,0 +1 @@
+{"version":3,"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,4BAA6C;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,YAAI,oDAA6B,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"]}