@xmaxai/web-sdk 1.0.6 → 1.0.8

package/dist/{chunk-NWNRFTLE.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.6";
+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,178 @@ 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 */);
+  }
+};
+
+// src/Foundation/Media/Camera/CameraRotation.ts
+function validateCameraRotation(rotation) {
+  if (![0, 90, 180, 270].includes(rotation)) {
+    throw new XmaxError("INVALID_CONFIGURATION" /* invalidConfiguration */, "Camera rotation must be 0, 90, 180 or 270");
+  }
+}
+
+// src/Foundation/Media/Camera/CameraRotationProcessor.ts
+var CameraRotationProcessor = class {
+  constructor(options) {
+    __publicField(this, "options", options);
+    __publicField(this, "video", document.createElement("video"));
+    __publicField(this, "canvas", document.createElement("canvas"));
+    __publicField(this, "context");
+    __publicField(this, "stream");
+    __publicField(this, "source");
+    __publicField(this, "frameCallback");
+    __publicField(this, "timer");
+    __publicField(this, "cancelPending");
+    __publicField(this, "stopped", false);
+    __publicField(this, "version", 0);
+    __publicField(this, "sourceEnded", () => {
+      this.fail(new XmaxError("MEDIA_ERROR" /* mediaError */, "Camera source ended during rotation"));
+    });
+    this.canvas.width = options.width;
+    this.canvas.height = options.height;
+    const context = this.canvas.getContext("2d", { alpha: false });
+    if (!context || typeof this.canvas.captureStream !== "function") {
+      throw new XmaxError("MEDIA_ERROR" /* mediaError */, "Canvas camera rotation is not supported by this browser");
+    }
+    this.context = context;
+    this.video.muted = true;
+    this.video.autoplay = true;
+    this.video.playsInline = true;
+  }
+  /** 等待第一帧实际绘制成功；换摄像头时复用输出轨，不重建 sender。 */
+  async setSource(source) {
+    if (this.stopped) throw new XmaxError("CANCELLED" /* cancelled */, "Camera rotation has stopped");
+    if (source.readyState === "ended") {
+      this.stop();
+      throw new XmaxError("MEDIA_ERROR" /* mediaError */, "Camera rotation requires a live source");
+    }
+    _optionalChain([this, 'access', _86 => _86.cancelPending, 'optionalCall', _87 => _87()]);
+    this.cancelFrame();
+    _optionalChain([this, 'access', _88 => _88.source, 'optionalAccess', _89 => _89.removeEventListener, 'call', _90 => _90("ended", this.sourceEnded)]);
+    const version = ++this.version;
+    this.source = source;
+    source.addEventListener("ended", this.sourceEnded);
+    this.video.srcObject = new MediaStream([source]);
+    try {
+      await new Promise((resolve, reject) => {
+        let settled = false;
+        const finish = (error) => {
+          if (settled) return;
+          settled = true;
+          clearTimeout(timeout);
+          this.cancelPending = void 0;
+          if (error) reject(error);
+          else resolve();
+        };
+        const timeout = setTimeout(() => finish(new XmaxError("TIMEOUT" /* timeout */, "Timed out waiting for a camera rotation frame")), 1e4);
+        this.cancelPending = () => finish(new XmaxError("CANCELLED" /* cancelled */, "Camera rotation source changed"));
+        void this.video.play().then(() => {
+          if (settled || this.stopped || version !== this.version) return;
+          const firstFrame = () => {
+            if (settled || this.stopped || version !== this.version) return;
+            try {
+              if (!this.draw()) {
+                this.schedule(firstFrame);
+                return;
+              }
+              _nullishCoalesce(this.stream, () => ( (this.stream = this.canvas.captureStream(this.options.frameRate))));
+              if (!this.stream.getVideoTracks()[0]) throw new Error("Canvas did not produce a video track");
+              this.requestFrame();
+              finish();
+              this.schedule(() => this.render(version));
+            } catch (error) {
+              finish(error);
+            }
+          };
+          this.schedule(firstFrame);
+        }, finish);
+      });
+      if (this.stopped || version !== this.version) {
+        throw new XmaxError("CANCELLED" /* cancelled */, "Camera rotation source changed");
+      }
+      return this.stream.getVideoTracks()[0];
+    } catch (error) {
+      if (version === this.version) this.stop();
+      throw XmaxError.from(error);
+    }
+  }
+  /** 换设备前解除旧原始轨监听，保留 Canvas 最后一帧及输出轨。 */
+  pauseSource() {
+    ++this.version;
+    _optionalChain([this, 'access', _91 => _91.cancelPending, 'optionalCall', _92 => _92()]);
+    this.cancelFrame();
+    _optionalChain([this, 'access', _93 => _93.source, 'optionalAccess', _94 => _94.removeEventListener, 'call', _95 => _95("ended", this.sourceEnded)]);
+    this.source = void 0;
+    this.video.pause();
+    this.video.srcObject = null;
+  }
+  stop() {
+    if (this.stopped) return;
+    this.stopped = true;
+    ++this.version;
+    _optionalChain([this, 'access', _96 => _96.cancelPending, 'optionalCall', _97 => _97()]);
+    this.cancelFrame();
+    _optionalChain([this, 'access', _98 => _98.source, 'optionalAccess', _99 => _99.removeEventListener, 'call', _100 => _100("ended", this.sourceEnded)]);
+    this.source = void 0;
+    this.video.pause();
+    this.video.srcObject = null;
+    _optionalChain([this, 'access', _101 => _101.stream, 'optionalAccess', _102 => _102.getTracks, 'call', _103 => _103(), 'access', _104 => _104.forEach, 'call', _105 => _105((track) => track.stop())]);
+    this.stream = void 0;
+    this.canvas.width = this.canvas.height = 0;
+  }
+  draw() {
+    const { videoWidth: width, videoHeight: height } = this.video;
+    if (this.video.readyState < 2 || !width || !height) return false;
+    const { width: outWidth, height: outHeight, rotation } = this.options;
+    const quarterTurn = rotation === 90 || rotation === 270;
+    const targetWidth = quarterTurn ? outHeight : outWidth;
+    const targetHeight = quarterTurn ? outWidth : outHeight;
+    const scale = Math.max(targetWidth / width, targetHeight / height);
+    const cropWidth = targetWidth / scale, cropHeight = targetHeight / scale;
+    this.context.setTransform(1, 0, 0, 1, outWidth / 2, outHeight / 2);
+    this.context.rotate(rotation * Math.PI / 180);
+    this.context.drawImage(
+      this.video,
+      (width - cropWidth) / 2,
+      (height - cropHeight) / 2,
+      cropWidth,
+      cropHeight,
+      -targetWidth / 2,
+      -targetHeight / 2,
+      targetWidth,
+      targetHeight
+    );
+    return true;
+  }
+  render(version) {
+    if (this.stopped || version !== this.version) return;
+    try {
+      if (this.draw()) this.requestFrame();
+      this.schedule(() => this.render(version));
+    } catch (error) {
+      this.fail(XmaxError.from(error));
+    }
+  }
+  requestFrame() {
+    const track = _optionalChain([this, 'access', _106 => _106.stream, 'optionalAccess', _107 => _107.getVideoTracks, 'call', _108 => _108(), 'access', _109 => _109[0]]);
+    _optionalChain([track, 'optionalAccess', _110 => _110.requestFrame, 'optionalCall', _111 => _111()]);
+  }
+  schedule(callback) {
+    if (typeof this.video.requestVideoFrameCallback === "function") {
+      this.frameCallback = this.video.requestVideoFrameCallback(callback);
+    } else {
+      this.timer = setTimeout(callback, 1e3 / this.options.frameRate);
+    }
+  }
+  cancelFrame() {
+    if (this.frameCallback !== void 0) this.video.cancelVideoFrameCallback(this.frameCallback);
+    clearTimeout(this.timer);
+    this.frameCallback = void 0;
+    this.timer = void 0;
+  }
+  fail(error) {
+    this.stop();
+    this.options.onError(error);
   }
 };
 
