@xmaxai/web-sdk 1.0.7 → 1.0.8

package/dist/{chunk-EKOYOFES.cjs → chunk-24VPU65T.cjs}

@@ -205,7 +205,7 @@ var XmaxError = class _XmaxError extends Error {
 };
 
 // src/Foundation/Runtime/RuntimeInfo.ts
-var XMAX_SDK_VERSION = "1.0.7";
+var XMAX_SDK_VERSION = "1.0.8";
 var _RuntimeInfo = class _RuntimeInfo {
   /**
    * 序列化为接口传输使用的 snake_case 字段。
@@ -601,6 +601,7 @@ var RealtimeModel = /* @__PURE__ */ ((RealtimeModel2) => {
   RealtimeModel2["x2_0"] = "x2.0";
   RealtimeModel2["x2_0_trtc"] = "x2.0-trtc";
   RealtimeModel2["x2_1_preview"] = "x2.1-preview";
+  RealtimeModel2["x2_1_preview_1014"] = "x2.1-preview-1014";
   return RealtimeModel2;
 })(RealtimeModel || {});
 function isKnownModel(model) {
@@ -615,10 +616,12 @@ function modelDefaults(model) {
 var MODEL_DISPLAY_NAMES = {
   ["x2.0" /* x2_0 */]: "X2.0",
   ["x2.0-trtc" /* x2_0_trtc */]: "X2.1-preview-trtc",
-  ["x2.1-preview" /* x2_1_preview */]: "X2.1-preview-agora"
+  ["x2.1-preview" /* x2_1_preview */]: "X2.1-preview-agora",
+  ["x2.1-preview-1014" /* x2_1_preview_1014 */]: "X2.1-preview-1014"
 };
 var MODEL_BASE_URLS = {
-  ["x2.1-preview" /* x2_1_preview */]: "https://cloud.xmax.22duck.cn/open/api/v1"
+  ["x2.1-preview" /* x2_1_preview */]: "https://cloud.xmax.22duck.cn/open/api/v1",
+  ["x2.1-preview-1014" /* x2_1_preview_1014 */]: "https://dev.xmaxai.com/open/api/v1"
 };
 var RESOLUTION_BUCKETS = {
   ["x2.0" /* x2_0 */]: [],
@@ -629,12 +632,17 @@ var RESOLUTION_BUCKETS = {
   ["x2.1-preview" /* x2_1_preview */]: [
     { width: 1024, height: 1920 },
     { width: 1920, height: 1024 }
+  ],
+  ["x2.1-preview-1014" /* x2_1_preview_1014 */]: [
+    { width: 1024, height: 1920 },
+    { width: 1920, height: 1024 }
   ]
 };
 var MAXIMUM_INPUT_PIXELS = {
   ["x2.0" /* x2_0 */]: 128e4,
   ["x2.0-trtc" /* x2_0_trtc */]: 21e5,
-  ["x2.1-preview" /* x2_1_preview */]: 21e5
+  ["x2.1-preview" /* x2_1_preview */]: 21e5,
+  ["x2.1-preview-1014" /* x2_1_preview_1014 */]: 21e5
 };
 function modelDisplayName(model) {
   return isKnownModel(model) ? MODEL_DISPLAY_NAMES[model] : model;
@@ -666,7 +674,8 @@ function defaultCameraVideoFormat(model) {
 var MODEL_RTC_PROVIDERS = {
   ["x2.0" /* x2_0 */]: Object.freeze(["vertc" /* vertc */]),
   ["x2.0-trtc" /* x2_0_trtc */]: Object.freeze(["trtc" /* trtc */]),
-  ["x2.1-preview" /* x2_1_preview */]: Object.freeze(["agora" /* agora */])
+  ["x2.1-preview" /* x2_1_preview */]: Object.freeze(["agora" /* agora */]),
+  ["x2.1-preview-1014" /* x2_1_preview_1014 */]: Object.freeze(["agora" /* agora */])
 };
 function supportedRtcProviders(model) {
   return isKnownModel(model) ? MODEL_RTC_PROVIDERS[model] : CUSTOM_MODEL_RTC_PROVIDERS;
@@ -1353,15 +1362,6 @@ var AgoraVideoSender = class {
       }
       throw new XmaxError("RTC_ERROR" /* rtcError */, "Browser did not retain WebRTC video sender parameters");
     }
-    XmaxLogger.rtc.info(() => `Agora \u53D1\u9001\u53C2\u6570\u5B9E\u9A8C (Agora Sender Parameters)
-${JSON.stringify({
-      capture: { width: capture.width, height: capture.height, frameRate: capture.frameRate },
-      target: { width: config.width, height: config.height, frameRate: config.frameRate },
-      scaleResolutionDownBy: actual.scaleResolutionDownBy,
-      maxFramerate: actual.maxFramerate,
-      maxBitrateKbps: actual.maxBitrate / 1e3,
-      minimumBitrateApplied: false
-    }, null, 2)}`, 2 /* performance */);
   }
 };
 
@@ -4842,6 +4842,46 @@ var LocalVideoController = class {
   }
 };
 
+// src/Media/Video/ExternalVideoController.ts
+var ExternalVideoController = class {
+  constructor(onError) {
+    __publicField(this, "onError", onError);
+    __publicField(this, "track");
+    __publicField(this, "onEnded", () => {
+      this.onError(new XmaxError("MEDIA_ERROR" /* mediaError */, "External video source ended"));
+    });
+  }
+  get currentTrack() {
+    return this.track;
+  }
+  create(options, mediaService) {
+    if (this.track) throw new XmaxError("INVALID_CONFIGURATION" /* invalidConfiguration */, "Close the current external video first");
+    const { videoTrack, videoFormat } = options;
+    if (!videoTrack || videoTrack.kind !== "video" || videoTrack.readyState !== "live" || typeof videoTrack.clone !== "function") {
+      throw new XmaxError("INVALID_CONFIGURATION" /* invalidConfiguration */, "External video requires a live video MediaStreamTrack");
+    }
+    videoFormat.validate();
+    const size = mediaService.resolveModelInputSize(videoFormat);
+    const format = videoFormat.resized(size.width, size.height);
+    const nativeTrack = videoTrack.clone();
+    if (nativeTrack.readyState !== "live") {
+      nativeTrack.stop();
+      throw new XmaxError("MEDIA_ERROR" /* mediaError */, "External video source ended during setup");
+    }
+    const track = new RealtimeVideoTrack({ id: "external-video", videoFormat: format });
+    track.mediaStreamTrack = nativeTrack;
+    nativeTrack.addEventListener("ended", this.onEnded);
+    this.track = track;
+    return new RealtimeMediaStream({ id: "stream0" /* local */, videoTrack: track });
+  }
+  stop() {
+    const nativeTrack = _optionalChain([this, 'access', _449 => _449.track, 'optionalAccess', _450 => _450.mediaStreamTrack]);
+    this.track = void 0;
+    _optionalChain([nativeTrack, 'optionalAccess', _451 => _451.removeEventListener, 'call', _452 => _452("ended", this.onEnded)]);
+    _optionalChain([nativeTrack, 'optionalAccess', _453 => _453.stop, 'call', _454 => _454()]);
+  }
+};
+
 // src/Service/Realtime/RealtimeContext.ts
 var RealtimeContext = class {
   /**
@@ -4865,7 +4905,7 @@ var RealtimeContext = class {
     __publicField(this, "referencePath");
     this.referenceVideo = init.referenceVideo && Object.freeze({ ...init.referenceVideo });
     this.prompt = init.prompt.trim();
-    const normalizedReferencePath = _optionalChain([init, 'access', _449 => _449.referencePath, 'optionalAccess', _450 => _450.trim, 'call', _451 => _451()]);
+    const normalizedReferencePath = _optionalChain([init, 'access', _455 => _455.referencePath, 'optionalAccess', _456 => _456.trim, 'call', _457 => _457()]);
     this.referencePath = normalizedReferencePath || void 0;
   }
 };
@@ -5133,7 +5173,7 @@ var RealtimeSessionService = class _RealtimeSessionService {
           return;
         }
         _RealtimeSessionService.ensureSessionActive(session);
-        await _optionalChain([handlers, 'access', _452 => _452.onRefresh, 'optionalCall', _453 => _453(session)]);
+        await _optionalChain([handlers, 'access', _458 => _458.onRefresh, 'optionalCall', _459 => _459(session)]);
       } catch (error) {
         if (this.heartbeatVersion !== version) {
           return;
@@ -5346,7 +5386,7 @@ var RealtimeState = class {
    * @param other 待比较的状态。
    */
   equals(other) {
-    return this.connectionState === other.connectionState && this.sessionID === other.sessionID && this.taskID === other.taskID && _optionalChain([this, 'access', _454 => _454.reason, 'optionalAccess', _455 => _455.kind]) === _optionalChain([other, 'access', _456 => _456.reason, 'optionalAccess', _457 => _457.kind]);
+    return this.connectionState === other.connectionState && this.sessionID === other.sessionID && this.taskID === other.taskID && _optionalChain([this, 'access', _460 => _460.reason, 'optionalAccess', _461 => _461.kind]) === _optionalChain([other, 'access', _462 => _462.reason, 'optionalAccess', _463 => _463.kind]);
   }
 };
 
@@ -5396,8 +5436,8 @@ var RoomEvent = class _RoomEvent {
           ref_video_path: options.context.referenceVideo.path,
           sample_method: options.context.referenceVideo.sampleMethod,
           target_size: [
-            _nullishCoalesce(_optionalChain([options, 'access', _458 => _458.targetSize, 'optionalAccess', _459 => _459.width]), () => ( options.videoFormat.width)),
-            _nullishCoalesce(_optionalChain([options, 'access', _460 => _460.targetSize, 'optionalAccess', _461 => _461.height]), () => ( options.videoFormat.height))
+            _nullishCoalesce(_optionalChain([options, 'access', _464 => _464.targetSize, 'optionalAccess', _465 => _465.width]), () => ( options.videoFormat.width)),
+            _nullishCoalesce(_optionalChain([options, 'access', _466 => _466.targetSize, 'optionalAccess', _467 => _467.height]), () => ( options.videoFormat.height))
           ]
         }
       },
@@ -5469,6 +5509,7 @@ var RoomEvent = class _RoomEvent {
   static generationParameters(options) {
     return {
       model: "default",
+      face_replace: _nullishCoalesce(options.faceRestoration, () => ( false)),
       size: [options.videoFormat.width, options.videoFormat.height],
       target_size: options.targetSize ? [
         Math.round(options.targetSize.width),
@@ -5839,12 +5880,19 @@ var RoomController = class {
   /**
    * 发送生成开始信令。
    *
+   * @param options.faceRestoration 是否回贴原始人脸，默认 false。
+   * @param options.mirror 是否由后端镜像输入画面，默认 false。
+   * @param options.taskID 当前生成任务标识。
+   * @param options.videoFormat 模型生成使用的视频规格。
+   * @param options.targetSize 服务端生成后的回传尺寸，缺省使用生成尺寸。
+   * @param options.context 本次生成条件。
    * @throws 房间未就绪或信令发送失败时抛出错误。
    */
   startGeneration(options) {
     return this.send(
       RoomEvent.start({
         mirror: _nullishCoalesce(options.mirror, () => ( false)),
+        faceRestoration: _nullishCoalesce(options.faceRestoration, () => ( false)),
         userID: this.requireUserID(),
         taskID: options.taskID,
         videoFormat: options.videoFormat,
@@ -5856,11 +5904,17 @@ var RoomController = class {
   /**
    * 发送生成条件变更信令。
    *
+   * @param options.faceRestoration 是否回贴原始人脸，默认 false。
+   * @param options.taskID 当前生成任务标识。
+   * @param options.videoFormat 模型生成使用的视频规格。
+   * @param options.targetSize 服务端生成后的回传尺寸。
+   * @param options.context 本次生成条件。
    * @throws 房间未就绪或信令发送失败时抛出错误。
    */
   changeGenerationCondition(options) {
     return this.send(
       RoomEvent.changeCondition({
+        faceRestoration: _nullishCoalesce(options.faceRestoration, () => ( false)),
         userID: this.requireUserID(),
         taskID: options.taskID,
         videoFormat: options.videoFormat,
@@ -5942,7 +5996,7 @@ var RoomController = class {
     if (targetUserID && ownUserID && targetUserID !== ownUserID) {
       return;
     }
-    _optionalChain([this, 'access', _462 => _462.listener, 'optionalAccess', _463 => _463.onRoomMessage, 'call', _464 => _464(senderUserID, message)]);
+    _optionalChain([this, 'access', _468 => _468.listener, 'optionalAccess', _469 => _469.onRoomMessage, 'call', _470 => _470(senderUserID, message)]);
   }
   /**
    * 发送房间信令并输出日志。
@@ -6224,7 +6278,7 @@ var StreamController = class {
     this.roomController.setListener({
       onRoomMessage: (sender, message) => {
         this.handleNetworkVideoCompletion(sender, message);
-        _optionalChain([this, 'access', _465 => _465.roomListener, 'optionalAccess', _466 => _466.onRoomMessage, 'call', _467 => _467(sender, message)]);
+        _optionalChain([this, 'access', _471 => _471.roomListener, 'optionalAccess', _472 => _472.onRoomMessage, 'call', _473 => _473(sender, message)]);
       }
     });
     this.rtcManager.setEventListener({
@@ -6234,18 +6288,18 @@ var StreamController = class {
       onError: (error) => this.errorListener(error),
       onNetworkStatistics: (statistics) => {
         if (this.state.roomID) {
-          _optionalChain([this, 'access', _468 => _468.networkStatisticsListener, 'optionalCall', _469 => _469(statistics)]);
+          _optionalChain([this, 'access', _474 => _474.networkStatisticsListener, 'optionalCall', _475 => _475(statistics)]);
         }
       },
       onRemoteVideoStatistics: (statistics) => {
-        const userID = _optionalChain([this, 'access', _470 => _470.state, 'access', _471 => _471.activeRemoteStream, 'optionalAccess', _472 => _472.userID]);
-        _optionalChain([this, 'access', _473 => _473.remoteVideoStatisticsListener, 'optionalCall', _474 => _474(
+        const userID = _optionalChain([this, 'access', _476 => _476.state, 'access', _477 => _477.activeRemoteStream, 'optionalAccess', _478 => _478.userID]);
+        _optionalChain([this, 'access', _479 => _479.remoteVideoStatisticsListener, 'optionalCall', _480 => _480(
           userID ? statistics.find((item) => item.userID === userID) : void 0
         )]);
       },
       onLocalVideoStatistics: (statistics) => {
         if (this.state.localVideoPublished) {
-          _optionalChain([this, 'access', _475 => _475.localVideoStatisticsListener, 'optionalCall', _476 => _476(statistics)]);
+          _optionalChain([this, 'access', _481 => _481.localVideoStatisticsListener, 'optionalCall', _482 => _482(statistics)]);
         }
       },
       onCustomMessageReceived: (senderUserID, message) => {
@@ -6322,7 +6376,7 @@ var StreamController = class {
 \u2514\u2500 roomID: ${connection.roomID}, botID: ${_nullishCoalesce(connection.botID, () => ( "(\u672A\u8BBE\u7F6E)"))}`
     );
     if (publishLocalMedia) {
-      await _optionalChain([beforePublish, 'optionalCall', _477 => _477()]);
+      await _optionalChain([beforePublish, 'optionalCall', _483 => _483()]);
       ensureActive2();
       await this.publishLocalStream(includeLocalAudio);
     }
@@ -6394,6 +6448,7 @@ var StreamController = class {
       const sending = this.roomController.startGeneration({
         taskID,
         mirror: _nullishCoalesce(options.mirror, () => ( false)),
+        faceRestoration: _nullishCoalesce(options.faceRestoration, () => ( false)),
         videoFormat: options.videoFormat,
         targetSize: options.targetSize,
         context: options.context
@@ -6401,7 +6456,7 @@ var StreamController = class {
       const state2 = this.state;
       const sent = Promise.resolve(sending).then(async () => {
         if (this.state !== state2 || state2.generationTaskID !== taskID) return;
-        await _optionalChain([options, 'access', _478 => _478.onStartSent, 'optionalCall', _479 => _479()]);
+        await _optionalChain([options, 'access', _484 => _484.onStartSent, 'optionalCall', _485 => _485()]);
         if (this.state !== state2 || state2.generationTaskID !== taskID) return;
         for (const userID of state2.publishedRemoteUserIDs) {
           void this.handleRemoteVideoPublished(userID, true);
@@ -6454,6 +6509,7 @@ var StreamController = class {
     try {
       await this.roomController.changeGenerationCondition({
         taskID: options.taskID,
+        faceRestoration: _nullishCoalesce(options.faceRestoration, () => ( false)),
         videoFormat: options.videoFormat,
         targetSize: options.targetSize,
         context: options.context
@@ -6536,7 +6592,7 @@ var StreamController = class {
   deliverNetworkVideoCompletion() {
     const state2 = this.state;
     const completion = state2.networkVideoCompletion;
-    if (!_optionalChain([completion, 'optionalAccess', _480 => _480.finished]) || !completion.onFinish || completion.scheduled) {
+    if (!_optionalChain([completion, 'optionalAccess', _486 => _486.finished]) || !completion.onFinish || completion.scheduled) {
       return;
     }
     completion.scheduled = true;
@@ -6545,7 +6601,7 @@ var StreamController = class {
         return;
       }
       try {
-        void Promise.resolve(_optionalChain([completion, 'access', _481 => _481.onFinish, 'optionalCall', _482 => _482()])).catch(() => {
+        void Promise.resolve(_optionalChain([completion, 'access', _487 => _487.onFinish, 'optionalCall', _488 => _488()])).catch(() => {
         });
       } catch (e23) {
       }
@@ -6556,7 +6612,7 @@ var StreamController = class {
    */
   configureRoom(options) {
     const roomID = options.roomID.trim();
-    const botID = _nullishCoalesce(_optionalChain([options, 'access', _483 => _483.botID, 'optionalAccess', _484 => _484.trim, 'call', _485 => _485()]), () => ( ""));
+    const botID = _nullishCoalesce(_optionalChain([options, 'access', _489 => _489.botID, 'optionalAccess', _490 => _490.trim, 'call', _491 => _491()]), () => ( ""));
     if (!roomID) {
       throw new XmaxError(
         "INVALID_CONFIGURATION" /* invalidConfiguration */,
@@ -6639,7 +6695,7 @@ var StreamController = class {
       return;
     }
     this.state.subscribedRemoteUserIDs.delete(trimmedUserID);
-    if (_optionalChain([this, 'access', _486 => _486.state, 'access', _487 => _487.activeRemoteStream, 'optionalAccess', _488 => _488.userID]) === trimmedUserID) {
+    if (_optionalChain([this, 'access', _492 => _492.state, 'access', _493 => _493.activeRemoteStream, 'optionalAccess', _494 => _494.userID]) === trimmedUserID) {
       await this.unsubscribeRemoteAudio(trimmedUserID);
       this.state.activeRemoteStream = void 0;
       this.clearRemoteStream();
@@ -6829,7 +6885,7 @@ var StreamController = class {
    */
   resolveGenerationStart(taskID) {
     const waiter = this.state.generationWaiter;
-    if (this.state.generationTaskID !== taskID || _optionalChain([waiter, 'optionalAccess', _489 => _489.taskID]) !== taskID) {
+    if (this.state.generationTaskID !== taskID || _optionalChain([waiter, 'optionalAccess', _495 => _495.taskID]) !== taskID) {
       return;
     }
     this.state.generationWaiter = void 0;
@@ -6841,7 +6897,7 @@ var StreamController = class {
    */
   rejectGenerationStart(taskID, error) {
     const waiter = this.state.generationWaiter;
-    if (this.state.generationTaskID !== taskID || _optionalChain([waiter, 'optionalAccess', _490 => _490.taskID]) !== taskID) {
+    if (this.state.generationTaskID !== taskID || _optionalChain([waiter, 'optionalAccess', _496 => _496.taskID]) !== taskID) {
       return;
     }
     this.state.generationWaiter = void 0;
@@ -6852,7 +6908,7 @@ var StreamController = class {
    * 通知渲染层清理远端生成流；失败仅记录日志。
    */
   clearRemoteStream() {
-    _optionalChain([this, 'access', _491 => _491.remoteVideoStatisticsListener, 'optionalCall', _492 => _492(void 0)]);
+    _optionalChain([this, 'access', _497 => _497.remoteVideoStatisticsListener, 'optionalCall', _498 => _498(void 0)]);
     try {
       this.remoteStreamListener(null);
     } catch (error) {
@@ -7316,7 +7372,7 @@ var RealtimeCoordinator = class _RealtimeCoordinator {
         }
         throw _RealtimeCoordinator.cancelledError();
       }
-      const terminationTask = await _asyncNullishCoalesce(await _asyncNullishCoalesce(operation.terminationTask, async () => ( _optionalChain([this, 'access', _493 => _493.termination, 'optionalAccess', _494 => _494.task]))), async () => ( await this.requestTermination(
+      const terminationTask = await _asyncNullishCoalesce(await _asyncNullishCoalesce(operation.terminationTask, async () => ( _optionalChain([this, 'access', _499 => _499.termination, 'optionalAccess', _500 => _500.task]))), async () => ( await this.requestTermination(
         _nullishCoalesce(operation.lease.failureScope, () => ( 0)) /* connection */,
         void 0,
         RealtimeReason.normal,
@@ -7445,7 +7501,7 @@ var RealtimeCoordinator = class _RealtimeCoordinator {
    * 结束指定操作，释放操作准入场。
    */
   finish(operation) {
-    if (_optionalChain([this, 'access', _495 => _495.activeOperation, 'optionalAccess', _496 => _496.id]) === operation.id) {
+    if (_optionalChain([this, 'access', _501 => _501.activeOperation, 'optionalAccess', _502 => _502.id]) === operation.id) {
       this.activeOperation = void 0;
     }
   }
@@ -7457,7 +7513,7 @@ var RealtimeCoordinator = class _RealtimeCoordinator {
       return;
     }
     this.state = nextState;
-    _optionalChain([this, 'access', _497 => _497.stateListener, 'optionalCall', _498 => _498(nextState)]);
+    _optionalChain([this, 'access', _503 => _503.stateListener, 'optionalCall', _504 => _504(nextState)]);
   }
   /**
    * 构造统一的操作取消错误。
@@ -7594,7 +7650,7 @@ var RealtimeLaunchTimer = class {
    */
   notify() {
     try {
-      void Promise.resolve(_optionalChain([this, 'access', _499 => _499.listener, 'optionalCall', _500 => _500(this.snapshot)])).catch(() => {
+      void Promise.resolve(_optionalChain([this, 'access', _505 => _505.listener, 'optionalCall', _506 => _506(this.snapshot)])).catch(() => {
       });
     } catch (e26) {
     }
@@ -7626,7 +7682,7 @@ var XmaxRealtimeConnectionManager = class {
    * 当前活动会话标识；尚未连接或清理完成后为空。
    */
   get currentSessionID() {
-    return _optionalChain([this, 'access', _501 => _501.activeSession, 'optionalAccess', _502 => _502.id]);
+    return _optionalChain([this, 'access', _507 => _507.activeSession, 'optionalAccess', _508 => _508.id]);
   }
   /**
    * 未配置 API 服务时在连接操作开始前报错，不影响本地预览。
@@ -7638,6 +7694,16 @@ var XmaxRealtimeConnectionManager = class {
    * 创建会话、配置编码、进房并发布本地媒体，启动心跳后返回远端占位流。
    * 进房结束即记录连接耗时；可选 beforePublish 检查阻塞发布，计入连接耗时；
    * 发布本地流单独计时。
+   * @param options.localTrack 当前本地媒体轨道。
+   * @param options.remoteVideoFormat 原始生成及远端画面规格，缺省使用本地轨道规格。
+   * @param options.localVideoFormat 发布前实际应用的上行编码格式；与原始生成及远端格式分开。
+   * @param options.onVideoEncoderConfigured 上行编码配置成功后的回调。
+   * @param options.model 创建业务会话使用的模型名称。
+   * @param options.includeLocalAudio 是否发布本地音频。
+   * @param options.ensureCurrent 校验当前操作仍有效。
+   * @param options.onPublished 本地发布完成后的回调。
+   * @param options.beforePublish 发布前的可选异步检查。
+   * @param options.publishLocalMedia 是否发布本地媒体，默认 true；网络视频源传 false。
    * @throws 会话、进房、发布失败或操作租约已失效时抛出错误，由上层统一清理。
    */
   async connect(options) {
@@ -7671,7 +7737,7 @@ var XmaxRealtimeConnectionManager = class {
     if (publishLocalMedia) {
       await streamController.updateUplinkVideoFormat(videoFormat);
       options.ensureCurrent();
-      _optionalChain([options, 'access', _503 => _503.onVideoEncoderConfigured, 'optionalCall', _504 => _504()]);
+      _optionalChain([options, 'access', _509 => _509.onVideoEncoderConfigured, 'optionalCall', _510 => _510()]);
     }
     options.ensureCurrent();
     let completePublish;
@@ -7679,13 +7745,13 @@ var XmaxRealtimeConnectionManager = class {
       options.ensureCurrent();
     }, async () => {
       options.ensureCurrent();
-      await _optionalChain([options, 'access', _505 => _505.beforePublish, 'optionalCall', _506 => _506()]);
+      await _optionalChain([options, 'access', _511 => _511.beforePublish, 'optionalCall', _512 => _512()]);
       completeConnection();
       completePublish = this.dependencies.timing.startPublish();
     }, publishLocalMedia);
     options.ensureCurrent();
     completeConnection();
-    _optionalChain([completePublish, 'optionalCall', _507 => _507()]);
+    _optionalChain([completePublish, 'optionalCall', _513 => _513()]);
     options.onPublished();
     sessionService.startHeartbeat(session.id, {
       onFailure: (sessionID, error) => {
@@ -7708,24 +7774,24 @@ var XmaxRealtimeConnectionManager = class {
    * 更新已绑定远端视图的插帧配置；传 undefined 停用插帧。
    */
   setFrameInterpolation(options) {
-    _optionalChain([this, 'access', _508 => _508.remoteTarget, 'optionalAccess', _509 => _509.setFrameInterpolation, 'optionalCall', _510 => _510(options)]);
+    _optionalChain([this, 'access', _514 => _514.remoteTarget, 'optionalAccess', _515 => _515.setFrameInterpolation, 'optionalCall', _516 => _516(options)]);
   }
   /**
    * 清空远端视图的媒体流，保留轨道与视图绑定以供统一清理。
    */
   clearRemoteMedia() {
-    _optionalChain([this, 'access', _511 => _511.remoteTarget, 'optionalAccess', _512 => _512.setMediaStream, 'call', _513 => _513(null)]);
+    _optionalChain([this, 'access', _517 => _517.remoteTarget, 'optionalAccess', _518 => _518.setMediaStream, 'call', _519 => _519(null)]);
   }
   /**
    * 停止会话心跳；未配置会话服务时不执行操作。
    */
   stopHeartbeat() {
     this.refreshVersion++;
-    _optionalChain([this, 'access', _514 => _514.credentialController, 'optionalAccess', _515 => _515.abort, 'call', _516 => _516()]);
+    _optionalChain([this, 'access', _520 => _520.credentialController, 'optionalAccess', _521 => _521.abort, 'call', _522 => _522()]);
     this.credentialController = void 0;
     this.credentialRefresh = void 0;
     this.credentialApplication = Promise.resolve();
-    _optionalChain([this, 'access', _517 => _517.dependencies, 'access', _518 => _518.sessionService, 'optionalAccess', _519 => _519.stopHeartbeat, 'call', _520 => _520()]);
+    _optionalChain([this, 'access', _523 => _523.dependencies, 'access', _524 => _524.sessionService, 'optionalAccess', _525 => _525.stopHeartbeat, 'call', _526 => _526()]);
   }
   /**
    * RTC Token 过期时复用会话心跳获取新凭据，并合并同一实例的并发请求。
@@ -7733,14 +7799,14 @@ var XmaxRealtimeConnectionManager = class {
   async refreshCredentials() {
     if (this.credentialRefresh) return this.credentialRefresh;
     const current = this.activeSession;
-    if (!_optionalChain([current, 'optionalAccess', _521 => _521.connection]) || current.connection.provider === "trtc" /* trtc */) return;
+    if (!_optionalChain([current, 'optionalAccess', _527 => _527.connection]) || current.connection.provider === "trtc" /* trtc */) return;
     const version = this.refreshVersion;
     const operation = (async () => {
       try {
         const session = await this.requireSessionService().heartbeatSession(current.id);
         await this.handleSessionRefresh(session, version, true);
       } catch (error) {
-        if (version === this.refreshVersion && _optionalChain([this, 'access', _522 => _522.activeSession, 'optionalAccess', _523 => _523.id]) === current.id) {
+        if (version === this.refreshVersion && _optionalChain([this, 'access', _528 => _528.activeSession, 'optionalAccess', _529 => _529.id]) === current.id) {
           this.dependencies.onHeartbeatFailure(current.id, XmaxError.from(error));
         }
       }
@@ -7757,7 +7823,7 @@ var XmaxRealtimeConnectionManager = class {
    */
   async waitUntilRemoteTrackReady(timeoutMs, signal) {
     if (signal.aborted) throw RealtimeCoordinator.cancelledError();
-    const mediaTrack = _optionalChain([this, 'access', _524 => _524.activeRemoteTrack, 'optionalAccess', _525 => _525.mediaStreamTrack]);
+    const mediaTrack = _optionalChain([this, 'access', _530 => _530.activeRemoteTrack, 'optionalAccess', _531 => _531.mediaStreamTrack]);
     if (!mediaTrack || !mediaTrack.muted) return;
     await new Promise((resolve, reject) => {
       const cleanup = () => {
@@ -7794,7 +7860,7 @@ var XmaxRealtimeConnectionManager = class {
       if (track) {
         track.mediaStreamTrack = void 0;
       }
-      _optionalChain([this, 'access', _526 => _526.remoteTarget, 'optionalAccess', _527 => _527.setMediaStream, 'call', _528 => _528(null)]);
+      _optionalChain([this, 'access', _532 => _532.remoteTarget, 'optionalAccess', _533 => _533.setMediaStream, 'call', _534 => _534(null)]);
       return;
     }
     if (!track) {
@@ -7804,7 +7870,7 @@ var XmaxRealtimeConnectionManager = class {
       );
     }
     track.mediaStreamTrack = binding.videoTrack;
-    _optionalChain([this, 'access', _529 => _529.remoteTarget, 'optionalAccess', _530 => _530.setMediaStream, 'call', _531 => _531(new MediaStream([binding.videoTrack]))]);
+    _optionalChain([this, 'access', _535 => _535.remoteTarget, 'optionalAccess', _536 => _536.setMediaStream, 'call', _537 => _537(new MediaStream([binding.videoTrack]))]);
   }
   /**
    * 为远端轨道注册渲染绑定：attach 时挂流占位，媒体轨到达后送入画面。
@@ -7817,7 +7883,7 @@ var XmaxRealtimeConnectionManager = class {
         }
       },
       attachHandler: (view) => {
-        _optionalChain([this, 'access', _532 => _532.remoteTarget, 'optionalAccess', _533 => _533.setFrameInterpolation, 'optionalCall', _534 => _534(void 0)]);
+        _optionalChain([this, 'access', _538 => _538.remoteTarget, 'optionalAccess', _539 => _539.setFrameInterpolation, 'optionalCall', _540 => _540(void 0)]);
         view.isMirrored = false;
         this.remoteTarget = view;
         this.dependencies.onRenderAttached();
@@ -7829,7 +7895,7 @@ var XmaxRealtimeConnectionManager = class {
           this.dependencies.onRenderDetached();
           this.remoteTarget = void 0;
         }
-        _optionalChain([view, 'access', _535 => _535.setFrameInterpolation, 'optionalCall', _536 => _536(void 0)]);
+        _optionalChain([view, 'access', _541 => _541.setFrameInterpolation, 'optionalCall', _542 => _542(void 0)]);
         view.setMediaStream(null);
       }
     });
@@ -7879,7 +7945,7 @@ var XmaxRealtimeConnectionManager = class {
       return;
     }
     if (next.provider !== "trtc" /* trtc */ && (force || !previous || previous.provider === "trtc" /* trtc */ || next.roomToken !== previous.roomToken)) {
-      await this.dependencies.streamController.updateCredentials(next, _optionalChain([this, 'access', _537 => _537.credentialController, 'optionalAccess', _538 => _538.signal]));
+      await this.dependencies.streamController.updateCredentials(next, _optionalChain([this, 'access', _543 => _543.credentialController, 'optionalAccess', _544 => _544.signal]));
       if (version !== this.refreshVersion || this.activeSession !== current) return;
     }
     this.activeSession = new RealtimeSession({
@@ -7894,7 +7960,7 @@ var XmaxRealtimeConnectionManager = class {
    * 尽力清理全部连接资源，即使退房失败也关闭服务端会话。
    */
   async disconnect() {
-    const sessionID = _optionalChain([this, 'access', _539 => _539.activeSession, 'optionalAccess', _540 => _540.id]);
+    const sessionID = _optionalChain([this, 'access', _545 => _545.activeSession, 'optionalAccess', _546 => _546.id]);
     this.stopHeartbeat();
     this.clearRemoteMedia();
     try {
@@ -7966,6 +8032,15 @@ var XmaxRealtimeGenerationManager = class _XmaxRealtimeGenerationManager {
   /**
    * 发送生成指令并等待确认、远端就绪和音频激活，成功后返回任务标识。
    * 条件上下文在生成确认后缓存；启动失败时尽力停止本次任务并保留原始错误。
+   * @param options.videoFormat 模型生成使用的视频规格。
+   * @param options.targetSize 服务端生成后的回传尺寸，缺省使用生成尺寸。
+   * @param options.context 生成条件，缺省复用最近缓存的上下文。
+   * @param options.faceRestoration 是否回贴原始人脸，默认 false。
+   * @param options.mirror 是否由后端水平翻转输入，默认 false；仅用于 start 信令。
+   * @param options.signal 取消本次生成启动的信号。
+   * @param options.ensureCurrent 校验当前操作仍有效。
+   * @param options.waitUntilRemoteReady 等待远端生成流就绪。
+   * @param options.onStartSent start 信令发送成功后的可选异步回调。
    */
   async start(options) {
     const context = this.validateContext(options.context);
@@ -7979,6 +8054,7 @@ var XmaxRealtimeGenerationManager = class _XmaxRealtimeGenerationManager {
         context,
         ...options.targetSize && { targetSize: options.targetSize },
         mirror: _nullishCoalesce(options.mirror, () => ( false)),
+        faceRestoration: _nullishCoalesce(options.faceRestoration, () => ( false)),
         ...options.onStartSent && { onStartSent: options.onStartSent }
       });
       await this.awaitConfirmation(confirmation, options.signal);
@@ -7996,6 +8072,11 @@ var XmaxRealtimeGenerationManager = class _XmaxRealtimeGenerationManager {
   }
   /**
    * 更新活动任务的生成条件；信令发送成功后才覆盖缓存，无任务或上下文时抛错。
+   * @param taskID 当前活动任务标识。
+   * @param options.videoFormat 模型生成使用的视频规格。
+   * @param options.targetSize 服务端生成后的回传尺寸。
+   * @param options.context 生成条件，缺省复用最近缓存的上下文。
+   * @param options.faceRestoration 是否回贴原始人脸，默认 false。
    */
   async update(taskID, options) {
     const context = _nullishCoalesce(options.context, () => ( this.currentContext));
@@ -8006,6 +8087,7 @@ var XmaxRealtimeGenerationManager = class _XmaxRealtimeGenerationManager {
       taskID,
       videoFormat: options.videoFormat,
       context,
+      faceRestoration: _nullishCoalesce(options.faceRestoration, () => ( false)),
       ...options.targetSize && { targetSize: options.targetSize }
     });
     if (this.activeTaskID !== taskID) throw RealtimeCoordinator.cancelledError();
@@ -8032,7 +8114,7 @@ var XmaxRealtimeGenerationManager = class _XmaxRealtimeGenerationManager {
     try {
       await completion;
     } finally {
-      if (_optionalChain([this, 'access', _541 => _541.pendingStop, 'optionalAccess', _542 => _542.completion]) === completion) this.pendingStop = void 0;
+      if (_optionalChain([this, 'access', _547 => _547.pendingStop, 'optionalAccess', _548 => _548.completion]) === completion) this.pendingStop = void 0;
     }
   }
   /**
@@ -8117,6 +8199,9 @@ var XmaxRealtimeManager = class _XmaxRealtimeManager {
     __publicField(this, "localVideoController", new LocalVideoController((error) => {
       void this.coordinator.terminateWithError(error, 0 /* connection */);
     }));
+    __publicField(this, "externalVideoController", new ExternalVideoController((error) => {
+      void this.coordinator.terminateWithError(error, 1 /* all */);
+    }));
     __publicField(this, "rtcManager");
     /**
      * 启动计时与首帧通知
@@ -8159,19 +8244,19 @@ var XmaxRealtimeManager = class _XmaxRealtimeManager {
     this.options = options;
     this.mediaService = new MediaService(options.model);
     this.interpolationRequested = options.isFrameInterpolationEnabled;
-    this.supportsInterpolation = _nullishCoalesce(_optionalChain([dependencies, 'optionalAccess', _543 => _543.supportsFrameInterpolation]), () => ( (async (size) => await frameInterpolationAdapter(size) !== null)));
+    this.supportsInterpolation = _nullishCoalesce(_optionalChain([dependencies, 'optionalAccess', _549 => _549.supportsFrameInterpolation]), () => ( (async (size) => await frameInterpolationAdapter(size) !== null)));
     this.errorHandler = new RealtimeErrorHandler();
-    const rtcManager = _nullishCoalesce(_optionalChain([dependencies, 'optionalAccess', _544 => _544.rtcManager]), () => ( createRtcManager(options.provider, _nullishCoalesce(_optionalChain([dependencies, 'optionalAccess', _545 => _545.environment]), () => ( "china")) /* china */)));
+    const rtcManager = _nullishCoalesce(_optionalChain([dependencies, 'optionalAccess', _550 => _550.rtcManager]), () => ( createRtcManager(options.provider, _nullishCoalesce(_optionalChain([dependencies, 'optionalAccess', _551 => _551.environment]), () => ( "china")) /* china */)));
     this.rtcManager = rtcManager;
-    this.cameraController = _nullishCoalesce(_optionalChain([dependencies, 'optionalAccess', _546 => _546.cameraController]), () => ( new CameraController({
+    this.cameraController = _nullishCoalesce(_optionalChain([dependencies, 'optionalAccess', _552 => _552.cameraController]), () => ( new CameraController({
       rtcManager,
       mediaService: this.mediaService,
       errorListener: (error) => {
         void this.errorHandler.report(error);
       }
     })));
-    const sessionService = _nullishCoalesce(_optionalChain([dependencies, 'optionalAccess', _547 => _547.sessionService]), () => ( (_optionalChain([dependencies, 'optionalAccess', _548 => _548.apiService]) ? new RealtimeSessionService({ apiService: dependencies.apiService, provider: options.provider }) : void 0)));
-    this.streamController = _nullishCoalesce(_optionalChain([dependencies, 'optionalAccess', _549 => _549.streamController]), () => ( new StreamController({
+    const sessionService = _nullishCoalesce(_optionalChain([dependencies, 'optionalAccess', _553 => _553.sessionService]), () => ( (_optionalChain([dependencies, 'optionalAccess', _554 => _554.apiService]) ? new RealtimeSessionService({ apiService: dependencies.apiService, provider: options.provider }) : void 0)));
+    this.streamController = _nullishCoalesce(_optionalChain([dependencies, 'optionalAccess', _555 => _555.streamController]), () => ( new StreamController({
       rtcManager,
       onCredentialsRequired: () => {
         void this.connectionManager.refreshCredentials();
@@ -8193,7 +8278,7 @@ var XmaxRealtimeManager = class _XmaxRealtimeManager {
       onHeartbeatFailure: (sessionID, error) => {
         void this.handleHeartbeatFailure(sessionID, error);
       },
-      onFrameDisplayed: () => _optionalChain([this, 'access', _550 => _550.remoteFrameDisplayHandler, 'optionalCall', _551 => _551()]),
+      onFrameDisplayed: () => _optionalChain([this, 'access', _556 => _556.remoteFrameDisplayHandler, 'optionalCall', _557 => _557()]),
       onRenderAttached: () => this.applyRemoteInterpolation(),
       onRenderDetached: () => {
         this.interpolationRevision++;
@@ -8211,7 +8296,7 @@ var XmaxRealtimeManager = class _XmaxRealtimeManager {
           throw new XmaxError("CANCELLED" /* cancelled */, "Adaptive video format update was cancelled");
         }
         await this.coordinator.run("configuration" /* configuration */, void 0, async (token) => {
-          const track = _nullishCoalesce(this.localVideoController.currentTrack, () => ( this.cameraController.currentTrack));
+          const track = this.currentUplinkTrack;
           const state2 = track && this.qualityStates.get(track);
           if (!track || !state2) throw new XmaxError("INVALID_CONFIGURATION" /* invalidConfiguration */, "Adaptive video baseline is unavailable");
           const format = qualityVideoFormat(state2.baseline, change.to);
@@ -8220,7 +8305,7 @@ var XmaxRealtimeManager = class _XmaxRealtimeManager {
           _nullishCoalesce(this.generationVideoFormat, () => ( (this.generationVideoFormat = state2.baseline)));
           track.updateVideoFormat(format);
           state2.level = change.to;
-          _optionalChain([this, 'access', _552 => _552.qualityHistory, 'optionalAccess', _553 => _553.write, 'call', _554 => _554("uplink", change.to)]);
+          _optionalChain([this, 'access', _558 => _558.qualityHistory, 'optionalAccess', _559 => _559.write, 'call', _560 => _560("uplink", change.to)]);
         });
       });
       this.downlinkQualityController = new QualityController(async (change, signal) => {
@@ -8266,7 +8351,7 @@ var XmaxRealtimeManager = class _XmaxRealtimeManager {
    */
   async setFrameInterpolationEnabled(enabled) {
     await this.coordinator.run("configuration" /* configuration */, void 0, async (token) => {
-      const format = _nullishCoalesce(_nullishCoalesce(_optionalChain([this, 'access', _555 => _555.downlinkQualityState, 'optionalAccess', _556 => _556.size]), () => ( this.generationVideoFormat)), () => ( _optionalChain([this, 'access', _557 => _557.currentLocalTrack, 'optionalAccess', _558 => _558.videoFormat])));
+      const format = _nullishCoalesce(_nullishCoalesce(_optionalChain([this, 'access', _561 => _561.downlinkQualityState, 'optionalAccess', _562 => _562.size]), () => ( this.generationVideoFormat)), () => ( _optionalChain([this, 'access', _563 => _563.currentLocalTrack, 'optionalAccess', _564 => _564.videoFormat])));
       const size = format && enabled ? this.mediaService.resolveFrameInterpolationSize(format) : void 0;
       if (enabled && !await this.checkInterpolationSupport(size, token)) {
         token.ensureCurrent();
@@ -8298,7 +8383,7 @@ var XmaxRealtimeManager = class _XmaxRealtimeManager {
     const state2 = this.downlinkQualityState;
     const ensureActive2 = () => {
       token.ensureCurrent();
-      if (_optionalChain([signal, 'optionalAccess', _559 => _559.aborted]) || !state2 || state2 !== this.downlinkQualityState || this.currentState.connectionState !== "Generating" /* generating */ || this.currentState.taskID !== state2.taskID) {
+      if (_optionalChain([signal, 'optionalAccess', _565 => _565.aborted]) || !state2 || state2 !== this.downlinkQualityState || this.currentState.connectionState !== "Generating" /* generating */ || this.currentState.taskID !== state2.taskID) {
         throw new XmaxError("CANCELLED" /* cancelled */, "Target size update was cancelled");
       }
     };
@@ -8309,7 +8394,7 @@ var XmaxRealtimeManager = class _XmaxRealtimeManager {
     ensureActive2();
     state2.level = level;
     state2.size = size;
-    _optionalChain([this, 'access', _560 => _560.qualityHistory, 'optionalAccess', _561 => _561.write, 'call', _562 => _562("downlink", level)]);
+    _optionalChain([this, 'access', _566 => _566.qualityHistory, 'optionalAccess', _567 => _567.write, 'call', _568 => _568("downlink", level)]);
     if (this.interpolationRequested) {
       this.interpolationSize = size;
       this.applyRemoteInterpolation();
@@ -8428,7 +8513,7 @@ var XmaxRealtimeManager = class _XmaxRealtimeManager {
    */
   notifyRemoteVideoStatistics() {
     try {
-      void Promise.resolve(_optionalChain([this, 'access', _563 => _563.remoteVideoStatisticsListener, 'optionalCall', _564 => _564(this.remoteVideoStatistics)])).catch(() => {
+      void Promise.resolve(_optionalChain([this, 'access', _569 => _569.remoteVideoStatisticsListener, 'optionalCall', _570 => _570(this.remoteVideoStatistics)])).catch(() => {
       });
     } catch (e27) {
     }
@@ -8445,7 +8530,7 @@ var XmaxRealtimeManager = class _XmaxRealtimeManager {
    */
   notifyNetworkStatistics() {
     try {
-      void Promise.resolve(_optionalChain([this, 'access', _565 => _565.networkStatisticsListener, 'optionalCall', _566 => _566(this.networkStatistics)])).catch(() => {
+      void Promise.resolve(_optionalChain([this, 'access', _571 => _571.networkStatisticsListener, 'optionalCall', _572 => _572(this.networkStatistics)])).catch(() => {
       });
     } catch (e28) {
     }
@@ -8465,7 +8550,7 @@ var XmaxRealtimeManager = class _XmaxRealtimeManager {
    */
   notifyLocalVideoStatistics() {
     try {
-      void Promise.resolve(_optionalChain([this, 'access', _567 => _567.localVideoStatisticsListener, 'optionalCall', _568 => _568(this.localVideoStatistics)])).catch(() => {
+      void Promise.resolve(_optionalChain([this, 'access', _573 => _573.localVideoStatisticsListener, 'optionalCall', _574 => _574(this.localVideoStatistics)])).catch(() => {
       });
     } catch (e29) {
     }
@@ -8474,8 +8559,8 @@ var XmaxRealtimeManager = class _XmaxRealtimeManager {
    * 停止接收媒体统计并清空各类快照，仅对曾有数据的统计发出清空通知。
    */
   clearVideoStatistics() {
-    _optionalChain([this, 'access', _569 => _569.qualityController, 'optionalAccess', _570 => _570.stop, 'call', _571 => _571()]);
-    _optionalChain([this, 'access', _572 => _572.downlinkQualityController, 'optionalAccess', _573 => _573.stop, 'call', _574 => _574()]);
+    _optionalChain([this, 'access', _575 => _575.qualityController, 'optionalAccess', _576 => _576.stop, 'call', _577 => _577()]);
+    _optionalChain([this, 'access', _578 => _578.downlinkQualityController, 'optionalAccess', _579 => _579.stop, 'call', _580 => _580()]);
     this.downlinkQualityState = void 0;
     this.adaptiveQualityRevision++;
     this.acceptsVideoStatistics = false;
@@ -8523,6 +8608,9 @@ var XmaxRealtimeManager = class _XmaxRealtimeManager {
    *
    * 将返回的轨道绑定到预览视图；收到有效帧且视图已绑定后进入 `ready`。
    *
+   * @param options.videoFormat 旋转后的目标规格，尺寸按模型规则解析。
+   * @param options.position 前置或后置摄像头。
+   * @param options.useMicrophone 是否采集并发布麦克风音频。
    * @param options.enableFrameValidation 是否在发布前等待相机预热（固定 200ms），默认 true；false 跳过等待。
    * @param options.rotation 输入帧顺时针旋转角度，默认 0；videoFormat 为旋转后的规格，目前仅 Agora 支持非零角度。
    * @returns 包含本地相机视频轨道的媒体流。
@@ -8544,7 +8632,7 @@ var XmaxRealtimeManager = class _XmaxRealtimeManager {
         const completeCamera = this.launchTimer.startCamera();
         this.clearVideoStatistics();
         this.disposePermissionWatch();
-        const permissionWatch = await watchMediaPermissionPrompt(_nullishCoalesce(_optionalChain([options, 'optionalAccess', _575 => _575.useMicrophone]), () => ( false)));
+        const permissionWatch = await watchMediaPermissionPrompt(_nullishCoalesce(_optionalChain([options, 'optionalAccess', _581 => _581.useMicrophone]), () => ( false)));
         if (permissionWatch) {
           const completePermission = this.launchTimer.startPermission();
           void permissionWatch.decided.then(() => completePermission()).catch(() => {
@@ -8561,7 +8649,7 @@ var XmaxRealtimeManager = class _XmaxRealtimeManager {
           throw error;
         }
         token.ensureCurrent();
-        this.generationVideoFormat = _optionalChain([stream, 'access', _576 => _576.videoTrack, 'optionalAccess', _577 => _577.videoFormat]);
+        this.generationVideoFormat = _optionalChain([stream, 'access', _582 => _582.videoTrack, 'optionalAccess', _583 => _583.videoFormat]);
         completeCamera();
         this.cameraController.setPreviewReadyHandler((isCurrent) => {
           void this.coordinator.localPreviewDidBecomeReady(isCurrent);
@@ -8572,6 +8660,10 @@ var XmaxRealtimeManager = class _XmaxRealtimeManager {
   }
   /**
    * 创建网络视频源并初始化接收端 RTC；预览是否加载成功不影响服务端读取视频。
+   * @param options.url 服务端可直接访问的 HTTP/HTTPS 视频地址。
+   * @param options.videoFormat 模型输入及生成画面规格，不是上行编码参数。
+   * @param options.sampleMethod 服务端采样方式，默认 time。
+   * @param options.onFinish 服务端完成当前任务后的回调，不代表尾帧已播放完。
    */
   async createNetworkVideoStream(options) {
     return this.coordinator.run("media" /* media */, void 0, async (token) => {
@@ -8582,13 +8674,17 @@ var XmaxRealtimeManager = class _XmaxRealtimeManager {
       this.clearVideoStatistics();
       await this.rtcManager.initialize();
       token.ensureCurrent();
-      this.generationVideoFormat = _optionalChain([stream, 'access', _578 => _578.videoTrack, 'optionalAccess', _579 => _579.videoFormat]);
+      this.generationVideoFormat = _optionalChain([stream, 'access', _584 => _584.videoTrack, 'optionalAccess', _585 => _585.videoFormat]);
       await this.coordinator.commit(new RealtimeState({ connectionState: "Ready" /* ready */ }), token);
       return stream;
     });
   }
   /**
    * 创建文件音视频源并准备外部轨道；准备失败时统一释放本次媒体和 RTC 资源。
+   * @param options.file 包含可解码视频的本地 File 或 Blob。
+   * @param options.videoFormat 期望的视频规格；尺寸按宽高比匹配模型档位。
+   * @param options.loop 是否循环播放，默认 true。
+   * @param options.includeAudio 是否发送文件音频，默认 true。
    */
   async createLocalVideoStream(options) {
     return this.coordinator.run("media" /* media */, void 0, async (token) => {
@@ -8608,16 +8704,42 @@ var XmaxRealtimeManager = class _XmaxRealtimeManager {
         audioTrack: this.localVideoController.audioTrack
       });
       token.ensureCurrent();
-      this.generationVideoFormat = _optionalChain([stream, 'access', _580 => _580.videoTrack, 'optionalAccess', _581 => _581.videoFormat]);
+      this.generationVideoFormat = _optionalChain([stream, 'access', _586 => _586.videoTrack, 'optionalAccess', _587 => _587.videoFormat]);
       await this.coordinator.commit(new RealtimeState({ connectionState: "Ready" /* ready */ }), token);
       return stream;
     });
   }
   /**
-   * 当前 Manager 拥有的媒体源轨道。
+   * 接入外部视频轨；不创建采集设备或预览，所有异步失败统一释放 SDK 副本。
+   * @param options.videoTrack 用户自行采集或处理的 live 视频轨，原始轨道归调用方所有。
+   * @param options.videoFormat 期望的上传及生成规格，须符合模型规则；不代表修改输入像素。
    */
+  async createExternalVideoStream(options) {
+    return this.coordinator.run("media" /* media */, void 0, async (token) => {
+      this.ensureNoLocalSource();
+      if (!this.rtcManager.setExternalMediaTracks) {
+        throw new XmaxError("INVALID_CONFIGURATION" /* invalidConfiguration */, "The RTC provider does not support external video streams");
+      }
+      const stream = this.externalVideoController.create(options, this.mediaService);
+      token.setFailureScope(1 /* all */);
+      this.launchTimer.start();
+      this.clearVideoStatistics();
+      await this.rtcManager.initialize();
+      token.ensureCurrent();
+      await this.rtcManager.setExternalMediaTracks({ videoTrack: stream.videoTrack.mediaStreamTrack });
+      token.ensureCurrent();
+      this.generationVideoFormat = _optionalChain([stream, 'access', _588 => _588.videoTrack, 'optionalAccess', _589 => _589.videoFormat]);
+      await this.coordinator.commit(new RealtimeState({ connectionState: "Ready" /* ready */ }), token);
+      return stream;
+    });
+  }
+  /** 当前可发布的本地视频轨，不包含服务端直接读取的网络视频。 */
+  get currentUplinkTrack() {
+    return _nullishCoalesce(_nullishCoalesce(this.externalVideoController.currentTrack, () => ( this.localVideoController.currentTrack)), () => ( this.cameraController.currentTrack));
+  }
+  /** 当前 Manager 拥有的媒体源轨道。 */
   get currentLocalTrack() {
-    return _nullishCoalesce(_nullishCoalesce(this.localVideoController.currentTrack, () => ( this.networkVideoController.currentTrack)), () => ( this.cameraController.currentTrack));
+    return _nullishCoalesce(this.currentUplinkTrack, () => ( this.networkVideoController.currentTrack));
   }
   /**
    * 创建前拒绝覆盖活动源，避免旧预览或连接资源被静默遗留。
@@ -8631,51 +8753,51 @@ var XmaxRealtimeManager = class _XmaxRealtimeManager {
    * 移除媒体权限弹窗观察；授权决定已记录或不再需要观察时调用。
    */
   disposePermissionWatch() {
-    _optionalChain([this, 'access', _582 => _582.permissionWatchDispose, 'optionalCall', _583 => _583()]);
+    _optionalChain([this, 'access', _590 => _590.permissionWatchDispose, 'optionalCall', _591 => _591()]);
     this.permissionWatchDispose = void 0;
   }
   /**
    * 应用完整的上行视频格式，成功后更新本地轨道元数据，不改变生成格式或生命周期。
    * 复用配置操作准入，避免与建连、切换摄像头或其他配置更新并发。
    *
-   * @throws 无本地相机或文件视频流、参数无效、操作冲突或底层编码更新失败时抛错。
+   * @throws 无本地相机、外部或文件视频流、参数无效、操作冲突或底层编码更新失败时抛错。
    */
   async updateUplinkVideoFormat(videoFormat) {
     await this.coordinator.run("configuration" /* configuration */, void 0, async (token) => {
-      const track = _nullishCoalesce(this.localVideoController.currentTrack, () => ( this.cameraController.currentTrack));
-      const previousFormat = _optionalChain([track, 'optionalAccess', _584 => _584.videoFormat]);
+      const track = this.currentUplinkTrack;
+      const previousFormat = _optionalChain([track, 'optionalAccess', _592 => _592.videoFormat]);
       if (!track || !previousFormat) {
-        throw new XmaxError("INVALID_CONFIGURATION" /* invalidConfiguration */, "Local camera or file video stream is not started");
+        throw new XmaxError("INVALID_CONFIGURATION" /* invalidConfiguration */, "Local camera, external or file video stream is not started");
       }
       videoFormat.validate();
-      _optionalChain([this, 'access', _585 => _585.qualityController, 'optionalAccess', _586 => _586.stop, 'call', _587 => _587()]);
+      _optionalChain([this, 'access', _593 => _593.qualityController, 'optionalAccess', _594 => _594.stop, 'call', _595 => _595()]);
       await this.streamController.updateUplinkVideoFormat(videoFormat);
       token.ensureCurrent();
       _nullishCoalesce(this.generationVideoFormat, () => ( (this.generationVideoFormat = previousFormat)));
       track.updateVideoFormat(videoFormat);
       this.qualityStates.set(track, { baseline: videoFormat, level: 1 });
-      _optionalChain([this, 'access', _588 => _588.qualityHistory, 'optionalAccess', _589 => _589.write, 'call', _590 => _590("uplink", 1)]);
+      _optionalChain([this, 'access', _596 => _596.qualityHistory, 'optionalAccess', _597 => _597.write, 'call', _598 => _598("uplink", 1)]);
     });
   }
   /** 已连接时仅替换帧率；与其他配置及生命周期操作共享同一操作租约。 */
   async updateUplinkFrameRate(fps) {
     await this.coordinator.run("configuration" /* configuration */, void 0, async (token) => {
-      _optionalChain([this, 'access', _591 => _591.qualityController, 'optionalAccess', _592 => _592.stop, 'call', _593 => _593()]);
+      _optionalChain([this, 'access', _599 => _599.qualityController, 'optionalAccess', _600 => _600.stop, 'call', _601 => _601()]);
       await this.applyUplinkFrameRate(fps, token);
       const track = this.currentLocalTrack;
-      if (_optionalChain([track, 'optionalAccess', _594 => _594.videoFormat])) {
+      if (_optionalChain([track, 'optionalAccess', _602 => _602.videoFormat])) {
         this.qualityStates.set(track, { baseline: track.videoFormat, level: 1 });
-        _optionalChain([this, 'access', _595 => _595.qualityHistory, 'optionalAccess', _596 => _596.write, 'call', _597 => _597("uplink", 1)]);
+        _optionalChain([this, 'access', _603 => _603.qualityHistory, 'optionalAccess', _604 => _604.write, 'call', _605 => _605("uplink", 1)]);
       }
     });
   }
   /** 手动仅调帧接口，成功后的当前格式将成为新的自适应 L1 基准。 */
   async applyUplinkFrameRate(fps, token) {
-    const track = _nullishCoalesce(this.localVideoController.currentTrack, () => ( this.cameraController.currentTrack));
-    const previous = _optionalChain([track, 'optionalAccess', _598 => _598.videoFormat]);
+    const track = this.currentUplinkTrack;
+    const previous = _optionalChain([track, 'optionalAccess', _606 => _606.videoFormat]);
     const state2 = this.currentState.connectionState;
     if (!track || !previous || state2 !== "Connected" /* connected */ && state2 !== "Generating" /* generating */) {
-      throw new XmaxError("INVALID_CONFIGURATION" /* invalidConfiguration */, "Frame rate updates require a connected local camera or file stream");
+      throw new XmaxError("INVALID_CONFIGURATION" /* invalidConfiguration */, "Frame rate updates require a connected local camera, external or file stream");
     }
     if (!Number.isFinite(fps) || fps <= 0) {
       throw new XmaxError("INVALID_CONFIGURATION" /* invalidConfiguration */, "Video frame rate must be greater than zero");
@@ -8702,7 +8824,7 @@ var XmaxRealtimeManager = class _XmaxRealtimeManager {
       downlink.resetSamples();
       return;
     }
-    const track = _nullishCoalesce(this.localVideoController.currentTrack, () => ( this.cameraController.currentTrack));
+    const track = this.currentUplinkTrack;
     if (!track) {
       controller.stop();
     } else if (!controller.snapshot.active) {
@@ -8734,7 +8856,7 @@ var XmaxRealtimeManager = class _XmaxRealtimeManager {
    * 停止本地相机流并释放本地预览与 RTC 资源。
    */
   async stopLocalCameraStream() {
-    if (this.networkVideoController.currentTrack || this.localVideoController.isActive) {
+    if (this.networkVideoController.currentTrack || this.localVideoController.isActive || this.externalVideoController.currentTrack) {
       return;
     }
     await this.coordinator.run(
@@ -8767,7 +8889,10 @@ var XmaxRealtimeManager = class _XmaxRealtimeManager {
       "cameraSwitch" /* cameraSwitch */,
       void 0,
       async (token) => {
-        _optionalChain([this, 'access', _599 => _599.qualityController, 'optionalAccess', _600 => _600.stop, 'call', _601 => _601()]);
+        if (this.externalVideoController.currentTrack) {
+          throw new XmaxError("INVALID_CONFIGURATION" /* invalidConfiguration */, "External video capture is managed by the caller");
+        }
+        _optionalChain([this, 'access', _607 => _607.qualityController, 'optionalAccess', _608 => _608.stop, 'call', _609 => _609()]);
         const stream = await this.cameraController.switchCamera();
         token.ensureCurrent();
         return stream;
@@ -8781,7 +8906,7 @@ var XmaxRealtimeManager = class _XmaxRealtimeManager {
    * 启用帧检测时，发布前并行等待相机预热（固定 200ms），避免把黑帧推给 RTC。
    * 返回的远端媒体流在生成开始后承载远端生成画面。
    *
-   * @param localStream 由当前 Manager 创建的摄像头、本地文件或网络视频源。
+   * @param localStream 由当前 Manager 创建的摄像头、外部视频轨、本地文件或网络视频源。
    * @returns 远端生成结果占位的媒体流。
    * @throws 本地流不属于当前 Manager、已有活动连接、会话创建或进房
    * 发布失败时抛出错误；失败时自动释放连接资源并恢复本地预览。
@@ -8808,8 +8933,9 @@ var XmaxRealtimeManager = class _XmaxRealtimeManager {
    * 尚未连接时先建立实时连接；已在生成时仅更新生成条件，不重启生成。
    * 首次生成必须提供条件上下文，之后缺省时复用最近一次缓存的上下文。
    *
-   * @param options.localStream 由当前 Manager 创建的摄像头、本地文件或网络视频源。
+   * @param options.localStream 由当前 Manager 创建的摄像头、外部视频轨、本地文件或网络视频源。
    * @param options.context 本次生成使用的条件上下文；缺省时复用缓存。
+   * @param options.faceRestoration 是否启用原始人脸回贴，默认 false；正在生成时通过 change_condition 更新。
    * @returns 承载远端生成画面的媒体流。
    * @throws 本地流不属于当前 Manager、缺少可用的条件上下文、信令发送
    * 或生成确认失败时抛出错误；失败时自动停止生成任务并释放连接资源。
@@ -8837,7 +8963,8 @@ var XmaxRealtimeManager = class _XmaxRealtimeManager {
         if (currentState.connectionState === "Generating" /* generating */) {
           await this.generationManager.update(currentState.taskID, {
             videoFormat,
-            targetSize: this.downlinkQualityController ? _optionalChain([this, 'access', _602 => _602.downlinkQualityState, 'optionalAccess', _603 => _603.size]) : void 0,
+            faceRestoration: _nullishCoalesce(options.faceRestoration, () => ( false)),
+            targetSize: this.downlinkQualityController ? _optionalChain([this, 'access', _610 => _610.downlinkQualityState, 'optionalAccess', _611 => _611.size]) : void 0,
             context: options.context
           });
           token.ensureCurrent();
@@ -8852,7 +8979,7 @@ var XmaxRealtimeManager = class _XmaxRealtimeManager {
         if (currentState.connectionState !== "Connected" /* connected */) {
           await this.performConnect(options.localStream, token);
         }
-        return this.performStartGeneration(token, videoFormat, context);
+        return this.performStartGeneration(token, videoFormat, context, _nullishCoalesce(options.faceRestoration, () => ( false)));
       }
     );
   }
@@ -8911,7 +9038,7 @@ var XmaxRealtimeManager = class _XmaxRealtimeManager {
     if (token.signal.aborted) abortWarmup();
     try {
       let beforePublish;
-      if (!this.localVideoController.isActive && !this.networkVideoController.currentTrack && this.cameraController.isFrameValidationEnabled) {
+      if (localTrack === this.cameraController.currentTrack && this.cameraController.isFrameValidationEnabled) {
         const cameraReady = this.cameraController.waitForValidCameraFrame(warmupController.signal).then(() => {
           token.ensureCurrent();
         });
@@ -8930,10 +9057,10 @@ var XmaxRealtimeManager = class _XmaxRealtimeManager {
           _nullishCoalesce(this.generationVideoFormat, () => ( (this.generationVideoFormat = initialQuality.baseline)));
           localTrack.updateVideoFormat(initialFormat);
           this.qualityStates.set(localTrack, initialQuality);
-          _optionalChain([this, 'access', _604 => _604.qualityHistory, 'optionalAccess', _605 => _605.write, 'call', _606 => _606("uplink", initialQuality.level)]);
+          _optionalChain([this, 'access', _612 => _612.qualityHistory, 'optionalAccess', _613 => _613.write, 'call', _614 => _614("uplink", initialQuality.level)]);
         },
         model: this.options.model,
-        includeLocalAudio: this.localVideoController.isActive ? this.localVideoController.audioTrack !== void 0 : !this.networkVideoController.currentTrack && this.cameraController.useMicrophone,
+        includeLocalAudio: this.localVideoController.isActive ? this.localVideoController.audioTrack !== void 0 : localTrack === this.cameraController.currentTrack && this.cameraController.useMicrophone,
         publishLocalMedia: !this.networkVideoController.currentTrack,
         ensureCurrent: () => token.ensureCurrent(),
         onPublished: () => {
@@ -8957,9 +9084,9 @@ var XmaxRealtimeManager = class _XmaxRealtimeManager {
   /**
    * 编排插帧、首帧计时和生成状态，任务与确认由生成管理器负责。
    */
-  async performStartGeneration(token, videoFormat, context) {
+  async performStartGeneration(token, videoFormat, context, faceRestoration) {
     token.setFailureScope(0 /* connection */);
-    const initialLevel = _nullishCoalesce(_optionalChain([this, 'access', _607 => _607.qualityHistory, 'optionalAccess', _608 => _608.read, 'call', _609 => _609("downlink")]), () => ( 1));
+    const initialLevel = _nullishCoalesce(_optionalChain([this, 'access', _615 => _615.qualityHistory, 'optionalAccess', _616 => _616.read, 'call', _617 => _617("downlink")]), () => ( 1));
     const targetSize = this.downlinkQualityController ? qualityVideoSize(videoFormat, initialLevel) : void 0;
     await this.prepareFrameInterpolation(_nullishCoalesce(targetSize, () => ( videoFormat)), token);
     const completeFirstFrame = this.launchTimer.startFirstFrame();
@@ -8970,7 +9097,8 @@ var XmaxRealtimeManager = class _XmaxRealtimeManager {
       videoFormat,
       targetSize,
       context,
-      mirror: this.currentLocalTrack === this.cameraController.currentTrack && _optionalChain([this, 'access', _610 => _610.cameraController, 'access', _611 => _611.currentTrack, 'optionalAccess', _612 => _612.position]) === "front" /* front */,
+      faceRestoration,
+      mirror: this.currentLocalTrack === this.cameraController.currentTrack && _optionalChain([this, 'access', _618 => _618.cameraController, 'access', _619 => _619.currentTrack, 'optionalAccess', _620 => _620.position]) === "front" /* front */,
       signal: token.signal,
       ensureCurrent: () => token.ensureCurrent(),
       onStartSent: this.localVideoController.isActive ? async () => {
@@ -8987,7 +9115,7 @@ var XmaxRealtimeManager = class _XmaxRealtimeManager {
     if (!sessionID) {
       throw new XmaxError("SESSION_ERROR" /* sessionError */, "Realtime session is unavailable");
     }
-    _optionalChain([this, 'access', _613 => _613.downlinkQualityController, 'optionalAccess', _614 => _614.stop, 'call', _615 => _615()]);
+    _optionalChain([this, 'access', _621 => _621.downlinkQualityController, 'optionalAccess', _622 => _622.stop, 'call', _623 => _623()]);
     this.downlinkQualityState = {
       taskID,
       baseline: videoFormat,
@@ -8998,7 +9126,7 @@ var XmaxRealtimeManager = class _XmaxRealtimeManager {
       new RealtimeState({ connectionState: "Generating" /* generating */, sessionID, taskID }),
       token
     );
-    _optionalChain([this, 'access', _616 => _616.qualityHistory, 'optionalAccess', _617 => _617.write, 'call', _618 => _618("downlink", initialLevel)]);
+    _optionalChain([this, 'access', _624 => _624.qualityHistory, 'optionalAccess', _625 => _625.write, 'call', _626 => _626("downlink", initialLevel)]);
     const onFinish = this.networkVideoController.onFinish;
     if (this.networkVideoController.currentTrack) {
       this.streamController.activateNetworkVideoCompletion(onFinish && (() => {
@@ -9034,12 +9162,12 @@ var XmaxRealtimeManager = class _XmaxRealtimeManager {
     await this.generationManager.reset(taskID);
     const sessionID = await this.connectionManager.disconnect();
     if (scope === 1 /* all */) {
-      const hadFileSource = this.networkVideoController.currentTrack !== void 0 || this.localVideoController.isActive;
+      const hadExternalSource = this.networkVideoController.currentTrack !== void 0 || this.localVideoController.isActive || this.externalVideoController.currentTrack !== void 0;
       this.networkVideoController.stop();
       this.generationVideoFormat = void 0;
       this.disposePermissionWatch();
       try {
-        if (hadFileSource) {
+        if (hadExternalSource) {
           await this.rtcManager.destroy();
         } else {
           await this.cameraController.stopLocalCameraStream();
@@ -9050,6 +9178,7 @@ var XmaxRealtimeManager = class _XmaxRealtimeManager {
 \u2514\u2500 ${XmaxLogger.localized("\u539F\u56E0\uFF1A", "Reason: ")}${XmaxError.from(error).message}`
         );
       } finally {
+        this.externalVideoController.stop();
         if (this.localVideoController.isActive) {
           await this.localVideoController.stop();
         }
@@ -9150,7 +9279,7 @@ var NonRealtimeTaskService = class {
    * 提交一次任务；请求结果不确定时也不自动重试，以免重复扣费。
    */
   async submitTask(options) {
-    const model = _optionalChain([options, 'access', _619 => _619.model, 'optionalAccess', _620 => _620.trim, 'call', _621 => _621()]);
+    const model = _optionalChain([options, 'access', _627 => _627.model, 'optionalAccess', _628 => _628.trim, 'call', _629 => _629()]);
     if (!model) {
       invalid("Model must not be empty");
     }
@@ -9290,7 +9419,7 @@ function parseTask(value) {
   const uid = field(data, "uid", "string");
   const status = field(data, "status", "string");
   const quality = field(data, "quality", "string");
-  if (!_optionalChain([uid, 'optionalAccess', _622 => _622.trim, 'call', _623 => _623()]) || !Object.values(NonRealtimeTaskStatus).includes(status)) {
+  if (!_optionalChain([uid, 'optionalAccess', _630 => _630.trim, 'call', _631 => _631()]) || !Object.values(NonRealtimeTaskStatus).includes(status)) {
     malformed("Missing task UID or invalid status");
   }
   if (quality !== void 0 && !Object.values(NonRealtimeQuality).includes(quality)) {
@@ -9372,7 +9501,7 @@ var XmaxNonRealtimeManager = class {
    * 取得任务快照，不把服务端失败终态当成查询失败。
    */
   getTask(taskUid, options) {
-    return this.tasks.getTask(taskUid, _optionalChain([options, 'optionalAccess', _624 => _624.signal]));
+    return this.tasks.getTask(taskUid, _optionalChain([options, 'optionalAccess', _632 => _632.signal]));
   }
   /**
    * 批量取得任务快照。
@@ -9406,8 +9535,8 @@ var XmaxNonRealtimeManager = class {
     const controller = new AbortController();
     let timedOut = false;
     const abort = () => controller.abort();
-    _optionalChain([options, 'access', _625 => _625.signal, 'optionalAccess', _626 => _626.addEventListener, 'call', _627 => _627("abort", abort, { once: true })]);
-    if (_optionalChain([options, 'access', _628 => _628.signal, 'optionalAccess', _629 => _629.aborted])) {
+    _optionalChain([options, 'access', _633 => _633.signal, 'optionalAccess', _634 => _634.addEventListener, 'call', _635 => _635("abort", abort, { once: true })]);
+    if (_optionalChain([options, 'access', _636 => _636.signal, 'optionalAccess', _637 => _637.aborted])) {
       abort();
     }
     const timer = options.timeoutMs === void 0 ? void 0 : setTimeout(() => {
@@ -9433,7 +9562,7 @@ var XmaxNonRealtimeManager = class {
         ensureActive(controller.signal);
         failures = 0;
         try {
-          void Promise.resolve(_optionalChain([options, 'access', _630 => _630.onTaskUpdated, 'optionalCall', _631 => _631(task)])).catch(() => {
+          void Promise.resolve(_optionalChain([options, 'access', _638 => _638.onTaskUpdated, 'optionalCall', _639 => _639(task)])).catch(() => {
           });
         } catch (e31) {
         }
@@ -9463,7 +9592,7 @@ var XmaxNonRealtimeManager = class {
       throw error;
     } finally {
       clearTimeout(timer);
-      _optionalChain([options, 'access', _632 => _632.signal, 'optionalAccess', _633 => _633.removeEventListener, 'call', _634 => _634("abort", abort)]);
+      _optionalChain([options, 'access', _640 => _640.signal, 'optionalAccess', _641 => _641.removeEventListener, 'call', _642 => _642("abort", abort)]);
     }
   }
 };
@@ -9507,7 +9636,7 @@ function isTransient(error) {
 }
 function isResultAvailable(task) {
   const result = task.result;
-  if (!_optionalChain([result, 'optionalAccess', _635 => _635.url, 'optionalAccess', _636 => _636.trim, 'call', _637 => _637()]) || _optionalChain([result, 'access', _638 => _638.uploadError, 'optionalAccess', _639 => _639.trim, 'call', _640 => _640()]) || result.uploadStatus !== void 0 && result.uploadStatus !== "success") {
+  if (!_optionalChain([result, 'optionalAccess', _643 => _643.url, 'optionalAccess', _644 => _644.trim, 'call', _645 => _645()]) || _optionalChain([result, 'access', _646 => _646.uploadError, 'optionalAccess', _647 => _647.trim, 'call', _648 => _648()]) || result.uploadStatus !== void 0 && result.uploadStatus !== "success") {
     return false;
   }
   try {
@@ -9771,7 +9900,7 @@ var RenderStatisticsController = class {
    */
   notify(statistics) {
     try {
-      _optionalChain([this, 'access', _641 => _641.handler, 'optionalCall', _642 => _642(statistics)]);
+      _optionalChain([this, 'access', _649 => _649.handler, 'optionalCall', _650 => _650(statistics)]);
     } catch (e33) {
     }
   }
@@ -11899,11 +12028,11 @@ var _FrameInterpolationManager = class _FrameInterpolationManager {
     if (this.destroyed) return;
     this.destroyed = true;
     this.device.removeEventListener("uncapturederror", this.onGPUError);
-    _optionalChain([this, 'access', _643 => _643.runtime, 'optionalAccess', _644 => _644.destroy, 'call', _645 => _645()]);
+    _optionalChain([this, 'access', _651 => _651.runtime, 'optionalAccess', _652 => _652.destroy, 'call', _653 => _653()]);
     this.runtime = void 0;
     this.textures.forEach((texture) => texture.destroy());
     this.textures = [];
-    _optionalChain([this, 'access', _646 => _646.context, 'optionalAccess', _647 => _647.unconfigure, 'call', _648 => _648()]);
+    _optionalChain([this, 'access', _654 => _654.context, 'optionalAccess', _655 => _655.unconfigure, 'call', _656 => _656()]);
     this.device.destroy();
   }
 };
@@ -12080,7 +12209,7 @@ var RemoteVideoFramePipeline = class {
     this.displayedTime = frame.time;
     this.canvas.style.visibility = "visible";
     this.setActive(true);
-    _optionalChain([this, 'access', _649 => _649.options, 'access', _650 => _650.onFramePresented, 'optionalCall', _651 => _651(_nullishCoalesce(frame.interpolated, () => ( false)))]);
+    _optionalChain([this, 'access', _657 => _657.options, 'access', _658 => _658.onFramePresented, 'optionalCall', _659 => _659(_nullishCoalesce(frame.interpolated, () => ( false)))]);
   }
   async initialize() {
     this.loading = true;
@@ -12108,7 +12237,7 @@ var RemoteVideoFramePipeline = class {
   setActive(active) {
     if (active === this.active) return;
     this.active = active;
-    _optionalChain([this, 'access', _652 => _652.options, 'access', _653 => _653.onActiveChange, 'optionalCall', _654 => _654(active)]);
+    _optionalChain([this, 'access', _660 => _660.options, 'access', _661 => _661.onActiveChange, 'optionalCall', _662 => _662(active)]);
   }
   resetTimeline(preserveGpuTimeout = false) {
     this.generation++;
@@ -12141,7 +12270,7 @@ var RemoteVideoFramePipeline = class {
     this.callback = void 0;
     clearTimeout(this.initializationTimer);
     this.resetTimeline();
-    _optionalChain([this, 'access', _655 => _655.processor, 'optionalAccess', _656 => _656.destroy, 'call', _657 => _657()]);
+    _optionalChain([this, 'access', _663 => _663.processor, 'optionalAccess', _664 => _664.destroy, 'call', _665 => _665()]);
     this.processor = void 0;
   }
 };
@@ -12203,7 +12332,7 @@ var XmaxVideoView = class {
      * DOM 挂载状态
      */
     __publicField(this, "detached", false);
-    this.contentMode = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _658 => _658.videoContentMode]), () => ( "fill")) /* fill */;
+    this.contentMode = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _666 => _666.videoContentMode]), () => ( "fill")) /* fill */;
     this.element = document.createElement("div");
     this.element.style.position = "relative";
     this.element.style.overflow = "hidden";
@@ -12388,11 +12517,11 @@ var XmaxVideoView = class {
       ...options,
       onActiveChange: (active) => {
         this.statisticsController.setInterpolationActive(active);
-        _optionalChain([options, 'access', _659 => _659.onActiveChange, 'optionalCall', _660 => _660(active)]);
+        _optionalChain([options, 'access', _667 => _667.onActiveChange, 'optionalCall', _668 => _668(active)]);
       },
       onFramePresented: (interpolated) => {
         this.statisticsController.recordCanvasFrame(interpolated);
-        _optionalChain([options, 'access', _661 => _661.onFramePresented, 'optionalCall', _662 => _662(interpolated)]);
+        _optionalChain([options, 'access', _669 => _669.onFramePresented, 'optionalCall', _670 => _670(interpolated)]);
       }
     });
     this.interpolationPipeline = pipeline;
@@ -12404,8 +12533,8 @@ var XmaxVideoView = class {
   stopInterpolation() {
     const pipeline = this.interpolationPipeline;
     this.interpolationPipeline = void 0;
-    _optionalChain([pipeline, 'optionalAccess', _663 => _663.stop, 'call', _664 => _664()]);
-    _optionalChain([this, 'access', _665 => _665.interpolationCanvas, 'optionalAccess', _666 => _666.remove, 'call', _667 => _667()]);
+    _optionalChain([pipeline, 'optionalAccess', _671 => _671.stop, 'call', _672 => _672()]);
+    _optionalChain([this, 'access', _673 => _673.interpolationCanvas, 'optionalAccess', _674 => _674.remove, 'call', _675 => _675()]);
     this.interpolationCanvas = void 0;
   }
   /**
@@ -12432,7 +12561,7 @@ var XmaxVideoView = class {
     this.statisticsController.stop();
     const track = this.currentTrack;
     if (track) {
-      _optionalChain([VideoRenderRegistry, 'access', _668 => _668.binding, 'call', _669 => _669(track), 'optionalAccess', _670 => _670.detachHandler, 'call', _671 => _671(this)]);
+      _optionalChain([VideoRenderRegistry, 'access', _676 => _676.binding, 'call', _677 => _677(track), 'optionalAccess', _678 => _678.detachHandler, 'call', _679 => _679(this)]);
     }
     this.setFrameInterpolation(void 0);
     this.cancelFrameDisplayNotification();
@@ -12455,8 +12584,8 @@ var XmaxVideoView = class {
       }
       this.hasNotifiedFrameDisplay = true;
       this.cancelFrameDisplayNotification();
-      _optionalChain([binding, 'optionalAccess', _672 => _672.frameDisplayHandler, 'optionalCall', _673 => _673()]);
-      _optionalChain([this, 'access', _674 => _674.frameDisplayHandler, 'optionalCall', _675 => _675()]);
+      _optionalChain([binding, 'optionalAccess', _680 => _680.frameDisplayHandler, 'optionalCall', _681 => _681()]);
+      _optionalChain([this, 'access', _682 => _682.frameDisplayHandler, 'optionalCall', _683 => _683()]);
     };
     if (typeof this.videoElement.requestVideoFrameCallback === "function") {
       this.videoFrameCallbackID = this.videoElement.requestVideoFrameCallback(notify);
@@ -12532,9 +12661,9 @@ var XmaxRealtimeVideoView = class {
     __publicField(this, "currentLocalTrack");
     __publicField(this, "currentRemoteTrack");
     __publicField(this, "contentMode");
-    this.contentMode = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _676 => _676.videoContentMode]), () => ( "fill")) /* fill */;
-    this.currentLocalTrack = _optionalChain([options, 'optionalAccess', _677 => _677.localTrack]);
-    this.currentRemoteTrack = _optionalChain([options, 'optionalAccess', _678 => _678.remoteTrack]);
+    this.contentMode = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _684 => _684.videoContentMode]), () => ( "fill")) /* fill */;
+    this.currentLocalTrack = _optionalChain([options, 'optionalAccess', _685 => _685.localTrack]);
+    this.currentRemoteTrack = _optionalChain([options, 'optionalAccess', _686 => _686.remoteTrack]);
     this.element = document.createElement("div");
     this.element.style.position = "relative";
     this.element.style.overflow = "hidden";
@@ -12700,4 +12829,4 @@ var XmaxRealtimeVideoView = class {
 
 
 exports.XmaxEnvironment = XmaxEnvironment; exports.apiBaseURL = apiBaseURL; exports.XmaxLoggerOption = XmaxLoggerOption; exports.XmaxLogger = XmaxLogger; exports.XmaxErrorCode = XmaxErrorCode; exports.XmaxError = XmaxError; exports.RealtimeVideoEncoderPreference = RealtimeVideoEncoderPreference; exports.RealtimeVideoFormat = RealtimeVideoFormat; exports.RtcProvider = RtcProvider; exports.RealtimeModel = RealtimeModel; exports.modelDisplayName = modelDisplayName; exports.defaultFrameRate = defaultFrameRate; exports.defaultCameraVideoFormat = defaultCameraVideoFormat; exports.supportedRtcProviders = supportedRtcProviders; exports.MediaService = MediaService; exports.StoredFile = StoredFile; exports.StorageService = StorageService; exports.CameraPosition = CameraPosition; exports.RealtimeVideoTrack = RealtimeVideoTrack; exports.RealtimeMediaStream = RealtimeMediaStream; exports.RealtimeVideoSampleMethod = RealtimeVideoSampleMethod; exports.RealtimeContext = RealtimeContext; exports.RealtimeConnectionState = RealtimeConnectionState; exports.RealtimeReason = RealtimeReason; exports.RealtimeState = RealtimeState; exports.XmaxConfiguration = XmaxConfiguration; exports.NonRealtimeQuality = NonRealtimeQuality; exports.NonRealtimeTaskStatus = NonRealtimeTaskStatus; exports.NonRealtimeTaskError = NonRealtimeTaskError; exports.XmaxClient = XmaxClient; exports.RealtimeConfiguration = RealtimeConfiguration; exports.VideoContentMode = VideoContentMode; exports.XmaxVideoView = XmaxVideoView; exports.XmaxRealtimeVideoView = XmaxRealtimeVideoView;
-//# sourceMappingURL=chunk-EKOYOFES.cjs.map
+//# sourceMappingURL=chunk-24VPU65T.cjs.map