@vivix-ai/ivi-frontend-sdk 0.3.2 → 0.3.4

package/dist/index.d.cts

@@ -72,6 +72,21 @@ interface IviRuntimeTrtcEvent {
     streamType?: unknown;
 }
 type IviRuntimeTrtcEventListener = (event: IviRuntimeTrtcEvent) => void;
+type IviRuntimeTrtcAIDenoiserMode = "normal" | "far_field_reduction";
+interface IviRuntimeTrtcAIDenoiserOptions {
+    /**
+     * 是否启用 TRTC AIDenoiser 插件，默认 true。
+     */
+    enabled?: boolean;
+    /**
+     * 降噪模式，默认 "normal"。
+     */
+    mode?: IviRuntimeTrtcAIDenoiserMode;
+    /**
+     * TRTC AIDenoiser 资源路径；未配置时使用 TRTC SDK 默认加载逻辑。
+     */
+    assetsPath?: string;
+}
 type IviRuntimeConversationLifecycle = "added" | "done";
 type IviRuntimeConversationStatus = "in_progress" | "completed" | "incomplete";
 interface IviRuntimeConversationItem {
@@ -103,6 +118,10 @@ interface IviRuntimeCoordinatorConfig {
      * TRTC SDK 原始事件回调；可用于业务监听远端音视频可用性等底层事件。
      */
     onTrtcEvent?: IviRuntimeTrtcEventListener;
+    /**
+     * TRTC SDK AIDenoiser 降噪配置。默认开启；传 false 可关闭。
+     */
+    trtcAIDenoiser?: boolean | IviRuntimeTrtcAIDenoiserOptions;
 }
 /**
  * 用户输入触发回复链路配置。
@@ -177,9 +196,11 @@ type TrtcSourceListener = (snapshot: TrtcSourceSnapshot) => void;
 declare class TrtcSourceManager {
     private readonly onLog?;
     private readonly onTrtcEvent?;
+    private readonly aiDenoiser?;
     private readonly sessions;
+    private readonly sourceSessionKeys;
     private readonly listeners;
-    constructor(onLog?: IviRuntimeLogCallback | undefined, onTrtcEvent?: IviRuntimeTrtcEventListener | undefined);
+    constructor(onLog?: IviRuntimeLogCallback | undefined, onTrtcEvent?: IviRuntimeTrtcEventListener | undefined, aiDenoiser?: (boolean | IviRuntimeTrtcAIDenoiserOptions) | undefined);
     /**
      * 将 runtime 当前 sources 与 TRTC 会话池对齐：
      * - 对 ready + trtc 的 source 进行 upsert（必要时建立连接）
@@ -190,7 +211,7 @@ declare class TrtcSourceManager {
      * 按 sourceId 注册/更新 TRTC 配置。
      * 若配置发生变化，会先销毁旧会话再按新参数重建连接。
      */
-    upsertSource(sourceId: string, trtc: IviSourcePlaybackTrtc): void;
+    upsertSource(sourceId: string, trtc: IviSourcePlaybackTrtc, aiDenoiser?: boolean | IviRuntimeTrtcAIDenoiserOptions): void;
     /**
      * 删除指定 source 的 TRTC 会话并释放连接资源。
      * 该操作通常由 source.deleted 或会话重置触发。
@@ -218,6 +239,11 @@ declare class TrtcSourceManager {
     attachView(sourceId: string, viewId: string, container: HTMLElement, muted: boolean): Promise<void>;
     detachView(sourceId: string, viewId: string): void;
     updateViewMuted(sourceId: string, viewId: string, muted: boolean): void;
+    private unlinkSourceFromSession;
+    private getSession;
+    private snapshotFromSession;
+    private emitSessionSnapshot;
+    private emitSessionTrtcEvent;
     private createSession;
     /**
      * 懒连接入口：同一会话只允许一次并发 connectPromise。
@@ -232,6 +258,7 @@ declare class TrtcSourceManager {
      * - 至少一个 view 需出声 -> 对可用远端用户解除静音
      */
     private applyAudioPolicy;
+    private applyAIDenoiserPolicy;
     /**
      * 销毁单个 source 会话：
      * 解绑事件、停止远端视频、退出房间并销毁客户端。
@@ -546,6 +573,11 @@ interface IVITrtcPlayerProps {
     loadingFallback?: ReactNode;
     errorFallback?: ReactNode;
     muted?: boolean;
+    /**
+     * 独立使用 IVITrtcPlayer（未传 runtime）时的 TRTC AIDenoiser 降噪配置。
+     * 默认开启；传 false 可关闭。
+     */
+    trtcAIDenoiser?: boolean | IviRuntimeTrtcAIDenoiserOptions;
 }
 /**
  * 默认 TRTC 播放器：挂载即加入房间并拉流，连接由 TrtcSourceManager 统一复用。
@@ -724,4 +756,4 @@ declare function useManagedIviRuntime(config: IviManagedRuntimeConfig): IviRunti
 
 declare function useIviStageView(): IviStageViewContextValue;
 
-export { EMPTY_RUNTIME_STATE, IVILivekitPlayer, type IVILivekitPlayerProps, IVIStageView, type IVIStageViewProps, IVISubtitleOverlay, type IVISubtitleOverlayProps, type IVISubtitleOverlayStyle, IVITrackSlot, type IVITrackSlotProps, IVITrtcPlayer, type IVITrtcPlayerProps, type IviFrontendClientConfig, IviFrontendSdk, type IviManagedRuntimeConfig, type IviManagedRuntimeLogCallback, type IviManagedRuntimeLogEntry, type IviManagedRuntimeLogLevel, type IviManagedRuntimeLogSource, type IviRuntimeConversationItem, type IviRuntimeConversationLifecycle, type IviRuntimeConversationStatus, IviRuntimeCoordinator, type IviRuntimeCoordinatorConfig, IviRuntimeDispatcher, type IviRuntimeDispatcherConfig, type IviRuntimeEventListener, type IviRuntimeLogCallback, type IviRuntimeLogEntry, type IviRuntimeLogLevel, type IviRuntimeSource, type IviRuntimeSourcePreloadState, type IviRuntimeState, type IviRuntimeStatus, type IviRuntimeStream, type IviRuntimeTrtcEvent, type IviRuntimeTrtcEventListener, type IviRuntimeTrtcEventType, type IviRuntimeUserTextToResponseCallbacks, type IviRuntimeUserTextToResponseOptions, type IviRuntimeUserTextToResponseResult, type IviSourcePlaybackLivekit, type IviSourcePlaybackLivekitDescriptor, type IviStageSlotBinding, type IviStageViewContextValue, type IviSubtitleItem, type IviSubtitleRole, type IviUseSubtitlesOptions, LivekitSourceManager, TrtcSourceManager, isLivekitSourcePlayback, isReadyLivekitRuntimeSource, isSameLivekitConfig, useIviStageView, useIviSubtitles, useManagedIviRuntime, useRuntimeState };
+export { EMPTY_RUNTIME_STATE, IVILivekitPlayer, type IVILivekitPlayerProps, IVIStageView, type IVIStageViewProps, IVISubtitleOverlay, type IVISubtitleOverlayProps, type IVISubtitleOverlayStyle, IVITrackSlot, type IVITrackSlotProps, IVITrtcPlayer, type IVITrtcPlayerProps, type IviFrontendClientConfig, IviFrontendSdk, type IviManagedRuntimeConfig, type IviManagedRuntimeLogCallback, type IviManagedRuntimeLogEntry, type IviManagedRuntimeLogLevel, type IviManagedRuntimeLogSource, type IviRuntimeConversationItem, type IviRuntimeConversationLifecycle, type IviRuntimeConversationStatus, IviRuntimeCoordinator, type IviRuntimeCoordinatorConfig, IviRuntimeDispatcher, type IviRuntimeDispatcherConfig, type IviRuntimeEventListener, type IviRuntimeLogCallback, type IviRuntimeLogEntry, type IviRuntimeLogLevel, type IviRuntimeSource, type IviRuntimeSourcePreloadState, type IviRuntimeState, type IviRuntimeStatus, type IviRuntimeStream, type IviRuntimeTrtcAIDenoiserMode, type IviRuntimeTrtcAIDenoiserOptions, type IviRuntimeTrtcEvent, type IviRuntimeTrtcEventListener, type IviRuntimeTrtcEventType, type IviRuntimeUserTextToResponseCallbacks, type IviRuntimeUserTextToResponseOptions, type IviRuntimeUserTextToResponseResult, type IviSourcePlaybackLivekit, type IviSourcePlaybackLivekitDescriptor, type IviStageSlotBinding, type IviStageViewContextValue, type IviSubtitleItem, type IviSubtitleRole, type IviUseSubtitlesOptions, LivekitSourceManager, TrtcSourceManager, isLivekitSourcePlayback, isReadyLivekitRuntimeSource, isSameLivekitConfig, useIviStageView, useIviSubtitles, useManagedIviRuntime, useRuntimeState };

package/dist/index.d.ts

@@ -72,6 +72,21 @@ interface IviRuntimeTrtcEvent {
     streamType?: unknown;
 }
 type IviRuntimeTrtcEventListener = (event: IviRuntimeTrtcEvent) => void;
+type IviRuntimeTrtcAIDenoiserMode = "normal" | "far_field_reduction";
+interface IviRuntimeTrtcAIDenoiserOptions {
+    /**
+     * 是否启用 TRTC AIDenoiser 插件，默认 true。
+     */
+    enabled?: boolean;
+    /**
+     * 降噪模式，默认 "normal"。
+     */
+    mode?: IviRuntimeTrtcAIDenoiserMode;
+    /**
+     * TRTC AIDenoiser 资源路径；未配置时使用 TRTC SDK 默认加载逻辑。
+     */
+    assetsPath?: string;
+}
 type IviRuntimeConversationLifecycle = "added" | "done";
 type IviRuntimeConversationStatus = "in_progress" | "completed" | "incomplete";
 interface IviRuntimeConversationItem {
@@ -103,6 +118,10 @@ interface IviRuntimeCoordinatorConfig {
      * TRTC SDK 原始事件回调；可用于业务监听远端音视频可用性等底层事件。
      */
     onTrtcEvent?: IviRuntimeTrtcEventListener;
+    /**
+     * TRTC SDK AIDenoiser 降噪配置。默认开启；传 false 可关闭。
+     */
+    trtcAIDenoiser?: boolean | IviRuntimeTrtcAIDenoiserOptions;
 }
 /**
  * 用户输入触发回复链路配置。
@@ -177,9 +196,11 @@ type TrtcSourceListener = (snapshot: TrtcSourceSnapshot) => void;
 declare class TrtcSourceManager {
     private readonly onLog?;
     private readonly onTrtcEvent?;
+    private readonly aiDenoiser?;
     private readonly sessions;
+    private readonly sourceSessionKeys;
     private readonly listeners;
-    constructor(onLog?: IviRuntimeLogCallback | undefined, onTrtcEvent?: IviRuntimeTrtcEventListener | undefined);
+    constructor(onLog?: IviRuntimeLogCallback | undefined, onTrtcEvent?: IviRuntimeTrtcEventListener | undefined, aiDenoiser?: (boolean | IviRuntimeTrtcAIDenoiserOptions) | undefined);
     /**
      * 将 runtime 当前 sources 与 TRTC 会话池对齐：
      * - 对 ready + trtc 的 source 进行 upsert（必要时建立连接）
@@ -190,7 +211,7 @@ declare class TrtcSourceManager {
      * 按 sourceId 注册/更新 TRTC 配置。
      * 若配置发生变化，会先销毁旧会话再按新参数重建连接。
      */
-    upsertSource(sourceId: string, trtc: IviSourcePlaybackTrtc): void;
+    upsertSource(sourceId: string, trtc: IviSourcePlaybackTrtc, aiDenoiser?: boolean | IviRuntimeTrtcAIDenoiserOptions): void;
     /**
      * 删除指定 source 的 TRTC 会话并释放连接资源。
      * 该操作通常由 source.deleted 或会话重置触发。
@@ -218,6 +239,11 @@ declare class TrtcSourceManager {
     attachView(sourceId: string, viewId: string, container: HTMLElement, muted: boolean): Promise<void>;
     detachView(sourceId: string, viewId: string): void;
     updateViewMuted(sourceId: string, viewId: string, muted: boolean): void;
+    private unlinkSourceFromSession;
+    private getSession;
+    private snapshotFromSession;
+    private emitSessionSnapshot;
+    private emitSessionTrtcEvent;
     private createSession;
     /**
      * 懒连接入口：同一会话只允许一次并发 connectPromise。
@@ -232,6 +258,7 @@ declare class TrtcSourceManager {
      * - 至少一个 view 需出声 -> 对可用远端用户解除静音
      */
     private applyAudioPolicy;
+    private applyAIDenoiserPolicy;
     /**
      * 销毁单个 source 会话：
      * 解绑事件、停止远端视频、退出房间并销毁客户端。
@@ -546,6 +573,11 @@ interface IVITrtcPlayerProps {
     loadingFallback?: ReactNode;
     errorFallback?: ReactNode;
     muted?: boolean;
+    /**
+     * 独立使用 IVITrtcPlayer（未传 runtime）时的 TRTC AIDenoiser 降噪配置。
+     * 默认开启；传 false 可关闭。
+     */
+    trtcAIDenoiser?: boolean | IviRuntimeTrtcAIDenoiserOptions;
 }
 /**
  * 默认 TRTC 播放器：挂载即加入房间并拉流，连接由 TrtcSourceManager 统一复用。
@@ -724,4 +756,4 @@ declare function useManagedIviRuntime(config: IviManagedRuntimeConfig): IviRunti
 
 declare function useIviStageView(): IviStageViewContextValue;
 
-export { EMPTY_RUNTIME_STATE, IVILivekitPlayer, type IVILivekitPlayerProps, IVIStageView, type IVIStageViewProps, IVISubtitleOverlay, type IVISubtitleOverlayProps, type IVISubtitleOverlayStyle, IVITrackSlot, type IVITrackSlotProps, IVITrtcPlayer, type IVITrtcPlayerProps, type IviFrontendClientConfig, IviFrontendSdk, type IviManagedRuntimeConfig, type IviManagedRuntimeLogCallback, type IviManagedRuntimeLogEntry, type IviManagedRuntimeLogLevel, type IviManagedRuntimeLogSource, type IviRuntimeConversationItem, type IviRuntimeConversationLifecycle, type IviRuntimeConversationStatus, IviRuntimeCoordinator, type IviRuntimeCoordinatorConfig, IviRuntimeDispatcher, type IviRuntimeDispatcherConfig, type IviRuntimeEventListener, type IviRuntimeLogCallback, type IviRuntimeLogEntry, type IviRuntimeLogLevel, type IviRuntimeSource, type IviRuntimeSourcePreloadState, type IviRuntimeState, type IviRuntimeStatus, type IviRuntimeStream, type IviRuntimeTrtcEvent, type IviRuntimeTrtcEventListener, type IviRuntimeTrtcEventType, type IviRuntimeUserTextToResponseCallbacks, type IviRuntimeUserTextToResponseOptions, type IviRuntimeUserTextToResponseResult, type IviSourcePlaybackLivekit, type IviSourcePlaybackLivekitDescriptor, type IviStageSlotBinding, type IviStageViewContextValue, type IviSubtitleItem, type IviSubtitleRole, type IviUseSubtitlesOptions, LivekitSourceManager, TrtcSourceManager, isLivekitSourcePlayback, isReadyLivekitRuntimeSource, isSameLivekitConfig, useIviStageView, useIviSubtitles, useManagedIviRuntime, useRuntimeState };
+export { EMPTY_RUNTIME_STATE, IVILivekitPlayer, type IVILivekitPlayerProps, IVIStageView, type IVIStageViewProps, IVISubtitleOverlay, type IVISubtitleOverlayProps, type IVISubtitleOverlayStyle, IVITrackSlot, type IVITrackSlotProps, IVITrtcPlayer, type IVITrtcPlayerProps, type IviFrontendClientConfig, IviFrontendSdk, type IviManagedRuntimeConfig, type IviManagedRuntimeLogCallback, type IviManagedRuntimeLogEntry, type IviManagedRuntimeLogLevel, type IviManagedRuntimeLogSource, type IviRuntimeConversationItem, type IviRuntimeConversationLifecycle, type IviRuntimeConversationStatus, IviRuntimeCoordinator, type IviRuntimeCoordinatorConfig, IviRuntimeDispatcher, type IviRuntimeDispatcherConfig, type IviRuntimeEventListener, type IviRuntimeLogCallback, type IviRuntimeLogEntry, type IviRuntimeLogLevel, type IviRuntimeSource, type IviRuntimeSourcePreloadState, type IviRuntimeState, type IviRuntimeStatus, type IviRuntimeStream, type IviRuntimeTrtcAIDenoiserMode, type IviRuntimeTrtcAIDenoiserOptions, type IviRuntimeTrtcEvent, type IviRuntimeTrtcEventListener, type IviRuntimeTrtcEventType, type IviRuntimeUserTextToResponseCallbacks, type IviRuntimeUserTextToResponseOptions, type IviRuntimeUserTextToResponseResult, type IviSourcePlaybackLivekit, type IviSourcePlaybackLivekitDescriptor, type IviStageSlotBinding, type IviStageViewContextValue, type IviSubtitleItem, type IviSubtitleRole, type IviUseSubtitlesOptions, LivekitSourceManager, TrtcSourceManager, isLivekitSourcePlayback, isReadyLivekitRuntimeSource, isSameLivekitConfig, useIviStageView, useIviSubtitles, useManagedIviRuntime, useRuntimeState };

package/dist/index.js

@@ -1105,11 +1105,17 @@ var ConversationManager = class {
 
 // src/runtime/managers/trtc-source-manager.ts
 var TAG = "[IVI-TRTC]";
+var DEFAULT_DENOISER_OPTIONS = {
+  enabled: true,
+  mode: "normal"
+};
 var TrtcSourceManager = class {
-  constructor(onLog, onTrtcEvent) {
+  constructor(onLog, onTrtcEvent, aiDenoiser) {
     this.onLog = onLog;
     this.onTrtcEvent = onTrtcEvent;
+    this.aiDenoiser = aiDenoiser;
     this.sessions = /* @__PURE__ */ new Map();