@@ -1381,6 +1553,9 @@ var _AgoraRtcManager = class _AgoraRtcManager {
     __publicField(this, "initialization");
     __publicField(this, "lifecycle", 0);
     __publicField(this, "camera");
+    __publicField(this, "cameraSource");
+    __publicField(this, "cameraRotation");
+    __publicField(this, "captureVersion", 0);
     __publicField(this, "microphone");
     __publicField(this, "externalVideo");
     __publicField(this, "externalAudio");
@@ -1460,7 +1635,7 @@ var _AgoraRtcManager = class _AgoraRtcManager {
     if (typeof client.sendStreamMessage !== "function") {
       throw new XmaxError("RTC_ERROR" /* rtcError */, "Agora DataStream is unavailable in this SDK version");
     }
-    _AgoraRtcManager.regions.set(sdk, { environment: this.environment, count: (_nullishCoalesce(_optionalChain([region, 'optionalAccess', _86 => _86.count]), () => ( 0))) + 1 });
+    _AgoraRtcManager.regions.set(sdk, { environment: this.environment, count: (_nullishCoalesce(_optionalChain([region, 'optionalAccess', _112 => _112.count]), () => ( 0))) + 1 });
     this.sdk = sdk;
     this.client = client;
     this.registerEvents(client);
@@ -1473,12 +1648,11 @@ var _AgoraRtcManager = class _AgoraRtcManager {
     const client = this.client;
     this.clearRoom();
     this.client = void 0;
-    _optionalChain([client, 'optionalAccess', _87 => _87.removeAllListeners, 'call', _88 => _88()]);
-    this.releaseCameraSender();
-    _optionalChain([this, 'access', _89 => _89.camera, 'optionalAccess', _90 => _90.close, 'call', _91 => _91()]);
-    _optionalChain([this, 'access', _92 => _92.microphone, 'optionalAccess', _93 => _93.close, 'call', _94 => _94()]);
-    _optionalChain([this, 'access', _95 => _95.externalVideo, 'optionalAccess', _96 => _96.close, 'call', _97 => _97()]);
-    _optionalChain([this, 'access', _98 => _98.externalAudio, 'optionalAccess', _99 => _99.close, 'call', _100 => _100()]);
+    _optionalChain([client, 'optionalAccess', _113 => _113.removeAllListeners, 'call', _114 => _114()]);
+    this.releaseCameraCapture();
+    _optionalChain([this, 'access', _115 => _115.microphone, 'optionalAccess', _116 => _116.close, 'call', _117 => _117()]);
+    _optionalChain([this, 'access', _118 => _118.externalVideo, 'optionalAccess', _119 => _119.close, 'call', _120 => _120()]);
+    _optionalChain([this, 'access', _121 => _121.externalAudio, 'optionalAccess', _122 => _122.close, 'call', _123 => _123()]);
     this.externalVideo = void 0;
     this.externalAudio = void 0;
     this.camera = void 0;
@@ -1486,7 +1660,7 @@ var _AgoraRtcManager = class _AgoraRtcManager {
     const sdk = this.sdk;
     this.sdk = void 0;
     try {
-      await _optionalChain([client, 'optionalAccess', _101 => _101.leave, 'call', _102 => _102()]);
+      await _optionalChain([client, 'optionalAccess', _124 => _124.leave, 'call', _125 => _125()]);
     } catch (e9) {
       XmaxLogger.rtc.warning(() => "Agora \u9000\u623F\u5931\u8D25\uFF0C\u5DF2\u91CA\u653E\u672C\u5730\u8D44\u6E90 (Agora Leave Failed)");
     } finally {
@@ -1499,19 +1673,41 @@ var _AgoraRtcManager = class _AgoraRtcManager {
    */
   async startCameraCapture(options) {
     const client = this.requireClient();
-    if (this.camera || this.externalVideo) {
+    if (this.camera || this.cameraSource || this.externalVideo) {
       throw new XmaxError("INVALID_CONFIGURATION" /* invalidConfiguration */, "A local video source is already active");
     }
+    const rotation = _nullishCoalesce(options.rotation, () => ( 0));
+    validateCameraRotation(rotation);
+    const version = ++this.captureVersion;
+    let source;
     try {
-      const captureSize = rtcOrientedVideoSize(options);
-      const camera = await this.sdk.createCameraVideoTrack({
+      const captureSize = rtcOrientedVideoSize(rotation === 90 || rotation === 270 ? { width: options.height, height: options.width } : options);
+      source = await this.sdk.createCameraVideoTrack({
         facingMode: options.position === "front" /* front */ ? "user" : "environment",
         encoderConfig: { width: captureSize.width, height: captureSize.height, frameRate: options.frameRate }
       });
-      if (this.client !== client) {
-        camera.close();
+      if (this.client !== client || version !== this.captureVersion) {
+        source.close();
         throw this.cancelled();
       }
+      this.cameraSource = source;
+      let camera = source;
+      if (rotation !== 0) {
+        const processor = new CameraRotationProcessor({
+          ...options,
+          rotation,
+          onError: (error) => _optionalChain([this, 'access', _126 => _126.listener, 'optionalAccess', _127 => _127.onError, 'optionalCall', _128 => _128(error)])
+        });
+        this.cameraRotation = processor;
+        const output = await processor.setSource(source.getMediaStreamTrack());
+        if (this.client !== client || version !== this.captureVersion) throw this.cancelled();
+        camera = this.sdk.createCustomVideoTrack({
+          mediaStreamTrack: output,
+          width: options.width,
+          height: options.height,
+          frameRate: options.frameRate
+        });
+      }
       this.camera = camera;
       this.cameraTransceiverListener = () => {
         if (this.client === client && client.localTracks.includes(camera) && this.videoPublishRequested && !this.rejoinTask) {
@@ -1525,6 +1721,7 @@ var _AgoraRtcManager = class _AgoraRtcManager {
       camera.on("transceiver-updated", this.cameraTransceiverListener);
       return camera.getMediaStreamTrack();
     } catch (error) {
+      if (version === this.captureVersion) this.releaseCameraCapture();
       throw this.mapError(error, "CAMERA_PERMISSION_DENIED" /* cameraPermissionDenied */);
     }
   }
@@ -1532,9 +1729,24 @@ var _AgoraRtcManager = class _AgoraRtcManager {
    * 切换声网相机设备并返回切换后的原生轨道。
    */
   async switchCameraCapture(to) {
-    const camera = this.requireCamera();
-    await this.run(() => camera.setDevice({ facingMode: to === "front" /* front */ ? "user" : "environment" }));
-    if (this.camera !== camera) throw this.cancelled();
+    const source = this.requireCamera();
+    const camera = this.camera;
+    _optionalChain([this, 'access', _129 => _129.cameraRotation, 'optionalAccess', _130 => _130.pauseSource, 'call', _131 => _131()]);
+    try {
+      await this.run(() => source.setDevice({ facingMode: to === "front" /* front */ ? "user" : "environment" }));
+    } catch (error) {
+      if (this.camera === camera && this.cameraRotation) {
+        await this.cameraRotation.setSource(source.getMediaStreamTrack()).catch((restoreError) => {
+          _optionalChain([this, 'access', _132 => _132.listener, 'optionalAccess', _133 => _133.onError, 'optionalCall', _134 => _134(XmaxError.from(restoreError))]);
+        });
+      }
+      throw error;
+    }
+    if (this.camera !== camera || this.cameraSource !== source) throw this.cancelled();
+    if (this.cameraRotation) {
+      await this.cameraRotation.setSource(source.getMediaStreamTrack());
+      if (this.camera !== camera) throw this.cancelled();
+    }
     if (this.videoPublishRequested) await this.restoreCameraSender(camera);
     return camera.getMediaStreamTrack();
   }
@@ -1542,17 +1754,25 @@ var _AgoraRtcManager = class _AgoraRtcManager {
    * 停止采集并释放摄像头。
    */
   async stopCameraCapture() {
+    this.releaseCameraCapture();
+  }
+  releaseCameraCapture() {
+    ++this.captureVersion;
     const camera = this.camera;
     this.releaseCameraSender();
     this.camera = void 0;
-    _optionalChain([camera, 'optionalAccess', _103 => _103.close, 'call', _104 => _104()]);
+    _optionalChain([camera, 'optionalAccess', _135 => _135.close, 'call', _136 => _136()]);
+    _optionalChain([this, 'access', _137 => _137.cameraRotation, 'optionalAccess', _138 => _138.stop, 'call', _139 => _139()]);
+    this.cameraRotation = void 0;
+    if (this.cameraSource !== camera) _optionalChain([this, 'access', _140 => _140.cameraSource, 'optionalAccess', _141 => _141.close, 'call', _142 => _142()]);
+    this.cameraSource = void 0;
   }
   /**
    * 将外部原生轨包装为 Agora 本地轨，不申请设备权限；失败时释放本次克隆。
    */
   async setExternalMediaTracks(tracks) {
     this.requireClient();
-    if (this.camera || this.microphone || this.externalVideo) {
+    if (this.camera || this.cameraSource || this.microphone || this.externalVideo) {
       throw new XmaxError("INVALID_CONFIGURATION" /* invalidConfiguration */, "Release the current local media before attaching external tracks");
     }
     if (tracks.videoTrack.kind !== "video" || tracks.videoTrack.readyState !== "live" || tracks.audioTrack && (tracks.audioTrack.kind !== "audio" || tracks.audioTrack.readyState !== "live")) {
@@ -1563,7 +1783,7 @@ var _AgoraRtcManager = class _AgoraRtcManager {
     let wrappedVideo;
     let wrappedAudio;
     try {
-      audio = _optionalChain([tracks, 'access', _105 => _105.audioTrack, 'optionalAccess', _106 => _106.clone, 'call', _107 => _107()]);
+      audio = _optionalChain([tracks, 'access', _143 => _143.audioTrack, 'optionalAccess', _144 => _144.clone, 'call', _145 => _145()]);
       wrappedVideo = this.sdk.createCustomVideoTrack({ mediaStreamTrack: video });
       if (audio) {
         wrappedAudio = this.sdk.createCustomAudioTrack({ mediaStreamTrack: audio, encoderConfig: "music_standard" });
@@ -1571,10 +1791,10 @@ var _AgoraRtcManager = class _AgoraRtcManager {
       this.externalVideo = wrappedVideo;
       this.externalAudio = wrappedAudio;
     } catch (error) {
-      _optionalChain([wrappedVideo, 'optionalAccess', _108 => _108.close, 'call', _109 => _109()]);
-      _optionalChain([wrappedAudio, 'optionalAccess', _110 => _110.close, 'call', _111 => _111()]);
+      _optionalChain([wrappedVideo, 'optionalAccess', _146 => _146.close, 'call', _147 => _147()]);
+      _optionalChain([wrappedAudio, 'optionalAccess', _148 => _148.close, 'call', _149 => _149()]);
       video.stop();
-      _optionalChain([audio, 'optionalAccess', _112 => _112.stop, 'call', _113 => _113()]);
+      _optionalChain([audio, 'optionalAccess', _150 => _150.stop, 'call', _151 => _151()]);
       throw this.mapError(error);
     }
   }
@@ -1592,7 +1812,7 @@ var _AgoraRtcManager = class _AgoraRtcManager {
         };
         ensureActive2();
         if (this.videoPublishRequested) {
-          await AgoraVideoSender.apply(camera, { ...config, ...rtcOrientedVideoSize(config) }, ensureActive2);
+          await AgoraVideoSender.apply(camera, this.cameraEncodingConfiguration(config), ensureActive2);
         }
         this.cameraSenderConfiguration = { ...config };
       }));
@@ -1630,11 +1850,14 @@ var _AgoraRtcManager = class _AgoraRtcManager {
       };
       ensureActive2();
       const config = this.cameraSenderConfiguration;
-      if (config) await AgoraVideoSender.apply(camera, { ...config, ...rtcOrientedVideoSize(config) }, ensureActive2);
+      if (config) await AgoraVideoSender.apply(camera, this.cameraEncodingConfiguration(config), ensureActive2);
     });
   }
+  cameraEncodingConfiguration(config) {
+    return this.cameraRotation ? config : { ...config, ...rtcOrientedVideoSize(config) };
+  }
   releaseCameraSender() {
-    if (this.cameraTransceiverListener) _optionalChain([this, 'access', _114 => _114.camera, 'optionalAccess', _115 => _115.off, 'call', _116 => _116("transceiver-updated", this.cameraTransceiverListener)]);
+    if (this.cameraTransceiverListener) _optionalChain([this, 'access', _152 => _152.camera, 'optionalAccess', _153 => _153.off, 'call', _154 => _154("transceiver-updated", this.cameraTransceiverListener)]);
     this.cameraTransceiverListener = void 0;
     this.cameraSenderConfiguration = void 0;
   }
@@ -1642,7 +1865,7 @@ var _AgoraRtcManager = class _AgoraRtcManager {
    * 使用会话下发的字符串频道与 UID 入房；不采信后端区域覆盖。
    */
   async joinRoom(configuration) {
-    await _optionalChain([this, 'access', _117 => _117.rejoinTask, 'optionalAccess', _118 => _118.catch, 'call', _119 => _119(() => {
+    await _optionalChain([this, 'access', _155 => _155.rejoinTask, 'optionalAccess', _156 => _156.catch, 'call', _157 => _157(() => {
     })]);
     const client = this.requireClient();
     if (configuration.provider !== "agora" /* agora */ || this.connection) {
@@ -1656,7 +1879,7 @@ var _AgoraRtcManager = class _AgoraRtcManager {
     }
     this.connection = configuration;
     for (const user of client.remoteUsers) {
-      if (user.hasVideo) _optionalChain([this, 'access', _120 => _120.listener, 'optionalAccess', _121 => _121.onRemoteVideoPublished, 'call', _122 => _122(String(user.uid), true)]);
+      if (user.hasVideo) _optionalChain([this, 'access', _158 => _158.listener, 'optionalAccess', _159 => _159.onRemoteVideoPublished, 'call', _160 => _160(String(user.uid), true)]);
     }
     this.statisticsTimer = setInterval(() => {
       if (this.client !== client || !this.connection || this.tokenExpired || this.rejoinOperation) return;
@@ -1678,7 +1901,7 @@ var _AgoraRtcManager = class _AgoraRtcManager {
    * 应用同一频道的新 Token；即将过期时续签，已经过期时重新进房并恢复媒体。
    */
   async updateCredentials(config, signal) {
-    if (_optionalChain([signal, 'optionalAccess', _123 => _123.aborted])) throw this.cancelled();
+    if (_optionalChain([signal, 'optionalAccess', _161 => _161.aborted])) throw this.cancelled();
     const current = this.connection;
     const client = this.requireClient();
     if (!current || config.provider !== "agora" /* agora */ || config.appID !== current.appID || config.roomID !== current.roomID || config.userID !== current.userID) {
@@ -1694,7 +1917,7 @@ var _AgoraRtcManager = class _AgoraRtcManager {
       }
     }
     this.ensureRoomCurrent(client, version);
-    if (_optionalChain([signal, 'optionalAccess', _124 => _124.aborted])) throw this.cancelled();
+    if (_optionalChain([signal, 'optionalAccess', _162 => _162.aborted])) throw this.cancelled();
     if (this.tokenExpired) await this.rejoinRoom(client, config, signal);
     else this.connection = config;
   }
@@ -1717,21 +1940,21 @@ var _AgoraRtcManager = class _AgoraRtcManager {
         reject(this.cancelled());
       };
       this.cancelRejoin = cancel;
-      _optionalChain([signal, 'optionalAccess', _125 => _125.addEventListener, 'call', _126 => _126("abort", cancel, { once: true })]);
+      _optionalChain([signal, 'optionalAccess', _163 => _163.addEventListener, 'call', _164 => _164("abort", cancel, { once: true })]);
       task.then(resolve, reject);
-      if (_optionalChain([signal, 'optionalAccess', _127 => _127.aborted])) cancel();
+      if (_optionalChain([signal, 'optionalAccess', _165 => _165.aborted])) cancel();
     });
     this.rejoinOperation = operation;
     try {
       await operation;
     } finally {
-      _optionalChain([signal, 'optionalAccess', _128 => _128.removeEventListener, 'call', _129 => _129("abort", cancel)]);
+      _optionalChain([signal, 'optionalAccess', _166 => _166.removeEventListener, 'call', _167 => _167("abort", cancel)]);
       if (this.cancelRejoin === cancel) this.cancelRejoin = void 0;
       if (this.rejoinOperation === operation) this.rejoinOperation = void 0;
     }
     this.ensureRoomCurrent(client, version);
     for (const user of client.remoteUsers) {
-      if (user.hasVideo) _optionalChain([this, 'access', _130 => _130.listener, 'optionalAccess', _131 => _131.onRemoteVideoPublished, 'call', _132 => _132(String(user.uid), true)]);
+      if (user.hasVideo) _optionalChain([this, 'access', _168 => _168.listener, 'optionalAccess', _169 => _169.onRemoteVideoPublished, 'call', _170 => _170(String(user.uid), true)]);
     }
   }
   /**
@@ -1739,10 +1962,10 @@ var _AgoraRtcManager = class _AgoraRtcManager {
    */
   async performRejoin(client, config, version) {
     this.ensureRoomCurrent(client, version);
-    _optionalChain([this, 'access', _133 => _133.cancelSendDelay, 'optionalCall', _134 => _134()]);
-    _optionalChain([this, 'access', _135 => _135.cancelActiveSend, 'optionalCall', _136 => _136()]);
-    _optionalChain([this, 'access', _137 => _137.listener, 'optionalAccess', _138 => _138.onRoomRejoining, 'optionalCall', _139 => _139()]);
-    for (const user of client.remoteUsers) _optionalChain([user, 'access', _140 => _140.audioTrack, 'optionalAccess', _141 => _141.stop, 'call', _142 => _142()]);
+    _optionalChain([this, 'access', _171 => _171.cancelSendDelay, 'optionalCall', _172 => _172()]);
+    _optionalChain([this, 'access', _173 => _173.cancelActiveSend, 'optionalCall', _174 => _174()]);
+    _optionalChain([this, 'access', _175 => _175.listener, 'optionalAccess', _176 => _176.onRoomRejoining, 'optionalCall', _177 => _177()]);
+    for (const user of client.remoteUsers) _optionalChain([user, 'access', _178 => _178.audioTrack, 'optionalAccess', _179 => _179.stop, 'call', _180 => _180()]);
     await this.run(() => client.leave());
     this.ensureRoomCurrent(client, version);
     await this.run(() => client.join(config.appID, config.roomID, config.roomToken, config.userID));
@@ -1866,8 +2089,8 @@ var _AgoraRtcManager = class _AgoraRtcManager {
     const user = client.remoteUsers.find((user2) => String(user2.uid) === userID);
     if (!subscribe) {
       this.requestedAudio.delete(userID);
-      _optionalChain([user, 'optionalAccess', _143 => _143.audioTrack, 'optionalAccess', _144 => _144.stop, 'call', _145 => _145()]);
-      if (_optionalChain([user, 'optionalAccess', _146 => _146.audioTrack]) && !this.rejoinTask) await this.run(() => client.unsubscribe(user, "audio"));
+      _optionalChain([user, 'optionalAccess', _181 => _181.audioTrack, 'optionalAccess', _182 => _182.stop, 'call', _183 => _183()]);
+      if (_optionalChain([user, 'optionalAccess', _184 => _184.audioTrack]) && !this.rejoinTask) await this.run(() => client.unsubscribe(user, "audio"));
       return;
     }
     this.requestedAudio.add(userID);
@@ -1878,7 +2101,7 @@ var _AgoraRtcManager = class _AgoraRtcManager {
       if (this.requestedAudio.has(userID)) await this.subscribeRemoteAudio(userID, true);
       return;
     }
-    if (!_optionalChain([user, 'optionalAccess', _147 => _147.hasAudio])) return;
+    if (!_optionalChain([user, 'optionalAccess', _185 => _185.hasAudio])) return;
     const version = this.roomVersion;
     const track = await this.run(() => client.subscribe(user, "audio"));
     if (client !== this.client || version !== this.roomVersion || !this.requestedAudio.has(userID)) {
@@ -1892,9 +2115,9 @@ var _AgoraRtcManager = class _AgoraRtcManager {
    */
   setRemoteAudioVolume(volume, userID) {
     this.audioVolumes.set(userID, Math.max(0, Math.min(100, Number.isFinite(volume) ? Math.round(volume) : 0)));
-    const user = _optionalChain([this, 'access', _148 => _148.client, 'optionalAccess', _149 => _149.remoteUsers, 'access', _150 => _150.find, 'call', _151 => _151((user2) => String(user2.uid) === userID)]);
+    const user = _optionalChain([this, 'access', _186 => _186.client, 'optionalAccess', _187 => _187.remoteUsers, 'access', _188 => _188.find, 'call', _189 => _189((user2) => String(user2.uid) === userID)]);
     if (this.rejoinTask || this.tokenExpired) {
-      _optionalChain([user, 'optionalAccess', _152 => _152.audioTrack, 'optionalAccess', _153 => _153.stop, 'call', _154 => _154()]);
+      _optionalChain([user, 'optionalAccess', _190 => _190.audioTrack, 'optionalAccess', _191 => _191.stop, 'call', _192 => _192()]);
       return;
     }
     if (user) this.applyAudioVolume(user);
@@ -1983,45 +2206,45 @@ var _AgoraRtcManager = class _AgoraRtcManager {
     const handleExpired = () => {
       if (!active() || this.tokenExpired) return;
       this.tokenExpired = true;
-      _optionalChain([this, 'access', _155 => _155.listener, 'optionalAccess', _156 => _156.onNetworkStatistics, 'optionalCall', _157 => _157(void 0)]);
-      _optionalChain([this, 'access', _158 => _158.listener, 'optionalAccess', _159 => _159.onTokenExpired, 'optionalCall', _160 => _160()]);
+      _optionalChain([this, 'access', _193 => _193.listener, 'optionalAccess', _194 => _194.onNetworkStatistics, 'optionalCall', _195 => _195(void 0)]);
+      _optionalChain([this, 'access', _196 => _196.listener, 'optionalAccess', _197 => _197.onTokenExpired, 'optionalCall', _198 => _198()]);
     };
     client.on("user-published", (user, kind) => {
       if (!mediaActive()) return;
-      if (kind === "video") _optionalChain([this, 'access', _161 => _161.listener, 'optionalAccess', _162 => _162.onRemoteVideoPublished, 'call', _163 => _163(String(user.uid), true)]);
+      if (kind === "video") _optionalChain([this, 'access', _199 => _199.listener, 'optionalAccess', _200 => _200.onRemoteVideoPublished, 'call', _201 => _201(String(user.uid), true)]);
       if (kind === "audio" && this.requestedAudio.has(String(user.uid))) {
         void this.subscribeRemoteAudio(String(user.uid), true).catch((error) => {
-          if (active()) _optionalChain([this, 'access', _164 => _164.listener, 'optionalAccess', _165 => _165.onError, 'optionalCall', _166 => _166(this.mapError(error))]);
+          if (active()) _optionalChain([this, 'access', _202 => _202.listener, 'optionalAccess', _203 => _203.onError, 'optionalCall', _204 => _204(this.mapError(error))]);
         });
       }
     });
     client.on("user-unpublished", (user, kind) => {
       if (!mediaActive()) return;
-      if (kind === "video") _optionalChain([this, 'access', _167 => _167.listener, 'optionalAccess', _168 => _168.onRemoteVideoPublished, 'call', _169 => _169(String(user.uid), false)]);
-      if (kind === "audio") _optionalChain([user, 'access', _170 => _170.audioTrack, 'optionalAccess', _171 => _171.stop, 'call', _172 => _172()]);
+      if (kind === "video") _optionalChain([this, 'access', _205 => _205.listener, 'optionalAccess', _206 => _206.onRemoteVideoPublished, 'call', _207 => _207(String(user.uid), false)]);
+      if (kind === "audio") _optionalChain([user, 'access', _208 => _208.audioTrack, 'optionalAccess', _209 => _209.stop, 'call', _210 => _210()]);
     });
     client.on("user-left", (user) => {
-      if (mediaActive()) _optionalChain([this, 'access', _173 => _173.listener, 'optionalAccess', _174 => _174.onRemoteVideoPublished, 'call', _175 => _175(String(user.uid), false)]);
+      if (mediaActive()) _optionalChain([this, 'access', _211 => _211.listener, 'optionalAccess', _212 => _212.onRemoteVideoPublished, 'call', _213 => _213(String(user.uid), false)]);
     });
     client.on("stream-message", (uid, data) => {
-      if (mediaActive()) _optionalChain([this, 'access', _176 => _176.listener, 'optionalAccess', _177 => _177.onCustomMessageReceived, 'call', _178 => _178(String(uid), typeof data === "string" ? data : new TextDecoder().decode(data))]);
+      if (mediaActive()) _optionalChain([this, 'access', _214 => _214.listener, 'optionalAccess', _215 => _215.onCustomMessageReceived, 'call', _216 => _216(String(uid), typeof data === "string" ? data : new TextDecoder().decode(data))]);
     });
     client.on("network-quality", (quality) => {
       if (mediaActive() && !this.networkQualitySuspended) AgoraRtcStatistics.network(quality, this.listener);
     });
     client.on("token-privilege-will-expire", () => {
-      if (active() && !this.tokenExpired) _optionalChain([this, 'access', _179 => _179.listener, 'optionalAccess', _180 => _180.onTokenWillExpire, 'optionalCall', _181 => _181()]);
+      if (active() && !this.tokenExpired) _optionalChain([this, 'access', _217 => _217.listener, 'optionalAccess', _218 => _218.onTokenWillExpire, 'optionalCall', _219 => _219()]);
     });
     client.on("token-privilege-did-expire", handleExpired);
     client.on("connection-state-change", (state2, previous, reason) => {
       if (this.client === client) this.networkQualitySuspended = state2 !== "CONNECTED";
-      if (active() && state2 !== "CONNECTED") _optionalChain([this, 'access', _182 => _182.listener, 'optionalAccess', _183 => _183.onNetworkStatistics, 'optionalCall', _184 => _184(void 0)]);
+      if (active() && state2 !== "CONNECTED") _optionalChain([this, 'access', _220 => _220.listener, 'optionalAccess', _221 => _221.onNetworkStatistics, 'optionalCall', _222 => _222(void 0)]);
       if (state2 === "DISCONNECTED" && reason === "TOKEN_EXPIRE") {
         handleExpired();
         return;
       }
       if (active() && !this.tokenExpired && state2 === "DISCONNECTED" && previous !== "DISCONNECTED") {
-        _optionalChain([this, 'access', _185 => _185.listener, 'optionalAccess', _186 => _186.onError, 'optionalCall', _187 => _187(new XmaxError("RTC_ERROR" /* rtcError */, `Agora connection disconnected: ${_nullishCoalesce(reason, () => ( "unknown"))}`))]);
+        _optionalChain([this, 'access', _223 => _223.listener, 'optionalAccess', _224 => _224.onError, 'optionalCall', _225 => _225(new XmaxError("RTC_ERROR" /* rtcError */, `Agora connection disconnected: ${_nullishCoalesce(reason, () => ( "unknown"))}`))]);
       }
     });
   }
@@ -2030,7 +2253,7 @@ var _AgoraRtcManager = class _AgoraRtcManager {
    */
   clearRoom() {
     this.roomVersion++;
-    _optionalChain([this, 'access', _188 => _188.cancelRejoin, 'optionalCall', _189 => _189()]);
+    _optionalChain([this, 'access', _226 => _226.cancelRejoin, 'optionalCall', _227 => _227()]);
     this.connection = void 0;
     this.tokenExpired = false;
     this.networkQualitySuspended = false;
@@ -2038,13 +2261,13 @@ var _AgoraRtcManager = class _AgoraRtcManager {
     this.audioPublishRequested = false;
     clearInterval(this.statisticsTimer);
     this.statisticsTimer = void 0;
-    _optionalChain([this, 'access', _190 => _190.cancelSendDelay, 'optionalCall', _191 => _191()]);
-    _optionalChain([this, 'access', _192 => _192.cancelActiveSend, 'optionalCall', _193 => _193()]);
+    _optionalChain([this, 'access', _228 => _228.cancelSendDelay, 'optionalCall', _229 => _229()]);
+    _optionalChain([this, 'access', _230 => _230.cancelActiveSend, 'optionalCall', _231 => _231()]);
     this.sentPackets = [];
     this.sendTail = Promise.resolve();
     this.requestedAudio.clear();
     this.audioVolumes.clear();
-    for (const user of _nullishCoalesce(_optionalChain([this, 'access', _194 => _194.client, 'optionalAccess', _195 => _195.remoteUsers]), () => ( []))) _optionalChain([user, 'access', _196 => _196.audioTrack, 'optionalAccess', _197 => _197.stop, 'call', _198 => _198()]);
+    for (const user of _nullishCoalesce(_optionalChain([this, 'access', _232 => _232.client, 'optionalAccess', _233 => _233.remoteUsers]), () => ( []))) _optionalChain([user, 'access', _234 => _234.audioTrack, 'optionalAccess', _235 => _235.stop, 'call', _236 => _236()]);
   }
   /**
    * 判断异步恢复工作是否仍属于当前房间生命周期。
@@ -2069,8 +2292,8 @@ var _AgoraRtcManager = class _AgoraRtcManager {
    * 获取已启动的相机采集。
    */
   requireCamera() {
-    if (!this.camera) throw new XmaxError("INVALID_CONFIGURATION" /* invalidConfiguration */, "Camera capture is not running");
-    return this.camera;
+    if (!this.cameraSource || !this.camera) throw new XmaxError("INVALID_CONFIGURATION" /* invalidConfiguration */, "Camera capture is not running");
+    return this.cameraSource;
   }
   /**
    * 获取当前可编码、发布的视频轨，不要求来源为摄像头。
@@ -2182,7 +2405,7 @@ var _RtcEngineManager = class _RtcEngineManager {
    * 释放有效租约、销毁 Engine，并把独占权交给下一个等待者。
    */
   release(lease) {
-    if (_optionalChain([this, 'access', _199 => _199.activeLease, 'optionalAccess', _200 => _200.id]) !== lease.id) {
+    if (_optionalChain([this, 'access', _237 => _237.activeLease, 'optionalAccess', _238 => _238.id]) !== lease.id) {
       return;
     }
     this.activeLease = void 0;
@@ -2256,10 +2479,10 @@ var RtcStatsLogger = class {
         `${XmaxLogger.localized("\u7D2F\u8BA1\u63A5\u6536\uFF1A", "Bytes Received: ")}${this.value(stats.bytesReceived, "bytes")}`
       ])];
       const local = stats.localStatistics;
-      if (_optionalChain([local, 'optionalAccess', _201 => _201.audio])) {
+      if (_optionalChain([local, 'optionalAccess', _239 => _239.audio])) {
         blocks.push(this.audioBlock("\u672C\u5730\u97F3\u9891\u53D1\u9001 (Local Audio Uplink)", local.audio, false));
       }
-      for (const video of _nullishCoalesce(_optionalChain([local, 'optionalAccess', _202 => _202.video]), () => ( []))) {
+      for (const video of _nullishCoalesce(_optionalChain([local, 'optionalAccess', _240 => _240.video]), () => ( []))) {
         blocks.push(this.videoBlock("\u672C\u5730\u89C6\u9891\u53D1\u9001 (Local Video Uplink)", video, false));
       }
       for (const remote of _nullishCoalesce(stats.remoteStatistics, () => ( []))) {
@@ -2349,8 +2572,8 @@ var RtcStatsLogger = class {
 
 // src/Foundation/RTC/TRTC/TrtcAudioVolumeSupport.ts
 function canControlTrtcRemoteAudioVolume(environment) {
-  const userAgent = _nullishCoalesce(_optionalChain([environment, 'optionalAccess', _203 => _203.userAgent]), () => ( (typeof navigator === "undefined" ? "" : navigator.userAgent)));
-  const maxTouchPoints = _nullishCoalesce(_optionalChain([environment, 'optionalAccess', _204 => _204.maxTouchPoints]), () => ( (typeof navigator === "undefined" ? 0 : _nullishCoalesce(navigator.maxTouchPoints, () => ( 0)))));
+  const userAgent = _nullishCoalesce(_optionalChain([environment, 'optionalAccess', _241 => _241.userAgent]), () => ( (typeof navigator === "undefined" ? "" : navigator.userAgent)));
+  const maxTouchPoints = _nullishCoalesce(_optionalChain([environment, 'optionalAccess', _242 => _242.maxTouchPoints]), () => ( (typeof navigator === "undefined" ? 0 : _nullishCoalesce(navigator.maxTouchPoints, () => ( 0)))));
   const ios = /iPhone|iPad|iPod/i.test(userAgent) || /Macintosh/i.test(userAgent) && maxTouchPoints > 1;
   return !ios;
 }
@@ -2437,11 +2660,11 @@ var TrtcRtcManager = class {
     this.isCapturing = false;
     this.isAudioCapturing = false;
     this.isInRoom = false;
-    _optionalChain([this, 'access', _205 => _205.removeStatsListeners, 'optionalCall', _206 => _206()]);
+    _optionalChain([this, 'access', _243 => _243.removeStatsListeners, 'optionalCall', _244 => _244()]);
     this.removeStatsListeners = void 0;
     if (!lease) {
-      _optionalChain([externalVideo, 'optionalAccess', _207 => _207.stop, 'call', _208 => _208()]);
-      _optionalChain([externalAudio, 'optionalAccess', _209 => _209.stop, 'call', _210 => _210()]);
+      _optionalChain([externalVideo, 'optionalAccess', _245 => _245.stop, 'call', _246 => _246()]);
+      _optionalChain([externalAudio, 'optionalAccess', _247 => _247.stop, 'call', _248 => _248()]);
       return;
     }
     try {
@@ -2452,8 +2675,8 @@ var TrtcRtcManager = class {
       await lease.engine.stopLocalVideo();
     } catch (e13) {
     }
-    _optionalChain([externalVideo, 'optionalAccess', _211 => _211.stop, 'call', _212 => _212()]);
-    _optionalChain([externalAudio, 'optionalAccess', _213 => _213.stop, 'call', _214 => _214()]);
+    _optionalChain([externalVideo, 'optionalAccess', _249 => _249.stop, 'call', _250 => _250()]);
+    _optionalChain([externalAudio, 'optionalAccess', _251 => _251.stop, 'call', _252 => _252()]);
     this.engineManager.release(lease);
   }
   /**
@@ -2471,10 +2694,10 @@ var TrtcRtcManager = class {
     this.externalVideo = video;
     let audio;
     try {
-      audio = _optionalChain([tracks, 'access', _215 => _215.audioTrack, 'optionalAccess', _216 => _216.clone, 'call', _217 => _217()]);
+      audio = _optionalChain([tracks, 'access', _253 => _253.audioTrack, 'optionalAccess', _254 => _254.clone, 'call', _255 => _255()]);
       this.externalAudio = audio;
       await engine.startLocalVideo({ publish: false, option: { videoTrack: video } });
-      if (_optionalChain([this, 'access', _218 => _218.lease, 'optionalAccess', _219 => _219.engine]) !== engine) {
+      if (_optionalChain([this, 'access', _256 => _256.lease, 'optionalAccess', _257 => _257.engine]) !== engine) {
         throw new XmaxError("CANCELLED" /* cancelled */, "External media preparation was cancelled");
       }
       if (audio) {
@@ -2482,12 +2705,12 @@ var TrtcRtcManager = class {
           publish: false,
           option: { audioTrack: audio, echoCancellation: false, autoGainControl: false, noiseSuppression: false }
         });
-        if (_optionalChain([this, 'access', _220 => _220.lease, 'optionalAccess', _221 => _221.engine]) !== engine) {
+        if (_optionalChain([this, 'access', _258 => _258.lease, 'optionalAccess', _259 => _259.engine]) !== engine) {
           throw new XmaxError("CANCELLED" /* cancelled */, "External media preparation was cancelled");
         }
       }
     } catch (error) {
-      if (_optionalChain([this, 'access', _222 => _222.lease, 'optionalAccess', _223 => _223.engine]) === engine) {
+      if (_optionalChain([this, 'access', _260 => _260.lease, 'optionalAccess', _261 => _261.engine]) === engine) {
         await engine.stopLocalAudio().catch(() => {
         });
         await engine.stopLocalVideo().catch(() => {
@@ -2498,7 +2721,7 @@ var TrtcRtcManager = class {
         this.externalAudio = void 0;
       }
       video.stop();
-      _optionalChain([audio, 'optionalAccess', _224 => _224.stop, 'call', _225 => _225()]);
+      _optionalChain([audio, 'optionalAccess', _262 => _262.stop, 'call', _263 => _263()]);
       throw this.mapError(error);
     }
   }
@@ -2509,6 +2732,9 @@ var TrtcRtcManager = class {
    * @throws 引擎未初始化、已在采集、设备不可用或权限被拒绝时抛出错误。
    */
   async startCameraCapture(options) {
+    if (options.rotation !== void 0 && options.rotation !== 0) {
+      throw new XmaxError("INVALID_CONFIGURATION" /* invalidConfiguration */, "Camera rotation currently requires Agora");
+    }
     const engine = this.requireEngine();
     if (this.isCapturing || this.externalVideo) {
       throw new XmaxError(
@@ -2583,7 +2809,7 @@ var TrtcRtcManager = class {
     if (this.externalVideo) {
       return;
     }
-    const engine = _optionalChain([this, 'access', _226 => _226.lease, 'optionalAccess', _227 => _227.engine]);
+    const engine = _optionalChain([this, 'access', _264 => _264.lease, 'optionalAccess', _265 => _265.engine]);
     this.isCapturing = false;
     if (!engine) {
       return;
@@ -2636,7 +2862,7 @@ var TrtcRtcManager = class {
    * 离开当前 RTC 房间；未在房间中或引擎未初始化时不产生效果，退房失败仅记录日志。
    */
   async leaveRoom() {
-    const engine = _optionalChain([this, 'access', _228 => _228.lease, 'optionalAccess', _229 => _229.engine]);
+    const engine = _optionalChain([this, 'access', _266 => _266.lease, 'optionalAccess', _267 => _267.engine]);
     if (!engine || !this.isInRoom) {
       return;
     }
@@ -2709,7 +2935,7 @@ var TrtcRtcManager = class {
    * 停止发布本地视频流；采集保持运行，本地预览不受影响。
    */
   async unpublishLocalVideo() {
-    const engine = _optionalChain([this, 'access', _230 => _230.lease, 'optionalAccess', _231 => _231.engine]);
+    const engine = _optionalChain([this, 'access', _268 => _268.lease, 'optionalAccess', _269 => _269.engine]);
     if (!engine || !this.isCapturing && !this.externalVideo) {
       return;
     }
@@ -2745,7 +2971,7 @@ var TrtcRtcManager = class {
    * 停止发布本地音频流；麦克风采集保持运行。
    */
   async unpublishLocalAudio() {
-    const engine = _optionalChain([this, 'access', _232 => _232.lease, 'optionalAccess', _233 => _233.engine]);
+    const engine = _optionalChain([this, 'access', _270 => _270.lease, 'optionalAccess', _271 => _271.engine]);
     if (!engine || !this.isAudioCapturing && !this.externalAudio) {
       return;
     }
@@ -2871,19 +3097,19 @@ var TrtcRtcManager = class {
   registerEventBridge(engine) {
     const source = engine;
     const onStatistics = (stats) => {
-      if (this.isInRoom && _optionalChain([this, 'access', _234 => _234.lease, 'optionalAccess', _235 => _235.engine]) === engine) {
+      if (this.isInRoom && _optionalChain([this, 'access', _272 => _272.lease, 'optionalAccess', _273 => _273.engine]) === engine) {
         RtcStatsLogger.logStatistics(stats);
-        const video = _optionalChain([stats, 'access', _236 => _236.localStatistics, 'optionalAccess', _237 => _237.video, 'optionalAccess', _238 => _238.find, 'call', _239 => _239((item) => item.videoType === "big")]);
+        const video = _optionalChain([stats, 'access', _274 => _274.localStatistics, 'optionalAccess', _275 => _275.video, 'optionalAccess', _276 => _276.find, 'call', _277 => _277((item) => item.videoType === "big")]);
         const valid = (value, minimum) => typeof value === "number" && Number.isFinite(value) && value >= minimum ? value : void 0;
-        _optionalChain([this, 'access', _240 => _240.eventListener, 'optionalAccess', _241 => _241.onLocalVideoStatistics, 'optionalCall', _242 => _242(video ? Object.freeze({
+        _optionalChain([this, 'access', _278 => _278.eventListener, 'optionalAccess', _279 => _279.onLocalVideoStatistics, 'optionalCall', _280 => _280(video ? Object.freeze({
           width: valid(video.width, 1),
           height: valid(video.height, 1),
           frameRate: valid(video.frameRate, 0),
           bitrateKbps: valid(video.bitrate, 0)
         }) : void 0)]);
-        _optionalChain([this, 'access', _243 => _243.eventListener, 'optionalAccess', _244 => _244.onRemoteVideoStatistics, 'optionalCall', _245 => _245(Object.freeze(
+        _optionalChain([this, 'access', _281 => _281.eventListener, 'optionalAccess', _282 => _282.onRemoteVideoStatistics, 'optionalCall', _283 => _283(Object.freeze(
           (_nullishCoalesce(stats.remoteStatistics, () => ( []))).flatMap((remote) => {
-            const video2 = _optionalChain([remote, 'access', _246 => _246.video, 'optionalAccess', _247 => _247.find, 'call', _248 => _248((item) => item.videoType === "big")]);
+            const video2 = _optionalChain([remote, 'access', _284 => _284.video, 'optionalAccess', _285 => _285.find, 'call', _286 => _286((item) => item.videoType === "big")]);
             if (!video2) {
               return [];
             }
@@ -2905,11 +3131,11 @@ var TrtcRtcManager = class {
       }
     };
     const onNetworkQuality = (stats) => {
-      if (this.isInRoom && _optionalChain([this, 'access', _249 => _249.lease, 'optionalAccess', _250 => _250.engine]) === engine) {
+      if (this.isInRoom && _optionalChain([this, 'access', _287 => _287.lease, 'optionalAccess', _288 => _288.engine]) === engine) {
         RtcStatsLogger.logNetworkQuality(stats);
         const quality = (value) => Number.isInteger(value) && value >= 0 && value <= 6 ? value : void 0;
         const rtt = (value) => Number.isFinite(value) && value >= 0 ? value : void 0;
-        _optionalChain([this, 'access', _251 => _251.eventListener, 'optionalAccess', _252 => _252.onNetworkStatistics, 'optionalCall', _253 => _253(Object.freeze({
+        _optionalChain([this, 'access', _289 => _289.eventListener, 'optionalAccess', _290 => _290.onNetworkStatistics, 'optionalCall', _291 => _291(Object.freeze({
           uplinkQuality: quality(stats.uplinkNetworkQuality),
           downlinkQuality: quality(stats.downlinkNetworkQuality),
           uplinkRttMs: rtt(stats.uplinkRTT),
@@ -2924,19 +3150,19 @@ var TrtcRtcManager = class {
       source.off(RTC_EVENT.networkQuality, onNetworkQuality);
     };
     source.on(RTC_EVENT.remoteVideoAvailable, (event) => {
-      if (_optionalChain([this, 'access', _254 => _254.lease, 'optionalAccess', _255 => _255.engine]) !== engine || event.streamType !== STREAM_TYPE_MAIN) {
+      if (_optionalChain([this, 'access', _292 => _292.lease, 'optionalAccess', _293 => _293.engine]) !== engine || event.streamType !== STREAM_TYPE_MAIN) {
         return;
       }
-      _optionalChain([this, 'access', _256 => _256.eventListener, 'optionalAccess', _257 => _257.onRemoteVideoPublished, 'call', _258 => _258(event.userId, true)]);
+      _optionalChain([this, 'access', _294 => _294.eventListener, 'optionalAccess', _295 => _295.onRemoteVideoPublished, 'call', _296 => _296(event.userId, true)]);
     });
     source.on(RTC_EVENT.remoteVideoUnavailable, (event) => {
-      if (_optionalChain([this, 'access', _259 => _259.lease, 'optionalAccess', _260 => _260.engine]) !== engine || event.streamType !== STREAM_TYPE_MAIN) {
+      if (_optionalChain([this, 'access', _297 => _297.lease, 'optionalAccess', _298 => _298.engine]) !== engine || event.streamType !== STREAM_TYPE_MAIN) {
         return;
       }
-      _optionalChain([this, 'access', _261 => _261.eventListener, 'optionalAccess', _262 => _262.onRemoteVideoPublished, 'call', _263 => _263(event.userId, false)]);
+      _optionalChain([this, 'access', _299 => _299.eventListener, 'optionalAccess', _300 => _300.onRemoteVideoPublished, 'call', _301 => _301(event.userId, false)]);
     });
     source.on(RTC_EVENT.customMessage, (event) => {
-      if (_optionalChain([this, 'access', _264 => _264.lease, 'optionalAccess', _265 => _265.engine]) !== engine || event.cmdId !== CUSTOM_MESSAGE_CMD_ID) {
+      if (_optionalChain([this, 'access', _302 => _302.lease, 'optionalAccess', _303 => _303.engine]) !== engine || event.cmdId !== CUSTOM_MESSAGE_CMD_ID) {
         return;
       }
       let message;
@@ -2946,14 +3172,14 @@ var TrtcRtcManager = class {
         XmaxLogger.rtc.warning(() => "\u81EA\u5B9A\u4E49\u6D88\u606F\u89E3\u7801\u5931\u8D25 (Failed to Decode Custom Message)");
         return;
       }
-      _optionalChain([this, 'access', _266 => _266.eventListener, 'optionalAccess', _267 => _267.onCustomMessageReceived, 'call', _268 => _268(event.userId, message)]);
+      _optionalChain([this, 'access', _304 => _304.eventListener, 'optionalAccess', _305 => _305.onCustomMessageReceived, 'call', _306 => _306(event.userId, message)]);
     });
   }
   /**
    * 返回当前引擎实例；未初始化时抛出错误。
    */
   requireEngine() {
-    const engine = _optionalChain([this, 'access', _269 => _269.lease, 'optionalAccess', _270 => _270.engine]);
+    const engine = _optionalChain([this, 'access', _307 => _307.lease, 'optionalAccess', _308 => _308.engine]);
     if (!engine) {
       throw new XmaxError(
         "RTC_ERROR" /* rtcError */,
@@ -2970,8 +3196,8 @@ var TrtcRtcManager = class {
       return error;
     }
     const rtcError = error;
-    const originName = _nullishCoalesce(_optionalChain([rtcError, 'optionalAccess', _271 => _271.originError, 'optionalAccess', _272 => _272.name]), () => ( ""));
-    const message = typeof _optionalChain([rtcError, 'optionalAccess', _273 => _273.message]) === "string" && rtcError.message.trim().length > 0 ? rtcError.message.trim() : String(error);
+    const originName = _nullishCoalesce(_optionalChain([rtcError, 'optionalAccess', _309 => _309.originError, 'optionalAccess', _310 => _310.name]), () => ( ""));
+    const message = typeof _optionalChain([rtcError, 'optionalAccess', _311 => _311.message]) === "string" && rtcError.message.trim().length > 0 ? rtcError.message.trim() : String(error);
     if (originName === "NotAllowedError" || originName === "SecurityError" || /NotAllowed/i.test(message)) {
       return new XmaxError("CAMERA_PERMISSION_DENIED" /* cameraPermissionDenied */, message);
     }
@@ -3094,12 +3320,12 @@ var VeRtcManager = class {
     this.sdk = void 0;
     this.camera = void 0;
     this.microphone = false;
-    _optionalChain([engine, 'optionalAccess', _274 => _274.removeAllListeners, 'call', _275 => _275()]);
+    _optionalChain([engine, 'optionalAccess', _312 => _312.removeAllListeners, 'call', _313 => _313()]);
     try {
       if (engine && sdk) sdk.default.destroyEngine(engine);
     } finally {
-      _optionalChain([this, 'access', _276 => _276.externalVideo, 'optionalAccess', _277 => _277.stop, 'call', _278 => _278()]);
-      _optionalChain([this, 'access', _279 => _279.externalAudio, 'optionalAccess', _280 => _280.stop, 'call', _281 => _281()]);
+      _optionalChain([this, 'access', _314 => _314.externalVideo, 'optionalAccess', _315 => _315.stop, 'call', _316 => _316()]);
+      _optionalChain([this, 'access', _317 => _317.externalAudio, 'optionalAccess', _318 => _318.stop, 'call', _319 => _319()]);
       this.externalVideo = void 0;
       this.externalAudio = void 0;
     }
@@ -3126,7 +3352,7 @@ var VeRtcManager = class {
       }
     };
     try {
-      audio = _optionalChain([tracks, 'access', _282 => _282.audioTrack, 'optionalAccess', _283 => _283.clone, 'call', _284 => _284()]);
+      audio = _optionalChain([tracks, 'access', _320 => _320.audioTrack, 'optionalAccess', _321 => _321.clone, 'call', _322 => _322()]);
       this.externalAudio = audio;
       await engine.setVideoSourceType(index, sdk.VideoSourceType.VIDEO_SOURCE_TYPE_EXTERNAL);
       ensureCurrent();
@@ -3150,11 +3376,14 @@ var VeRtcManager = class {
         this.externalAudio = void 0;
       }
       video.stop();
-      _optionalChain([audio, 'optionalAccess', _285 => _285.stop, 'call', _286 => _286()]);
+      _optionalChain([audio, 'optionalAccess', _323 => _323.stop, 'call', _324 => _324()]);
       throw this.mapError(error);
     }
   }
   async startCameraCapture(options) {
+    if (options.rotation !== void 0 && options.rotation !== 0) {
+      throw new XmaxError("INVALID_CONFIGURATION" /* invalidConfiguration */, "Camera rotation currently requires Agora");
+    }
     const engine = this.requireEngine();
     if (this.camera || this.externalVideo) {
       throw new XmaxError("INVALID_CONFIGURATION" /* invalidConfiguration */, "Local video is already prepared");
@@ -3219,9 +3448,9 @@ var VeRtcManager = class {
     }));
   }
   async joinRoom(config) {
-    await _optionalChain([this, 'access', _287 => _287.joining, 'optionalAccess', _288 => _288.catch, 'call', _289 => _289(() => {
+    await _optionalChain([this, 'access', _325 => _325.joining, 'optionalAccess', _326 => _326.catch, 'call', _327 => _327(() => {
     })]);
-    await _optionalChain([this, 'access', _290 => _290.recovery, 'optionalAccess', _291 => _291.catch, 'call', _292 => _292(() => {
+    await _optionalChain([this, 'access', _328 => _328.recovery, 'optionalAccess', _329 => _329.catch, 'call', _330 => _330(() => {
     })]);
     const engine = this.requireEngine();
     if (config.provider !== "vertc" /* vertc */ || config.appID !== VERTC_APP_ID || this.connection) {
@@ -3270,7 +3499,7 @@ var VeRtcManager = class {
   async updateCredentials(config, signal) {
     const engine = this.requireEngine();
     const current = this.connection;
-    if (_optionalChain([signal, 'optionalAccess', _293 => _293.aborted])) throw this.cancelled();
+    if (_optionalChain([signal, 'optionalAccess', _331 => _331.aborted])) throw this.cancelled();
     if (!current || config.provider !== "vertc" /* vertc */ || config.appID !== current.appID || config.roomID !== current.roomID || config.userID !== current.userID) {
       throw new XmaxError("SESSION_ERROR" /* sessionError */, "VeRTC session binding changed");
     }
@@ -3298,7 +3527,7 @@ var VeRtcManager = class {
     const restore = this.tokenExpired || this.publishPrivilegeExpired || this.subscribePrivilegeExpired;
     if (restore) {
       this.joined = false;
-      _optionalChain([this, 'access', _294 => _294.listener, 'optionalAccess', _295 => _295.onRoomRejoining, 'optionalCall', _296 => _296()]);
+      _optionalChain([this, 'access', _332 => _332.listener, 'optionalAccess', _333 => _333.onRoomRejoining, 'optionalCall', _334 => _334()]);
       this.clearPlayers();
       this.clearStatistics();
       if (this.tokenExpired) {
@@ -3469,13 +3698,13 @@ var VeRtcManager = class {
       if (!active()) return;
       if (video(mediaType)) {
         this.publishedVideo.add(userId);
-        if (mediaActive()) _optionalChain([this, 'access', _297 => _297.listener, 'optionalAccess', _298 => _298.onRemoteVideoPublished, 'call', _299 => _299(userId, true)]);
+        if (mediaActive()) _optionalChain([this, 'access', _335 => _335.listener, 'optionalAccess', _336 => _336.onRemoteVideoPublished, 'call', _337 => _337(userId, true)]);
       }
       if (audio(mediaType)) {
         this.publishedAudio.add(userId);
         if (mediaActive() && this.requestedAudio.has(userId)) {
           void this.subscribeRemoteAudio(userId, true).catch((error) => {
-            if (mediaActive()) _optionalChain([this, 'access', _300 => _300.listener, 'optionalAccess', _301 => _301.onError, 'optionalCall', _302 => _302(this.mapError(error))]);
+            if (mediaActive()) _optionalChain([this, 'access', _338 => _338.listener, 'optionalAccess', _339 => _339.onError, 'optionalCall', _340 => _340(this.mapError(error))]);
           });
         }
       }
@@ -3495,10 +3724,10 @@ var VeRtcManager = class {
       this.clearPlayer(userInfo.userId);
     });
     engine.on(events.onRoomMessageReceived, ({ userId, message }) => {
-      if (mediaActive() && typeof message === "string") _optionalChain([this, 'access', _303 => _303.listener, 'optionalAccess', _304 => _304.onCustomMessageReceived, 'call', _305 => _305(userId, message)]);
+      if (mediaActive() && typeof message === "string") _optionalChain([this, 'access', _341 => _341.listener, 'optionalAccess', _342 => _342.onCustomMessageReceived, 'call', _343 => _343(userId, message)]);
     });
     const willExpire = () => {
-      if (active()) _optionalChain([this, 'access', _306 => _306.listener, 'optionalAccess', _307 => _307.onTokenWillExpire, 'optionalCall', _308 => _308()]);
+      if (active()) _optionalChain([this, 'access', _344 => _344.listener, 'optionalAccess', _345 => _345.onTokenWillExpire, 'optionalCall', _346 => _346()]);
     };
     engine.on(events.onTokenWillExpire, willExpire);
     engine.on(events.onTokenPublishPrivilegeWillExpire, willExpire);
@@ -3506,13 +3735,13 @@ var VeRtcManager = class {
     engine.on(events.onTokenPublishPrivilegeDidExpired, () => {
       if (!active() || this.publishPrivilegeExpired) return;
       this.publishPrivilegeExpired = true;
-      _optionalChain([this, 'access', _309 => _309.listener, 'optionalAccess', _310 => _310.onTokenExpired, 'optionalCall', _311 => _311()]);
+      _optionalChain([this, 'access', _347 => _347.listener, 'optionalAccess', _348 => _348.onTokenExpired, 'optionalCall', _349 => _349()]);
     });
     engine.on(events.onTokenSubscribePrivilegeDidExpired, () => {
       if (!active() || this.subscribePrivilegeExpired) return;
       this.subscribePrivilegeExpired = true;
       this.clearPlayers();
-      _optionalChain([this, 'access', _312 => _312.listener, 'optionalAccess', _313 => _313.onTokenExpired, 'optionalCall', _314 => _314()]);
+      _optionalChain([this, 'access', _350 => _350.listener, 'optionalAccess', _351 => _351.onTokenExpired, 'optionalCall', _352 => _352()]);
     });
     engine.on(events.onError, ({ errorCode }) => {
       if (!active()) return;
@@ -3520,23 +3749,23 @@ var VeRtcManager = class {
         if (this.tokenExpired) return;
         this.tokenExpired = true;
         this.clearPlayers();
-        _optionalChain([this, 'access', _315 => _315.listener, 'optionalAccess', _316 => _316.onTokenExpired, 'optionalCall', _317 => _317()]);
-      } else _optionalChain([this, 'access', _318 => _318.listener, 'optionalAccess', _319 => _319.onError, 'optionalCall', _320 => _320(this.mapError({ code: errorCode }))]);
+        _optionalChain([this, 'access', _353 => _353.listener, 'optionalAccess', _354 => _354.onTokenExpired, 'optionalCall', _355 => _355()]);
+      } else _optionalChain([this, 'access', _356 => _356.listener, 'optionalAccess', _357 => _357.onError, 'optionalCall', _358 => _358(this.mapError({ code: errorCode }))]);
     });
     engine.on(events.onConnectionStateChanged, ({ state: state2 }) => {
       if (!mediaActive() || state2 !== this.sdk.ConnectionState.CONNECTION_STATE_RECONNECTED) return;
-      _optionalChain([this, 'access', _321 => _321.listener, 'optionalAccess', _322 => _322.onRoomRejoining, 'optionalCall', _323 => _323()]);
+      _optionalChain([this, 'access', _359 => _359.listener, 'optionalAccess', _360 => _360.onRoomRejoining, 'optionalCall', _361 => _361()]);
       this.clearPlayers();
       this.clearStatistics();
       this.replayVideo();
       for (const userID of this.requestedAudio) {
         void this.subscribeRemoteAudio(userID, true).catch((error) => {
-          if (mediaActive()) _optionalChain([this, 'access', _324 => _324.listener, 'optionalAccess', _325 => _325.onError, 'optionalCall', _326 => _326(this.mapError(error))]);
+          if (mediaActive()) _optionalChain([this, 'access', _362 => _362.listener, 'optionalAccess', _363 => _363.onError, 'optionalCall', _364 => _364(this.mapError(error))]);
         });
       }
     });
     engine.on(events.onNetworkQuality, (up, down) => {
-      if (mediaActive()) _optionalChain([this, 'access', _327 => _327.listener, 'optionalAccess', _328 => _328.onNetworkStatistics, 'optionalCall', _329 => _329(Object.freeze({
+      if (mediaActive()) _optionalChain([this, 'access', _365 => _365.listener, 'optionalAccess', _366 => _366.onNetworkStatistics, 'optionalCall', _367 => _367(Object.freeze({
         uplinkQuality: VeRtcStatistics.quality(up),
         downlinkQuality: VeRtcStatistics.quality(down)
       }))]);
@@ -3545,7 +3774,7 @@ var VeRtcManager = class {
       if (!mediaActive() || stats.isScreen || !this.videoRequested) return;
       const result = VeRtcStatistics.local(stats.videoStats);
       this.uplinkLossPercent = result.uplinkLossPercent;
-      _optionalChain([this, 'access', _330 => _330.listener, 'optionalAccess', _331 => _331.onLocalVideoStatistics, 'optionalCall', _332 => _332(result)]);
+      _optionalChain([this, 'access', _368 => _368.listener, 'optionalAccess', _369 => _369.onLocalVideoStatistics, 'optionalCall', _370 => _370(result)]);
       XmaxLogger.rtc.info(() => `VeRTC local video statistics: ${JSON.stringify(result)}`, 2 /* performance */);
     });
     engine.on(events.onRemoteStreamStats, (stats) => {
@@ -3555,21 +3784,21 @@ var VeRtcManager = class {
     });
   }
   replayVideo() {
-    for (const userID of this.publishedVideo) _optionalChain([this, 'access', _333 => _333.listener, 'optionalAccess', _334 => _334.onRemoteVideoPublished, 'call', _335 => _335(userID, true)]);
+    for (const userID of this.publishedVideo) _optionalChain([this, 'access', _371 => _371.listener, 'optionalAccess', _372 => _372.onRemoteVideoPublished, 'call', _373 => _373(userID, true)]);
   }
   removeVideo(userID) {
     this.publishedVideo.delete(userID);
     this.remoteStatistics.delete(userID);
     this.emitRemoteStatistics();
-    if (this.joined && !this.tokenExpired) _optionalChain([this, 'access', _336 => _336.listener, 'optionalAccess', _337 => _337.onRemoteVideoPublished, 'call', _338 => _338(userID, false)]);
+    if (this.joined && !this.tokenExpired) _optionalChain([this, 'access', _374 => _374.listener, 'optionalAccess', _375 => _375.onRemoteVideoPublished, 'call', _376 => _376(userID, false)]);
   }
   emitRemoteStatistics() {
-    _optionalChain([this, 'access', _339 => _339.listener, 'optionalAccess', _340 => _340.onRemoteVideoStatistics, 'optionalCall', _341 => _341(Object.freeze([...this.remoteStatistics.values()]))]);
+    _optionalChain([this, 'access', _377 => _377.listener, 'optionalAccess', _378 => _378.onRemoteVideoStatistics, 'optionalCall', _379 => _379(Object.freeze([...this.remoteStatistics.values()]))]);
   }
   clearStatistics() {
     this.remoteStatistics.clear();
     this.uplinkLossPercent = void 0;
-    _optionalChain([this, 'access', _342 => _342.listener, 'optionalAccess', _343 => _343.onLocalVideoStatistics, 'optionalCall', _344 => _344(void 0)]);
+    _optionalChain([this, 'access', _380 => _380.listener, 'optionalAccess', _381 => _381.onLocalVideoStatistics, 'optionalCall', _382 => _382(void 0)]);
     this.emitRemoteStatistics();
   }
   clearPlayer(userID) {
@@ -3615,15 +3844,15 @@ var VeRtcManager = class {
       const cleanup = () => {
         clearTimeout(timer);
         roomSignal.removeEventListener("abort", cancel);
-        _optionalChain([signal, 'optionalAccess', _345 => _345.removeEventListener, 'call', _346 => _346("abort", cancel)]);
+        _optionalChain([signal, 'optionalAccess', _383 => _383.removeEventListener, 'call', _384 => _384("abort", cancel)]);
       };
       const cancel = () => {
-        if (_optionalChain([signal, 'optionalAccess', _347 => _347.aborted]) && !roomSignal.aborted) this.roomVersion++;
+        if (_optionalChain([signal, 'optionalAccess', _385 => _385.aborted]) && !roomSignal.aborted) this.roomVersion++;
         cleanup();
         reject(this.cancelled());
       };
       roomSignal.addEventListener("abort", cancel, { once: true });
-      _optionalChain([signal, 'optionalAccess', _348 => _348.addEventListener, 'call', _349 => _349("abort", cancel, { once: true })]);
+      _optionalChain([signal, 'optionalAccess', _386 => _386.addEventListener, 'call', _387 => _387("abort", cancel, { once: true })]);
       task.then((value) => {
         cleanup();
         resolve(value);
@@ -3631,7 +3860,7 @@ var VeRtcManager = class {
         cleanup();
         reject(error);
       });
-      if (roomSignal.aborted || _optionalChain([signal, 'optionalAccess', _350 => _350.aborted])) cancel();
+      if (roomSignal.aborted || _optionalChain([signal, 'optionalAccess', _388 => _388.aborted])) cancel();
     });
   }
   isCurrent(engine, version) {
@@ -3667,8 +3896,8 @@ var VeRtcManager = class {
   mapError(error, permissionCode) {
     if (error instanceof XmaxError) return error;
     const value = error;
-    const code = typeof _optionalChain([value, 'optionalAccess', _351 => _351.code]) === "string" && /^[A-Z_0-9-]{1,64}$/.test(value.code) ? value.code : "UNKNOWN";
-    const denied = _optionalChain([value, 'optionalAccess', _352 => _352.name]) === "NotAllowedError" || code === "PERMISSION_DENIED" || code === "DEVICE_PERMISSION_DENIED";
+    const code = typeof _optionalChain([value, 'optionalAccess', _389 => _389.code]) === "string" && /^[A-Z_0-9-]{1,64}$/.test(value.code) ? value.code : "UNKNOWN";
+    const denied = _optionalChain([value, 'optionalAccess', _390 => _390.name]) === "NotAllowedError" || code === "PERMISSION_DENIED" || code === "DEVICE_PERMISSION_DENIED";
     return new XmaxError(permissionCode && denied ? permissionCode : "RTC_ERROR" /* rtcError */, `VeRTC operation failed (${code})`);
   }
   cancelled() {
@@ -3750,7 +3979,7 @@ var PermissionManager = class {
    * @param deniedCode 权限被拒绝时抛出的错误码。
    */
   async ensurePermission(name, deniedCode) {
-    if (typeof navigator === "undefined" || !_optionalChain([navigator, 'access', _353 => _353.mediaDevices, 'optionalAccess', _354 => _354.getUserMedia])) {
+    if (typeof navigator === "undefined" || !_optionalChain([navigator, 'access', _391 => _391.mediaDevices, 'optionalAccess', _392 => _392.getUserMedia])) {
       throw new XmaxError(
         deniedCode,
         "This browser does not support media capture (getUserMedia)"
@@ -3758,7 +3987,7 @@ var PermissionManager = class {
     }
     try {
       const permissions = navigator.permissions;
-      if (!_optionalChain([permissions, 'optionalAccess', _355 => _355.query])) {
+      if (!_optionalChain([permissions, 'optionalAccess', _393 => _393.query])) {
         return;
       }
       const status = await permissions.query({
@@ -3938,10 +4167,10 @@ var _CameraController = class _CameraController {
      */
     __publicField(this, "storedUseMicrophone", false);
     __publicField(this, "storedFrameValidationEnabled", true);
-    this.permissionManager = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _356 => _356.permissionManager]), () => ( new PermissionManager()));
-    this.rtcManager = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _357 => _357.rtcManager]), () => ( new TrtcRtcManager()));
-    this.mediaService = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _358 => _358.mediaService]), () => ( new MediaService()));
-    this.errorListener = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _359 => _359.errorListener]), () => ( (() => {
+    this.permissionManager = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _394 => _394.permissionManager]), () => ( new PermissionManager()));
+    this.rtcManager = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _395 => _395.rtcManager]), () => ( new TrtcRtcManager()));
+    this.mediaService = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _396 => _396.mediaService]), () => ( new MediaService()));
+    this.errorListener = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _397 => _397.errorListener]), () => ( (() => {
     })));
   }
   /**
@@ -3967,7 +4196,7 @@ var _CameraController = class _CameraController {
    */
   async waitForValidCameraFrame(signal) {
     const track = this.activeTrack;
-    const mediaTrack = _optionalChain([track, 'optionalAccess', _360 => _360.mediaStreamTrack]);
+    const mediaTrack = _optionalChain([track, 'optionalAccess', _398 => _398.mediaStreamTrack]);
     if (!mediaTrack) throw new XmaxError("MEDIA_ERROR" /* mediaError */, "Camera capture is not running");
     if (signal.aborted) throw new XmaxError("CANCELLED" /* cancelled */, "Camera frame validation cancelled");
     if (!this.isFrameValidationEnabled) return;
@@ -3991,6 +4220,7 @@ var _CameraController = class _CameraController {
    *
    * @param options.videoFormat 期望的输出尺寸、帧率和编码配置；尺寸按模型规则调整。
    * @param options.position 首次启动时使用的摄像头位置。
+   * @param options.rotation 输入帧顺时针旋转角度，默认 0；videoFormat 为旋转后的规格，目前仅 Agora 支持非零角度。
    * @param options.useMicrophone 是否申请麦克风权限并允许实时连接时启动音频采集。
    * @param options.enableFrameValidation 是否在发布前等待相机预热（固定 200ms），默认 true；false 跳过等待。
    * @returns 包含本地相机视频轨道的媒体流。
@@ -4003,6 +4233,7 @@ var _CameraController = class _CameraController {
         "Stop the current local camera stream before creating another one"
       );
     }
+    validateCameraRotation(_nullishCoalesce(options.rotation, () => ( 0)));
     const resolvedFormat = this.resolveVideoFormat(options.videoFormat);
     const track = new RealtimeVideoTrack({
       id: _CameraController.localVideoTrackID,
@@ -4025,7 +4256,8 @@ var _CameraController = class _CameraController {
         width: resolvedFormat.width,
         height: resolvedFormat.height,
         frameRate: resolvedFormat.fps,
-        position: options.position
+        position: options.position,
+        ...options.rotation !== void 0 ? { rotation: options.rotation } : {}
       });
       track.mediaStreamTrack = mediaTrack;
       this.previewStream = new MediaStream([mediaTrack]);
@@ -4067,7 +4299,7 @@ var _CameraController = class _CameraController {
    */
   async switchCamera() {
     const track = this.activeTrack;
-    const position = _optionalChain([track, 'optionalAccess', _361 => _361.position]);
+    const position = _optionalChain([track, 'optionalAccess', _399 => _399.position]);
     if (!track || !position) {
       throw new XmaxError(
         "RTC_ERROR" /* rtcError */,
@@ -4085,7 +4317,7 @@ var _CameraController = class _CameraController {
       }
       this.previewStream.addTrack(mediaTrack);
     }
-    _optionalChain([this, 'access', _362 => _362.previewMirrorApplier, 'optionalCall', _363 => _363(nextPosition === "front" /* front */)]);
+    _optionalChain([this, 'access', _400 => _400.previewMirrorApplier, 'optionalCall', _401 => _401(nextPosition === "front" /* front */)]);
     this.observeMediaTrack(track, mediaTrack);
     return new RealtimeMediaStream({ id: "stream0" /* local */, videoTrack: track });
   }
@@ -4283,7 +4515,7 @@ var NetworkVideoController = class {
       this.ended = video.ended || this.ended;
       video.removeEventListener("loadedmetadata", restore);
       video.removeEventListener("error", fail);
-      _optionalChain([view, 'access', _364 => _364.setVideoURL, 'optionalCall', _365 => _365(null)]);
+      _optionalChain([view, 'access', _402 => _402.setVideoURL, 'optionalCall', _403 => _403(null)]);
     });
     view.isMirrored = false;
     view.setVideoURL(this.reference.path);
@@ -4292,7 +4524,7 @@ var NetworkVideoController = class {
    * 保存预览进度并释放该视图的地址和事件监听。
    */
   detach(view) {
-    _optionalChain([this, 'access', _366 => _366.bindings, 'access', _367 => _367.get, 'call', _368 => _368(view), 'optionalCall', _369 => _369()]);
+    _optionalChain([this, 'access', _404 => _404.bindings, 'access', _405 => _405.get, 'call', _406 => _406(view), 'optionalCall', _407 => _407()]);
     this.bindings.delete(view);
   }
 };
@@ -4321,13 +4553,13 @@ var LocalVideoController = class {
    * 准备完成的本地视频轨。
    */
   get currentTrack() {
-    return _optionalChain([this, 'access', _370 => _370.source, 'optionalAccess', _371 => _371.track]);
+    return _optionalChain([this, 'access', _408 => _408.source, 'optionalAccess', _409 => _409.track]);
   }
   /**
    * 文件音频输出；禁用音频时为空，无音轨文件的 Web Audio 输出为静音。
    */
   get audioTrack() {
-    return _optionalChain([this, 'access', _372 => _372.source, 'optionalAccess', _373 => _373.audioDestination, 'optionalAccess', _374 => _374.stream, 'access', _375 => _375.getAudioTracks, 'call', _376 => _376(), 'access', _377 => _377[0]]);
+    return _optionalChain([this, 'access', _410 => _410.source, 'optionalAccess', _411 => _411.audioDestination, 'optionalAccess', _412 => _412.stream, 'access', _413 => _413.getAudioTracks, 'call', _414 => _414(), 'access', _415 => _415[0]]);
   }
   /**
    * 校验文件和格式，准备首帧与音频输出；应从用户点击事件直接调用以解锁播放。
@@ -4380,7 +4612,7 @@ var LocalVideoController = class {
         source.audioSource.connect(source.audioDestination);
       }
       video.src = source.url;
-      const resume = _optionalChain([source, 'access', _378 => _378.audioContext, 'optionalAccess', _379 => _379.resume, 'call', _380 => _380()]);
+      const resume = _optionalChain([source, 'access', _416 => _416.audioContext, 'optionalAccess', _417 => _417.resume, 'call', _418 => _418()]);
       const playing = this.play(source, signal);
       await this.wait(source, Promise.all([resume, playing]), signal);
       video.pause();
@@ -4432,7 +4664,7 @@ var LocalVideoController = class {
    */
   async start(signal) {
     const source = this.source;
-    if (!_optionalChain([source, 'optionalAccess', _381 => _381.track])) {
+    if (!_optionalChain([source, 'optionalAccess', _419 => _419.track])) {
       throw new XmaxError("INVALID_CONFIGURATION" /* invalidConfiguration */, "Local video is not prepared");
     }
     if (signal.aborted) {
@@ -4440,7 +4672,7 @@ var LocalVideoController = class {
     }
     try {
       await this.rewind(source, signal);
-      await this.wait(source, Promise.all([_optionalChain([source, 'access', _382 => _382.audioContext, 'optionalAccess', _383 => _383.resume, 'call', _384 => _384()]), this.play(source, signal)]), signal);
+      await this.wait(source, Promise.all([_optionalChain([source, 'access', _420 => _420.audioContext, 'optionalAccess', _421 => _421.resume, 'call', _422 => _422()]), this.play(source, signal)]), signal);
     } catch (error) {
       source.video.pause();
       throw error;
@@ -4450,7 +4682,7 @@ var LocalVideoController = class {
    * 暂停文件音视频，保留当前预览；重新开始生成时回到文件开头。
    */
   pause() {
-    _optionalChain([this, 'access', _385 => _385.source, 'optionalAccess', _386 => _386.video, 'access', _387 => _387.pause, 'call', _388 => _388()]);
+    _optionalChain([this, 'access', _423 => _423.source, 'optionalAccess', _424 => _424.video, 'access', _425 => _425.pause, 'call', _426 => _426()]);
   }
   /**
    * 释放播放器、预览、定时器、轨道、音频上下文和对象 URL。
@@ -4480,12 +4712,12 @@ var LocalVideoController = class {
     source.video.pause();
     source.video.removeAttribute("src");
     source.video.load();
-    _optionalChain([source, 'access', _389 => _389.stream, 'optionalAccess', _390 => _390.getTracks, 'call', _391 => _391(), 'access', _392 => _392.forEach, 'call', _393 => _393((track) => track.stop())]);
-    _optionalChain([source, 'access', _394 => _394.audioDestination, 'optionalAccess', _395 => _395.stream, 'access', _396 => _396.getTracks, 'call', _397 => _397(), 'access', _398 => _398.forEach, 'call', _399 => _399((track) => track.stop())]);
-    _optionalChain([source, 'access', _400 => _400.audioSource, 'optionalAccess', _401 => _401.disconnect, 'call', _402 => _402()]);
-    _optionalChain([source, 'access', _403 => _403.audioDestination, 'optionalAccess', _404 => _404.disconnect, 'call', _405 => _405()]);
+    _optionalChain([source, 'access', _427 => _427.stream, 'optionalAccess', _428 => _428.getTracks, 'call', _429 => _429(), 'access', _430 => _430.forEach, 'call', _431 => _431((track) => track.stop())]);
+    _optionalChain([source, 'access', _432 => _432.audioDestination, 'optionalAccess', _433 => _433.stream, 'access', _434 => _434.getTracks, 'call', _435 => _435(), 'access', _436 => _436.forEach, 'call', _437 => _437((track) => track.stop())]);
+    _optionalChain([source, 'access', _438 => _438.audioSource, 'optionalAccess', _439 => _439.disconnect, 'call', _440 => _440()]);
+    _optionalChain([source, 'access', _441 => _441.audioDestination, 'optionalAccess', _442 => _442.disconnect, 'call', _443 => _443()]);
     URL.revokeObjectURL(source.url);
-    await _optionalChain([source, 'access', _406 => _406.audioContext, 'optionalAccess', _407 => _407.close, 'call', _408 => _408(), 'access', _409 => _409.catch, 'call', _410 => _410(() => {
+    await _optionalChain([source, 'access', _444 => _444.audioContext, 'optionalAccess', _445 => _445.close, 'call', _446 => _446(), 'access', _447 => _447.catch, 'call', _448 => _448(() => {
     })]);
   }
   /**
@@ -4610,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 {
   /**
@@ -4633,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', _411 => _411.referencePath, 'optionalAccess', _412 => _412.trim, 'call', _413 => _413()]);
+    const normalizedReferencePath = _optionalChain([init, 'access', _455 => _455.referencePath, 'optionalAccess', _456 => _456.trim, 'call', _457 => _457()]);
     this.referencePath = normalizedReferencePath || void 0;
   }
 };
@@ -4901,7 +5173,7 @@ var RealtimeSessionService = class _RealtimeSessionService {
           return;
         }
         _RealtimeSessionService.ensureSessionActive(session);
-        await _optionalChain([handlers, 'access', _414 => _414.onRefresh, 'optionalCall', _415 => _415(session)]);
+        await _optionalChain([handlers, 'access', _458 => _458.onRefresh, 'optionalCall', _459 => _459(session)]);
       } catch (error) {
         if (this.heartbeatVersion !== version) {
           return;
@@ -5114,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', _416 => _416.reason, 'optionalAccess', _417 => _417.kind]) === _optionalChain([other, 'access', _418 => _418.reason, 'optionalAccess', _419 => _419.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]);
   }
 };
 
@@ -5164,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', _420 => _420.targetSize, 'optionalAccess', _421 => _421.width]), () => ( options.videoFormat.width)),
-            _nullishCoalesce(_optionalChain([options, 'access', _422 => _422.targetSize, 'optionalAccess', _423 => _423.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))
           ]
         }
       },
@@ -5237,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),
@@ -5607,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,
@@ -5624,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,
@@ -5710,7 +5996,7 @@ var RoomController = class {
     if (targetUserID && ownUserID && targetUserID !== ownUserID) {
       return;
     }
-    _optionalChain([this, 'access', _424 => _424.listener, 'optionalAccess', _425 => _425.onRoomMessage, 'call', _426 => _426(senderUserID, message)]);
+    _optionalChain([this, 'access', _468 => _468.listener, 'optionalAccess', _469 => _469.onRoomMessage, 'call', _470 => _470(senderUserID, message)]);
   }
   /**
    * 发送房间信令并输出日志。
@@ -5992,7 +6278,7 @@ var StreamController = class {
     this.roomController.setListener({
       onRoomMessage: (sender, message) => {
         this.handleNetworkVideoCompletion(sender, message);
-        _optionalChain([this, 'access', _427 => _427.roomListener, 'optionalAccess', _428 => _428.onRoomMessage, 'call', _429 => _429(sender, message)]);
+        _optionalChain([this, 'access', _471 => _471.roomListener, 'optionalAccess', _472 => _472.onRoomMessage, 'call', _473 => _473(sender, message)]);
       }
     });
     this.rtcManager.setEventListener({
@@ -6002,18 +6288,18 @@ var StreamController = class {
       onError: (error) => this.errorListener(error),
       onNetworkStatistics: (statistics) => {
         if (this.state.roomID) {
-          _optionalChain([this, 'access', _430 => _430.networkStatisticsListener, 'optionalCall', _431 => _431(statistics)]);
+          _optionalChain([this, 'access', _474 => _474.networkStatisticsListener, 'optionalCall', _475 => _475(statistics)]);
         }
       },
       onRemoteVideoStatistics: (statistics) => {
-        const userID = _optionalChain([this, 'access', _432 => _432.state, 'access', _433 => _433.activeRemoteStream, 'optionalAccess', _434 => _434.userID]);
-        _optionalChain([this, 'access', _435 => _435.remoteVideoStatisticsListener, 'optionalCall', _436 => _436(
+        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', _437 => _437.localVideoStatisticsListener, 'optionalCall', _438 => _438(statistics)]);
+          _optionalChain([this, 'access', _481 => _481.localVideoStatisticsListener, 'optionalCall', _482 => _482(statistics)]);
         }
       },
       onCustomMessageReceived: (senderUserID, message) => {
@@ -6090,7 +6376,7 @@ var StreamController = class {
 \u2514\u2500 roomID: ${connection.roomID}, botID: ${_nullishCoalesce(connection.botID, () => ( "(\u672A\u8BBE\u7F6E)"))}`
     );
     if (publishLocalMedia) {
-      await _optionalChain([beforePublish, 'optionalCall', _439 => _439()]);
+      await _optionalChain([beforePublish, 'optionalCall', _483 => _483()]);
       ensureActive2();
       await this.publishLocalStream(includeLocalAudio);
     }
@@ -6162,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
@@ -6169,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', _440 => _440.onStartSent, 'optionalCall', _441 => _441()]);
+        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);
@@ -6222,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
@@ -6304,7 +6592,7 @@ var StreamController = class {
   deliverNetworkVideoCompletion() {
     const state2 = this.state;
     const completion = state2.networkVideoCompletion;
-    if (!_optionalChain([completion, 'optionalAccess', _442 => _442.finished]) || !completion.onFinish || completion.scheduled) {
+    if (!_optionalChain([completion, 'optionalAccess', _486 => _486.finished]) || !completion.onFinish || completion.scheduled) {
       return;
     }
     completion.scheduled = true;
@@ -6313,7 +6601,7 @@ var StreamController = class {
         return;
       }
       try {
-        void Promise.resolve(_optionalChain([completion, 'access', _443 => _443.onFinish, 'optionalCall', _444 => _444()])).catch(() => {
+        void Promise.resolve(_optionalChain([completion, 'access', _487 => _487.onFinish, 'optionalCall', _488 => _488()])).catch(() => {
         });
       } catch (e23) {
       }
@@ -6324,7 +6612,7 @@ var StreamController = class {
    */
   configureRoom(options) {
     const roomID = options.roomID.trim();
-    const botID = _nullishCoalesce(_optionalChain([options, 'access', _445 => _445.botID, 'optionalAccess', _446 => _446.trim, 'call', _447 => _447()]), () => ( ""));
+    const botID = _nullishCoalesce(_optionalChain([options, 'access', _489 => _489.botID, 'optionalAccess', _490 => _490.trim, 'call', _491 => _491()]), () => ( ""));
     if (!roomID) {
       throw new XmaxError(
         "INVALID_CONFIGURATION" /* invalidConfiguration */,
@@ -6407,7 +6695,7 @@ var StreamController = class {
       return;
     }
     this.state.subscribedRemoteUserIDs.delete(trimmedUserID);
-    if (_optionalChain([this, 'access', _448 => _448.state, 'access', _449 => _449.activeRemoteStream, 'optionalAccess', _450 => _450.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();
@@ -6597,7 +6885,7 @@ var StreamController = class {
    */
   resolveGenerationStart(taskID) {
     const waiter = this.state.generationWaiter;
-    if (this.state.generationTaskID !== taskID || _optionalChain([waiter, 'optionalAccess', _451 => _451.taskID]) !== taskID) {
+    if (this.state.generationTaskID !== taskID || _optionalChain([waiter, 'optionalAccess', _495 => _495.taskID]) !== taskID) {
       return;
     }
     this.state.generationWaiter = void 0;
@@ -6609,7 +6897,7 @@ var StreamController = class {
    */
   rejectGenerationStart(taskID, error) {
     const waiter = this.state.generationWaiter;
-    if (this.state.generationTaskID !== taskID || _optionalChain([waiter, 'optionalAccess', _452 => _452.taskID]) !== taskID) {
+    if (this.state.generationTaskID !== taskID || _optionalChain([waiter, 'optionalAccess', _496 => _496.taskID]) !== taskID) {
       return;
     }
     this.state.generationWaiter = void 0;
@@ -6620,7 +6908,7 @@ var StreamController = class {
    * 通知渲染层清理远端生成流；失败仅记录日志。
    */
   clearRemoteStream() {
-    _optionalChain([this, 'access', _453 => _453.remoteVideoStatisticsListener, 'optionalCall', _454 => _454(void 0)]);
+    _optionalChain([this, 'access', _497 => _497.remoteVideoStatisticsListener, 'optionalCall', _498 => _498(void 0)]);
     try {
       this.remoteStreamListener(null);
     } catch (error) {
@@ -7084,7 +7372,7 @@ var RealtimeCoordinator = class _RealtimeCoordinator {
         }
         throw _RealtimeCoordinator.cancelledError();
       }
-      const terminationTask = await _asyncNullishCoalesce(await _asyncNullishCoalesce(operation.terminationTask, async () => ( _optionalChain([this, 'access', _455 => _455.termination, 'optionalAccess', _456 => _456.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,
@@ -7213,7 +7501,7 @@ var RealtimeCoordinator = class _RealtimeCoordinator {
    * 结束指定操作，释放操作准入场。
    */
   finish(operation) {
-    if (_optionalChain([this, 'access', _457 => _457.activeOperation, 'optionalAccess', _458 => _458.id]) === operation.id) {
+    if (_optionalChain([this, 'access', _501 => _501.activeOperation, 'optionalAccess', _502 => _502.id]) === operation.id) {
       this.activeOperation = void 0;
     }
   }
@@ -7225,7 +7513,7 @@ var RealtimeCoordinator = class _RealtimeCoordinator {
       return;
     }
     this.state = nextState;
-    _optionalChain([this, 'access', _459 => _459.stateListener, 'optionalCall', _460 => _460(nextState)]);
+    _optionalChain([this, 'access', _503 => _503.stateListener, 'optionalCall', _504 => _504(nextState)]);
   }
   /**
    * 构造统一的操作取消错误。
@@ -7362,7 +7650,7 @@ var RealtimeLaunchTimer = class {
    */
   notify() {
     try {
-      void Promise.resolve(_optionalChain([this, 'access', _461 => _461.listener, 'optionalCall', _462 => _462(this.snapshot)])).catch(() => {
+      void Promise.resolve(_optionalChain([this, 'access', _505 => _505.listener, 'optionalCall', _506 => _506(this.snapshot)])).catch(() => {
       });
     } catch (e26) {
     }
@@ -7394,7 +7682,7 @@ var XmaxRealtimeConnectionManager = class {
    * 当前活动会话标识；尚未连接或清理完成后为空。
    */
   get currentSessionID() {
-    return _optionalChain([this, 'access', _463 => _463.activeSession, 'optionalAccess', _464 => _464.id]);
+    return _optionalChain([this, 'access', _507 => _507.activeSession, 'optionalAccess', _508 => _508.id]);
   }
   /**
    * 未配置 API 服务时在连接操作开始前报错，不影响本地预览。
@@ -7406,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) {
@@ -7439,7 +7737,7 @@ var XmaxRealtimeConnectionManager = class {
     if (publishLocalMedia) {
       await streamController.updateUplinkVideoFormat(videoFormat);
       options.ensureCurrent();
-      _optionalChain([options, 'access', _465 => _465.onVideoEncoderConfigured, 'optionalCall', _466 => _466()]);
+      _optionalChain([options, 'access', _509 => _509.onVideoEncoderConfigured, 'optionalCall', _510 => _510()]);
     }
     options.ensureCurrent();
     let completePublish;
@@ -7447,13 +7745,13 @@ var XmaxRealtimeConnectionManager = class {
       options.ensureCurrent();
     }, async () => {
       options.ensureCurrent();
-      await _optionalChain([options, 'access', _467 => _467.beforePublish, 'optionalCall', _468 => _468()]);
+      await _optionalChain([options, 'access', _511 => _511.beforePublish, 'optionalCall', _512 => _512()]);
       completeConnection();
       completePublish = this.dependencies.timing.startPublish();
     }, publishLocalMedia);
     options.ensureCurrent();
     completeConnection();
-    _optionalChain([completePublish, 'optionalCall', _469 => _469()]);
+    _optionalChain([completePublish, 'optionalCall', _513 => _513()]);
     options.onPublished();
     sessionService.startHeartbeat(session.id, {
       onFailure: (sessionID, error) => {
@@ -7476,24 +7774,24 @@ var XmaxRealtimeConnectionManager = class {
    * 更新已绑定远端视图的插帧配置；传 undefined 停用插帧。
    */
   setFrameInterpolation(options) {
-    _optionalChain([this, 'access', _470 => _470.remoteTarget, 'optionalAccess', _471 => _471.setFrameInterpolation, 'optionalCall', _472 => _472(options)]);
+    _optionalChain([this, 'access', _514 => _514.remoteTarget, 'optionalAccess', _515 => _515.setFrameInterpolation, 'optionalCall', _516 => _516(options)]);
   }
   /**
    * 清空远端视图的媒体流，保留轨道与视图绑定以供统一清理。
    */
   clearRemoteMedia() {
-    _optionalChain([this, 'access', _473 => _473.remoteTarget, 'optionalAccess', _474 => _474.setMediaStream, 'call', _475 => _475(null)]);
+    _optionalChain([this, 'access', _517 => _517.remoteTarget, 'optionalAccess', _518 => _518.setMediaStream, 'call', _519 => _519(null)]);
   }
   /**
    * 停止会话心跳；未配置会话服务时不执行操作。
    */
   stopHeartbeat() {
     this.refreshVersion++;
-    _optionalChain([this, 'access', _476 => _476.credentialController, 'optionalAccess', _477 => _477.abort, 'call', _478 => _478()]);
+    _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', _479 => _479.dependencies, 'access', _480 => _480.sessionService, 'optionalAccess', _481 => _481.stopHeartbeat, 'call', _482 => _482()]);
+    _optionalChain([this, 'access', _523 => _523.dependencies, 'access', _524 => _524.sessionService, 'optionalAccess', _525 => _525.stopHeartbeat, 'call', _526 => _526()]);
   }
   /**
    * RTC Token 过期时复用会话心跳获取新凭据，并合并同一实例的并发请求。
@@ -7501,14 +7799,14 @@ var XmaxRealtimeConnectionManager = class {
   async refreshCredentials() {
     if (this.credentialRefresh) return this.credentialRefresh;
     const current = this.activeSession;
-    if (!_optionalChain([current, 'optionalAccess', _483 => _483.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', _484 => _484.activeSession, 'optionalAccess', _485 => _485.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));
         }
       }
@@ -7525,7 +7823,7 @@ var XmaxRealtimeConnectionManager = class {
    */
   async waitUntilRemoteTrackReady(timeoutMs, signal) {
     if (signal.aborted) throw RealtimeCoordinator.cancelledError();
-    const mediaTrack = _optionalChain([this, 'access', _486 => _486.activeRemoteTrack, 'optionalAccess', _487 => _487.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 = () => {
@@ -7562,7 +7860,7 @@ var XmaxRealtimeConnectionManager = class {
       if (track) {
         track.mediaStreamTrack = void 0;
       }
-      _optionalChain([this, 'access', _488 => _488.remoteTarget, 'optionalAccess', _489 => _489.setMediaStream, 'call', _490 => _490(null)]);
+      _optionalChain([this, 'access', _532 => _532.remoteTarget, 'optionalAccess', _533 => _533.setMediaStream, 'call', _534 => _534(null)]);
       return;
     }
     if (!track) {
@@ -7572,7 +7870,7 @@ var XmaxRealtimeConnectionManager = class {
       );
     }
     track.mediaStreamTrack = binding.videoTrack;
-    _optionalChain([this, 'access', _491 => _491.remoteTarget, 'optionalAccess', _492 => _492.setMediaStream, 'call', _493 => _493(new MediaStream([binding.videoTrack]))]);
+    _optionalChain([this, 'access', _535 => _535.remoteTarget, 'optionalAccess', _536 => _536.setMediaStream, 'call', _537 => _537(new MediaStream([binding.videoTrack]))]);
   }
   /**
    * 为远端轨道注册渲染绑定：attach 时挂流占位，媒体轨到达后送入画面。
@@ -7585,7 +7883,7 @@ var XmaxRealtimeConnectionManager = class {
         }
       },
       attachHandler: (view) => {
-        _optionalChain([this, 'access', _494 => _494.remoteTarget, 'optionalAccess', _495 => _495.setFrameInterpolation, 'optionalCall', _496 => _496(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();
@@ -7597,7 +7895,7 @@ var XmaxRealtimeConnectionManager = class {
           this.dependencies.onRenderDetached();
           this.remoteTarget = void 0;
         }
-        _optionalChain([view, 'access', _497 => _497.setFrameInterpolation, 'optionalCall', _498 => _498(void 0)]);
+        _optionalChain([view, 'access', _541 => _541.setFrameInterpolation, 'optionalCall', _542 => _542(void 0)]);
         view.setMediaStream(null);
       }
     });
@@ -7647,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', _499 => _499.credentialController, 'optionalAccess', _500 => _500.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({
@@ -7662,7 +7960,7 @@ var XmaxRealtimeConnectionManager = class {
    * 尽力清理全部连接资源，即使退房失败也关闭服务端会话。
    */
   async disconnect() {
-    const sessionID = _optionalChain([this, 'access', _501 => _501.activeSession, 'optionalAccess', _502 => _502.id]);
+    const sessionID = _optionalChain([this, 'access', _545 => _545.activeSession, 'optionalAccess', _546 => _546.id]);
     this.stopHeartbeat();
     this.clearRemoteMedia();
     try {
@@ -7734,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);
@@ -7747,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);
@@ -7764,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));
@@ -7774,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();
@@ -7800,7 +8114,7 @@ var XmaxRealtimeGenerationManager = class _XmaxRealtimeGenerationManager {
     try {
       await completion;
     } finally {
-      if (_optionalChain([this, 'access', _503 => _503.pendingStop, 'optionalAccess', _504 => _504.completion]) === completion) this.pendingStop = void 0;
+      if (_optionalChain([this, 'access', _547 => _547.pendingStop, 'optionalAccess', _548 => _548.completion]) === completion) this.pendingStop = void 0;
     }
   }
   /**
@@ -7885,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");
     /**
      * 启动计时与首帧通知
@@ -7927,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', _505 => _505.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', _506 => _506.rtcManager]), () => ( createRtcManager(options.provider, _nullishCoalesce(_optionalChain([dependencies, 'optionalAccess', _507 => _507.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', _508 => _508.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', _509 => _509.sessionService]), () => ( (_optionalChain([dependencies, 'optionalAccess', _510 => _510.apiService]) ? new RealtimeSessionService({ apiService: dependencies.apiService, provider: options.provider }) : void 0)));
-    this.streamController = _nullishCoalesce(_optionalChain([dependencies, 'optionalAccess', _511 => _511.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();
@@ -7961,7 +8278,7 @@ var XmaxRealtimeManager = class _XmaxRealtimeManager {
       onHeartbeatFailure: (sessionID, error) => {
         void this.handleHeartbeatFailure(sessionID, error);
       },
-      onFrameDisplayed: () => _optionalChain([this, 'access', _512 => _512.remoteFrameDisplayHandler, 'optionalCall', _513 => _513()]),
+      onFrameDisplayed: () => _optionalChain([this, 'access', _556 => _556.remoteFrameDisplayHandler, 'optionalCall', _557 => _557()]),
       onRenderAttached: () => this.applyRemoteInterpolation(),
       onRenderDetached: () => {
         this.interpolationRevision++;
@@ -7979,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);
@@ -7988,7 +8305,7 @@ var XmaxRealtimeManager = class _XmaxRealtimeManager {
           _nullishCoalesce(this.generationVideoFormat, () => ( (this.generationVideoFormat = state2.baseline)));
           track.updateVideoFormat(format);
           state2.level = change.to;
-          _optionalChain([this, 'access', _514 => _514.qualityHistory, 'optionalAccess', _515 => _515.write, 'call', _516 => _516("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) => {
@@ -8034,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', _517 => _517.downlinkQualityState, 'optionalAccess', _518 => _518.size]), () => ( this.generationVideoFormat)), () => ( _optionalChain([this, 'access', _519 => _519.currentLocalTrack, 'optionalAccess', _520 => _520.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();
@@ -8066,7 +8383,7 @@ var XmaxRealtimeManager = class _XmaxRealtimeManager {
     const state2 = this.downlinkQualityState;
     const ensureActive2 = () => {
       token.ensureCurrent();
-      if (_optionalChain([signal, 'optionalAccess', _521 => _521.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");
       }
     };
@@ -8077,7 +8394,7 @@ var XmaxRealtimeManager = class _XmaxRealtimeManager {
     ensureActive2();
     state2.level = level;
     state2.size = size;
-    _optionalChain([this, 'access', _522 => _522.qualityHistory, 'optionalAccess', _523 => _523.write, 'call', _524 => _524("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();
@@ -8196,7 +8513,7 @@ var XmaxRealtimeManager = class _XmaxRealtimeManager {
    */
   notifyRemoteVideoStatistics() {
     try {
-      void Promise.resolve(_optionalChain([this, 'access', _525 => _525.remoteVideoStatisticsListener, 'optionalCall', _526 => _526(this.remoteVideoStatistics)])).catch(() => {
+      void Promise.resolve(_optionalChain([this, 'access', _569 => _569.remoteVideoStatisticsListener, 'optionalCall', _570 => _570(this.remoteVideoStatistics)])).catch(() => {
       });
     } catch (e27) {
     }
@@ -8213,7 +8530,7 @@ var XmaxRealtimeManager = class _XmaxRealtimeManager {
    */
   notifyNetworkStatistics() {
     try {
-      void Promise.resolve(_optionalChain([this, 'access', _527 => _527.networkStatisticsListener, 'optionalCall', _528 => _528(this.networkStatistics)])).catch(() => {
+      void Promise.resolve(_optionalChain([this, 'access', _571 => _571.networkStatisticsListener, 'optionalCall', _572 => _572(this.networkStatistics)])).catch(() => {
       });
     } catch (e28) {
     }
@@ -8233,7 +8550,7 @@ var XmaxRealtimeManager = class _XmaxRealtimeManager {
    */
   notifyLocalVideoStatistics() {
     try {
-      void Promise.resolve(_optionalChain([this, 'access', _529 => _529.localVideoStatisticsListener, 'optionalCall', _530 => _530(this.localVideoStatistics)])).catch(() => {
+      void Promise.resolve(_optionalChain([this, 'access', _573 => _573.localVideoStatisticsListener, 'optionalCall', _574 => _574(this.localVideoStatistics)])).catch(() => {
       });
     } catch (e29) {
     }
@@ -8242,8 +8559,8 @@ var XmaxRealtimeManager = class _XmaxRealtimeManager {
    * 停止接收媒体统计并清空各类快照，仅对曾有数据的统计发出清空通知。
    */
   clearVideoStatistics() {
-    _optionalChain([this, 'access', _531 => _531.qualityController, 'optionalAccess', _532 => _532.stop, 'call', _533 => _533()]);
-    _optionalChain([this, 'access', _534 => _534.downlinkQualityController, 'optionalAccess', _535 => _535.stop, 'call', _536 => _536()]);
+    _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;
@@ -8291,7 +8608,11 @@ 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 包含本地相机视频轨道的媒体流。
    * @throws 模型不支持相机输入、配置无效、权限或采集启动失败时抛出错误。
    */
@@ -8311,7 +8632,7 @@ var XmaxRealtimeManager = class _XmaxRealtimeManager {
         const completeCamera = this.launchTimer.startCamera();
         this.clearVideoStatistics();
         this.disposePermissionWatch();
-        const permissionWatch = await watchMediaPermissionPrompt(_nullishCoalesce(_optionalChain([options, 'optionalAccess', _537 => _537.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(() => {
@@ -8328,7 +8649,7 @@ var XmaxRealtimeManager = class _XmaxRealtimeManager {
           throw error;
         }
         token.ensureCurrent();
-        this.generationVideoFormat = _optionalChain([stream, 'access', _538 => _538.videoTrack, 'optionalAccess', _539 => _539.videoFormat]);
+        this.generationVideoFormat = _optionalChain([stream, 'access', _582 => _582.videoTrack, 'optionalAccess', _583 => _583.videoFormat]);
         completeCamera();
         this.cameraController.setPreviewReadyHandler((isCurrent) => {
           void this.coordinator.localPreviewDidBecomeReady(isCurrent);
@@ -8339,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) => {
@@ -8349,13 +8674,17 @@ var XmaxRealtimeManager = class _XmaxRealtimeManager {
       this.clearVideoStatistics();
       await this.rtcManager.initialize();
       token.ensureCurrent();
-      this.generationVideoFormat = _optionalChain([stream, 'access', _540 => _540.videoTrack, 'optionalAccess', _541 => _541.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) => {
@@ -8375,16 +8704,42 @@ var XmaxRealtimeManager = class _XmaxRealtimeManager {
         audioTrack: this.localVideoController.audioTrack
       });
       token.ensureCurrent();
-      this.generationVideoFormat = _optionalChain([stream, 'access', _542 => _542.videoTrack, 'optionalAccess', _543 => _543.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));
   }
   /**
    * 创建前拒绝覆盖活动源，避免旧预览或连接资源被静默遗留。
@@ -8398,51 +8753,51 @@ var XmaxRealtimeManager = class _XmaxRealtimeManager {
    * 移除媒体权限弹窗观察；授权决定已记录或不再需要观察时调用。
    */
   disposePermissionWatch() {
-    _optionalChain([this, 'access', _544 => _544.permissionWatchDispose, 'optionalCall', _545 => _545()]);
+    _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', _546 => _546.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', _547 => _547.qualityController, 'optionalAccess', _548 => _548.stop, 'call', _549 => _549()]);
+      _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', _550 => _550.qualityHistory, 'optionalAccess', _551 => _551.write, 'call', _552 => _552("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', _553 => _553.qualityController, 'optionalAccess', _554 => _554.stop, 'call', _555 => _555()]);
+      _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', _556 => _556.videoFormat])) {
+      if (_optionalChain([track, 'optionalAccess', _602 => _602.videoFormat])) {
         this.qualityStates.set(track, { baseline: track.videoFormat, level: 1 });
-        _optionalChain([this, 'access', _557 => _557.qualityHistory, 'optionalAccess', _558 => _558.write, 'call', _559 => _559("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', _560 => _560.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");
@@ -8469,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) {
@@ -8501,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(
@@ -8534,7 +8889,10 @@ var XmaxRealtimeManager = class _XmaxRealtimeManager {
       "cameraSwitch" /* cameraSwitch */,
       void 0,
       async (token) => {
-        _optionalChain([this, 'access', _561 => _561.qualityController, 'optionalAccess', _562 => _562.stop, 'call', _563 => _563()]);
+        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;
@@ -8548,7 +8906,7 @@ var XmaxRealtimeManager = class _XmaxRealtimeManager {
    * 启用帧检测时，发布前并行等待相机预热（固定 200ms），避免把黑帧推给 RTC。
    * 返回的远端媒体流在生成开始后承载远端生成画面。
    *
-   * @param localStream 由当前 Manager 创建的摄像头、本地文件或网络视频源。
+   * @param localStream 由当前 Manager 创建的摄像头、外部视频轨、本地文件或网络视频源。
    * @returns 远端生成结果占位的媒体流。
    * @throws 本地流不属于当前 Manager、已有活动连接、会话创建或进房
    * 发布失败时抛出错误；失败时自动释放连接资源并恢复本地预览。
@@ -8575,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、缺少可用的条件上下文、信令发送
    * 或生成确认失败时抛出错误；失败时自动停止生成任务并释放连接资源。
@@ -8604,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', _564 => _564.downlinkQualityState, 'optionalAccess', _565 => _565.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();
@@ -8619,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)));
       }
     );
   }
@@ -8678,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();
         });
@@ -8697,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', _566 => _566.qualityHistory, 'optionalAccess', _567 => _567.write, 'call', _568 => _568("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: () => {
@@ -8724,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', _569 => _569.qualityHistory, 'optionalAccess', _570 => _570.read, 'call', _571 => _571("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();
@@ -8737,7 +9097,8 @@ var XmaxRealtimeManager = class _XmaxRealtimeManager {
       videoFormat,
       targetSize,
       context,
-      mirror: this.currentLocalTrack === this.cameraController.currentTrack && _optionalChain([this, 'access', _572 => _572.cameraController, 'access', _573 => _573.currentTrack, 'optionalAccess', _574 => _574.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 () => {
@@ -8754,7 +9115,7 @@ var XmaxRealtimeManager = class _XmaxRealtimeManager {
     if (!sessionID) {
       throw new XmaxError("SESSION_ERROR" /* sessionError */, "Realtime session is unavailable");
     }
-    _optionalChain([this, 'access', _575 => _575.downlinkQualityController, 'optionalAccess', _576 => _576.stop, 'call', _577 => _577()]);
+    _optionalChain([this, 'access', _621 => _621.downlinkQualityController, 'optionalAccess', _622 => _622.stop, 'call', _623 => _623()]);
     this.downlinkQualityState = {
       taskID,
       baseline: videoFormat,
@@ -8765,7 +9126,7 @@ var XmaxRealtimeManager = class _XmaxRealtimeManager {
       new RealtimeState({ connectionState: "Generating" /* generating */, sessionID, taskID }),
       token
     );
-    _optionalChain([this, 'access', _578 => _578.qualityHistory, 'optionalAccess', _579 => _579.write, 'call', _580 => _580("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 && (() => {
@@ -8801,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();
@@ -8817,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();
         }
@@ -8917,7 +9279,7 @@ var NonRealtimeTaskService = class {
    * 提交一次任务；请求结果不确定时也不自动重试，以免重复扣费。
    */
   async submitTask(options) {
-    const model = _optionalChain([options, 'access', _581 => _581.model, 'optionalAccess', _582 => _582.trim, 'call', _583 => _583()]);
+    const model = _optionalChain([options, 'access', _627 => _627.model, 'optionalAccess', _628 => _628.trim, 'call', _629 => _629()]);
     if (!model) {
       invalid("Model must not be empty");
     }
@@ -9057,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', _584 => _584.trim, 'call', _585 => _585()]) || !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)) {
@@ -9139,7 +9501,7 @@ var XmaxNonRealtimeManager = class {
    * 取得任务快照，不把服务端失败终态当成查询失败。
    */
   getTask(taskUid, options) {
-    return this.tasks.getTask(taskUid, _optionalChain([options, 'optionalAccess', _586 => _586.signal]));
+    return this.tasks.getTask(taskUid, _optionalChain([options, 'optionalAccess', _632 => _632.signal]));
   }
   /**
    * 批量取得任务快照。
@@ -9173,8 +9535,8 @@ var XmaxNonRealtimeManager = class {
     const controller = new AbortController();
     let timedOut = false;
     const abort = () => controller.abort();
-    _optionalChain([options, 'access', _587 => _587.signal, 'optionalAccess', _588 => _588.addEventListener, 'call', _589 => _589("abort", abort, { once: true })]);
-    if (_optionalChain([options, 'access', _590 => _590.signal, 'optionalAccess', _591 => _591.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(() => {
@@ -9200,7 +9562,7 @@ var XmaxNonRealtimeManager = class {
         ensureActive(controller.signal);
         failures = 0;
         try {
-          void Promise.resolve(_optionalChain([options, 'access', _592 => _592.onTaskUpdated, 'optionalCall', _593 => _593(task)])).catch(() => {
+          void Promise.resolve(_optionalChain([options, 'access', _638 => _638.onTaskUpdated, 'optionalCall', _639 => _639(task)])).catch(() => {
           });
         } catch (e31) {
         }
@@ -9230,7 +9592,7 @@ var XmaxNonRealtimeManager = class {
       throw error;
     } finally {
       clearTimeout(timer);
-      _optionalChain([options, 'access', _594 => _594.signal, 'optionalAccess', _595 => _595.removeEventListener, 'call', _596 => _596("abort", abort)]);
+      _optionalChain([options, 'access', _640 => _640.signal, 'optionalAccess', _641 => _641.removeEventListener, 'call', _642 => _642("abort", abort)]);
     }
   }
 };
@@ -9274,7 +9636,7 @@ function isTransient(error) {
 }
 function isResultAvailable(task) {
   const result = task.result;
-  if (!_optionalChain([result, 'optionalAccess', _597 => _597.url, 'optionalAccess', _598 => _598.trim, 'call', _599 => _599()]) || _optionalChain([result, 'access', _600 => _600.uploadError, 'optionalAccess', _601 => _601.trim, 'call', _602 => _602()]) || 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 {
@@ -9538,7 +9900,7 @@ var RenderStatisticsController = class {
    */
   notify(statistics) {
     try {
-      _optionalChain([this, 'access', _603 => _603.handler, 'optionalCall', _604 => _604(statistics)]);
+      _optionalChain([this, 'access', _649 => _649.handler, 'optionalCall', _650 => _650(statistics)]);
     } catch (e33) {
     }
   }
@@ -11666,11 +12028,11 @@ var _FrameInterpolationManager = class _FrameInterpolationManager {
     if (this.destroyed) return;
     this.destroyed = true;
     this.device.removeEventListener("uncapturederror", this.onGPUError);
-    _optionalChain([this, 'access', _605 => _605.runtime, 'optionalAccess', _606 => _606.destroy, 'call', _607 => _607()]);
+    _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', _608 => _608.context, 'optionalAccess', _609 => _609.unconfigure, 'call', _610 => _610()]);
+    _optionalChain([this, 'access', _654 => _654.context, 'optionalAccess', _655 => _655.unconfigure, 'call', _656 => _656()]);
     this.device.destroy();
   }
 };
@@ -11847,7 +12209,7 @@ var RemoteVideoFramePipeline = class {
     this.displayedTime = frame.time;
     this.canvas.style.visibility = "visible";
     this.setActive(true);
-    _optionalChain([this, 'access', _611 => _611.options, 'access', _612 => _612.onFramePresented, 'optionalCall', _613 => _613(_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;
@@ -11875,7 +12237,7 @@ var RemoteVideoFramePipeline = class {
   setActive(active) {
     if (active === this.active) return;
     this.active = active;
-    _optionalChain([this, 'access', _614 => _614.options, 'access', _615 => _615.onActiveChange, 'optionalCall', _616 => _616(active)]);
+    _optionalChain([this, 'access', _660 => _660.options, 'access', _661 => _661.onActiveChange, 'optionalCall', _662 => _662(active)]);
   }
   resetTimeline(preserveGpuTimeout = false) {
     this.generation++;
@@ -11908,7 +12270,7 @@ var RemoteVideoFramePipeline = class {
     this.callback = void 0;
     clearTimeout(this.initializationTimer);
     this.resetTimeline();
-    _optionalChain([this, 'access', _617 => _617.processor, 'optionalAccess', _618 => _618.destroy, 'call', _619 => _619()]);
+    _optionalChain([this, 'access', _663 => _663.processor, 'optionalAccess', _664 => _664.destroy, 'call', _665 => _665()]);
     this.processor = void 0;
   }
 };
@@ -11970,7 +12332,7 @@ var XmaxVideoView = class {
      * DOM 挂载状态
      */
     __publicField(this, "detached", false);
-    this.contentMode = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _620 => _620.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";
@@ -12155,11 +12517,11 @@ var XmaxVideoView = class {
       ...options,
       onActiveChange: (active) => {
         this.statisticsController.setInterpolationActive(active);
-        _optionalChain([options, 'access', _621 => _621.onActiveChange, 'optionalCall', _622 => _622(active)]);
+        _optionalChain([options, 'access', _667 => _667.onActiveChange, 'optionalCall', _668 => _668(active)]);
       },
       onFramePresented: (interpolated) => {
         this.statisticsController.recordCanvasFrame(interpolated);
-        _optionalChain([options, 'access', _623 => _623.onFramePresented, 'optionalCall', _624 => _624(interpolated)]);
+        _optionalChain([options, 'access', _669 => _669.onFramePresented, 'optionalCall', _670 => _670(interpolated)]);
       }
     });
     this.interpolationPipeline = pipeline;
@@ -12171,8 +12533,8 @@ var XmaxVideoView = class {
   stopInterpolation() {
     const pipeline = this.interpolationPipeline;
     this.interpolationPipeline = void 0;
-    _optionalChain([pipeline, 'optionalAccess', _625 => _625.stop, 'call', _626 => _626()]);
-    _optionalChain([this, 'access', _627 => _627.interpolationCanvas, 'optionalAccess', _628 => _628.remove, 'call', _629 => _629()]);
+    _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;
   }
   /**
@@ -12199,7 +12561,7 @@ var XmaxVideoView = class {
     this.statisticsController.stop();
     const track = this.currentTrack;
     if (track) {
-      _optionalChain([VideoRenderRegistry, 'access', _630 => _630.binding, 'call', _631 => _631(track), 'optionalAccess', _632 => _632.detachHandler, 'call', _633 => _633(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();
@@ -12222,8 +12584,8 @@ var XmaxVideoView = class {
       }
       this.hasNotifiedFrameDisplay = true;
       this.cancelFrameDisplayNotification();
-      _optionalChain([binding, 'optionalAccess', _634 => _634.frameDisplayHandler, 'optionalCall', _635 => _635()]);
-      _optionalChain([this, 'access', _636 => _636.frameDisplayHandler, 'optionalCall', _637 => _637()]);
+      _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);
@@ -12299,9 +12661,9 @@ var XmaxRealtimeVideoView = class {
     __publicField(this, "currentLocalTrack");
     __publicField(this, "currentRemoteTrack");
     __publicField(this, "contentMode");
-    this.contentMode = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _638 => _638.videoContentMode]), () => ( "fill")) /* fill */;
-    this.currentLocalTrack = _optionalChain([options, 'optionalAccess', _639 => _639.localTrack]);
-    this.currentRemoteTrack = _optionalChain([options, 'optionalAccess', _640 => _640.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";
@@ -12467,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-NWNRFTLE.cjs.map
+//# sourceMappingURL=chunk-24VPU65T.cjs.map