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

package/README.md

@@ -155,12 +155,29 @@ const unlistenEvent = runtime.onEvent((event, state) => {
   console.log("event:", event.type, "runtime:", state.status);
 });
 
+const unlistenTrtcEvent = runtime.onTrtcEvent((event) => {
+  console.log("trtc event:", event.sourceId, event.type, event.payload);
+});
+
 // 业务结束时
 unlistenState();
 unlistenEvent();
+unlistenTrtcEvent();
 runtime.stop();
 ```
 
+也可以在创建 runtime 时通过 `onTrtcEvent` 配置项统一接收 TRTC SDK 原始事件：
+
+```ts
+const runtime = new IviRuntimeCoordinator(client, {
+  onTrtcEvent: (event) => {
+    // event.type: "remote_video_available" | "remote_video_unavailable" | "remote_audio_available" | "remote_audio_unavailable"
+    // event.rawType: TRTC SDK 原始事件名
+    // event.payload: TRTC SDK 原始事件 payload
+  }
+});
+```
+
 ### 3）发送用户文本并触发模型回复
 
 ```ts

package/dist/index.cjs

@@ -1108,8 +1108,9 @@ var ConversationManager = class {
 // src/runtime/managers/trtc-source-manager.ts
 var TAG = "[IVI-TRTC]";
 var TrtcSourceManager = class {
-  constructor(onLog) {
+  constructor(onLog, onTrtcEvent) {
     this.onLog = onLog;
+    this.onTrtcEvent = onTrtcEvent;
     this.sessions = /* @__PURE__ */ new Map();
     this.listeners = /* @__PURE__ */ new Map();
   }
@@ -1345,6 +1346,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);
       };
       const onRemoteVideoUnavailable = (event) => {
         this.log("info", `\u8FDC\u7AEF\u89C6\u9891\u4E0D\u53EF\u7528 source=${session.sourceId} userId=${event.userId} streamType=${event.streamType}`);
@@ -1358,16 +1360,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);
       };
       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);
       };
       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);
       };
       session.onRemoteVideoAvailable = onRemoteVideoAvailable;
       session.onRemoteVideoUnavailable = onRemoteVideoUnavailable;
@@ -1540,6 +1545,17 @@ var TrtcSourceManager = class {
       data: extra.length > 0 ? { message, extra } : { message }
     });
   }
+  emitTrtcEvent(sourceId, type, rawType, payload) {
+    const event = {
+      sourceId,
+      type,
+      rawType: String(rawType),
+      payload,
+      userId: payload.userId,
+      streamType: payload.streamType
+    };
+    this.onTrtcEvent?.(event);
+  }
 };
 function isRuntimeTrtcSource(source) {
   return source.status === "ready" && source.playback?.type === "trtc" && typeof source.playback.trtc === "object" && source.playback.trtc !== null;
@@ -2038,6 +2054,7 @@ var IviRuntimeCoordinator = class {
     this.conversationManager = new ConversationManager();
     this.stateListeners = /* @__PURE__ */ new Set();
     this.eventListeners = /* @__PURE__ */ new Set();
+    this.trtcEventListeners = /* @__PURE__ */ new Set();
     this.pendingUserTextToResponseFlows = /* @__PURE__ */ new Map();
     this.userTextFlowCounter = 0;
     this.waitingTracksListValidation = false;
@@ -2057,7 +2074,10 @@ var IviRuntimeCoordinator = class {
       syncStageOnSessionCreated: true,
       ...config
     };
-    this.trtcSourceManager = new TrtcSourceManager(this.config.onLog);
+    this.trtcSourceManager = new TrtcSourceManager(
+      this.config.onLog,
+      (event) => this.emitTrtcEvent(event)
+    );
     this.livekitSourceManager = new LivekitSourceManager(this.config.onLog);
     this.sessionHandler = new SessionEventHandler(this.sessionManager, {
       onSessionCreated: (event) => this.onSessionCreated(event),
@@ -2130,6 +2150,12 @@ var IviRuntimeCoordinator = class {
       this.eventListeners.delete(listener);
     };
   }
+  onTrtcEvent(listener) {
+    this.trtcEventListeners.add(listener);
+    return () => {
+      this.trtcEventListeners.delete(listener);
+    };
+  }
   emitLog(entry) {
     this.config.onLog?.(entry);
   }
@@ -2384,6 +2410,10 @@ var IviRuntimeCoordinator = class {
     this.progressUserTextToResponseFlows(event);
     this.eventListeners.forEach((listener) => listener(event, this.state));
   }
+  emitTrtcEvent(event) {
+    this.config.onTrtcEvent?.(event);
+    this.trtcEventListeners.forEach((listener) => listener(event));
+  }
   resetStoppedState() {
     this.rejectPendingUserTextToResponseFlows(
       new Error("Runtime stopped before user text to response flow completed.")