im-rtc-call-engine 1.0.0 → 2.1.0

package/dist/media/engineMediaApi.js

@@ -1,23 +1,13 @@
-/** 探麦克风。失败**也走一遍 error 事件**再抛——宿主的契约见 CallEngine.probeMicrophone。 */
+/**
+ * 探麦克风。失败**只** reject，不再同时发 error 事件（2.0.0 起一次失败只从一个出口报，
+ * server `docs/design/ACTION_RESULT_DESIGN.md` R3）。宿主的契约见 CallEngine.probeMicrophone。
+ */
 export async function probeMicrophone(d) {
-    try {
-        await d.media.probeMicrophone();
-    }
-    catch (err) {
-        // 宿主只监听事件表也该知道「这通电话是因为没权限才没打出去」。
-        d.bus.emitError(err);
-        throw err;
-    }
+    await d.media.probeMicrophone();
 }
-/** 探摄像头。与 probeMicrophone 同一个契约：失败先报 error 事件再抛。 */
+/** 探摄像头。与 probeMicrophone 同一个契约。 */
 export async function probeCamera(d) {
-    try {
-        await d.media.probeCamera();
-    }
-    catch (err) {
-        d.bus.emitError(err);
-        throw err;
-    }
+    await d.media.probeCamera();
 }
 /**
  * 发布麦克风。顺序是**先拿轨道再拿 cid**：浏览器不允许自定义 track.id，
@@ -25,7 +15,7 @@ export async function probeCamera(d) {
  */
 export async function publishMicrophone(d) {
     const info = await d.media.acquireMicrophone();
-    await d.loop.dispatch({
+    await d.loop.request({
         kind: 'act',
         op: 'publish',
         args: { cid: info.cid, kind: info.kind, source: info.source, simulcast: false },
@@ -35,7 +25,7 @@ export async function publishMicrophone(d) {
 /** 发布摄像头。`simulcast` **同时喂给媒体面与信令**——只喂一边就是「报了三层、实际发一层」。 */
 export async function publishCamera(d, simulcast) {
     const info = await d.media.acquireCamera(simulcast);
-    await d.loop.dispatch({
+    await d.loop.request({
         kind: 'act',
         op: 'publish',
         args: { cid: info.cid, kind: info.kind, source: info.source, simulcast },
@@ -52,20 +42,66 @@ export async function publishCamera(d, simulcast) {
 export async function setMuted(d, cid, muted) {
     await d.media.setMuted(cid, muted);
     const trackId = d.loop.state.room.publishTrackIds[cid];
-    if (trackId === undefined)
+    if (trackId !== undefined) {
+        await d.loop.request({ kind: 'act', op: 'mute', args: { track_id: trackId, muted } });
+    }
+    d.bridge.refreshLocalViews();
+}
+/**
+ * 「发布过没有」**只问媒体适配器自己的账**，不在门面另记一份：宿主先直接调 `publish*()`
+ * 发布过、再调 `open*()` 的话，门面那份账不知道，会误判成「没发布」再发一次（2026-09-15 iOS 踩过）。
+ */
+function publishedCid(d, source) {
+    return source === 'microphone' ? d.media.publishedMicrophoneCid() : d.media.publishedCameraCid();
+}
+/** 按类型开：没发布过就发布（摄像头有预览时复用），发布过就取消静音——**不会重复发布**。 */
+export async function openLocal(d, source) {
+    const cid = publishedCid(d, source);
+    if (cid !== null) {
+        await setMuted(d, cid, false);
         return;
-    await d.loop.dispatch({ kind: 'act', op: 'mute', args: { track_id: trackId, muted } });
+    }
+    if (source === 'microphone')
+        await publishMicrophone(d);
+    else
+        await publishCamera(d, true);
 }
-/** 报某人画面的层上界。一个 uid 可能有多条视频轨道，逐条报。 */
+/**
+ * 按类型关：已发布的那条 `setMuted(cid, true)`，**不 unpublish**；没发布过是空操作。
+ *
+ * 清理类，**永不 reject**：本端在发帧之前就已经静音，`room.mute` 被拒也不回滚本端（隐私优先），
+ * 错误走 error 事件。
+ */
+export async function closeLocal(d, source) {
+    const cid = publishedCid(d, source);
+    if (cid === null)
+        return;
+    try {
+        await setMuted(d, cid, true);
+    }
+    catch (err) {
+        d.bus.emitError(err);
+    }
+}
+/**
+ * 报某人画面的层上界。一个 uid 可能有多条视频轨道，逐条报。
+ *
+ * 提示类，**永不 reject**（界面每次换布局都调，失败宿主也无事可做）：失败走 error 事件。
+ */
 export async function setRemoteLayer(d, uid, layer) {
     for (const [trackId, info] of Object.entries(d.loop.state.room.remoteTracks)) {
         if (info.uid !== uid || info.kind !== 'video')
             continue;
-        await d.loop.dispatch({
-            kind: 'act',
-            op: 'update_layer',
-            args: { track_id: trackId, max_layer: layer },
-        });
+        try {
+            await d.loop.request({
+                kind: 'act',
+                op: 'update_layer',
+                args: { track_id: trackId, max_layer: layer },
+            });
+        }
+        catch (err) {
+            d.bus.emitError(err);
+        }
     }
 }
 //# sourceMappingURL=engineMediaApi.js.map

package/dist/media/engineMediaApi.js.map

@@ -1 +1 @@
-{"version":3,"file":"engineMediaApi.js","sourceRoot":"","sources":["../../src/media/engineMediaApi.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"engineMediaApi.js","sourceRoot":"","sources":["../../src/media/engineMediaApi.ts"],"names":[],"mappings":"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"}

package/dist/media/mediaBridge.d.ts

@@ -1,4 +1,5 @@
 import type { MediaAdapter, MediaAdapterEvents } from './mediaAdapter.js';
+import type { SinkFactory } from './remoteAudio.js';
 import type { ViewElement } from './viewRegistry.js';
 /** RemoteTrackOwner 是「这条 track_id 是谁的」的最小查询接口。 */
 export interface RemoteTrackOwner {
@@ -18,12 +19,16 @@ export interface RemoteTrackOwner {
 export declare class MediaBridge {
     readonly adapter: MediaAdapter;
     private readonly views;
+    /** 远端音频由引擎自己播，与画面挂在哪无关（`remoteAudio.ts`）。 */
+    private readonly audio;
     /** 已经抛过「首帧」的轨道，避免重复抛。 */
     private readonly seenVideo;
     /** 开摄像头之后等新画面上屏的那些人（见 awaitFirstVideoFrame）。 */
     private readonly firstFrames;
     private events;
-    constructor(adapter: MediaAdapter);
+    constructor(adapter: MediaAdapter, createAudioSink?: SinkFactory);
+    /** unlockRemoteAudio 在进房那次用户手势里再试一遍播放（浏览器自动播放限制）。 */
+    unlockRemoteAudio(): void;
     /** open 建两条 PeerConnection。 */
     open(events: MediaAdapterEvents): void;
     /**

package/dist/media/mediaBridge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mediaBridge.d.ts","sourceRoot":"","sources":["../../src/media/mediaBridge.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC1E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGrD,kDAAkD;AAClD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;;GAUG;AACH,qBAAa,WAAW;IACtB,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;IAC/B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAsB;IAC5C,yBAAyB;IACzB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqB;IAC/C,gDAAgD;IAChD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAwB;IACpD,OAAO,CAAC,MAAM,CAAmC;gBAErC,OAAO,EAAE,YAAY;IAIjC,+BAA+B;IAC/B,IAAI,CAAC,MAAM,EAAE,kBAAkB,GAAG,IAAI;IAKtC;;;;;OAKG;IACH,KAAK,IAAI,IAAI;IAMb,0BAA0B;IAC1B,KAAK,IAAI,IAAI;IAMb;;;;;;;OAOG;IACH,cAAc,CACZ,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,gBAAgB,EACvB,GAAG,EAAE,MAAM,EACX,YAAY,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GACtC,IAAI;IAOP;;;;;;;;OAQG;IACH,OAAO,CAAC,YAAY;IAkBpB;;;;;;;;;;;;;;;;;;OAkBG;IACH,gBAAgB,CAAC,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC,GAAG,IAAI;IAahF;;;;;OAKG;IACH,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAI3E,+CAA+C;IAC/C,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,WAAW,GAAG,IAAI,GAAG,IAAI;IAKrD,iDAAiD;IACjD,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,WAAW,GAAG,IAAI,GAAG,IAAI;IAW1D;;;;;;OAMG;IACH,iBAAiB,IAAI,IAAI;IAWzB,OAAO,CAAC,KAAK;IAMb,OAAO,CAAC,YAAY;CAGrB"}
+{"version":3,"file":"mediaBridge.d.ts","sourceRoot":"","sources":["../../src/media/mediaBridge.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC1E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGrD,kDAAkD;AAClD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;;GAUG;AACH,qBAAa,WAAW;IACtB,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;IAC/B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAsB;IAC5C,6CAA6C;IAC7C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoB;IAC1C,yBAAyB;IACzB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqB;IAC/C,gDAAgD;IAChD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAwB;IACpD,OAAO,CAAC,MAAM,CAAmC;gBAErC,OAAO,EAAE,YAAY,EAAE,eAAe,CAAC,EAAE,WAAW;IAKhE,qDAAqD;IACrD,iBAAiB,IAAI,IAAI;IAIzB,+BAA+B;IAC/B,IAAI,CAAC,MAAM,EAAE,kBAAkB,GAAG,IAAI;IAKtC;;;;;OAKG;IACH,KAAK,IAAI,IAAI;IAMb,0BAA0B;IAC1B,KAAK,IAAI,IAAI;IAMb;;;;;;;OAOG;IACH,cAAc,CACZ,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,gBAAgB,EACvB,GAAG,EAAE,MAAM,EACX,YAAY,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GACtC,IAAI;IAaP;;;;;;;;OAQG;IACH,OAAO,CAAC,YAAY;IAkBpB;;;;;;;;;;;;;;;;;;OAkBG;IACH,gBAAgB,CAAC,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC,GAAG,IAAI;IAchF;;;;;OAKG;IACH,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAI3E,+CAA+C;IAC/C,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,WAAW,GAAG,IAAI,GAAG,IAAI;IAKrD,iDAAiD;IACjD,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,WAAW,GAAG,IAAI,GAAG,IAAI;IAW1D;;;;;;OAMG;IACH,iBAAiB,IAAI,IAAI;IAWzB,OAAO,CAAC,KAAK;IAOb,OAAO,CAAC,YAAY;CAGrB"}

package/dist/media/mediaBridge.js

@@ -1,4 +1,5 @@
 import { FirstFrameGate } from './firstFrameGate.js';
+import { RemoteAudioPlayer } from './remoteAudio.js';
 import { ViewRegistry } from './viewRegistry.js';
 /**
  * MediaBridge 把媒体适配器与 uid↔元素的挂载登记捆在一起。
@@ -14,13 +15,20 @@ import { ViewRegistry } from './viewRegistry.js';
 export class MediaBridge {
     adapter;
     views = new ViewRegistry();
+    /** 远端音频由引擎自己播，与画面挂在哪无关（`remoteAudio.ts`）。 */
+    audio;
     /** 已经抛过「首帧」的轨道，避免重复抛。 */
     seenVideo = new Set();
     /** 开摄像头之后等新画面上屏的那些人（见 awaitFirstVideoFrame）。 */
     firstFrames = new FirstFrameGate();
     events = null;
-    constructor(adapter) {
+    constructor(adapter, createAudioSink) {
         this.adapter = adapter;
+        this.audio = new RemoteAudioPlayer(createAudioSink);
+    }
+    /** unlockRemoteAudio 在进房那次用户手势里再试一遍播放（浏览器自动播放限制）。 */
+    unlockRemoteAudio() {
+        this.audio.unlock();
     }
     /** open 建两条 PeerConnection。 */
     open(events) {
@@ -55,6 +63,13 @@ export class MediaBridge {
      */
     addRemoteTrack(trackId, track, uid, onFirstVideo) {
         this.views.addTrack(trackId, track, uid);
+        /*
+          **音频一到就播，不等认领**：`ontrack` 与 `room.track_published` 谁先到都可能，
+          而声音不该等一个信令帧。认领不到 uid 的轨道照样出声——以后服务端换成音频槽位时
+          它根本不会有 uid（MEETING_ROOM_DESIGN §9 路 B）。
+        */
+        if (track.kind === 'audio')
+            this.audio.add(trackId, track);
         if (track.kind !== 'video' || this.seenVideo.has(trackId))
             return;
         this.seenVideo.add(trackId);
@@ -111,6 +126,7 @@ export class MediaBridge {
             if (Object.hasOwn(remoteTracks, trackId))
                 continue;
             this.views.removeTrack(trackId);
+            this.audio.remove(trackId);
             // 忘掉「首帧抛过了」：同一条 track_id 再回来时该重新抛一次 firstVideoFrame。
             this.seenVideo.delete(trackId);
         }
@@ -164,6 +180,7 @@ export class MediaBridge {
     }
     clear() {
         this.views.clear();
+        this.audio.clear();
         this.seenVideo.clear();
         this.firstFrames.clear();
     }

package/dist/media/mediaBridge.js.map

@@ -1 +1 @@
-{"version":3,"file":"mediaBridge.js","sourceRoot":"","sources":["../../src/media/mediaBridge.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"mediaBridge.js","sourceRoot":"","sources":["../../src/media/mediaBridge.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAGrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAErD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAOjD;;;;;;;;;;GAUG;AACH,MAAM,OAAO,WAAW;IACb,OAAO,CAAe;IACd,KAAK,GAAG,IAAI,YAAY,EAAE,CAAC;IAC5C,6CAA6C;IAC5B,KAAK,CAAoB;IAC1C,yBAAyB;IACR,SAAS,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/C,gDAAgD;IAC/B,WAAW,GAAG,IAAI,cAAc,EAAE,CAAC;IAC5C,MAAM,GAA8B,IAAI,CAAC;IAEjD,YAAY,OAAqB,EAAE,eAA6B;QAC9D,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,KAAK,GAAG,IAAI,iBAAiB,CAAC,eAAe,CAAC,CAAC;IACtD,CAAC;IAED,qDAAqD;IACrD,iBAAiB;QACf,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;IACtB,CAAC;IAED,+BAA+B;IAC/B,IAAI,CAAC,MAA0B;QAC7B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC5B,CAAC;IAED;;;;;OAKG;IACH,KAAK;QACH,IAAI,CAAC,KAAK,EAAE,CAAC;QACb,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACrB,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI;YAAE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC3D,CAAC;IAED,0BAA0B;IAC1B,KAAK;QACH,IAAI,CAAC,KAAK,EAAE,CAAC;QACb,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACrB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;IACrB,CAAC;IAED;;;;;;;OAOG;IACH,cAAc,CACZ,OAAe,EACf,KAAuB,EACvB,GAAW,EACX,YAAuC;QAEvC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;QACzC;;;;UAIE;QACF,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO;YAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAC3D,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC;YAAE,OAAO;QAClE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC5B,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC;IAClD,CAAC;IAED;;;;;;;;OAQG;IACK,YAAY,CAClB,OAAe,EACf,KAAuB,EACvB,YAAuC;QAEvC,IAAI,KAAK,CAAC,KAAK,KAAK,KAAK,EAAE,CAAC;YAC1B,YAAY,CAAC,OAAO,CAAC,CAAC;YACtB,OAAO;QACT,CAAC;QACD,mCAAmC;QACnC,YAAY;QACZ,IAAI,OAAO,KAAK,CAAC,gBAAgB,KAAK,UAAU,EAAE,CAAC;YACjD,YAAY,CAAC,OAAO,CAAC,CAAC;YACtB,OAAO;QACT,CAAC;QACD,KAAK,CAAC,gBAAgB,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAChF,CAAC;IAED;;;;;;;;;;;;;;;;;;OAkBG;IACH,gBAAgB,CAAC,YAAwD;QACvE,KAAK,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC;YAC3D,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;QACtC,CAAC;QACD,KAAK,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,aAAa,EAAE,EAAE,CAAC;YAC1D,IAAI,KAAK,CAAC,UAAU,CAAC,iBAAiB,CAAC;gBAAE,SAAS;YAClD,IAAI,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,OAAO,CAAC;gBAAE,SAAS;YACnD,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;YAChC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YAC3B,qDAAqD;YACrD,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,oBAAoB,CAAC,GAAW,EAAE,OAAkC;QAClE,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAC3F,CAAC;IAED,+CAA+C;IAC/C,UAAU,CAAC,GAAW,EAAE,EAAsB;QAC5C,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QAC3B,IAAI,EAAE,KAAK,IAAI;YAAE,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IACtD,CAAC;IAED,iDAAiD;IACjD,eAAe,CAAC,GAAW,EAAE,EAAsB;QACjD,MAAM,GAAG,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;QAC9B,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;YAChB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YAC7B,OAAO;QACT,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QAC3C,IAAI,KAAK,KAAK,SAAS;YAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;QACnE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IAC7B,CAAC;IAED;;;;;;OAMG;IACH,iBAAiB;QACf,KAAK,MAAM,CAAC,OAAO,EAAE,GAAG,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,aAAa,EAAE,EAAE,CAAC;YACxD,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,iBAAiB,CAAC;gBAAE,SAAS;YACjD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAAC;YAC7E,IAAI,OAAO,EAAE,EAAE,KAAK,OAAO;gBAAE,SAAS;YACtC,kDAAkD;YAClD,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;YAChC,IAAI,OAAO,KAAK,SAAS;gBAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC;QAC3E,CAAC;IACH,CAAC;IAEO,KAAK;QACX,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACnB,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACnB,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;QACvB,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC;IAC3B,CAAC;IAEO,YAAY,CAAC,GAAW;QAC9B,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,SAAS,EAAE,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,OAAO,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC;IAClG,CAAC;CACF;AAED;;;;;;GAMG;AACH,MAAM,iBAAiB,GAAG,SAAS,CAAC;AAEpC,0CAA0C;AAC1C,SAAS,YAAY,CAAC,GAAW;IAC/B,OAAO,GAAG,iBAAiB,GAAG,GAAG,EAAE,CAAC;AACtC,CAAC"}

package/dist/media/remoteAudio.d.ts

@@ -0,0 +1,65 @@
+/**
+ * 远端音频由 **Engine 自己播放**，与画面挂在哪无关。
+ *
+ * # 为什么这层要存在
+ *
+ * 原先远端的音视频装在同一条按 uid 的 `MediaStream` 里，挂到 `attachView(uid, el)`
+ * 的那个 `<video>` 上才出声。于是**没有格子的人就是彻底静音**：语音版式、页内小窗、
+ * 会议翻页之后不在本页的二十几个人，全都听不见。`call-uikit-react` 为此长了一个
+ * `RemoteAudioSink` 组件——那是把 Engine 该做的事推给了 Kit，自画 UI 的宿主还得再抄一遍。
+ *
+ * iOS / Android 从来没有这个问题：它们的远端音频由 WebRTC 原生音频设备直接播放。
+ * 这里把 Web 对齐过去（MEETING_ROOM_DESIGN §8 #10 / §9 ②）：
+ * **`attachView` 从此只管画面，声音一律由引擎播。**
+ *
+ * # 为什么一条轨道一个 `<audio>`，而不是一个元素收全部
+ *
+ * `HTMLMediaElement` 绑一条带多路音频轨的 `MediaStream` 时，浏览器只播其中一路——
+ * 「汇进一个元素」实际做不到。真要一个出口就得走 `AudioContext`
+ * （每条轨 `createMediaStreamSource` 再 connect 到 destination），
+ * 那等于把自动播放解锁、采样率、重采样一整套问题揽进来，换不到任何东西。
+ * 元素是引擎自己建的、宿主看不见，几个都一样。
+ *
+ * # 为什么不按 uid 建
+ *
+ * 认领不到 uid 的轨道**也要出声**（以后服务端换成音频槽位时，轨道根本没有 uid，
+ * 见 §9 路 B）。按 track_id 建，这件事天然成立。
+ */
+/** AudioSink 是一个能播一条音频轨的出口。取 `HTMLAudioElement` 的最小交集，便于测试替身。 */
+export interface AudioSink {
+    srcObject: MediaProvider | null;
+    autoplay: boolean;
+    muted: boolean;
+    play(): Promise<void>;
+    remove(): void;
+}
+/** SinkFactory 建一个出口。默认实现建一个隐藏的 `<audio>`，测试里换成替身。 */
+export type SinkFactory = (track: MediaStreamTrack) => AudioSink | null;
+/** RemoteAudioPlayer 持有全部远端音频的播放出口。 */
+export declare class RemoteAudioPlayer {
+    private readonly sinks;
+    private readonly createSink;
+    constructor(createSink?: SinkFactory);
+    /**
+     * add 收下一条远端音频轨并立刻播。
+     *
+     * 重复 add 同一个 track_id 是幂等的——`ontrack` 与认领两条路都可能走到这里。
+     */
+    add(trackId: string, track: MediaStreamTrack): void;
+    /** remove 摘掉一条（对方停发、退订、离房）。 */
+    remove(trackId: string): void;
+    /**
+     * unlock 再试一次播放，**在一次用户手势的调用栈里调**。
+     *
+     * 浏览器的自动播放限制会让进房前建出来的出口停在暂停态。进房几乎总是由一次点击
+     * 触发（「加入会议」「接听」），所以引擎在 `joinRoom` 那一刻顺手再 `play()` 一遍。
+     * 已经在播的调它是空操作。
+     */
+    unlock(): void;
+    /** clear 关掉全部出口（离房、logout）。 */
+    clear(): void;
+    /** count 是此刻挂着几个出口，供测试断言。 */
+    get count(): number;
+    private start;
+}
+//# sourceMappingURL=remoteAudio.d.ts.map

package/dist/media/remoteAudio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remoteAudio.d.ts","sourceRoot":"","sources":["../../src/media/remoteAudio.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,iEAAiE;AACjE,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,aAAa,GAAG,IAAI,CAAC;IAChC,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,MAAM,IAAI,IAAI,CAAC;CAChB;AAED,sDAAsD;AACtD,MAAM,MAAM,WAAW,GAAG,CAAC,KAAK,EAAE,gBAAgB,KAAK,SAAS,GAAG,IAAI,CAAC;AAExE,uCAAuC;AACvC,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgC;IACtD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAc;gBAE7B,UAAU,GAAE,WAA0B;IAIlD;;;;OAIG;IACH,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,gBAAgB,GAAG,IAAI;IAQnD,+BAA+B;IAC/B,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAQ7B;;;;;;OAMG;IACH,MAAM,IAAI,IAAI;IAId,+BAA+B;IAC/B,KAAK,IAAI,IAAI;IAIb,6BAA6B;IAC7B,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,OAAO,CAAC,KAAK;CAcd"}

package/dist/media/remoteAudio.js

@@ -0,0 +1,83 @@
+import { logger } from '../logger.js';
+/** RemoteAudioPlayer 持有全部远端音频的播放出口。 */
+export class RemoteAudioPlayer {
+    sinks = new Map();
+    createSink;
+    constructor(createSink = domAudioSink) {
+        this.createSink = createSink;
+    }
+    /**
+     * add 收下一条远端音频轨并立刻播。
+     *
+     * 重复 add 同一个 track_id 是幂等的——`ontrack` 与认领两条路都可能走到这里。
+     */
+    add(trackId, track) {
+        if (this.sinks.has(trackId))
+            return;
+        const sink = this.createSink(track);
+        if (sink === null)
+            return;
+        this.sinks.set(trackId, sink);
+        this.start(sink);
+    }
+    /** remove 摘掉一条（对方停发、退订、离房）。 */
+    remove(trackId) {
+        const sink = this.sinks.get(trackId);
+        if (sink === undefined)
+            return;
+        this.sinks.delete(trackId);
+        sink.srcObject = null;
+        sink.remove();
+    }
+    /**
+     * unlock 再试一次播放，**在一次用户手势的调用栈里调**。
+     *
+     * 浏览器的自动播放限制会让进房前建出来的出口停在暂停态。进房几乎总是由一次点击
+     * 触发（「加入会议」「接听」），所以引擎在 `joinRoom` 那一刻顺手再 `play()` 一遍。
+     * 已经在播的调它是空操作。
+     */
+    unlock() {
+        for (const [, sink] of this.sinks)
+            this.start(sink);
+    }
+    /** clear 关掉全部出口（离房、logout）。 */
+    clear() {
+        for (const trackId of [...this.sinks.keys()])
+            this.remove(trackId);
+    }
+    /** count 是此刻挂着几个出口，供测试断言。 */
+    get count() {
+        return this.sinks.size;
+    }
+    start(sink) {
+        /*
+          **播放失败只记一条，不往上抛。**
+    
+          自动播放被挡（还没有用户手势）是最常见的一种，而那时正确的做法是等 `unlock()`，
+          不是把一个 Promise 拒绝丢给宿主的 `error` 事件——宿主对它无事可做，
+          只会在控制台刷一片没人看的红。
+        */
+        sink.play().catch((err) => {
+            logger.debug('远端音频暂时播不了（多半是自动播放限制，等进房那次点击解锁）', {
+                err: String(err),
+            });
+        });
+    }
+}
+/** domAudioSink 是默认实现：一个隐藏的 `<audio>`。没有 DOM（node 环境）时返回 null。 */
+function domAudioSink(track) {
+    if (typeof document === 'undefined' || typeof MediaStream === 'undefined')
+        return null;
+    const el = document.createElement('audio');
+    el.autoplay = true;
+    /*
+      **挂进 document 而不是留一个游离元素**：游离的 `<audio>` 在 iOS Safari 上不出声。
+      不设 `display:none`——那在部分浏览器上会让媒体元素停播；`<audio>` 不带 `controls`
+      本来就没有可见的盒子，`hidden` 只是让它连布局都不参与。
+    */
+    el.hidden = true;
+    el.srcObject = new MediaStream([track]);
+    document.body.appendChild(el);
+    return el;
+}
+//# sourceMappingURL=remoteAudio.js.map

package/dist/media/remoteAudio.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remoteAudio.js","sourceRoot":"","sources":["../../src/media/remoteAudio.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AA0CtC,uCAAuC;AACvC,MAAM,OAAO,iBAAiB;IACX,KAAK,GAAG,IAAI,GAAG,EAAqB,CAAC;IACrC,UAAU,CAAc;IAEzC,YAAY,aAA0B,YAAY;QAChD,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;IAED;;;;OAIG;IACH,GAAG,CAAC,OAAe,EAAE,KAAuB;QAC1C,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC;YAAE,OAAO;QACpC,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QACpC,IAAI,IAAI,KAAK,IAAI;YAAE,OAAO;QAC1B,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAC9B,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACnB,CAAC;IAED,+BAA+B;IAC/B,MAAM,CAAC,OAAe;QACpB,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACrC,IAAI,IAAI,KAAK,SAAS;YAAE,OAAO;QAC/B,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC3B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACtB,IAAI,CAAC,MAAM,EAAE,CAAC;IAChB,CAAC;IAED;;;;;;OAMG;IACH,MAAM;QACJ,KAAK,MAAM,CAAC,EAAE,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK;YAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACtD,CAAC;IAED,+BAA+B;IAC/B,KAAK;QACH,KAAK,MAAM,OAAO,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;YAAE,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACrE,CAAC;IAED,6BAA6B;IAC7B,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;IACzB,CAAC;IAEO,KAAK,CAAC,IAAe;QAC3B;;;;;;UAME;QACF,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;YACjC,MAAM,CAAC,KAAK,CAAC,gCAAgC,EAAE;gBAC7C,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC;aACjB,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;CACF;AAED,kEAAkE;AAClE,SAAS,YAAY,CAAC,KAAuB;IAC3C,IAAI,OAAO,QAAQ,KAAK,WAAW,IAAI,OAAO,WAAW,KAAK,WAAW;QAAE,OAAO,IAAI,CAAC;IACvF,MAAM,EAAE,GAAG,QAAQ,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;IAC3C,EAAE,CAAC,QAAQ,GAAG,IAAI,CAAC;IACnB;;;;MAIE;IACF,EAAE,CAAC,MAAM,GAAG,IAAI,CAAC;IACjB,EAAE,CAAC,SAAS,GAAG,IAAI,WAAW,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;IACxC,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;IAC9B,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/dist/media/videoSender.d.ts

@@ -0,0 +1,21 @@
+import type { VideoProfile } from './videoProfile.js';
+/**
+ * addVideoSender 把一条上行视频挂到 pub 上，返回它的 sender。
+ *
+ * # 为什么不能用 addTrack
+ *
+ * `addTrack` 只会产生**一个 encoding**，浏览器里发 simulcast 必须在建
+ * transceiver 时就把 `sendEncodings` 给出来——协商之后再 `setParameters`
+ * 加层是加不上的（规范不允许改 encoding 的条数）。
+ *
+ * 这正是之前那个洞：`publishCamera(simulcast = true)` 的这个参数一路传进了
+ * `room.publish` 帧、**告诉服务端「我是 simulcast」**，可媒体面走的是裸
+ * `addTrack`，实际只发一层。服务端于是只看到空 RID 的单层（`ridToLayer("")`
+ * 当成 h），层选择无从谈起：订阅者报 `l` 也只能收到全速率的 h
+ * （`selectLayer` 的兜底），弱下行的那一方被自己的全速率流压死。
+ *
+ * `streams: [stream]` 不能省：msid 的第二段就是 cid，服务端靠它认领 m-line
+ * （协议 §3.2）。省掉它服务端永远认不回这条轨道。
+ */
+export declare function addVideoSender(pub: RTCPeerConnection, track: MediaStreamTrack, stream: MediaStream, simulcast: boolean, video: VideoProfile): RTCRtpSender;
+//# sourceMappingURL=videoSender.d.ts.map

package/dist/media/videoSender.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"videoSender.d.ts","sourceRoot":"","sources":["../../src/media/videoSender.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAWtD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,iBAAiB,EACtB,KAAK,EAAE,gBAAgB,EACvB,MAAM,EAAE,WAAW,EACnB,SAAS,EAAE,OAAO,EAClB,KAAK,EAAE,YAAY,GAClB,YAAY,CAiBd"}

package/dist/media/videoSender.js

@@ -0,0 +1,74 @@
+import { logger } from '../logger.js';
+import { simulcastEncodings } from './videoProfile.js';
+/*
+  上行视频怎么挂到 pub 上、码率怎么压。
+
+  从 `webrtcAdapter.ts` 里单拎出来：这两件事只读画质档位、只碰传进来的 PC 与 sender，
+  **不碰适配器的任何状态**（预览、开关队列、代数那一套都不相干），
+  拆出来之后可以直接对着假 PC 单测，不必再 `Reflect.get` 去掏私有方法。
+*/
+/**
+ * addVideoSender 把一条上行视频挂到 pub 上，返回它的 sender。
+ *
+ * # 为什么不能用 addTrack
+ *
+ * `addTrack` 只会产生**一个 encoding**，浏览器里发 simulcast 必须在建
+ * transceiver 时就把 `sendEncodings` 给出来——协商之后再 `setParameters`
+ * 加层是加不上的（规范不允许改 encoding 的条数）。
+ *
+ * 这正是之前那个洞：`publishCamera(simulcast = true)` 的这个参数一路传进了
+ * `room.publish` 帧、**告诉服务端「我是 simulcast」**，可媒体面走的是裸
+ * `addTrack`，实际只发一层。服务端于是只看到空 RID 的单层（`ridToLayer("")`
+ * 当成 h），层选择无从谈起：订阅者报 `l` 也只能收到全速率的 h
+ * （`selectLayer` 的兜底），弱下行的那一方被自己的全速率流压死。
+ *
+ * `streams: [stream]` 不能省：msid 的第二段就是 cid，服务端靠它认领 m-line
+ * （协议 §3.2）。省掉它服务端永远认不回这条轨道。
+ */
+export function addVideoSender(pub, track, stream, simulcast, video) {
+    if (!simulcast) {
+        const sender = pub.addTrack(track, stream);
+        applyVideoBitrate(sender, video);
+        return sender;
+    }
+    const transceiver = pub.addTransceiver(track, {
+        direction: 'sendonly',
+        streams: [stream],
+        sendEncodings: simulcastEncodings(video),
+    });
+    logger.info('上行视频已按 simulcast 发布', {
+        cid: track.id,
+        layers: simulcastEncodings(video).map((e) => e.rid).join(','),
+    });
+    applyVideoBitrate(transceiver.sender, video);
+    return transceiver.sender;
+}
+/**
+ * applyVideoBitrate 给上行视频压一个码率上限。
+ *
+ * **不设的话浏览器会自己往上飙**：Chrome 对 720p 的默认上限远高于我们给
+ * simulcast h 层定的目标值，服务端的带宽预算（`bwe.go` 的 `bitrateHigh`）
+ * 就成了一个对不上的数字，降层判断跟着不准。
+ *
+ * 失败只记日志：码率是画质偏好，`setParameters` 被拒不该让通话打不出去。
+ */
+function applyVideoBitrate(sender, video) {
+    const params = sender.getParameters();
+    // encodings 可能还是空的（协商之前）；补一个默认项，浏览器会认。
+    if (params.encodings.length === 0)
+        params.encodings = [{}];
+    /*
+     **simulcast 的三层各有各的码率，不能抹平成同一个值。**
+     全设成 h 的目标码率等于让 l / m 两层也按 1.5Mbps 发，
+     上行瞬间涨到三倍，而降层根本省不下带宽——降了个寂寞。
+     按 rid 对号入座；没有 rid（单层发布）才用整档的上限。
+    */
+    const byRid = new Map(simulcastEncodings(video).map((e) => [e.rid, e.maxBitrate]));
+    for (const encoding of params.encodings) {
+        encoding.maxBitrate = byRid.get(encoding.rid) ?? video.maxBitrateBps;
+    }
+    void sender.setParameters(params).catch((err) => {
+        logger.info('设置上行码率失败，用浏览器默认值', { err: String(err) });
+    });
+}
+//# sourceMappingURL=videoSender.js.map

package/dist/media/videoSender.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"videoSender.js","sourceRoot":"","sources":["../../src/media/videoSender.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD;;;;;;EAME;AAEF;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,cAAc,CAC5B,GAAsB,EACtB,KAAuB,EACvB,MAAmB,EACnB,SAAkB,EAClB,KAAmB;IAEnB,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,MAAM,GAAG,GAAG,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAC3C,iBAAiB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QACjC,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,MAAM,WAAW,GAAG,GAAG,CAAC,cAAc,CAAC,KAAK,EAAE;QAC5C,SAAS,EAAE,UAAU;QACrB,OAAO,EAAE,CAAC,MAAM,CAAC;QACjB,aAAa,EAAE,kBAAkB,CAAC,KAAK,CAAC;KACzC,CAAC,CAAC;IACH,MAAM,CAAC,IAAI,CAAC,qBAAqB,EAAE;QACjC,GAAG,EAAE,KAAK,CAAC,EAAE;QACb,MAAM,EAAE,kBAAkB,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;KAC9D,CAAC,CAAC;IACH,iBAAiB,CAAC,WAAW,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC7C,OAAO,WAAW,CAAC,MAAM,CAAC;AAC5B,CAAC;AAED;;;;;;;;GAQG;AACH,SAAS,iBAAiB,CAAC,MAAoB,EAAE,KAAmB;IAClE,MAAM,MAAM,GAAG,MAAM,CAAC,aAAa,EAAE,CAAC;IACtC,uCAAuC;IACvC,IAAI,MAAM,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,CAAC,SAAS,GAAG,CAAC,EAAE,CAAC,CAAC;IAC3D;;;;;MAKE;IACF,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IACnF,KAAK,MAAM,QAAQ,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;QACxC,QAAQ,CAAC,UAAU,GAAG,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,aAAa,CAAC;IACvE,CAAC;IACD,KAAK,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;QACvD,MAAM,CAAC,IAAI,CAAC,kBAAkB,EAAE,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/media/viewRegistry.d.ts

@@ -24,9 +24,15 @@
 export interface ViewElement {
     srcObject: MediaProvider | null;
 }
-/** ViewRegistry 管「哪条轨道属于谁」与「谁挂在哪个元素上」。 */
+/**
+ * ViewRegistry 管「哪条轨道属于谁」与「谁挂在哪个元素上」。
+ *
+ * **只有视频进得了这条流**（2.0.0 起）：远端音频由引擎自己播（`remoteAudio.ts`），
+ * 挂载与否不影响听不听得见。两样都往这条流里塞的话，挂了 `<video>` 的人会**出两份声音**
+ * ——一份来自隐藏的 `<audio>`，一份来自那个 `<video>`。
+ */
 export declare class ViewRegistry {
-    /** uid → 该用户的媒体流（音视频合在一条流里，浏览器才会同步播放）。 */
+    /** uid → 该用户的画面流。 */
     private readonly streams;
     /** uid → 已挂载的元素。 */
     private readonly views;
@@ -52,6 +58,8 @@ export declare class ViewRegistry {
     /**
      * attach 把某个 uid 的画面挂到元素上；`el` 传 null 表示卸载。
      *
+     * **只管画面**：挂不挂都不影响听不听得见（远端音频由引擎自己播）。
+     *
      * **卸载必须做**：组件卸载时不清 `srcObject`，被卸掉的 <video> 会连着
      * MediaStream 一起被引用，画面停了但解码器还占着（CONVENTIONS §5）。
      */
@@ -65,7 +73,7 @@ export declare class ViewRegistry {
     claimedTracks(): [string, string][];
     /** viewOf 取某人此刻挂着的元素（没挂为 undefined）。 */
     viewOf(uid: string): ViewElement | undefined;
-    /** streamFor 取某人的流，宿主想自己挂载时用。 */
+    /** streamFor 取某人的**画面**流，宿主想自己挂载时用。声音不在里面。 */
     streamFor(uid: string): MediaStream | undefined;
     /** clear 清空全部登记（通话结束 / logout）。 */
     clear(): void;

package/dist/media/viewRegistry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"viewRegistry.d.ts","sourceRoot":"","sources":["../../src/media/viewRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH;;;;;;GAMG;AACH,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,aAAa,GAAG,IAAI,CAAC;CACjC;AAED,0CAA0C;AAC1C,qBAAa,YAAY;IACvB,0CAA0C;IAC1C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkC;IAC1D,oBAAoB;IACpB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAkC;IACxD,4BAA4B;IAC5B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuC;IAC/D,kDAAkD;IAClD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA6B;IAEpD;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,gBAAgB,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IAWrE;;;;;OAKG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IAMzC,mCAAmC;IACnC,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAelC;;;;;OAKG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,WAAW,GAAG,IAAI,GAAG,IAAI;IAWjD;;;;;OAKG;IACH,aAAa,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE;IAInC,wCAAwC;IACxC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAI5C,iCAAiC;IACjC,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAI/C,mCAAmC;IACnC,KAAK,IAAI,IAAI;IAQb,OAAO,CAAC,QAAQ;IAShB,OAAO,CAAC,OAAO;CAKhB"}
+{"version":3,"file":"viewRegistry.d.ts","sourceRoot":"","sources":["../../src/media/viewRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH;;;;;;GAMG;AACH,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,aAAa,GAAG,IAAI,CAAC;CACjC;AAED;;;;;;GAMG;AACH,qBAAa,YAAY;IACvB,qBAAqB;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkC;IAC1D,oBAAoB;IACpB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAkC;IACxD,4BAA4B;IAC5B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuC;IAC/D,kDAAkD;IAClD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA6B;IAEpD;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,gBAAgB,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IAgCrE;;;;;OAKG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IAMzC,mCAAmC;IACnC,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAelC;;;;;;;OAOG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,WAAW,GAAG,IAAI,GAAG,IAAI;IAWjD;;;;;OAKG;IACH,aAAa,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE;IAInC,wCAAwC;IACxC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAI5C,8CAA8C;IAC9C,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAI/C,mCAAmC;IACnC,KAAK,IAAI,IAAI;IAQb,OAAO,CAAC,QAAQ;IAShB,OAAO,CAAC,OAAO;CAKhB"}

package/dist/media/viewRegistry.js

@@ -14,9 +14,15 @@
  * 迟到时把已经攒着的轨道补挂上去。漏掉这一步的表现是「有声音没画面」，
  * 且只在网络较快时偶发。
  */
-/** ViewRegistry 管「哪条轨道属于谁」与「谁挂在哪个元素上」。 */
+/**
+ * ViewRegistry 管「哪条轨道属于谁」与「谁挂在哪个元素上」。
+ *
+ * **只有视频进得了这条流**（2.0.0 起）：远端音频由引擎自己播（`remoteAudio.ts`），
+ * 挂载与否不影响听不听得见。两样都往这条流里塞的话，挂了 `<video>` 的人会**出两份声音**
+ * ——一份来自隐藏的 `<audio>`，一份来自那个 `<video>`。
+ */
 export class ViewRegistry {
-    /** uid → 该用户的媒体流（音视频合在一条流里，浏览器才会同步播放）。 */
+    /** uid → 该用户的画面流。 */
     streams = new Map();
     /** uid → 已挂载的元素。 */
     views = new Map();
@@ -36,8 +42,30 @@ export class ViewRegistry {
         }
         this.orphans.delete(trackId);
         this.owners.set(trackId, uid);
-        this.streamOf(uid).addTrack(track);
-        this.refresh(uid);
+        // 音频只记账不进流：它由引擎自己播（见类注释）。记账仍要做——
+        // 对账要靠 owners 知道「这条轨道还在不在」。
+        if (track.kind !== 'audio') {
+            /*
+              **同一个人同一类轨道只留最新那条。**
+      
+              会议分页翻走五秒会退订、翻回来重新订阅：`remoteTracks` 里那一条自始至终都在
+              （发布者没停发），所以 `syncRemoteTracks` 的对账扫不到它，而 `ontrack`
+              会送来一个**全新的** `MediaStreamTrack`。不摘旧的就变成流里同时挂着
+              「已经 ended 的旧轨道 + 新轨道」，`<video>` 播的是第一条——
+              **画面定格在最后一帧**（2026-09-18 真机在 iOS / Android 上先撞到，同一个根因）。
+      
+              按 kind 摘而不是按 track_id：新旧两条的协议 track_id 是同一个，
+              浏览器给的对象却不是。2.0.0 一个人只有一路摄像头，所以「同类只留一条」成立；
+              将来加屏幕共享要改成按 source 分。
+            */
+            const stream = this.streamOf(uid);
+            for (const existing of stream.getTracks()) {
+                if (existing.kind === track.kind && existing !== track)
+                    stream.removeTrack(existing);
+            }
+            stream.addTrack(track);
+            this.refresh(uid);
+        }
     }
     /**
      * claim 认领一条之前不知道归属的轨道。
@@ -72,6 +100,8 @@ export class ViewRegistry {
     /**
      * attach 把某个 uid 的画面挂到元素上；`el` 传 null 表示卸载。
      *
+     * **只管画面**：挂不挂都不影响听不听得见（远端音频由引擎自己播）。
+     *
      * **卸载必须做**：组件卸载时不清 `srcObject`，被卸掉的 <video> 会连着
      * MediaStream 一起被引用，画面停了但解码器还占着（CONVENTIONS §5）。
      */
@@ -99,7 +129,7 @@ export class ViewRegistry {
     viewOf(uid) {
         return this.views.get(uid);
     }
-    /** streamFor 取某人的流，宿主想自己挂载时用。 */
+    /** streamFor 取某人的**画面**流，宿主想自己挂载时用。声音不在里面。 */
     streamFor(uid) {
         return this.streams.get(uid);
     }