+    this.sourceSessionKeys = /* @__PURE__ */ new Map();
     this.listeners = /* @__PURE__ */ new Map();
   }
   /**
@@ -1118,15 +1124,16 @@ var TrtcSourceManager = class {
    * - 清理已不在 runtime 中的会话（释放资源）
    */
   syncRuntimeSources(sources) {
-    const existingIds = new Set(sources.keys());
+    const trtcSourceIds = /* @__PURE__ */ new Set();
     sources.forEach((source, sourceId) => {
       if (!isRuntimeTrtcSource(source)) {
         return;
       }
+      trtcSourceIds.add(sourceId);
       this.upsertSource(sourceId, source.playback.trtc);
     });
-    this.sessions.forEach((_session, sourceId) => {
-      if (!existingIds.has(sourceId)) {
+    Array.from(this.sourceSessionKeys.keys()).forEach((sourceId) => {
+      if (!trtcSourceIds.has(sourceId)) {
         this.removeSource(sourceId);
       }
     });
@@ -1135,22 +1142,29 @@ var TrtcSourceManager = class {
    * 按 sourceId 注册/更新 TRTC 配置。
    * 若配置发生变化，会先销毁旧会话再按新参数重建连接。
    */
-  upsertSource(sourceId, trtc) {
-    const existing = this.sessions.get(sourceId);
-    if (!existing) {
-      this.log("info", `\u65B0\u5EFA\u4F1A\u8BDD source=${sourceId} room=${getTrtcString(trtc, "room_id")} user=${getTrtcString(trtc, "user_id")}`);
-      const session2 = this.createSession(sourceId, trtc);
-      this.sessions.set(sourceId, session2);
-      void this.ensureConnected(session2);
+  upsertSource(sourceId, trtc, aiDenoiser) {
+    const existing = this.getSession(sourceId);
+    if (existing && isSameTrtcConfig(existing.trtc, trtc) && isSameAIDenoiserOptions(existing.aiDenoiser, aiDenoiser)) {
       return;
     }
-    if (isSameTrtcConfig(existing.trtc, trtc)) {
+    if (existing) {
+      this.log("info", `\u914D\u7F6E\u53D8\u66F4\uFF0C\u91CD\u5EFA\u4F1A\u8BDD source=${sourceId} room=${getTrtcString(trtc, "room_id")}`);
+      this.unlinkSourceFromSession(sourceId, existing);
+    }
+    const sessionKey = buildTrtcSessionKey(trtc, aiDenoiser);
+    const reusable = this.sessions.get(sessionKey);
+    if (reusable) {
+      this.log("info", `\u590D\u7528\u4F1A\u8BDD source=${sourceId} room=${getTrtcString(trtc, "room_id")} user=${getTrtcString(trtc, "user_id")}`);
+      reusable.sourceIds.add(sourceId);
+      this.sourceSessionKeys.set(sourceId, sessionKey);
+      this.emitSnapshot(sourceId, this.snapshotFromSession(reusable));
+      void this.ensureConnected(reusable);
       return;
     }
-    this.log("info", `\u914D\u7F6E\u53D8\u66F4\uFF0C\u91CD\u5EFA\u4F1A\u8BDD source=${sourceId} room=${getTrtcString(trtc, "room_id")}`);
-    void this.disposeSession(existing);
-    const session = this.createSession(sourceId, trtc);
-    this.sessions.set(sourceId, session);
+    this.log("info", `\u65B0\u5EFA\u4F1A\u8BDD source=${sourceId} room=${getTrtcString(trtc, "room_id")} user=${getTrtcString(trtc, "user_id")}`);
+    const session = this.createSession(sourceId, trtc, aiDenoiser);
+    this.sessions.set(session.sessionKey, session);
+    this.sourceSessionKeys.set(sourceId, session.sessionKey);
     void this.ensureConnected(session);
   }
   /**
@@ -1158,13 +1172,12 @@ var TrtcSourceManager = class {
    * 该操作通常由 source.deleted 或会话重置触发。
    */
   removeSource(sourceId) {
-    const session = this.sessions.get(sourceId);
+    const session = this.getSession(sourceId);
     if (!session) {
       return;
     }
     this.log("info", `\u79FB\u9664\u4F1A\u8BDD source=${sourceId}`);
-    this.sessions.delete(sourceId);
-    void this.disposeSession(session);
+    this.unlinkSourceFromSession(sourceId, session);
     this.emitSnapshot(sourceId, {
       status: "idle"
     });
@@ -1174,6 +1187,7 @@ var TrtcSourceManager = class {
     this.log("info", `\u91CD\u7F6E\u5168\u90E8\u4F1A\u8BDD count=${this.sessions.size}`);
     const sessions = Array.from(this.sessions.values());
     this.sessions.clear();
+    this.sourceSessionKeys.clear();
     sessions.forEach((session) => {
       void this.disposeSession(session);
     });
@@ -1196,7 +1210,7 @@ var TrtcSourceManager = class {
     };
   }
   getSnapshot(sourceId) {
-    const session = this.sessions.get(sourceId);
+    const session = this.getSession(sourceId);
     if (!session) {
       return {
         status: "idle"
@@ -1211,7 +1225,7 @@ var TrtcSourceManager = class {
    * 检查指定 source 的 TRTC 会话是否曾收到过 REMOTE_VIDEO_AVAILABLE 事件。
    */
   hasRemoteVideoAvailable(sourceId) {
-    const session = this.sessions.get(sourceId);
+    const session = this.getSession(sourceId);
     return session?.hasEverReceivedRemoteVideo ?? false;
   }
   /**
@@ -1220,7 +1234,7 @@ var TrtcSourceManager = class {
    * - 若会话被销毁或超时，返回 false。
    */
   waitForRemoteVideoAvailable(sourceId, timeoutMs = 3e4) {
-    const session = this.sessions.get(sourceId);
+    const session = this.getSession(sourceId);
     if (!session) return Promise.resolve(false);
     if (session.hasEverReceivedRemoteVideo) return Promise.resolve(true);
     return new Promise((resolve) => {
@@ -1248,11 +1262,12 @@ var TrtcSourceManager = class {
    * - 应用全局音频策略（根据所有 view 的 muted 汇总）
    */
   async attachView(sourceId, viewId, container, muted) {
-    const session = this.sessions.get(sourceId);
+    const session = this.getSession(sourceId);
     if (!session) {
       throw new Error(`TRTC source session not found: ${sourceId}`);
     }
     session.views.set(viewId, {
+      sourceId,
       container,
       muted,
       startedVideoKeys: /* @__PURE__ */ new Set(),
@@ -1267,15 +1282,18 @@ var TrtcSourceManager = class {
     await this.applyAudioPolicy(session);
   }
   detachView(sourceId, viewId) {
-    const session = this.sessions.get(sourceId);
+    const session = this.getSession(sourceId);
     if (!session) {
       return;
     }
-    session.views.delete(viewId);
+    const binding = session.views.get(viewId);
+    if (binding?.sourceId === sourceId) {
+      session.views.delete(viewId);
+    }
     void this.applyAudioPolicy(session);
   }
   updateViewMuted(sourceId, viewId, muted) {
-    const session = this.sessions.get(sourceId);
+    const session = this.getSession(sourceId);
     if (!session) {
       return;
     }
@@ -1286,10 +1304,45 @@ var TrtcSourceManager = class {
     binding.muted = muted;
     void this.applyAudioPolicy(session);
   }
-  createSession(sourceId, trtc) {
+  unlinkSourceFromSession(sourceId, session) {
+    session.sourceIds.delete(sourceId);
+    this.sourceSessionKeys.delete(sourceId);
+    session.views.forEach((binding, viewId) => {
+      if (binding.sourceId === sourceId) {
+        session.views.delete(viewId);
+      }
+    });
+    if (session.sourceIds.size > 0) {
+      session.sourceId = session.sourceIds.values().next().value ?? session.sourceId;
+      void this.applyAudioPolicy(session);
+      return;
+    }
+    this.sessions.delete(session.sessionKey);
+    void this.disposeSession(session);
+  }
+  getSession(sourceId) {
+    const sessionKey = this.sourceSessionKeys.get(sourceId);
+    return sessionKey ? this.sessions.get(sessionKey) : void 0;
+  }
+  snapshotFromSession(session) {
+    return {
+      status: session.status,
+      error: session.error
+    };
+  }
+  emitSessionSnapshot(session, snapshot) {
+    session.sourceIds.forEach((sourceId) => this.emitSnapshot(sourceId, snapshot));
+  }
+  emitSessionTrtcEvent(session, type, rawType, payload) {
+    session.sourceIds.forEach((sourceId) => this.emitTrtcEvent(sourceId, type, rawType, payload));
+  }
+  createSession(sourceId, trtc, aiDenoiser) {
     return {
+      sessionKey: buildTrtcSessionKey(trtc, aiDenoiser),
       sourceId,
+      sourceIds: /* @__PURE__ */ new Set([sourceId]),
       trtc,
+      aiDenoiser,
       TRTC: null,
       client: null,
       connectPromise: null,
@@ -1315,7 +1368,7 @@ var TrtcSourceManager = class {
     }
     session.status = "connecting";
     session.error = void 0;
-    this.emitSnapshot(session.sourceId, {
+    this.emitSessionSnapshot(session, {
       status: session.status
     });
     session.connectPromise = (async () => {
@@ -1344,7 +1397,7 @@ var TrtcSourceManager = class {
         session.views.forEach((binding) => {
           void this.startRemoteVideoForBinding(client, event.userId, event.streamType, binding, remoteVideoKey);
         });
-        this.emitTrtcEvent(session.sourceId, "remote_video_available", TRTC.EVENT.REMOTE_VIDEO_AVAILABLE, event);
+        this.emitSessionTrtcEvent(session, "remote_video_available", TRTC.EVENT.REMOTE_VIDEO_AVAILABLE, event);
       };
       const onRemoteVideoUnavailable = (event) => {
         this.log("info", `\u8FDC\u7AEF\u89C6\u9891\u4E0D\u53EF\u7528 source=${session.sourceId} userId=${event.userId} streamType=${event.streamType}`);
@@ -1358,19 +1411,19 @@ var TrtcSourceManager = class {
           userId: event.userId,
           streamType: event.streamType
         }).catch(() => void 0);
-        this.emitTrtcEvent(session.sourceId, "remote_video_unavailable", TRTC.EVENT.REMOTE_VIDEO_UNAVAILABLE, event);
+        this.emitSessionTrtcEvent(session, "remote_video_unavailable", TRTC.EVENT.REMOTE_VIDEO_UNAVAILABLE, event);
       };
       const onRemoteAudioAvailable = (event) => {
         this.log("info", `\u8FDC\u7AEF\u97F3\u9891\u53EF\u7528 source=${session.sourceId} userId=${event.userId}`);
         session.remoteAudioUsers.add(event.userId);
         void this.applyAudioPolicy(session);
-        this.emitTrtcEvent(session.sourceId, "remote_audio_available", TRTC.EVENT.REMOTE_AUDIO_AVAILABLE, event);
+        this.emitSessionTrtcEvent(session, "remote_audio_available", TRTC.EVENT.REMOTE_AUDIO_AVAILABLE, event);
       };
       const onRemoteAudioUnavailable = (event) => {
         this.log("info", `\u8FDC\u7AEF\u97F3\u9891\u4E0D\u53EF\u7528 source=${session.sourceId} userId=${event.userId}`);
         session.remoteAudioUsers.delete(event.userId);
         void this.applyAudioPolicy(session);
-        this.emitTrtcEvent(session.sourceId, "remote_audio_unavailable", TRTC.EVENT.REMOTE_AUDIO_UNAVAILABLE, event);
+        this.emitSessionTrtcEvent(session, "remote_audio_unavailable", TRTC.EVENT.REMOTE_AUDIO_UNAVAILABLE, event);
       };
       session.onRemoteVideoAvailable = onRemoteVideoAvailable;
       session.onRemoteVideoUnavailable = onRemoteVideoUnavailable;
@@ -1395,7 +1448,8 @@ var TrtcSourceManager = class {
       session.status = "connected";
       session.error = void 0;
       this.log("info", `\u8FDB\u623F\u6210\u529F source=${session.sourceId} room=${roomId}`);
-      this.emitSnapshot(session.sourceId, {
+      await this.applyAIDenoiserPolicy(session, client, sdkAppId, userId, userSig);
+      this.emitSessionSnapshot(session, {
         status: session.status
       });
       await this.applyAudioPolicy(session);
@@ -1403,7 +1457,7 @@ var TrtcSourceManager = class {
       session.status = "error";
       session.error = error instanceof Error ? error.message : String(error);
       this.log("error", `\u8FDE\u63A5\u5931\u8D25 source=${session.sourceId} error=${session.error}`);
-      this.emitSnapshot(session.sourceId, {
+      this.emitSessionSnapshot(session, {
         status: session.status,
         error: session.error
       });
@@ -1480,6 +1534,25 @@ var TrtcSourceManager = class {
       await client.muteRemoteAudio(userId, false);
     }
   }
+  async applyAIDenoiserPolicy(session, client, sdkAppId, userId, userSig) {
+    const options = resolveAIDenoiserOptions(session.aiDenoiser ?? this.aiDenoiser);
+    if (!options.enabled) {
+      this.log("info", `TRTC AIDenoiser \u5DF2\u5173\u95ED source=${session.sourceId}`);
+      return;
+    }
+    try {
+      await client.startPlugin("AIDenoiser", {
+        sdkAppId,
+        userId,
+        userSig,
+        mode: getAIDenoiserModeValue(options.mode),
+        ...options.assetsPath ? { assetsPath: options.assetsPath } : {}
+      });
+      this.log("info", `TRTC AIDenoiser \u5DF2\u5F00\u542F source=${session.sourceId} mode=${options.mode}`);
+    } catch (error) {
+      this.log("warn", `TRTC AIDenoiser \u5F00\u542F\u5931\u8D25 source=${session.sourceId}`, error);
+    }
+  }
   /**
    * 销毁单个 source 会话：
    * 解绑事件、停止远端视频、退出房间并销毁客户端。
@@ -1561,6 +1634,25 @@ function isRuntimeTrtcSource(source) {
 function isSameTrtcConfig(a, b) {
   return a.app_id === b.app_id && a.user_id === b.user_id && a.user_sig === b.user_sig && a.room_id === b.room_id;
 }
+function buildTrtcSessionKey(trtc, aiDenoiser) {
+  const denoiser = resolveAIDenoiserOptions(aiDenoiser);
+  return JSON.stringify({
+    appId: trtc.app_id,
+    roomId: trtc.room_id,
+    userId: trtc.user_id,
+    userSig: trtc.user_sig,
+    aiDenoiser: {
+      enabled: denoiser.enabled,
+      mode: denoiser.mode,
+      assetsPath: denoiser.assetsPath
+    }
+  });
+}
+function isSameAIDenoiserOptions(a, b) {
+  const left = resolveAIDenoiserOptions(a);
+  const right = resolveAIDenoiserOptions(b);
+  return left.enabled === right.enabled && left.mode === right.mode && left.assetsPath === right.assetsPath;
+}
 function shouldUseStringRoomId(roomId) {
   if (!/^\d+$/.test(roomId)) {
     return true;
@@ -1572,6 +1664,26 @@ function getTrtcString(trtc, key) {
   const value = trtc[key];
   return typeof value === "string" ? value : "";
 }
+function resolveAIDenoiserOptions(options) {
+  if (options === false) {
+    return {
+      ...DEFAULT_DENOISER_OPTIONS,
+      enabled: false
+    };
+  }
+  if (options === true || options === void 0) {
+    return DEFAULT_DENOISER_OPTIONS;
+  }
+  return {
+    ...DEFAULT_DENOISER_OPTIONS,
+    ...options,
+    enabled: options.enabled ?? DEFAULT_DENOISER_OPTIONS.enabled,
+    mode: options.mode ?? DEFAULT_DENOISER_OPTIONS.mode
+  };
+}
+function getAIDenoiserModeValue(mode) {
+  return mode === "far_field_reduction" ? 1 : 0;
+}
 function buildRemoteVideoKey(userId, streamType) {
   return `${userId}::${streamType}`;
 }
@@ -2074,7 +2186,8 @@ var IviRuntimeCoordinator = class {
     };
     this.trtcSourceManager = new TrtcSourceManager(
       this.config.onLog,
-      (event) => this.emitTrtcEvent(event)
+      (event) => this.emitTrtcEvent(event),
+      this.config.trtcAIDenoiser
     );
     this.livekitSourceManager = new LivekitSourceManager(this.config.onLog);
     this.sessionHandler = new SessionEventHandler(this.sessionManager, {
@@ -3154,7 +3267,8 @@ function IVITrtcPlayer(props) {
     style,
     loadingFallback = null,
     errorFallback = null,
-    muted = false
+    muted = false,
+    trtcAIDenoiser
   } = props;
   const containerRef = useRef(null);
   const viewIdRef = useRef(`trtc-view-${Math.random().toString(36).slice(2, 10)}`);
@@ -3175,7 +3289,7 @@ function IVITrtcPlayer(props) {
     }
     let disposed = false;
     if (shouldManageSourceLifecycle) {
-      manager.upsertSource(resolvedSourceId, trtc);
+      manager.upsertSource(resolvedSourceId, trtc, trtcAIDenoiser);
     }
     const unsubscribe = manager.subscribe(resolvedSourceId, (snapshot) => {
       if (disposed) {
@@ -3206,7 +3320,8 @@ function IVITrtcPlayer(props) {
     trtc.app_id,
     trtc.room_id,
     trtc.user_id,
-    trtc.user_sig
+    trtc.user_sig,
+    trtcAIDenoiser
   ]);
   useEffect(() => {
     manager.updateViewMuted(resolvedSourceId, viewIdRef.current, muted);