@xmaxai/web-sdk 1.0.9 → 1.0.10

package/dist/{chunk-KROY2O4A.cjs → chunk-UF2RD42G.cjs}

@@ -205,7 +205,7 @@ var XmaxError = class _XmaxError extends Error {
 };
 
 // src/Foundation/Runtime/RuntimeInfo.ts
-var XMAX_SDK_VERSION = "1.0.9";
+var XMAX_SDK_VERSION = "1.0.10";
 var _RuntimeInfo = class _RuntimeInfo {
   /**
    * 序列化为接口传输使用的 snake_case 字段。
@@ -501,7 +501,7 @@ var RealtimeVideoFormat = class _RealtimeVideoFormat {
    * @param init.width 视频宽度，单位为像素。
    * @param init.height 视频高度，单位为像素。
    * @param init.fps 视频帧率，必须大于 0。
-   * @param init.minimumBitrate 最低上传码率，单位为 kbps；缺省按最终上传尺寸和帧率计算。
+   * @param init.minimumBitrate 最低上传码率，单位为 kbps；缺省为 100，仅支持该参数的 RTC 链路生效。
    * @param init.maximumBitrate 最高上传码率，单位为 kbps；缺省按最终上传尺寸和帧率计算。
    * @param init.encoderPreference 上传编码策略偏好，默认值为 maintainFramerate。
    */
@@ -525,7 +525,7 @@ var RealtimeVideoFormat = class _RealtimeVideoFormat {
      * 上传编码配置
      */
     /**
-     * 最低上传码率，单位为 kbps；未指定时由 SDK 计算，0 表示不设最低码率。
+     * 最低上传码率，单位为 kbps；缺省为 100，0 表示不设最低码率；仅支持该参数的 RTC 链路生效。
      */
     _chunk4DE2IREAcjs.__publicField.call(void 0, this, "minimumBitrate");
     /**
@@ -598,10 +598,6 @@ var RtcProvider = /* @__PURE__ */ ((RtcProvider2) => {
 
 // src/Service/Realtime/RealtimeModel.ts
 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";
   RealtimeModel2["x2_1_1_preview_cn"] = "x2.1.1-preview-cn";
   RealtimeModel2["x2_1_1_preview_us"] = "x2.1.1-preview-us";
   return RealtimeModel2;
@@ -613,36 +609,17 @@ function isKnownModel(model) {
   return Object.values(RealtimeModel).includes(model);
 }
 function modelDefaults(model) {
-  return isKnownModel(model) ? model : "x2.1-preview" /* x2_1_preview */;
+  return isKnownModel(model) ? model : "x2.1.1-preview-cn" /* x2_1_1_preview_cn */;
 }
 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-1014" /* x2_1_preview_1014 */]: "X2.1-preview-1014",
   ["x2.1.1-preview-cn" /* x2_1_1_preview_cn */]: "X2.1.1-preview-cn",
   ["x2.1.1-preview-us" /* x2_1_1_preview_us */]: "X2.1.1-preview-us"
 };
 var MODEL_BASE_URLS = {
-  ["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",
   ["x2.1.1-preview-cn" /* x2_1_1_preview_cn */]: "https://cloud.xmax.22duck.cn/open/api/v1",
   ["x2.1.1-preview-us" /* x2_1_1_preview_us */]: "https://api.xmax.ai/open/api/v1"
 };
 var RESOLUTION_BUCKETS = {
-  ["x2.0" /* x2_0 */]: [],
-  ["x2.0-trtc" /* x2_0_trtc */]: [
-    { width: 1024, height: 1920 },
-    { width: 1920, height: 1024 }
-  ],
-  ["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 }
-  ],
   ["x2.1.1-preview-cn" /* x2_1_1_preview_cn */]: [
     { width: 1024, height: 1920 },
     { width: 1920, height: 1024 }
@@ -653,10 +630,6 @@ var RESOLUTION_BUCKETS = {
   ]
 };
 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-1014" /* x2_1_preview_1014 */]: 21e5,
   ["x2.1.1-preview-cn" /* x2_1_1_preview_cn */]: 21e5,
   ["x2.1.1-preview-us" /* x2_1_1_preview_us */]: 21e5
 };
@@ -682,16 +655,10 @@ function defaultFrameRate(_model) {
   return 30;
 }
 function defaultCameraVideoFormat(model) {
-  if (modelDefaults(model) === "x2.0" /* x2_0 */) {
-    return new RealtimeVideoFormat({ width: 832, height: 1472, fps: 30 });
-  }
+  modelDefaults(model);
   return new RealtimeVideoFormat({ width: 1024, height: 1920, fps: 30 });
 }
 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-1014" /* x2_1_preview_1014 */]: Object.freeze(["agora" /* agora */]),
   ["x2.1.1-preview-cn" /* x2_1_1_preview_cn */]: Object.freeze(["agora" /* agora */]),
   ["x2.1.1-preview-us" /* x2_1_1_preview_us */]: Object.freeze(["agora" /* agora */])
 };
@@ -699,8 +666,8 @@ function supportedRtcProviders(model) {
   return isKnownModel(model) ? MODEL_RTC_PROVIDERS[model] : CUSTOM_MODEL_RTC_PROVIDERS;
 }
 var CUSTOM_MODEL_RTC_PROVIDERS = Object.freeze([
-  ...MODEL_RTC_PROVIDERS["x2.1-preview" /* x2_1_preview */],
-  ...Object.values(RtcProvider).filter((provider) => !MODEL_RTC_PROVIDERS["x2.1-preview" /* x2_1_preview */].includes(provider))
+  ...MODEL_RTC_PROVIDERS["x2.1.1-preview-cn" /* x2_1_1_preview_cn */],
+  ...Object.values(RtcProvider).filter((provider) => !MODEL_RTC_PROVIDERS["x2.1.1-preview-cn" /* x2_1_1_preview_cn */].includes(provider))
 ]);
 
 // src/Foundation/Media/Video/FrameInterpolationSupport.ts
@@ -722,9 +689,9 @@ var MediaService = class {
   /**
    * 创建媒体服务。
    *
-   * @param model 媒体输入规则使用的模型，默认为 `x2.0-trtc`。
+   * @param model 媒体输入规则使用的模型，默认为 `x2.1.1-preview-cn`。
    */
-  constructor(model = "x2.0-trtc" /* x2_0_trtc */) {
+  constructor(model = "x2.1.1-preview-cn" /* x2_1_1_preview_cn */) {
     /**
      * 模型约束
      */
@@ -3968,7 +3935,9 @@ var RESERVED_PARAMS = /* @__PURE__ */ new Set([
   "ref_image_path",
   "mirror",
   "ref_video_path",
-  "sample_method"
+  "sample_method",
+  "min_bitrate",
+  "max_bitrate"
 ]);
 function snapshotExtraParams(params) {
   if (params === void 0) return void 0;
@@ -5980,6 +5949,20 @@ var RenderController = class {
     _chunk4DE2IREAcjs.__publicField.call(void 0, this, "track");
     _chunk4DE2IREAcjs.__publicField.call(void 0, this, "target");
     _chunk4DE2IREAcjs.__publicField.call(void 0, this, "interactionEnabled", false);
+    _chunk4DE2IREAcjs.__publicField.call(void 0, this, "ready", false);
+  }
+  /**
+   * 当前远端视图是否已完成渲染预热。
+   */
+  get isReady() {
+    return this.ready;
+  }
+  /**
+   * 新任务重新等待首帧和预热，避免复用上一次任务的展示就绪状态。
+   */
+  prepareForGeneration() {
+    this.ready = false;
+    _optionalChain([this, 'access', _521 => _521.target, 'optionalAccess', _522 => _522.prepareForGeneration, 'optionalCall', _523 => _523()]);
   }
   /**
    * 注册新轨道并使旧绑定失效；本地轨道不经过该入口。
@@ -5991,27 +5974,37 @@ var RenderController = class {
       TrajectoryRegistry.register(track, new TrajectoryBinding(listener, track.videoFormat));
     }
     VideoRenderRegistry.register(track, {
+      // 临时缓解生成开头卡顿：首帧后继续播放 1000 ms，再渐入。
+      renderWarmupMs: 1e3,
+      renderWarmupCompletedHandler: () => {
+        if (this.track === track) {
+          this.ready = true;
+          _optionalChain([this, 'access', _524 => _524.callbacks, 'access', _525 => _525.onRenderWarmupCompleted, 'optionalCall', _526 => _526()]);
+        }
+      },
       frameDisplayHandler: () => {
         if (this.track === track) {
-          _optionalChain([this, 'access', _521 => _521.callbacks, 'access', _522 => _522.onFrameDisplayed, 'optionalCall', _523 => _523()]);
+          _optionalChain([this, 'access', _527 => _527.callbacks, 'access', _528 => _528.onFrameDisplayed, 'optionalCall', _529 => _529()]);
         }
       },
       attachHandler: (view) => {
         if (this.track !== track) {
           return;
         }
-        _optionalChain([this, 'access', _524 => _524.target, 'optionalAccess', _525 => _525.setFrameInterpolation, 'optionalCall', _526 => _526(void 0)]);
+        _optionalChain([this, 'access', _530 => _530.target, 'optionalAccess', _531 => _531.setFrameInterpolation, 'optionalCall', _532 => _532(void 0)]);
+        this.ready = false;
         view.isMirrored = false;
         this.target = view;
-        _optionalChain([this, 'access', _527 => _527.callbacks, 'access', _528 => _528.onAttached, 'optionalCall', _529 => _529()]);
+        _optionalChain([this, 'access', _533 => _533.callbacks, 'access', _534 => _534.onAttached, 'optionalCall', _535 => _535()]);
         view.setMediaStream(track.mediaStreamTrack ? new MediaStream([track.mediaStreamTrack]) : null);
       },
       detachHandler: (view) => {
         if (this.target === view) {
-          _optionalChain([this, 'access', _530 => _530.callbacks, 'access', _531 => _531.onDetached, 'optionalCall', _532 => _532()]);
+          this.ready = false;
+          _optionalChain([this, 'access', _536 => _536.callbacks, 'access', _537 => _537.onDetached, 'optionalCall', _538 => _538()]);
           this.target = void 0;
         }
-        _optionalChain([view, 'access', _533 => _533.setFrameInterpolation, 'optionalCall', _534 => _534(void 0)]);
+        _optionalChain([view, 'access', _539 => _539.setFrameInterpolation, 'optionalCall', _540 => _540(void 0)]);
         view.setMediaStream(null);
       }
     });
@@ -6020,16 +6013,17 @@ var RenderController = class {
    * 更新媒体画面；暂停显示时同时禁用交互。
    */
   setRemoteMedia(track) {
+    this.ready = false;
     if (this.track) {
-      _optionalChain([TrajectoryRegistry, 'access', _535 => _535.binding, 'call', _536 => _536(this.track), 'optionalAccess', _537 => _537.update, 'call', _538 => _538(!!track && this.interactionEnabled)]);
+      _optionalChain([TrajectoryRegistry, 'access', _541 => _541.binding, 'call', _542 => _542(this.track), 'optionalAccess', _543 => _543.update, 'call', _544 => _544(!!track && this.interactionEnabled)]);
     }
-    _optionalChain([this, 'access', _539 => _539.target, 'optionalAccess', _540 => _540.setMediaStream, 'call', _541 => _541(track ? new MediaStream([track]) : null)]);
+    _optionalChain([this, 'access', _545 => _545.target, 'optionalAccess', _546 => _546.setMediaStream, 'call', _547 => _547(track ? new MediaStream([track]) : null)]);
   }
   /**
    * 转交插帧配置，不重建交互视图。
    */
   setFrameInterpolation(options) {
-    _optionalChain([this, 'access', _542 => _542.target, 'optionalAccess', _543 => _543.setFrameInterpolation, 'optionalCall', _544 => _544(options)]);
+    _optionalChain([this, 'access', _548 => _548.target, 'optionalAccess', _549 => _549.setFrameInterpolation, 'optionalCall', _550 => _550(options)]);
   }
   /**
    * 更新交互绑定的输入格式和可用性。
@@ -6037,13 +6031,14 @@ var RenderController = class {
   setInteractionEnabled(enabled, format) {
     this.interactionEnabled = enabled;
     if (this.track) {
-      _optionalChain([TrajectoryRegistry, 'access', _545 => _545.binding, 'call', _546 => _546(this.track), 'optionalAccess', _547 => _547.update, 'call', _548 => _548(enabled, format)]);
+      _optionalChain([TrajectoryRegistry, 'access', _551 => _551.binding, 'call', _552 => _552(this.track), 'optionalAccess', _553 => _553.update, 'call', _554 => _554(enabled, format)]);
     }
   }
   /**
    * 先使能力失效再清空画面，迟到首帧和旧手势不能恢复已结束任务。
    */
   resetRemoteTrack() {
+    this.ready = false;
     const track = this.track;
     this.track = void 0;
     this.interactionEnabled = false;
@@ -6051,8 +6046,8 @@ var RenderController = class {
       TrajectoryRegistry.unregister(track);
       VideoRenderRegistry.unregister(track);
     }
-    _optionalChain([this, 'access', _549 => _549.target, 'optionalAccess', _550 => _550.setFrameInterpolation, 'optionalCall', _551 => _551(void 0)]);
-    _optionalChain([this, 'access', _552 => _552.target, 'optionalAccess', _553 => _553.setMediaStream, 'call', _554 => _554(null)]);
+    _optionalChain([this, 'access', _555 => _555.target, 'optionalAccess', _556 => _556.setFrameInterpolation, 'optionalCall', _557 => _557(void 0)]);
+    _optionalChain([this, 'access', _558 => _558.target, 'optionalAccess', _559 => _559.setMediaStream, 'call', _560 => _560(null)]);
     this.target = void 0;
   }
 };
@@ -6080,7 +6075,7 @@ var RealtimeContext = class {
     _chunk4DE2IREAcjs.__publicField.call(void 0, this, "referencePath");
     this.referenceVideo = init.referenceVideo && Object.freeze({ ...init.referenceVideo });
     this.prompt = init.prompt.trim();
-    const normalizedReferencePath = _optionalChain([init, 'access', _555 => _555.referencePath, 'optionalAccess', _556 => _556.trim, 'call', _557 => _557()]);
+    const normalizedReferencePath = _optionalChain([init, 'access', _561 => _561.referencePath, 'optionalAccess', _562 => _562.trim, 'call', _563 => _563()]);
     this.referencePath = normalizedReferencePath || void 0;
   }
 };
@@ -6348,7 +6343,7 @@ var RealtimeSessionService = class _RealtimeSessionService {
           return;
         }
         _RealtimeSessionService.ensureSessionActive(session);
-        await _optionalChain([handlers, 'access', _558 => _558.onRefresh, 'optionalCall', _559 => _559(session)]);
+        await _optionalChain([handlers, 'access', _564 => _564.onRefresh, 'optionalCall', _565 => _565(session)]);
       } catch (error) {
         if (this.heartbeatVersion !== version) {
           return;
@@ -6501,6 +6496,7 @@ var RealtimeConnectionState = /* @__PURE__ */ ((RealtimeConnectionState2) => {
   RealtimeConnectionState2["ready"] = "Ready";
   RealtimeConnectionState2["connecting"] = "Connecting";
   RealtimeConnectionState2["connected"] = "Connected";
+  RealtimeConnectionState2["starting"] = "Starting";
   RealtimeConnectionState2["generating"] = "Generating";
   RealtimeConnectionState2["disconnecting"] = "Disconnecting";
   return RealtimeConnectionState2;
@@ -6561,7 +6557,7 @@ var RealtimeState = class {
    * @param other 待比较的状态。
    */
   equals(other) {
-    return this.connectionState === other.connectionState && this.sessionID === other.sessionID && this.taskID === other.taskID && _optionalChain([this, 'access', _560 => _560.reason, 'optionalAccess', _561 => _561.kind]) === _optionalChain([other, 'access', _562 => _562.reason, 'optionalAccess', _563 => _563.kind]);
+    return this.connectionState === other.connectionState && this.sessionID === other.sessionID && this.taskID === other.taskID && _optionalChain([this, 'access', _566 => _566.reason, 'optionalAccess', _567 => _567.kind]) === _optionalChain([other, 'access', _568 => _568.reason, 'optionalAccess', _569 => _569.kind]);
   }
 };
 
@@ -6606,6 +6602,8 @@ var RoomEvent = class _RoomEvent {
    * @param options.videoFormat 模型生成使用的视频规格。
    * @param options.context 本次生成条件。
    * @param options.targetSize 回传尺寸，缺省时不发送；网络视频默认使用生成尺寸。
+   * @param options.minimumBitrate 服务端回传的最低码率，单位为 kbps。
+   * @param options.maximumBitrate 服务端回传的最高码率，单位为 kbps。
    * @param options.mirror 是否由后端镜像输入画面，默认 false。
    * @param options.faceRestoration 是否回贴原始人脸，默认 false。
    * @param options.extraParams 已校验的本次扩展参数，合并到 params。
@@ -6616,13 +6614,15 @@ var RoomEvent = class _RoomEvent {
       event: "start",
       params: {
         ..._RoomEvent.generationParameters(options),
+        min_bitrate: options.minimumBitrate,
+        max_bitrate: options.maximumBitrate,
         mirror: _nullishCoalesce(options.mirror, () => ( false)),
         ...options.context.referenceVideo && {
           ref_video_path: options.context.referenceVideo.path,
           sample_method: options.context.referenceVideo.sampleMethod,
           target_size: [
-            _nullishCoalesce(_optionalChain([options, 'access', _564 => _564.targetSize, 'optionalAccess', _565 => _565.width]), () => ( options.videoFormat.width)),
-            _nullishCoalesce(_optionalChain([options, 'access', _566 => _566.targetSize, 'optionalAccess', _567 => _567.height]), () => ( options.videoFormat.height))
+            _nullishCoalesce(_optionalChain([options, 'access', _570 => _570.targetSize, 'optionalAccess', _571 => _571.width]), () => ( options.videoFormat.width)),
+            _nullishCoalesce(_optionalChain([options, 'access', _572 => _572.targetSize, 'optionalAccess', _573 => _573.height]), () => ( options.videoFormat.height))
           ]
         }
       },
@@ -6652,12 +6652,14 @@ var RoomEvent = class _RoomEvent {
     });
   }
   /**
-   * 回传尺寸调整信令。
+   * 回传尺寸和码率范围调整信令，码率单位为 kbps。
    */
   static changeTargetSize(options) {
     return _RoomEvent.encode({
       event: "change_target_size",
       params: {
+        min_bitrate: options.minimumBitrate,
+        max_bitrate: options.maximumBitrate,
         target_size: [
           Math.round(options.targetSize.width),
           Math.round(options.targetSize.height)
@@ -6732,6 +6734,114 @@ var RoomEvent = class _RoomEvent {
   }
 };
 
+// src/Stream/Encoding/EncodingBitratePolicy.ts
+var _EncodingBitratePolicy = class _EncodingBitratePolicy {
+  /**
+   * 最低码率固定为 100 kbps，最高码率按尺寸和帧率计算并应用预算系数。
+   */
+  static resolve(width, height, fps) {
+    new RealtimeVideoFormat({ width, height, fps }).validate();
+    const maximum = Math.round(
+      this.resolveMaximumBitrate(width * height, fps) * this.bitrateScale
+    );
+    if (!Number.isSafeInteger(maximum)) {
+      throw new XmaxError(
+        "INVALID_CONFIGURATION" /* invalidConfiguration */,
+        "Realtime video format exceeds the supported bitrate range"
+      );
+    }
+    return { minimum: 100, maximum: Math.max(100, maximum) };
+  }
+  /**
+   * 按像素面积和帧率插值计算最高码率参考值。
+   */
+  static resolveMaximumBitrate(pixels, fps) {
+    const bitrate15 = _EncodingBitratePolicy.interpolate(
+      pixels,
+      _EncodingBitratePolicy.referenceBitratesAt15FPS
+    );
+    const first30 = _EncodingBitratePolicy.referenceBitratesAt30FPS[0];
+    let bitrate30;
+    if (pixels < first30.value) {
+      const reference15 = _EncodingBitratePolicy.interpolate(
+        first30.value,
+        _EncodingBitratePolicy.referenceBitratesAt15FPS
+      );
+      bitrate30 = bitrate15 * (first30.bitrate / reference15);
+    } else {
+      bitrate30 = _EncodingBitratePolicy.interpolate(
+        pixels,
+        _EncodingBitratePolicy.referenceBitratesAt30FPS
+      );
+    }
+    const bitrate10 = bitrate15 * (400 / 500);
+    const maximum60 = bitrate30 * (6500 / 3150);
+    return _EncodingBitratePolicy.interpolate(fps, [
+      { value: 10, bitrate: bitrate10 * 2 },
+      { value: 15, bitrate: bitrate15 * 2 },
+      { value: 30, bitrate: bitrate30 * 2 },
+      { value: 60, bitrate: maximum60 }
+    ]);
+  }
+  /**
+   * 在相邻参考点间线性插值，表外按最近端点的比例外推。
+   */
+  static interpolate(value, points) {
+    const first = points[0];
+    if (value <= first.value) {
+      return first.bitrate * (value / first.value);
+    }
+    for (let index = 1; index < points.length; index += 1) {
+      const upper = points[index];
+      if (value <= upper.value) {
+        const lower = points[index - 1];
+        const ratio = (value - lower.value) / (upper.value - lower.value);
+        return lower.bitrate + (upper.bitrate - lower.bitrate) * ratio;
+      }
+    }
+    const last = points[points.length - 1];
+    return last.bitrate * (value / last.value);
+  }
+};
+/**
+ * 最高码率相对参考值的预算系数。
+ */
+_chunk4DE2IREAcjs.__publicField.call(void 0, _EncodingBitratePolicy, "bitrateScale", 0.6);
+/**
+ * 流畅优先码率参考，按像素面积升序排列，单位为 kbps。
+ */
+_chunk4DE2IREAcjs.__publicField.call(void 0, _EncodingBitratePolicy, "referenceBitratesAt15FPS", [
+  { value: 120 * 120, bitrate: 50 },
+  { value: 160 * 120, bitrate: 65 },
+  { value: 180 * 180, bitrate: 100 },
+  { value: 240 * 180, bitrate: 120 },
+  { value: 320 * 180, bitrate: 140 },
+  { value: 320 * 240, bitrate: 200 },
+  { value: 424 * 240, bitrate: 220 },
+  { value: 360 * 360, bitrate: 260 },
+  { value: 480 * 360, bitrate: 320 },
+  { value: 640 * 360, bitrate: 400 },
+  { value: 640 * 480, bitrate: 500 },
+  { value: 848 * 480, bitrate: 610 },
+  { value: 960 * 720, bitrate: 910 },
+  { value: 1280 * 720, bitrate: 1130 },
+  { value: 1920 * 1080, bitrate: 2080 }
+]);
+/**
+ * 30 fps 的像素面积与码率参考点，单位为 kbps。
+ */
+_chunk4DE2IREAcjs.__publicField.call(void 0, _EncodingBitratePolicy, "referenceBitratesAt30FPS", [
+  { value: 360 * 360, bitrate: 400 },
+  { value: 480 * 360, bitrate: 490 },
+  { value: 640 * 360, bitrate: 600 },
+  { value: 640 * 480, bitrate: 750 },
+  { value: 848 * 480, bitrate: 930 },
+  { value: 960 * 720, bitrate: 1380 },
+  { value: 1280 * 720, bitrate: 1710 },
+  { value: 1920 * 1080, bitrate: 3150 }
+]);
+var EncodingBitratePolicy = _EncodingBitratePolicy;
+
 // src/Stream/Room/RoomHeartbeat.ts
 var RoomHeartbeat = class {
   /**
@@ -7022,7 +7132,7 @@ var RoomController = class {
    *
    * @throws 已有房间未离开、操作失效或进房失败时抛出错误。
    */
-  async join(connection, ensureActive2) {
+  async join(connection, ensureActive2, measureRtcJoin) {
     try {
       ensureActive2();
     } catch (error) {
@@ -7041,11 +7151,14 @@ var RoomController = class {
       if (!this.customCodec) this.codec = new RoomMessageCodec(
         connection.provider === "vertc" /* vertc */ ? null : connection.provider === "agora" /* agora */ ? "__agora_chunk__" : "__trtc_chunk__"
       );
-      await this.rtcManager.joinRoom(toRoomJoinConfiguration(connection));
+      const configuration = toRoomJoinConfiguration(connection);
+      const completeRtcJoin = _optionalChain([measureRtcJoin, 'optionalCall', _574 => _574()]);
+      await this.rtcManager.joinRoom(configuration);
       ensureActive2();
       if (this.state.kind !== "joining" || this.state.operationID !== operationID || this.leaveOperation) {
         throw new XmaxError("CANCELLED" /* cancelled */, "RTC room join was cancelled");
       }
+      _optionalChain([completeRtcJoin, 'optionalCall', _575 => _575()]);
       this.state = { kind: "joined", userID: connection.userID };
       this.heartbeat.start(connection.userID);
     } catch (error) {
@@ -7097,7 +7210,8 @@ var RoomController = class {
         targetSize: options.targetSize,
         mirror: _nullishCoalesce(options.mirror, () => ( false)),
         faceRestoration: _nullishCoalesce(options.faceRestoration, () => ( false)),
-        extraParams: options.extraParams
+        extraParams: options.extraParams,
+        ...this.downlinkBitrates(_nullishCoalesce(options.targetSize, () => ( options.videoFormat)))
       })
     );
   }
@@ -7136,10 +7250,23 @@ var RoomController = class {
       RoomEvent.changeTargetSize({
         userID: this.requireUserID(),
         taskID: options.taskID,
-        targetSize: options.targetSize
+        targetSize: options.targetSize,
+        ...this.downlinkBitrates(options.targetSize)
       })
     );
   }
+  /**
+   * 按回传尺寸和 24 fps 估算下行码率，最高值限制在 100～10000 kbps。
+   * 估算不设置服务端帧率，也不沿用显式上传码率。
+   */
+  downlinkBitrates(size) {
+    const { maximum } = EncodingBitratePolicy.resolve(
+      Math.round(size.width),
+      Math.round(size.height),
+      24
+    );
+    return { minimumBitrate: 100, maximumBitrate: Math.min(1e4, maximum) };
+  }
   /**
    * 尝试发送生成停止信令；未进房或任务标识为空时忽略。
    */
@@ -7198,7 +7325,7 @@ var RoomController = class {
     if (targetUserID && ownUserID && targetUserID !== ownUserID) {
       return;
     }
-    _optionalChain([this, 'access', _568 => _568.listener, 'optionalAccess', _569 => _569.onRoomMessage, 'call', _570 => _570(senderUserID, message)]);
+    _optionalChain([this, 'access', _576 => _576.listener, 'optionalAccess', _577 => _577.onRoomMessage, 'call', _578 => _578(senderUserID, message)]);
   }
   /**
    * 发送房间信令并输出日志。
@@ -7241,7 +7368,7 @@ var ENCODER_PREFERENCE_MAP = {
   ["maintainFramerate" /* maintainFramerate */]: "maintainFramerate" /* maintainFramerate */,
   ["maintainQuality" /* maintainQuality */]: "maintainQuality" /* maintainQuality */
 };
-var _EncodingController = class _EncodingController {
+var EncodingController = class {
   /**
    * 创建编码控制器。
    *
@@ -7266,21 +7393,13 @@ var _EncodingController = class _EncodingController {
       minimum = videoFormat.minimumBitrate;
       maximum = videoFormat.maximumBitrate;
     } else {
-      const bitrates = _EncodingController.resolveBitrates(
-        videoFormat.width * videoFormat.height,
+      const defaults = EncodingBitratePolicy.resolve(
+        videoFormat.width,
+        videoFormat.height,
         videoFormat.fps
       );
-      const maximumBitrate = Math.round(bitrates.maximum);
-      if (!Number.isFinite(maximumBitrate)) {
-        throw new XmaxError(
-          "INVALID_CONFIGURATION" /* invalidConfiguration */,
-          "Realtime video format exceeds the supported bitrate range"
-        );
-      }
-      const defaultMinimum = Math.max(1, Math.round(bitrates.minimum));
-      const defaultMaximum = Math.max(defaultMinimum + 1, maximumBitrate);
-      minimum = _nullishCoalesce(videoFormat.minimumBitrate, () => ( defaultMinimum));
-      maximum = _nullishCoalesce(videoFormat.maximumBitrate, () => ( defaultMaximum));
+      minimum = _nullishCoalesce(videoFormat.minimumBitrate, () => ( defaults.minimum));
+      maximum = _nullishCoalesce(videoFormat.maximumBitrate, () => ( defaults.maximum));
     }
     if (minimum > maximum) {
       throw new XmaxError(
@@ -7321,97 +7440,7 @@ var _EncodingController = class _EncodingController {
     }
     return format;
   }
-  /**
-   * 按像素面积与帧率计算码率区间（kbps）：流畅优先为最低，画质优先为最高。
-   */
-  static resolveBitrates(pixels, fps) {
-    const bitrate15 = _EncodingController.interpolate(
-      pixels,
-      _EncodingController.referenceBitratesAt15FPS
-    );
-    const first30 = _EncodingController.referenceBitratesAt30FPS[0];
-    let bitrate30;
-    if (pixels < first30.value) {
-      const reference15 = _EncodingController.interpolate(
-        first30.value,
-        _EncodingController.referenceBitratesAt15FPS
-      );
-      bitrate30 = bitrate15 * (first30.bitrate / reference15);
-    } else {
-      bitrate30 = _EncodingController.interpolate(
-        pixels,
-        _EncodingController.referenceBitratesAt30FPS
-      );
-    }
-    const bitrate10 = bitrate15 * (400 / 500);
-    const minimum60 = bitrate30 * (4780 / 3150);
-    const maximum60 = bitrate30 * (6500 / 3150);
-    return {
-      minimum: _EncodingController.interpolate(fps, [
-        { value: 10, bitrate: bitrate10 },
-        { value: 15, bitrate: bitrate15 },
-        { value: 30, bitrate: bitrate30 },
-        { value: 60, bitrate: minimum60 }
-      ]),
-      maximum: _EncodingController.interpolate(fps, [
-        { value: 10, bitrate: bitrate10 * 2 },
-        { value: 15, bitrate: bitrate15 * 2 },
-        { value: 30, bitrate: bitrate30 * 2 },
-        { value: 60, bitrate: maximum60 }
-      ])
-    };
-  }
-  /**
-   * 在相邻参考点间线性插值，表外按最近端点的比例外推。
-   */
-  static interpolate(value, points) {
-    const first = points[0];
-    if (value <= first.value) {
-      return first.bitrate * (value / first.value);
-    }
-    for (let index = 1; index < points.length; index += 1) {
-      const upper = points[index];
-      if (value <= upper.value) {
-        const lower = points[index - 1];
-        const ratio = (value - lower.value) / (upper.value - lower.value);
-        return lower.bitrate + (upper.bitrate - lower.bitrate) * ratio;
-      }
-    }
-    const last = points[points.length - 1];
-    return last.bitrate * (value / last.value);
-  }
 };
-/**
- * 流畅优先码率参考，按像素面积升序排列，单位为 kbps。
- */
-_chunk4DE2IREAcjs.__publicField.call(void 0, _EncodingController, "referenceBitratesAt15FPS", [
-  { value: 120 * 120, bitrate: 50 },
-  { value: 160 * 120, bitrate: 65 },
-  { value: 180 * 180, bitrate: 100 },
-  { value: 240 * 180, bitrate: 120 },
-  { value: 320 * 180, bitrate: 140 },
-  { value: 320 * 240, bitrate: 200 },
-  { value: 424 * 240, bitrate: 220 },
-  { value: 360 * 360, bitrate: 260 },
-  { value: 480 * 360, bitrate: 320 },
-  { value: 640 * 360, bitrate: 400 },
-  { value: 640 * 480, bitrate: 500 },
-  { value: 848 * 480, bitrate: 610 },
-  { value: 960 * 720, bitrate: 910 },
-  { value: 1280 * 720, bitrate: 1130 },
-  { value: 1920 * 1080, bitrate: 2080 }
-]);
-_chunk4DE2IREAcjs.__publicField.call(void 0, _EncodingController, "referenceBitratesAt30FPS", [
-  { value: 360 * 360, bitrate: 400 },
-  { value: 480 * 360, bitrate: 490 },
-  { value: 640 * 360, bitrate: 600 },
-  { value: 640 * 480, bitrate: 750 },
-  { value: 848 * 480, bitrate: 930 },
-  { value: 960 * 720, bitrate: 1380 },
-  { value: 1280 * 720, bitrate: 1710 },
-  { value: 1920 * 1080, bitrate: 3150 }
-]);
-var EncodingController = _EncodingController;
 
 // src/Stream/StreamController.ts
 function makeInitialState() {
@@ -7480,7 +7509,7 @@ var StreamController = class {
     this.roomController.setListener({
       onRoomMessage: (sender, message) => {
         this.handleNetworkVideoCompletion(sender, message);
-        _optionalChain([this, 'access', _571 => _571.roomListener, 'optionalAccess', _572 => _572.onRoomMessage, 'call', _573 => _573(sender, message)]);
+        _optionalChain([this, 'access', _579 => _579.roomListener, 'optionalAccess', _580 => _580.onRoomMessage, 'call', _581 => _581(sender, message)]);
       }
     });
     this.rtcManager.setEventListener({
@@ -7490,18 +7519,18 @@ var StreamController = class {
       onError: (error) => this.errorListener(error),
       onNetworkStatistics: (statistics) => {
         if (this.state.roomID) {
-          _optionalChain([this, 'access', _574 => _574.networkStatisticsListener, 'optionalCall', _575 => _575(statistics)]);
+          _optionalChain([this, 'access', _582 => _582.networkStatisticsListener, 'optionalCall', _583 => _583(statistics)]);
         }
       },
       onRemoteVideoStatistics: (statistics) => {
-        const userID = _optionalChain([this, 'access', _576 => _576.state, 'access', _577 => _577.activeRemoteStream, 'optionalAccess', _578 => _578.userID]);
-        _optionalChain([this, 'access', _579 => _579.remoteVideoStatisticsListener, 'optionalCall', _580 => _580(
+        const userID = _optionalChain([this, 'access', _584 => _584.state, 'access', _585 => _585.activeRemoteStream, 'optionalAccess', _586 => _586.userID]);
+        _optionalChain([this, 'access', _587 => _587.remoteVideoStatisticsListener, 'optionalCall', _588 => _588(
           userID ? statistics.find((item) => item.userID === userID) : void 0
         )]);
       },
       onLocalVideoStatistics: (statistics) => {
         if (this.state.localVideoPublished) {
-          _optionalChain([this, 'access', _581 => _581.localVideoStatisticsListener, 'optionalCall', _582 => _582(statistics)]);
+          _optionalChain([this, 'access', _589 => _589.localVideoStatisticsListener, 'optionalCall', _590 => _590(statistics)]);
         }
       },
       onCustomMessageReceived: (senderUserID, message) => {
@@ -7522,7 +7551,7 @@ var StreamController = class {
    * 按活动结果流身份读取原始音视频，避免录制房间内其他用户的媒体。
    */
   getRemoteRecordingTracks() {
-    const userID = _optionalChain([this, 'access', _583 => _583.state, 'access', _584 => _584.activeRemoteStream, 'optionalAccess', _585 => _585.userID]);
+    const userID = _optionalChain([this, 'access', _591 => _591.state, 'access', _592 => _592.activeRemoteStream, 'optionalAccess', _593 => _593.userID]);
     const videoTrack = userID && this.state.remoteVideoTracks.get(userID);
     if (!userID || !videoTrack) {
       return void 0;
@@ -7580,16 +7609,16 @@ var StreamController = class {
    *
    * @throws 连接已取消，或 RTC 进房、房间配置与本地流发布失败时抛出错误。
    */
-  async connect(connection, includeLocalAudio, ensureActive2, beforePublish, publishLocalMedia = true) {
+  async connect(connection, includeLocalAudio, ensureActive2, beforePublish, publishLocalMedia = true, measureRtcJoin) {
     this.configureRoom({ roomID: connection.roomID, botID: connection.botID });
-    await this.roomController.join(connection, ensureActive2);
+    await this.roomController.join(connection, ensureActive2, measureRtcJoin);
     ensureActive2();
     XmaxLogger.stream.info(
       () => `RTC \u623F\u95F4\u5DF2\u914D\u7F6E (RTC Room Configured)
 \u2514\u2500 roomID: ${connection.roomID}, botID: ${_nullishCoalesce(connection.botID, () => ( "(\u672A\u8BBE\u7F6E)"))}`
     );
     if (publishLocalMedia) {
-      await _optionalChain([beforePublish, 'optionalCall', _586 => _586()]);
+      await _optionalChain([beforePublish, 'optionalCall', _594 => _594()]);
       ensureActive2();
       await this.publishLocalStream(includeLocalAudio);
     }
@@ -7679,7 +7708,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', _587 => _587.onStartSent, 'optionalCall', _588 => _588()]);
+        await _optionalChain([options, 'access', _595 => _595.onStartSent, 'optionalCall', _596 => _596()]);
         if (this.state !== state2 || state2.generationTaskID !== taskID) return;
         for (const userID of state2.publishedRemoteUserIDs) {
           void this.handleRemoteVideoPublished(userID, true);
@@ -7825,7 +7854,7 @@ var StreamController = class {
   deliverNetworkVideoCompletion() {
     const state2 = this.state;
     const completion = state2.networkVideoCompletion;
-    if (!_optionalChain([completion, 'optionalAccess', _589 => _589.finished]) || !completion.onFinish || completion.scheduled) {
+    if (!_optionalChain([completion, 'optionalAccess', _597 => _597.finished]) || !completion.onFinish || completion.scheduled) {
       return;
     }
     completion.scheduled = true;
@@ -7834,7 +7863,7 @@ var StreamController = class {
         return;
       }
       try {
-        void Promise.resolve(_optionalChain([completion, 'access', _590 => _590.onFinish, 'optionalCall', _591 => _591()])).catch(() => {
+        void Promise.resolve(_optionalChain([completion, 'access', _598 => _598.onFinish, 'optionalCall', _599 => _599()])).catch(() => {
         });
       } catch (e27) {
       }
@@ -7845,7 +7874,7 @@ var StreamController = class {
    */
   configureRoom(options) {
     const roomID = options.roomID.trim();
-    const botID = _nullishCoalesce(_optionalChain([options, 'access', _592 => _592.botID, 'optionalAccess', _593 => _593.trim, 'call', _594 => _594()]), () => ( ""));
+    const botID = _nullishCoalesce(_optionalChain([options, 'access', _600 => _600.botID, 'optionalAccess', _601 => _601.trim, 'call', _602 => _602()]), () => ( ""));
     if (!roomID) {
       throw new XmaxError(
         "INVALID_CONFIGURATION" /* invalidConfiguration */,
@@ -7928,7 +7957,7 @@ var StreamController = class {
       return;
     }
     this.state.subscribedRemoteUserIDs.delete(trimmedUserID);
-    if (_optionalChain([this, 'access', _595 => _595.state, 'access', _596 => _596.activeRemoteStream, 'optionalAccess', _597 => _597.userID]) === trimmedUserID) {
+    if (_optionalChain([this, 'access', _603 => _603.state, 'access', _604 => _604.activeRemoteStream, 'optionalAccess', _605 => _605.userID]) === trimmedUserID) {
       await this.unsubscribeRemoteAudio(trimmedUserID);
       this.state.activeRemoteStream = void 0;
       this.clearRemoteStream();
@@ -8118,7 +8147,7 @@ var StreamController = class {
    */
   resolveGenerationStart(taskID) {
     const waiter = this.state.generationWaiter;
-    if (this.state.generationTaskID !== taskID || _optionalChain([waiter, 'optionalAccess', _598 => _598.taskID]) !== taskID) {
+    if (this.state.generationTaskID !== taskID || _optionalChain([waiter, 'optionalAccess', _606 => _606.taskID]) !== taskID) {
       return;
     }
     this.state.generationWaiter = void 0;
@@ -8130,7 +8159,7 @@ var StreamController = class {
    */
   rejectGenerationStart(taskID, error) {
     const waiter = this.state.generationWaiter;
-    if (this.state.generationTaskID !== taskID || _optionalChain([waiter, 'optionalAccess', _599 => _599.taskID]) !== taskID) {
+    if (this.state.generationTaskID !== taskID || _optionalChain([waiter, 'optionalAccess', _607 => _607.taskID]) !== taskID) {
       return;
     }
     this.state.generationWaiter = void 0;
@@ -8141,7 +8170,7 @@ var StreamController = class {
    * 通知渲染层清理远端生成流；失败仅记录日志。
    */
   clearRemoteStream() {
-    _optionalChain([this, 'access', _600 => _600.remoteVideoStatisticsListener, 'optionalCall', _601 => _601(void 0)]);
+    _optionalChain([this, 'access', _608 => _608.remoteVideoStatisticsListener, 'optionalCall', _609 => _609(void 0)]);
     try {
       this.remoteStreamListener(null);
     } catch (error) {
@@ -8180,12 +8209,13 @@ var StreamController = class {
 
 // src/Stream/Quality/QualityTiers.ts
 var INITIAL_QUALITY_LEVEL = 2;
+var MINIMUM_QUALITY_SHORT_SIDE = 240;
 var QUALITY_TIERS = {
-  L1: { width: 1024, height: 1920, frameRate: 30 },
-  L2: { width: 768, height: 1440, frameRate: 24 },
-  L3: { width: 640, height: 1200, frameRate: 24 },
-  L4: { width: 512, height: 960, frameRate: 20 },
-  L5: { width: 384, height: 720, frameRate: 16 }
+  L1: { scale: 1, width: 1024, height: 1920, frameRate: 30 },
+  L2: { scale: 0.8, width: 818, height: 1536, frameRate: 24 },
+  L3: { scale: 0.65, width: 664, height: 1248, frameRate: 24 },
+  L4: { scale: 0.5, width: 512, height: 960, frameRate: 20 },
+  L5: { scale: 0.4, width: 408, height: 768, frameRate: 16 }
 };
 
 // src/Stream/Quality/QualityPolicy.ts
@@ -8201,9 +8231,13 @@ var DEFAULT_POLICY = {
 // src/Stream/Quality/QualityController.ts
 var ORDERED_QUALITY_TIERS = Object.values(QUALITY_TIERS);
 var QualityController = class {
-  constructor(apply, now = () => performance.now(), policy = {}) {
+  /**
+   * 创建调档状态机；候选档位不满足编码约束时保持当前档位，不跨档尝试。
+   */
+  constructor(apply, now = () => performance.now(), policy = {}, canApply = () => true) {
     _chunk4DE2IREAcjs.__publicField.call(void 0, this, "apply", apply);
     _chunk4DE2IREAcjs.__publicField.call(void 0, this, "now", now);
+    _chunk4DE2IREAcjs.__publicField.call(void 0, this, "canApply", canApply);
     _chunk4DE2IREAcjs.__publicField.call(void 0, this, "policy");
     _chunk4DE2IREAcjs.__publicField.call(void 0, this, "active", false);
     _chunk4DE2IREAcjs.__publicField.call(void 0, this, "index", 0);
@@ -8293,10 +8327,13 @@ var QualityController = class {
     this.good = this.poor = 0;
   }
   async change(index, reason) {
+    this.resetCounts();
+    if (!this.canApply(index + 1)) {
+      return;
+    }
     const lifecycle = this.lifecycle;
     const change = { from: this.index + 1, to: index + 1, ...ORDERED_QUALITY_TIERS[index], reason };
     this.switching = true;
-    this.resetCounts();
     try {
       await this.apply(change, lifecycle.signal);
       if (lifecycle.signal.aborted) return;
@@ -8321,12 +8358,20 @@ var QualityController = class {
 // src/Stream/Quality/QualityVideoFormat.ts
 function qualityVideoSize(baseline, level) {
   const tier = Object.values(QUALITY_TIERS)[level - 1];
-  if (!Number.isInteger(level) || !tier) throw new Error("Unsupported quality level");
+  if (!Number.isInteger(level) || !tier) {
+    throw new Error("Unsupported quality level");
+  }
   baseline.validate();
-  const scale = tier.width / QUALITY_TIERS.L1.width;
-  const even = (value) => Math.max(2, Math.floor(value / 2) * 2);
+  const shortSide = Math.min(baseline.width, baseline.height);
+  const minimum = Math.min(shortSide, MINIMUM_QUALITY_SHORT_SIDE);
+  const scale = Math.max(tier.scale, minimum / shortSide);
+  const even = (value) => Math.max(2, Math.floor(value / 2 + 1e-9) * 2);
   return { width: even(baseline.width * scale), height: even(baseline.height * scale) };
 }
+function supportsQualityEncoding(format) {
+  const defaults = EncodingBitratePolicy.resolve(format.width, format.height, format.fps);
+  return (_nullishCoalesce(format.minimumBitrate, () => ( defaults.minimum))) <= (_nullishCoalesce(format.maximumBitrate, () => ( defaults.maximum)));
+}
 function qualityVideoFormat(baseline, level) {
   const size = qualityVideoSize(baseline, level);
   const tier = Object.values(QUALITY_TIERS)[level - 1];
@@ -8338,35 +8383,59 @@ function qualityVideoFormat(baseline, level) {
 }
 
 // src/Stream/Quality/QualityHistory.ts
-var QualityHistory = class {
-  constructor(model, provider) {
+var _QualityHistory = class _QualityHistory {
+  /**
+   * 创建按模型与 RTC 提供方隔离的档位存储。
+   */
+  constructor(model, provider, now = Date.now) {
     _chunk4DE2IREAcjs.__publicField.call(void 0, this, "model", model);
     _chunk4DE2IREAcjs.__publicField.call(void 0, this, "provider", provider);
+    _chunk4DE2IREAcjs.__publicField.call(void 0, this, "now", now);
   }
-  /** 无记录、损坏、SSR 或浏览器禁止存储时使用默认 L2。 */
+  /**
+   * 无记录、过期、损坏、时钟回退或存储不可用时使用默认 L2。
+   */
   read(direction) {
     try {
-      const level = Number(globalThis.localStorage.getItem(this.key(direction)));
-      if (this.isValid(level)) return level;
+      const entry = JSON.parse(_nullishCoalesce(globalThis.localStorage.getItem(this.key(direction)), () => ( "null")));
+      const now = this.now();
+      if (entry && this.isValid(entry.level) && Number.isFinite(entry.savedAt) && entry.savedAt > 0 && now >= entry.savedAt && now - entry.savedAt < _QualityHistory.expirationMs) {
+        return entry.level;
+      }
     } catch (e28) {
     }
     return INITIAL_QUALITY_LEVEL;
   }
-  /** 仅在应用成功后调用；下行成功表示信令已发送，不代表服务端已确认生效。 */
+  /**
+   * 应用成功后保存档位并刷新一小时有效期；下行成功仅表示信令已发送。
+   */
   write(direction, level) {
-    if (!this.isValid(level)) return;
+    if (!this.isValid(level)) {
+      return;
+    }
     try {
-      globalThis.localStorage.setItem(this.key(direction), String(level));
+      globalThis.localStorage.setItem(this.key(direction), JSON.stringify({ level, savedAt: this.now() }));
     } catch (e29) {
     }
   }
+  /**
+   * 生成当前方向的存储键；无时间戳的旧记录按无效记录处理。
+   */
   key(direction) {
     return `xmax:quality:v1:${this.provider}:${encodeURIComponent(this.model)}:${direction}`;
   }
+  /**
+   * 校验档位编号。
+   */
   isValid(level) {
     return Number.isInteger(level) && level >= 1 && level <= Object.keys(QUALITY_TIERS).length;
   }
 };
+/**
+ * 历史档位有效期，单位为毫秒。
+ */
+_chunk4DE2IREAcjs.__publicField.call(void 0, _QualityHistory, "expirationMs", 60 * 60 * 1e3);
+var QualityHistory = _QualityHistory;
 
 // src/Core/Realtime/RealtimeCoordinator.ts
 function scopeAffects(scope, kind) {
@@ -8504,7 +8573,7 @@ var RealtimeCoordinator = class _RealtimeCoordinator {
       await this.errorHandler.report(error);
       throw error;
     }
-    const operationKind = kind === "generation" /* generation */ && this.state.connectionState === "Generating" /* generating */ ? "configuration" /* configuration */ : kind;
+    const operationKind = kind === "generation" /* generation */ && (this.state.connectionState === "Generating" /* generating */ || this.state.connectionState === "Starting" /* starting */ && !!this.state.taskID) ? "configuration" /* configuration */ : kind;
     const lease = new OperationLease(failureScope);
     const resultPromise = (async () => body(lease))();
     const operation = {
@@ -8544,6 +8613,19 @@ var RealtimeCoordinator = class _RealtimeCoordinator {
       new RealtimeState({ connectionState: "Ready" /* ready */ })
     );
   }
+  /**
+   * 当前生成任务和远端展示均就绪后进入 generating；迟到通知不恢复已结束任务。
+   */
+  async remotePreviewDidBecomeReady(sessionID, taskID, isCurrent) {
+    if (this.termination || this.state.connectionState !== "Starting" /* starting */ || this.state.sessionID !== sessionID || this.state.taskID !== taskID || !isCurrent()) {
+      return;
+    }
+    await this.setState(new RealtimeState({
+      connectionState: "Generating" /* generating */,
+      sessionID,
+      taskID
+    }));
+  }
   /**
    * 断开实时连接；尚未提交连接状态的活跃操作也会被取消。
    */
@@ -8606,7 +8688,7 @@ var RealtimeCoordinator = class _RealtimeCoordinator {
         }
         throw _RealtimeCoordinator.cancelledError();
       }
-      const terminationTask = await _asyncNullishCoalesce(await _asyncNullishCoalesce(operation.terminationTask, async () => ( _optionalChain([this, 'access', _602 => _602.termination, 'optionalAccess', _603 => _603.task]))), async () => ( await this.requestTermination(
+      const terminationTask = await _asyncNullishCoalesce(await _asyncNullishCoalesce(operation.terminationTask, async () => ( _optionalChain([this, 'access', _610 => _610.termination, 'optionalAccess', _611 => _611.task]))), async () => ( await this.requestTermination(
         _nullishCoalesce(operation.lease.failureScope, () => ( 0)) /* connection */,
         void 0,
         RealtimeReason.normal,
@@ -8735,7 +8817,7 @@ var RealtimeCoordinator = class _RealtimeCoordinator {
    * 结束指定操作，释放操作准入场。
    */
   finish(operation) {
-    if (_optionalChain([this, 'access', _604 => _604.activeOperation, 'optionalAccess', _605 => _605.id]) === operation.id) {
+    if (_optionalChain([this, 'access', _612 => _612.activeOperation, 'optionalAccess', _613 => _613.id]) === operation.id) {
       this.activeOperation = void 0;
     }
   }
@@ -8747,7 +8829,7 @@ var RealtimeCoordinator = class _RealtimeCoordinator {
       return;
     }
     this.state = nextState;
-    _optionalChain([this, 'access', _606 => _606.stateListener, 'optionalCall', _607 => _607(nextState)]);
+    _optionalChain([this, 'access', _614 => _614.stateListener, 'optionalCall', _615 => _615(nextState)]);
   }
   /**
    * 构造统一的操作取消错误。
@@ -8836,11 +8918,16 @@ var RealtimeLaunchTimer = class {
     return this.measure("permissionMs", performance.now());
   }
   /**
-   * 开始会话与进房计时，返回连接阶段完成时调用的记录函数。
-   * 相机预热等待计入连接耗时。
+   * 开始创建业务会话的计时。
+   */
+  startSession() {
+    return this.measure("sessionMs", performance.now());
+  }
+  /**
+   * 开始 RTC 适配器进房调用的计时。
    */
-  startConnection() {
-    return this.measure("connectionMs", performance.now());
+  startRtcJoin() {
+    return this.measure("rtcJoinMs", performance.now());
   }
   /**
    * 开始发布本地流计时，返回发布完成时调用的记录函数。
@@ -8849,11 +8936,17 @@ var RealtimeLaunchTimer = class {
     return this.measure("publishMs", performance.now());
   }
   /**
-   * 开始等待远端显示首帧；完成回调同时记录首帧耗时和实际总耗时。
+   * 开始等待远端首帧提交合成器，不包含后续渲染预热。
    */
   startFirstFrame() {
     return this.measure("firstFrameMs", performance.now());
   }
+  /**
+   * 首帧就绪后开始渲染预热；结束时记录预热及实际总耗时，不含渐入动画。
+   */
+  startRenderWarmup() {
+    return this.measure("renderWarmupMs", performance.now());
+  }
   /**
    * 冻结本轮结果，令尚未完成的回调失效；下一轮相机启动才重置。
    */
@@ -8874,7 +8967,7 @@ var RealtimeLaunchTimer = class {
       this.snapshot = Object.freeze({
         ...this.snapshot,
         [key]: now - startedAt,
-        ...key === "firstFrameMs" ? { totalMs: now - this.startedAt } : {}
+        ...key === "renderWarmupMs" ? { totalMs: now - this.startedAt } : {}
       });
       this.notify();
     };
@@ -8884,7 +8977,7 @@ var RealtimeLaunchTimer = class {
    */
   notify() {
     try {
-      void Promise.resolve(_optionalChain([this, 'access', _608 => _608.listener, 'optionalCall', _609 => _609(this.snapshot)])).catch(() => {
+      void Promise.resolve(_optionalChain([this, 'access', _616 => _616.listener, 'optionalCall', _617 => _617(this.snapshot)])).catch(() => {
       });
     } catch (e30) {
     }
@@ -8915,7 +9008,7 @@ var XmaxRealtimeConnectionManager = class {
    * 当前活动会话标识；尚未连接或清理完成后为空。
    */
   get currentSessionID() {
-    return _optionalChain([this, 'access', _610 => _610.activeSession, 'optionalAccess', _611 => _611.id]);
+    return _optionalChain([this, 'access', _618 => _618.activeSession, 'optionalAccess', _619 => _619.id]);
   }
   /**
    * 未配置 API 服务时在连接操作开始前报错，不影响本地预览。
@@ -8925,8 +9018,8 @@ var XmaxRealtimeConnectionManager = class {
   }
   /**
    * 创建会话、配置编码、进房并发布本地媒体，启动心跳后返回远端占位流。
-   * 进房结束即记录连接耗时；可选 beforePublish 检查阻塞发布，计入连接耗时；
-   * 发布本地流单独计时。
+   * 会话创建、RTC 进房和本地流发布分别计时；可选 beforePublish 检查阻塞发布，
+   * 其等待只反映在实际完整启动耗时中。
    * @param options.localTrack 当前本地媒体轨道。
    * @param options.remoteVideoFormat 原始生成及远端画面规格，缺省使用本地轨道规格。
    * @param options.localVideoFormat 发布前实际应用的上行编码格式；与原始生成及远端格式分开。
@@ -8943,10 +9036,11 @@ var XmaxRealtimeConnectionManager = class {
     const sessionService = this.requireSessionService();
     const streamController = this.dependencies.streamController;
     options.ensureCurrent();
-    const completeConnection = this.dependencies.timing.startConnection();
+    const completeSession = this.dependencies.timing.startSession();
     const session = await sessionService.createSession(options.model);
     this.activeSession = session;
     options.ensureCurrent();
+    completeSession();
     const connection = session.connection;
     if (!connection) {
       throw new XmaxError(
@@ -8970,7 +9064,7 @@ var XmaxRealtimeConnectionManager = class {
     if (publishLocalMedia) {
       await streamController.updateUplinkVideoFormat(videoFormat);
       options.ensureCurrent();
-      _optionalChain([options, 'access', _612 => _612.onVideoEncoderConfigured, 'optionalCall', _613 => _613()]);
+      _optionalChain([options, 'access', _620 => _620.onVideoEncoderConfigured, 'optionalCall', _621 => _621()]);
     }
     options.ensureCurrent();
     let completePublish;
@@ -8978,13 +9072,12 @@ var XmaxRealtimeConnectionManager = class {
       options.ensureCurrent();
     }, async () => {
       options.ensureCurrent();
-      await _optionalChain([options, 'access', _614 => _614.beforePublish, 'optionalCall', _615 => _615()]);
-      completeConnection();
+      await _optionalChain([options, 'access', _622 => _622.beforePublish, 'optionalCall', _623 => _623()]);
+      options.ensureCurrent();
       completePublish = this.dependencies.timing.startPublish();
-    }, publishLocalMedia);
+    }, publishLocalMedia, () => this.dependencies.timing.startRtcJoin());
     options.ensureCurrent();
-    completeConnection();
-    _optionalChain([completePublish, 'optionalCall', _616 => _616()]);
+    _optionalChain([completePublish, 'optionalCall', _624 => _624()]);
     options.onPublished();
     sessionService.startHeartbeat(session.id, {
       onFailure: (sessionID, error) => {
@@ -9014,11 +9107,11 @@ var XmaxRealtimeConnectionManager = class {
    */
   stopHeartbeat() {
     this.refreshVersion++;
-    _optionalChain([this, 'access', _617 => _617.credentialController, 'optionalAccess', _618 => _618.abort, 'call', _619 => _619()]);
+    _optionalChain([this, 'access', _625 => _625.credentialController, 'optionalAccess', _626 => _626.abort, 'call', _627 => _627()]);
     this.credentialController = void 0;
     this.credentialRefresh = void 0;
     this.credentialApplication = Promise.resolve();
-    _optionalChain([this, 'access', _620 => _620.dependencies, 'access', _621 => _621.sessionService, 'optionalAccess', _622 => _622.stopHeartbeat, 'call', _623 => _623()]);
+    _optionalChain([this, 'access', _628 => _628.dependencies, 'access', _629 => _629.sessionService, 'optionalAccess', _630 => _630.stopHeartbeat, 'call', _631 => _631()]);
   }
   /**
    * RTC Token 过期时复用会话心跳获取新凭据，并合并同一实例的并发请求。
@@ -9026,14 +9119,14 @@ var XmaxRealtimeConnectionManager = class {
   async refreshCredentials() {
     if (this.credentialRefresh) return this.credentialRefresh;
     const current = this.activeSession;
-    if (!_optionalChain([current, 'optionalAccess', _624 => _624.connection]) || current.connection.provider === "trtc" /* trtc */) return;
+    if (!_optionalChain([current, 'optionalAccess', _632 => _632.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', _625 => _625.activeSession, 'optionalAccess', _626 => _626.id]) === current.id) {
+        if (version === this.refreshVersion && _optionalChain([this, 'access', _633 => _633.activeSession, 'optionalAccess', _634 => _634.id]) === current.id) {
           this.dependencies.onHeartbeatFailure(current.id, XmaxError.from(error));
         }
       }
@@ -9050,7 +9143,7 @@ var XmaxRealtimeConnectionManager = class {
    */
   async waitUntilRemoteTrackReady(timeoutMs, signal) {
     if (signal.aborted) throw RealtimeCoordinator.cancelledError();
-    const mediaTrack = _optionalChain([this, 'access', _627 => _627.activeRemoteTrack, 'optionalAccess', _628 => _628.mediaStreamTrack]);
+    const mediaTrack = _optionalChain([this, 'access', _635 => _635.activeRemoteTrack, 'optionalAccess', _636 => _636.mediaStreamTrack]);
     if (!mediaTrack || !mediaTrack.muted) return;
     await new Promise((resolve, reject) => {
       const cleanup = () => {
@@ -9144,7 +9237,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', _629 => _629.credentialController, 'optionalAccess', _630 => _630.signal]));
+      await this.dependencies.streamController.updateCredentials(next, _optionalChain([this, 'access', _637 => _637.credentialController, 'optionalAccess', _638 => _638.signal]));
       if (version !== this.refreshVersion || this.activeSession !== current) return;
     }
     this.activeSession = new RealtimeSession({
@@ -9159,7 +9252,7 @@ var XmaxRealtimeConnectionManager = class {
    * 尽力清理全部连接资源，即使退房失败也关闭服务端会话。
    */
   async disconnect() {
-    const sessionID = _optionalChain([this, 'access', _631 => _631.activeSession, 'optionalAccess', _632 => _632.id]);
+    const sessionID = _optionalChain([this, 'access', _639 => _639.activeSession, 'optionalAccess', _640 => _640.id]);
     this.stopHeartbeat();
     this.clearRemoteMedia();
     try {
@@ -9271,7 +9364,7 @@ var XmaxRealtimeGenerationManager = class _XmaxRealtimeGenerationManager {
       this.currentContext = context;
       await options.waitUntilRemoteReady();
       options.ensureCurrent();
-      _optionalChain([options, 'access', _633 => _633.onRemoteReady, 'optionalCall', _634 => _634(taskID)]);
+      _optionalChain([options, 'access', _641 => _641.onRemoteReady, 'optionalCall', _642 => _642(taskID)]);
       options.ensureCurrent();
       await this.streamController.activateRemoteAudio();
       options.ensureCurrent();
@@ -9333,7 +9426,7 @@ var XmaxRealtimeGenerationManager = class _XmaxRealtimeGenerationManager {
     try {
       await completion;
     } finally {
-      if (_optionalChain([this, 'access', _635 => _635.pendingStop, 'optionalAccess', _636 => _636.completion]) === completion) this.pendingStop = void 0;
+      if (_optionalChain([this, 'access', _643 => _643.pendingStop, 'optionalAccess', _644 => _644.completion]) === completion) this.pendingStop = void 0;
     }
   }
   /**
@@ -9426,6 +9519,7 @@ var XmaxRealtimeManager = class _XmaxRealtimeManager {
      */
     _chunk4DE2IREAcjs.__publicField.call(void 0, this, "launchTimer", new RealtimeLaunchTimer());
     _chunk4DE2IREAcjs.__publicField.call(void 0, this, "remoteFrameDisplayHandler");
+    _chunk4DE2IREAcjs.__publicField.call(void 0, this, "remoteRenderWarmupCompletedHandler");
     /**
      * 媒体权限弹窗观察
      */
@@ -9462,11 +9556,11 @@ var XmaxRealtimeManager = class _XmaxRealtimeManager {
     this.options = options;
     this.mediaService = new MediaService(options.model);
     this.interpolationRequested = options.isFrameInterpolationEnabled;
-    this.supportsInterpolation = _nullishCoalesce(_optionalChain([dependencies, 'optionalAccess', _637 => _637.supportsFrameInterpolation]), () => ( (async (size) => await frameInterpolationAdapter(size) !== null)));
+    this.supportsInterpolation = _nullishCoalesce(_optionalChain([dependencies, 'optionalAccess', _645 => _645.supportsFrameInterpolation]), () => ( (async (size) => await frameInterpolationAdapter(size) !== null)));
     this.errorHandler = new RealtimeErrorHandler();
-    const rtcManager = _nullishCoalesce(_optionalChain([dependencies, 'optionalAccess', _638 => _638.rtcManager]), () => ( createRtcManager(options.provider, _nullishCoalesce(_optionalChain([dependencies, 'optionalAccess', _639 => _639.environment]), () => ( "china")) /* china */)));
-    const sessionService = _nullishCoalesce(_optionalChain([dependencies, 'optionalAccess', _640 => _640.sessionService]), () => ( (_optionalChain([dependencies, 'optionalAccess', _641 => _641.apiService]) ? new RealtimeSessionService({ apiService: dependencies.apiService, provider: options.provider }) : void 0)));
-    this.streamController = _nullishCoalesce(_optionalChain([dependencies, 'optionalAccess', _642 => _642.streamController]), () => ( new StreamController({
+    const rtcManager = _nullishCoalesce(_optionalChain([dependencies, 'optionalAccess', _646 => _646.rtcManager]), () => ( createRtcManager(options.provider, _nullishCoalesce(_optionalChain([dependencies, 'optionalAccess', _647 => _647.environment]), () => ( "china")) /* china */)));
+    const sessionService = _nullishCoalesce(_optionalChain([dependencies, 'optionalAccess', _648 => _648.sessionService]), () => ( (_optionalChain([dependencies, 'optionalAccess', _649 => _649.apiService]) ? new RealtimeSessionService({ apiService: dependencies.apiService, provider: options.provider }) : void 0)));
+    this.streamController = _nullishCoalesce(_optionalChain([dependencies, 'optionalAccess', _650 => _650.streamController]), () => ( new StreamController({
       rtcManager,
       onCredentialsRequired: () => {
         void this.connectionManager.refreshCredentials();
@@ -9485,7 +9579,7 @@ var XmaxRealtimeManager = class _XmaxRealtimeManager {
     this.mediaController = new MediaController({
       rtcManager,
       mediaService: this.mediaService,
-      cameraController: _optionalChain([dependencies, 'optionalAccess', _643 => _643.cameraController]),
+      cameraController: _optionalChain([dependencies, 'optionalAccess', _651 => _651.cameraController]),
       onCameraError: (error) => {
         void this.errorHandler.report(error);
       },
@@ -9501,7 +9595,11 @@ var XmaxRealtimeManager = class _XmaxRealtimeManager {
       interactionListener: (taskID, points) => this.streamController.sendTracks(taskID, points)
     });
     this.renderController = new RenderController({
-      onFrameDisplayed: () => _optionalChain([this, 'access', _644 => _644.remoteFrameDisplayHandler, 'optionalCall', _645 => _645()]),
+      onFrameDisplayed: () => _optionalChain([this, 'access', _652 => _652.remoteFrameDisplayHandler, 'optionalCall', _653 => _653()]),
+      onRenderWarmupCompleted: () => {
+        _optionalChain([this, 'access', _654 => _654.remoteRenderWarmupCompletedHandler, 'optionalCall', _655 => _655()]);
+        void this.completeGenerationPresentation().catch((error) => this.errorHandler.report(error));
+      },
       onAttached: () => this.applyRemoteInterpolation(),
       onDetached: () => {
         this.interpolationRevision++;
@@ -9530,6 +9628,10 @@ var XmaxRealtimeManager = class _XmaxRealtimeManager {
         await this.coordinator.run("configuration" /* configuration */, void 0, async (token) => {
           await this.applyUplinkQuality(change.to, token, signal);
         });
+      }, void 0, {}, (level) => {
+        const track = this.currentUplinkTrack;
+        const state2 = track && this.qualityStates.get(track);
+        return !!state2 && supportsQualityEncoding(this.uplinkQualityFormat(state2.baseline, level));
       });
       this.downlinkQualityController = new QualityController(async (change, signal) => {
         await this.coordinator.run("configuration" /* configuration */, void 0, async (token) => {
@@ -9574,7 +9676,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', _646 => _646.downlinkQualityState, 'optionalAccess', _647 => _647.size]), () => ( this.generationVideoFormat)), () => ( _optionalChain([this, 'access', _648 => _648.currentLocalTrack, 'optionalAccess', _649 => _649.videoFormat])));
+      const format = _nullishCoalesce(_nullishCoalesce(_optionalChain([this, 'access', _656 => _656.downlinkQualityState, 'optionalAccess', _657 => _657.size]), () => ( this.generationVideoFormat)), () => ( _optionalChain([this, 'access', _658 => _658.currentLocalTrack, 'optionalAccess', _659 => _659.videoFormat])));
       const size = format && enabled ? this.mediaService.resolveFrameInterpolationSize(format) : void 0;
       if (enabled && !await this.checkInterpolationSupport(size, token)) {
         token.ensureCurrent();
@@ -9600,6 +9702,9 @@ var XmaxRealtimeManager = class _XmaxRealtimeManager {
       }
       const level = Math.max(1, Math.min(Object.keys(QUALITY_TIERS).length, state2.level + (direction === "upgrade" ? -1 : 1)));
       if (level === state2.level) return;
+      if (!supportsQualityEncoding(this.uplinkQualityFormat(state2.baseline, level))) {
+        throw new XmaxError("INVALID_CONFIGURATION" /* invalidConfiguration */, "Quality level conflicts with explicit bitrate constraints");
+      }
       this.adaptiveQualityRevision++;
       controller.resetSamples();
       await this.applyUplinkQuality(level, token);
@@ -9611,7 +9716,7 @@ var XmaxRealtimeManager = class _XmaxRealtimeManager {
     const state2 = track && this.qualityStates.get(track);
     const ensureActive2 = () => {
       token.ensureCurrent();
-      if (_optionalChain([signal, 'optionalAccess', _650 => _650.aborted]) || !track || !state2 || track !== this.currentUplinkTrack || state2 !== this.qualityStates.get(track) || this.currentState.connectionState !== "Generating" /* generating */) {
+      if (_optionalChain([signal, 'optionalAccess', _660 => _660.aborted]) || !track || !state2 || track !== this.currentUplinkTrack || state2 !== this.qualityStates.get(track) || this.currentState.connectionState !== "Generating" /* generating */) {
         throw new XmaxError("CANCELLED" /* cancelled */, "Adaptive video format update was cancelled");
       }
     };
@@ -9629,7 +9734,7 @@ var XmaxRealtimeManager = class _XmaxRealtimeManager {
     _nullishCoalesce(this.generationVideoFormat, () => ( (this.generationVideoFormat = state2.baseline)));
     track.updateVideoFormat(format);
     state2.level = level;
-    _optionalChain([this, 'access', _651 => _651.qualityHistory, 'optionalAccess', _652 => _652.write, 'call', _653 => _653("uplink", level)]);
+    _optionalChain([this, 'access', _661 => _661.qualityHistory, 'optionalAccess', _662 => _662.write, 'call', _663 => _663("uplink", level)]);
   }
   /** 手动调试与自动调档使用同一尺寸信令路径，不修改生成或上行配置。 */
   async adjustDownlinkQuality(direction) {
@@ -9651,7 +9756,7 @@ var XmaxRealtimeManager = class _XmaxRealtimeManager {
     const state2 = this.downlinkQualityState;
     const ensureActive2 = () => {
       token.ensureCurrent();
-      if (_optionalChain([signal, 'optionalAccess', _654 => _654.aborted]) || !state2 || state2 !== this.downlinkQualityState || this.currentState.connectionState !== "Generating" /* generating */ || this.currentState.taskID !== state2.taskID) {
+      if (_optionalChain([signal, 'optionalAccess', _664 => _664.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");
       }
     };
@@ -9662,7 +9767,7 @@ var XmaxRealtimeManager = class _XmaxRealtimeManager {
     ensureActive2();
     state2.level = level;
     state2.size = size;
-    _optionalChain([this, 'access', _655 => _655.qualityHistory, 'optionalAccess', _656 => _656.write, 'call', _657 => _657("downlink", level)]);
+    _optionalChain([this, 'access', _665 => _665.qualityHistory, 'optionalAccess', _666 => _666.write, 'call', _667 => _667("downlink", level)]);
     if (this.interpolationRequested) {
       this.interpolationSize = size;
       this.applyRemoteInterpolation();
@@ -9781,7 +9886,7 @@ var XmaxRealtimeManager = class _XmaxRealtimeManager {
    */
   notifyRemoteVideoStatistics() {
     try {
-      void Promise.resolve(_optionalChain([this, 'access', _658 => _658.remoteVideoStatisticsListener, 'optionalCall', _659 => _659(this.remoteVideoStatistics)])).catch(() => {
+      void Promise.resolve(_optionalChain([this, 'access', _668 => _668.remoteVideoStatisticsListener, 'optionalCall', _669 => _669(this.remoteVideoStatistics)])).catch(() => {
       });
     } catch (e31) {
     }
@@ -9798,7 +9903,7 @@ var XmaxRealtimeManager = class _XmaxRealtimeManager {
    */
   notifyNetworkStatistics() {
     try {
-      void Promise.resolve(_optionalChain([this, 'access', _660 => _660.networkStatisticsListener, 'optionalCall', _661 => _661(this.networkStatistics)])).catch(() => {
+      void Promise.resolve(_optionalChain([this, 'access', _670 => _670.networkStatisticsListener, 'optionalCall', _671 => _671(this.networkStatistics)])).catch(() => {
       });
     } catch (e32) {
     }
@@ -9818,7 +9923,7 @@ var XmaxRealtimeManager = class _XmaxRealtimeManager {
    */
   notifyLocalVideoStatistics() {
     try {
-      void Promise.resolve(_optionalChain([this, 'access', _662 => _662.localVideoStatisticsListener, 'optionalCall', _663 => _663(this.localVideoStatistics)])).catch(() => {
+      void Promise.resolve(_optionalChain([this, 'access', _672 => _672.localVideoStatisticsListener, 'optionalCall', _673 => _673(this.localVideoStatistics)])).catch(() => {
       });
     } catch (e33) {
     }
@@ -9827,8 +9932,8 @@ var XmaxRealtimeManager = class _XmaxRealtimeManager {
    * 停止接收媒体统计并清空各类快照，仅对曾有数据的统计发出清空通知。
    */
   clearVideoStatistics() {
-    _optionalChain([this, 'access', _664 => _664.qualityController, 'optionalAccess', _665 => _665.stop, 'call', _666 => _666()]);
-    _optionalChain([this, 'access', _667 => _667.downlinkQualityController, 'optionalAccess', _668 => _668.stop, 'call', _669 => _669()]);
+    _optionalChain([this, 'access', _674 => _674.qualityController, 'optionalAccess', _675 => _675.stop, 'call', _676 => _676()]);
+    _optionalChain([this, 'access', _677 => _677.downlinkQualityController, 'optionalAccess', _678 => _678.stop, 'call', _679 => _679()]);
     this.downlinkQualityState = void 0;
     this.adaptiveQualityRevision++;
     this.acceptsVideoStatistics = false;
@@ -9900,7 +10005,7 @@ var XmaxRealtimeManager = class _XmaxRealtimeManager {
         const completeCamera = this.launchTimer.startCamera();
         this.clearVideoStatistics();
         this.disposePermissionWatch();
-        const permissionWatch = await watchMediaPermissionPrompt(_nullishCoalesce(_optionalChain([options, 'optionalAccess', _670 => _670.useMicrophone]), () => ( false)));
+        const permissionWatch = await watchMediaPermissionPrompt(_nullishCoalesce(_optionalChain([options, 'optionalAccess', _680 => _680.useMicrophone]), () => ( false)));
         if (permissionWatch) {
           const completePermission = this.launchTimer.startPermission();
           void permissionWatch.decided.then(() => completePermission()).catch(() => {
@@ -9917,7 +10022,7 @@ var XmaxRealtimeManager = class _XmaxRealtimeManager {
           throw error;
         }
         token.ensureCurrent();
-        this.generationVideoFormat = _optionalChain([stream, 'access', _671 => _671.videoTrack, 'optionalAccess', _672 => _672.videoFormat]);
+        this.generationVideoFormat = _optionalChain([stream, 'access', _681 => _681.videoTrack, 'optionalAccess', _682 => _682.videoFormat]);
         completeCamera();
         this.mediaController.setCameraPreviewReadyHandler((isCurrent) => {
           void this.coordinator.localPreviewDidBecomeReady(isCurrent);
@@ -9942,7 +10047,7 @@ var XmaxRealtimeManager = class _XmaxRealtimeManager {
       this.clearVideoStatistics();
       await this.mediaController.prepareSource(() => token.ensureCurrent());
       token.ensureCurrent();
-      this.generationVideoFormat = _optionalChain([stream, 'access', _673 => _673.videoTrack, 'optionalAccess', _674 => _674.videoFormat]);
+      this.generationVideoFormat = _optionalChain([stream, 'access', _683 => _683.videoTrack, 'optionalAccess', _684 => _684.videoFormat]);
       await this.coordinator.commit(new RealtimeState({ connectionState: "Ready" /* ready */ }), token);
       return stream;
     });
@@ -9964,7 +10069,7 @@ var XmaxRealtimeManager = class _XmaxRealtimeManager {
       const stream = await this.mediaController.createLocalVideoStream(options, token.signal);
       token.ensureCurrent();
       await this.mediaController.prepareSource(() => token.ensureCurrent());
-      this.generationVideoFormat = _optionalChain([stream, 'access', _675 => _675.videoTrack, 'optionalAccess', _676 => _676.videoFormat]);
+      this.generationVideoFormat = _optionalChain([stream, 'access', _685 => _685.videoTrack, 'optionalAccess', _686 => _686.videoFormat]);
       await this.coordinator.commit(new RealtimeState({ connectionState: "Ready" /* ready */ }), token);
       return stream;
     });
@@ -9982,7 +10087,7 @@ var XmaxRealtimeManager = class _XmaxRealtimeManager {
       const stream = await this.mediaController.createLocalImageStream(options, token.signal);
       token.ensureCurrent();
       await this.mediaController.prepareSource(() => token.ensureCurrent());
-      this.generationVideoFormat = _optionalChain([stream, 'access', _677 => _677.videoTrack, 'optionalAccess', _678 => _678.videoFormat]);
+      this.generationVideoFormat = _optionalChain([stream, 'access', _687 => _687.videoTrack, 'optionalAccess', _688 => _688.videoFormat]);
       await this.coordinator.commit(new RealtimeState({ connectionState: "Ready" /* ready */ }), token);
       return stream;
     });
@@ -10001,7 +10106,7 @@ var XmaxRealtimeManager = class _XmaxRealtimeManager {
       this.launchTimer.start();
       this.clearVideoStatistics();
       await this.mediaController.prepareSource(() => token.ensureCurrent());
-      this.generationVideoFormat = _optionalChain([stream, 'access', _679 => _679.videoTrack, 'optionalAccess', _680 => _680.videoFormat]);
+      this.generationVideoFormat = _optionalChain([stream, 'access', _689 => _689.videoTrack, 'optionalAccess', _690 => _690.videoFormat]);
       await this.coordinator.commit(new RealtimeState({ connectionState: "Ready" /* ready */ }), token);
       return stream;
     });
@@ -10018,7 +10123,7 @@ var XmaxRealtimeManager = class _XmaxRealtimeManager {
    * 移除媒体权限弹窗观察；授权决定已记录或不再需要观察时调用。
    */
   disposePermissionWatch() {
-    _optionalChain([this, 'access', _681 => _681.permissionWatchDispose, 'optionalCall', _682 => _682()]);
+    _optionalChain([this, 'access', _691 => _691.permissionWatchDispose, 'optionalCall', _692 => _692()]);
     this.permissionWatchDispose = void 0;
   }
   /**
@@ -10030,38 +10135,38 @@ var XmaxRealtimeManager = class _XmaxRealtimeManager {
   async updateUplinkVideoFormat(videoFormat) {
     await this.coordinator.run("configuration" /* configuration */, void 0, async (token) => {
       const track = this.currentUplinkTrack;
-      const previousFormat = _optionalChain([track, 'optionalAccess', _683 => _683.videoFormat]);
+      const previousFormat = _optionalChain([track, 'optionalAccess', _693 => _693.videoFormat]);
       if (!track || !previousFormat) {
         throw new XmaxError("INVALID_CONFIGURATION" /* invalidConfiguration */, "Local camera, external or file video stream is not started");
       }
       videoFormat.validate();
-      _optionalChain([this, 'access', _684 => _684.qualityController, 'optionalAccess', _685 => _685.stop, 'call', _686 => _686()]);
+      _optionalChain([this, 'access', _694 => _694.qualityController, 'optionalAccess', _695 => _695.stop, 'call', _696 => _696()]);
       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', _687 => _687.qualityHistory, 'optionalAccess', _688 => _688.write, 'call', _689 => _689("uplink", 1)]);
+      _optionalChain([this, 'access', _697 => _697.qualityHistory, 'optionalAccess', _698 => _698.write, 'call', _699 => _699("uplink", 1)]);
     });
   }
   /** 已连接时仅替换帧率；与其他配置及生命周期操作共享同一操作租约。 */
   async updateUplinkFrameRate(fps) {
     await this.coordinator.run("configuration" /* configuration */, void 0, async (token) => {
-      _optionalChain([this, 'access', _690 => _690.qualityController, 'optionalAccess', _691 => _691.stop, 'call', _692 => _692()]);
+      _optionalChain([this, 'access', _700 => _700.qualityController, 'optionalAccess', _701 => _701.stop, 'call', _702 => _702()]);
       await this.applyUplinkFrameRate(fps, token);
       const track = this.currentLocalTrack;
-      if (_optionalChain([track, 'optionalAccess', _693 => _693.videoFormat])) {
+      if (_optionalChain([track, 'optionalAccess', _703 => _703.videoFormat])) {
         this.qualityStates.set(track, { baseline: track.videoFormat, level: 1 });
-        _optionalChain([this, 'access', _694 => _694.qualityHistory, 'optionalAccess', _695 => _695.write, 'call', _696 => _696("uplink", 1)]);
+        _optionalChain([this, 'access', _704 => _704.qualityHistory, 'optionalAccess', _705 => _705.write, 'call', _706 => _706("uplink", 1)]);
       }
     });
   }
   /** 手动仅调帧接口，成功后的当前格式将成为新的自适应 L1 基准。 */
   async applyUplinkFrameRate(fps, token) {
     const track = this.currentUplinkTrack;
-    const previous = _optionalChain([track, 'optionalAccess', _697 => _697.videoFormat]);
+    const previous = _optionalChain([track, 'optionalAccess', _707 => _707.videoFormat]);
     const state2 = this.currentState.connectionState;
-    if (!track || !previous || state2 !== "Connected" /* connected */ && state2 !== "Generating" /* generating */) {
+    if (!track || !previous || state2 !== "Connected" /* connected */ && state2 !== "Starting" /* starting */ && state2 !== "Generating" /* generating */) {
       throw new XmaxError("INVALID_CONFIGURATION" /* invalidConfiguration */, "Frame rate updates require a connected local camera, external or file stream");
     }
     if (!Number.isFinite(fps) || fps <= 0) {
@@ -10157,7 +10262,7 @@ var XmaxRealtimeManager = class _XmaxRealtimeManager {
         if (this.mediaController.source === "externalVideo") {
           throw new XmaxError("INVALID_CONFIGURATION" /* invalidConfiguration */, "External video capture is managed by the caller");
         }
-        _optionalChain([this, 'access', _698 => _698.qualityController, 'optionalAccess', _699 => _699.stop, 'call', _700 => _700()]);
+        _optionalChain([this, 'access', _708 => _708.qualityController, 'optionalAccess', _709 => _709.stop, 'call', _710 => _710()]);
         const stream = await this.mediaController.switchCamera();
         token.ensureCurrent();
         return stream;
@@ -10182,7 +10287,7 @@ var XmaxRealtimeManager = class _XmaxRealtimeManager {
       void 0,
       async (token) => {
         const connectionState = this.coordinator.currentState.connectionState;
-        if (connectionState === "Connecting" /* connecting */ || connectionState === "Connected" /* connected */ || connectionState === "Generating" /* generating */) {
+        if (connectionState === "Connecting" /* connecting */ || connectionState === "Connected" /* connected */ || connectionState === "Starting" /* starting */ || connectionState === "Generating" /* generating */) {
           throw new XmaxError(
             "INVALID_CONFIGURATION" /* invalidConfiguration */,
             "A realtime connection is already active"
@@ -10197,6 +10302,7 @@ var XmaxRealtimeManager = class _XmaxRealtimeManager {
    *
    * 尚未连接时先建立实时连接；已在生成时默认更新条件，restart 为 true 时重新开始生成。
    * 首次生成必须提供条件上下文，之后缺省时复用最近一次缓存的上下文。
+   * 返回后请将远端流挂载到 SDK 视频视图；首帧及渲染预热完成后状态才进入 generating。
    *
    * @param options.localStream 由当前 Manager 创建的摄像头、外部视频轨、本地文件或网络视频源。
    * @param options.context 本次生成使用的条件上下文；缺省时复用缓存。
@@ -10204,7 +10310,7 @@ var XmaxRealtimeManager = class _XmaxRealtimeManager {
    * @param options.faceRestoration 是否启用原始人脸回贴，默认 false；正在生成时通过 change_condition 更新。
    * @param options.extraParams 合并到本次 start 或 change_condition 的 params；不缓存，自动恢复时不携带，不允许覆盖 SDK 字段。
    * @param options.record 是否录制远端原始音视频约 20 秒，默认 false；仅 start 有效，条件更新时忽略，重启录制暂不支持。
-   * @returns 承载远端生成画面的媒体流。
+   * @returns 可挂载的远端媒体流，不等待渲染预热；展示就绪以 generating 状态为准。
    * @throws extraParams 包含非 JSON 数据、循环引用或 SDK 保留字段时，在连接或更新前抛出 invalidConfiguration。
    * @throws 本地流不属于当前 Manager、缺少可用的条件上下文、信令发送
    * 或生成确认失败时抛出错误；失败时自动停止生成任务并释放连接资源。
@@ -10230,12 +10336,12 @@ var XmaxRealtimeManager = class _XmaxRealtimeManager {
           );
         }
         const currentState = this.coordinator.currentState;
-        const isGenerating = currentState.connectionState === "Generating" /* generating */;
-        if (isGenerating && options.restart !== true) {
+        const hasGeneration = currentState.connectionState === "Generating" /* generating */ || currentState.connectionState === "Starting" /* starting */ && !!currentState.taskID;
+        if (hasGeneration && options.restart !== true) {
           await this.generationManager.update(currentState.taskID, {
             videoFormat,
             context: options.context,
-            targetSize: this.downlinkQualityController ? _optionalChain([this, 'access', _701 => _701.downlinkQualityState, 'optionalAccess', _702 => _702.size]) : void 0,
+            targetSize: this.downlinkQualityController ? _optionalChain([this, 'access', _711 => _711.downlinkQualityState, 'optionalAccess', _712 => _712.size]) : void 0,
             faceRestoration: _nullishCoalesce(options.faceRestoration, () => ( false)),
             extraParams
           });
@@ -10248,7 +10354,7 @@ var XmaxRealtimeManager = class _XmaxRealtimeManager {
           throw new XmaxError("INVALID_CONFIGURATION" /* invalidConfiguration */, "Create a network video stream before using a reference video");
         }
         const context = referenceVideo ? new RealtimeContext({ ...supplied, referenceVideo }) : supplied;
-        if (currentState.connectionState !== "Connected" /* connected */ && !isGenerating) {
+        if (currentState.connectionState !== "Connected" /* connected */ && !hasGeneration) {
           await this.performConnect(options.localStream, token);
         }
         return this.performStartGeneration(
@@ -10300,7 +10406,11 @@ var XmaxRealtimeManager = class _XmaxRealtimeManager {
     if (this.qualityStates.has(track)) return void 0;
     const baseline = track.videoFormat;
     if (!baseline) return void 0;
-    return { baseline, level: this.qualityHistory.read("uplink") };
+    let level = this.qualityHistory.read("uplink");
+    while (level > 1 && !supportsQualityEncoding(this.uplinkQualityFormat(baseline, level))) {
+      level--;
+    }
+    return { baseline, level };
   }
   /**
    * 建立实时连接：创建会话、进房发布、启动心跳并准备远端渲染轨道。
@@ -10348,7 +10458,7 @@ var XmaxRealtimeManager = class _XmaxRealtimeManager {
           _nullishCoalesce(this.generationVideoFormat, () => ( (this.generationVideoFormat = initialQuality.baseline)));
           localTrack.updateVideoFormat(initialFormat);
           this.qualityStates.set(localTrack, initialQuality);
-          _optionalChain([this, 'access', _703 => _703.qualityHistory, 'optionalAccess', _704 => _704.write, 'call', _705 => _705("uplink", initialQuality.level)]);
+          _optionalChain([this, 'access', _713 => _713.qualityHistory, 'optionalAccess', _714 => _714.write, 'call', _715 => _715("uplink", initialQuality.level)]);
         },
         model: this.options.model,
         includeLocalAudio: this.mediaController.hasAudio,
@@ -10386,16 +10496,30 @@ var XmaxRealtimeManager = class _XmaxRealtimeManager {
    */
   async performStartGeneration(token, videoFormat, context, restart, faceRestoration, extraParams, record2 = false) {
     token.setFailureScope(0 /* connection */);
+    const sessionID = this.connectionManager.currentSessionID;
+    if (!sessionID) {
+      throw new XmaxError("SESSION_ERROR" /* sessionError */, "Realtime session is unavailable");
+    }
+    await this.coordinator.commit(
+      new RealtimeState({ connectionState: "Starting" /* starting */, sessionID }),
+      token
+    );
+    token.ensureCurrent();
     if (restart) {
       void this.recordingController.stop("restarted" /* restarted */);
     }
-    const initialLevel = _nullishCoalesce(_optionalChain([this, 'access', _706 => _706.qualityHistory, 'optionalAccess', _707 => _707.read, 'call', _708 => _708("downlink")]), () => ( 1));
+    const initialLevel = _nullishCoalesce(_optionalChain([this, 'access', _716 => _716.qualityHistory, 'optionalAccess', _717 => _717.read, 'call', _718 => _718("downlink")]), () => ( 1));
     const targetSize = this.downlinkQualityController ? qualityVideoSize(videoFormat, initialLevel) : void 0;
     await this.prepareFrameInterpolation(_nullishCoalesce(targetSize, () => ( videoFormat)), token);
     const completeFirstFrame = this.launchTimer.startFirstFrame();
+    this.remoteRenderWarmupCompletedHandler = void 0;
     this.remoteFrameDisplayHandler = () => {
-      if (!token.signal.aborted) completeFirstFrame();
+      if (!token.signal.aborted) {
+        completeFirstFrame();
+        _nullishCoalesce(this.remoteRenderWarmupCompletedHandler, () => ( (this.remoteRenderWarmupCompletedHandler = this.launchTimer.startRenderWarmup())));
+      }
     };
+    this.renderController.prepareForGeneration();
     const taskID = await this.generationManager.start({
       videoFormat,
       signal: token.signal,
@@ -10417,7 +10541,7 @@ var XmaxRealtimeManager = class _XmaxRealtimeManager {
         }
       } : void 0,
       targetSize,
-      mirror: this.mediaController.source === "camera" && _optionalChain([this, 'access', _709 => _709.currentLocalTrack, 'optionalAccess', _710 => _710.position]) === "front" /* front */,
+      mirror: this.mediaController.source === "camera" && _optionalChain([this, 'access', _719 => _719.currentLocalTrack, 'optionalAccess', _720 => _720.position]) === "front" /* front */,
       faceRestoration,
       onStartSent: this.mediaController.source === "localVideo" ? async () => {
         token.ensureCurrent();
@@ -10426,11 +10550,8 @@ var XmaxRealtimeManager = class _XmaxRealtimeManager {
       } : void 0,
       extraParams
     });
-    const sessionID = this.connectionManager.currentSessionID;
-    if (!sessionID) {
-      throw new XmaxError("SESSION_ERROR" /* sessionError */, "Realtime session is unavailable");
-    }
-    _optionalChain([this, 'access', _711 => _711.downlinkQualityController, 'optionalAccess', _712 => _712.stop, 'call', _713 => _713()]);
+    token.ensureCurrent();
+    _optionalChain([this, 'access', _721 => _721.downlinkQualityController, 'optionalAccess', _722 => _722.stop, 'call', _723 => _723()]);
     this.downlinkQualityState = {
       taskID,
       baseline: videoFormat,
@@ -10438,21 +10559,38 @@ var XmaxRealtimeManager = class _XmaxRealtimeManager {
       size: _nullishCoalesce(targetSize, () => ( { width: videoFormat.width, height: videoFormat.height }))
     };
     await this.coordinator.commit(
-      new RealtimeState({ connectionState: "Generating" /* generating */, sessionID, taskID }),
+      new RealtimeState({ connectionState: "Starting" /* starting */, sessionID, taskID }),
       token
     );
-    _optionalChain([this, 'access', _714 => _714.qualityHistory, 'optionalAccess', _715 => _715.write, 'call', _716 => _716("downlink", initialLevel)]);
+    token.ensureCurrent();
+    await this.completeGenerationPresentation();
+    token.ensureCurrent();
+    _optionalChain([this, 'access', _724 => _724.qualityHistory, 'optionalAccess', _725 => _725.write, 'call', _726 => _726("downlink", initialLevel)]);
     const onFinish = this.mediaController.onNetworkVideoFinish;
     if (this.mediaController.source === "networkVideo") {
       this.streamController.activateNetworkVideoCompletion(() => {
-        if (this.currentState.taskID === taskID && this.currentState.connectionState === "Generating" /* generating */) {
+        if (this.currentState.taskID === taskID && (this.currentState.connectionState === "Starting" /* starting */ || this.currentState.connectionState === "Generating" /* generating */)) {
           void this.recordingController.stop("generationEnded" /* generationEnded */);
-          return _optionalChain([onFinish, 'optionalCall', _717 => _717()]);
+          return _optionalChain([onFinish, 'optionalCall', _727 => _727()]);
         }
       });
     }
     return this.connectionManager.makeRemoteStream();
   }
+  /**
+   * 任务启动成功且当前视图完成预热后提交展示就绪状态，不阻塞远端流返回。
+   */
+  async completeGenerationPresentation() {
+    const { sessionID, taskID } = this.currentState;
+    if (!sessionID || !taskID) {
+      return;
+    }
+    await this.coordinator.remotePreviewDidBecomeReady(
+      sessionID,
+      taskID,
+      () => this.renderController.isReady
+    );
+  }
   /**
    * 心跳失败或会话失效：结束当前连接生命周期并通过最终状态给出原因。
    */
@@ -10471,6 +10609,7 @@ var XmaxRealtimeManager = class _XmaxRealtimeManager {
     this.mediaController.pauseLocalVideo();
     this.launchTimer.cancel();
     this.remoteFrameDisplayHandler = void 0;
+    this.remoteRenderWarmupCompletedHandler = void 0;
     this.clearVideoStatistics();
     this.interpolationSize = void 0;
     this.applyRemoteInterpolation();
@@ -10586,7 +10725,7 @@ var NonRealtimeTaskService = class {
    * 提交一次任务；请求结果不确定时也不自动重试，以免重复扣费。
    */
   async submitTask(options) {
-    const model = _optionalChain([options, 'access', _718 => _718.model, 'optionalAccess', _719 => _719.trim, 'call', _720 => _720()]);
+    const model = _optionalChain([options, 'access', _728 => _728.model, 'optionalAccess', _729 => _729.trim, 'call', _730 => _730()]);
     if (!model) {
       invalid("Model must not be empty");
     }
@@ -10726,7 +10865,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', _721 => _721.trim, 'call', _722 => _722()]) || !Object.values(NonRealtimeTaskStatus).includes(status)) {
+  if (!_optionalChain([uid, 'optionalAccess', _731 => _731.trim, 'call', _732 => _732()]) || !Object.values(NonRealtimeTaskStatus).includes(status)) {
     malformed("Missing task UID or invalid status");
   }
   if (quality !== void 0 && !Object.values(NonRealtimeQuality).includes(quality)) {
@@ -10808,7 +10947,7 @@ var XmaxNonRealtimeManager = class {
    * 取得任务快照，不把服务端失败终态当成查询失败。
    */
   getTask(taskUid, options) {
-    return this.tasks.getTask(taskUid, _optionalChain([options, 'optionalAccess', _723 => _723.signal]));
+    return this.tasks.getTask(taskUid, _optionalChain([options, 'optionalAccess', _733 => _733.signal]));
   }
   /**
    * 批量取得任务快照。
@@ -10842,8 +10981,8 @@ var XmaxNonRealtimeManager = class {
     const controller = new AbortController();
     let timedOut = false;
     const abort = () => controller.abort();
-    _optionalChain([options, 'access', _724 => _724.signal, 'optionalAccess', _725 => _725.addEventListener, 'call', _726 => _726("abort", abort, { once: true })]);
-    if (_optionalChain([options, 'access', _727 => _727.signal, 'optionalAccess', _728 => _728.aborted])) {
+    _optionalChain([options, 'access', _734 => _734.signal, 'optionalAccess', _735 => _735.addEventListener, 'call', _736 => _736("abort", abort, { once: true })]);
+    if (_optionalChain([options, 'access', _737 => _737.signal, 'optionalAccess', _738 => _738.aborted])) {
       abort();
     }
     const timer = options.timeoutMs === void 0 ? void 0 : setTimeout(() => {
@@ -10869,7 +11008,7 @@ var XmaxNonRealtimeManager = class {
         ensureActive(controller.signal);
         failures = 0;
         try {
-          void Promise.resolve(_optionalChain([options, 'access', _729 => _729.onTaskUpdated, 'optionalCall', _730 => _730(task)])).catch(() => {
+          void Promise.resolve(_optionalChain([options, 'access', _739 => _739.onTaskUpdated, 'optionalCall', _740 => _740(task)])).catch(() => {
           });
         } catch (e35) {
         }
@@ -10899,7 +11038,7 @@ var XmaxNonRealtimeManager = class {
       throw error;
     } finally {
       clearTimeout(timer);
-      _optionalChain([options, 'access', _731 => _731.signal, 'optionalAccess', _732 => _732.removeEventListener, 'call', _733 => _733("abort", abort)]);
+      _optionalChain([options, 'access', _741 => _741.signal, 'optionalAccess', _742 => _742.removeEventListener, 'call', _743 => _743("abort", abort)]);
     }
   }
 };
@@ -10943,7 +11082,7 @@ function isTransient(error) {
 }
 function isResultAvailable(task) {
   const result = task.result;
-  if (!_optionalChain([result, 'optionalAccess', _734 => _734.url, 'optionalAccess', _735 => _735.trim, 'call', _736 => _736()]) || _optionalChain([result, 'access', _737 => _737.uploadError, 'optionalAccess', _738 => _738.trim, 'call', _739 => _739()]) || result.uploadStatus !== void 0 && result.uploadStatus !== "success") {
+  if (!_optionalChain([result, 'optionalAccess', _744 => _744.url, 'optionalAccess', _745 => _745.trim, 'call', _746 => _746()]) || _optionalChain([result, 'access', _747 => _747.uploadError, 'optionalAccess', _748 => _748.trim, 'call', _749 => _749()]) || result.uploadStatus !== void 0 && result.uploadStatus !== "success") {
     return false;
   }
   try {
@@ -11013,9 +11152,9 @@ var XmaxClient = class {
   /**
    * 创建媒体处理与能力查询 Service。
    *
-   * @param model 媒体输入规则使用的模型，默认为 `x2.0-trtc`。
+   * @param model 媒体输入规则使用的模型，默认为 `x2.1.1-preview-cn`。
    */
-  createMediaService(model = "x2.0-trtc" /* x2_0_trtc */) {
+  createMediaService(model = "x2.1.1-preview-cn" /* x2_1_1_preview_cn */) {
     return new MediaService(model);
   }
   /**
@@ -11033,7 +11172,7 @@ var RealtimeConfiguration = class {
   /**
    * 创建实时业务配置。
    *
-   * @param init.model 实时生成业务使用的模型；未知名称原样透传，默认配置同 x2.1-preview。
+   * @param init.model 实时生成业务使用的模型；未知名称原样透传，默认配置同 x2.1.1-preview-cn。
    * @param init.provider RTC 提供方，默认按模型定义选择；必须受模型支持，创建后不可切换。
    * @param init.isFrameInterpolationEnabled 是否默认开启远端生成画面的插帧，默认 false。
    */
@@ -11200,12 +11339,81 @@ var RenderStatisticsController = class {
    */
   notify(statistics) {
     try {
-      _optionalChain([this, 'access', _740 => _740.handler, 'optionalCall', _741 => _741(statistics)]);
+      _optionalChain([this, 'access', _750 => _750.handler, 'optionalCall', _751 => _751(statistics)]);
     } catch (e37) {
     }
   }
 };
 
+// src/Render/Video/RenderWarmupController.ts
+var RenderWarmupController = class {
+  /**
+   * 创建视图预热控制器。
+   */
+  constructor(element) {
+    _chunk4DE2IREAcjs.__publicField.call(void 0, this, "element", element);
+    /**
+     * 预热配置与生命周期
+     */
+    _chunk4DE2IREAcjs.__publicField.call(void 0, this, "durationMs");
+    _chunk4DE2IREAcjs.__publicField.call(void 0, this, "timer");
+    _chunk4DE2IREAcjs.__publicField.call(void 0, this, "started", false);
+    _chunk4DE2IREAcjs.__publicField.call(void 0, this, "completed", false);
+  }
+  /**
+   * 是否仍在等待首帧或预热完成；期间不允许对不可见画面交互。
+   */
+  get isPending() {
+    return this.durationMs !== void 0 && !this.completed;
+  }
+  /**
+   * 为新媒体隐藏画面；undefined 表示直接显示，不启用预热。
+   */
+  prepare(durationMs) {
+    this.reset();
+    this.durationMs = durationMs;
+    if (durationMs === void 0) {
+      return;
+    }
+    this.element.style.transition = "none";
+    this.element.style.opacity = "0";
+    this.element.style.pointerEvents = "none";
+  }
+  /**
+   * 首帧就绪后开始一次性预热，结束时通知并渐入画面。
+   */
+  start(onCompleted) {
+    if (this.durationMs === void 0 || this.started) {
+      return;
+    }
+    this.started = true;
+    this.timer = setTimeout(() => {
+      this.timer = void 0;
+      this.completed = true;
+      const reduceMotion = _optionalChain([globalThis, 'access', _752 => _752.matchMedia, 'optionalCall', _753 => _753("(prefers-reduced-motion: reduce)"), 'access', _754 => _754.matches]);
+      this.element.style.transition = reduceMotion ? "none" : "opacity 300ms ease-in-out";
+      this.element.style.opacity = "1";
+      this.element.style.pointerEvents = "";
+      onCompleted();
+    }, this.durationMs);
+  }
+  /**
+   * 换流或卸载时取消预热和渐入，防止旧任务显示新画面。
+   */
+  reset() {
+    clearTimeout(this.timer);
+    this.timer = void 0;
+    this.started = false;
+    this.completed = false;
+    if (this.durationMs !== void 0) {
+      this.element.style.transition = "";
+      this.element.style.opacity = "";
+      this.element.style.pointerEvents = "";
+    }
+    this.durationMs = void 0;
+  }
+};
+
 // ../../node_modules/.pnpm/framegen@1.4.0/node_modules/framegen/rt.js
 var WG = 8;
 var texBgSeq = 0;
@@ -13328,11 +13536,11 @@ var _FrameInterpolationManager = class _FrameInterpolationManager {
     if (this.destroyed) return;
     this.destroyed = true;
     this.device.removeEventListener("uncapturederror", this.onGPUError);
-    _optionalChain([this, 'access', _742 => _742.runtime, 'optionalAccess', _743 => _743.destroy, 'call', _744 => _744()]);
+    _optionalChain([this, 'access', _755 => _755.runtime, 'optionalAccess', _756 => _756.destroy, 'call', _757 => _757()]);
     this.runtime = void 0;
     this.textures.forEach((texture) => texture.destroy());
     this.textures = [];
-    _optionalChain([this, 'access', _745 => _745.context, 'optionalAccess', _746 => _746.unconfigure, 'call', _747 => _747()]);
+    _optionalChain([this, 'access', _758 => _758.context, 'optionalAccess', _759 => _759.unconfigure, 'call', _760 => _760()]);
     this.device.destroy();
   }
 };
@@ -13509,7 +13717,7 @@ var RemoteVideoFramePipeline = class {
     this.displayedTime = frame.time;
     this.canvas.style.visibility = "visible";
     this.setActive(true);
-    _optionalChain([this, 'access', _748 => _748.options, 'access', _749 => _749.onFramePresented, 'optionalCall', _750 => _750(_nullishCoalesce(frame.interpolated, () => ( false)))]);
+    _optionalChain([this, 'access', _761 => _761.options, 'access', _762 => _762.onFramePresented, 'optionalCall', _763 => _763(_nullishCoalesce(frame.interpolated, () => ( false)))]);
   }
   async initialize() {
     this.loading = true;
@@ -13537,7 +13745,7 @@ var RemoteVideoFramePipeline = class {
   setActive(active) {
     if (active === this.active) return;
     this.active = active;
-    _optionalChain([this, 'access', _751 => _751.options, 'access', _752 => _752.onActiveChange, 'optionalCall', _753 => _753(active)]);
+    _optionalChain([this, 'access', _764 => _764.options, 'access', _765 => _765.onActiveChange, 'optionalCall', _766 => _766(active)]);
   }
   resetTimeline(preserveGpuTimeout = false) {
     this.generation++;
@@ -13570,7 +13778,7 @@ var RemoteVideoFramePipeline = class {
     this.callback = void 0;
     clearTimeout(this.initializationTimer);
     this.resetTimeline();
-    _optionalChain([this, 'access', _754 => _754.processor, 'optionalAccess', _755 => _755.destroy, 'call', _756 => _756()]);
+    _optionalChain([this, 'access', _767 => _767.processor, 'optionalAccess', _768 => _768.destroy, 'call', _769 => _769()]);
     this.processor = void 0;
   }
 };
@@ -13651,9 +13859,9 @@ var TrajectoryOverlayView = class {
    * 卸载时取消采样、动画、捕获和事件监听；Renderer 可以再次挂载。
    */
   dispose() {
-    _optionalChain([this, 'access', _757 => _757.binding, 'optionalAccess', _758 => _758.detach, 'call', _759 => _759(this)]);
+    _optionalChain([this, 'access', _770 => _770.binding, 'optionalAccess', _771 => _771.detach, 'call', _772 => _772(this)]);
     this.cancel();
-    _optionalChain([this, 'access', _760 => _760.resizeObserver, 'optionalAccess', _761 => _761.disconnect, 'call', _762 => _762()]);
+    _optionalChain([this, 'access', _773 => _773.resizeObserver, 'optionalAccess', _774 => _774.disconnect, 'call', _775 => _775()]);
     document.removeEventListener("visibilitychange", this.visibilityChanged);
     this.element.removeEventListener("pointerdown", this.onDown);
     this.element.removeEventListener("pointermove", this.onMove);
@@ -13805,7 +14013,7 @@ var TrajectoryOverlayView = class {
       return;
     }
     this.lastSample = now;
-    _optionalChain([this, 'access', _763 => _763.binding, 'optionalAccess', _764 => _764.submit, 'call', _765 => _765({
+    _optionalChain([this, 'access', _776 => _776.binding, 'optionalAccess', _777 => _777.submit, 'call', _778 => _778({
       points: [...this.pointers.values()].map((point) => point.location),
       viewportSize: this.viewport,
       contentMode: this.contentMode,
@@ -13919,7 +14127,7 @@ var DefaultTrajectoryEffectRenderer = class {
     this.hasTrailPixels = false;
     this.idleFadeFrames = 0;
     for (const canvas of [this.trailCanvas, this.effectCanvas]) {
-      _optionalChain([canvas, 'access', _766 => _766.getContext, 'call', _767 => _767("2d"), 'optionalAccess', _768 => _768.clearRect, 'call', _769 => _769(0, 0, canvas.width, canvas.height)]);
+      _optionalChain([canvas, 'access', _779 => _779.getContext, 'call', _780 => _780("2d"), 'optionalAccess', _781 => _781.clearRect, 'call', _782 => _782(0, 0, canvas.width, canvas.height)]);
     }
   }
   /**
@@ -14120,6 +14328,10 @@ var XmaxVideoView = class {
      * 呈现统计组件
      */
     _chunk4DE2IREAcjs.__publicField.call(void 0, this, "statisticsController");
+    /**
+     * 远端画面预热与渐入组件
+     */
+    _chunk4DE2IREAcjs.__publicField.call(void 0, this, "warmupController");
     /**
      * DOM 挂载状态
      */
@@ -14130,12 +14342,13 @@ var XmaxVideoView = class {
     _chunk4DE2IREAcjs.__publicField.call(void 0, this, "interactionEnabled", true);
     _chunk4DE2IREAcjs.__publicField.call(void 0, this, "customTrajectoryRenderer");
     _chunk4DE2IREAcjs.__publicField.call(void 0, this, "trajectoryOverlay");
-    this.contentMode = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _770 => _770.videoContentMode]), () => ( "fill")) /* fill */;
-    this.interactionEnabled = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _771 => _771.isInteractionEnabled]), () => ( true));
+    this.contentMode = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _783 => _783.videoContentMode]), () => ( "fill")) /* fill */;
+    this.interactionEnabled = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _784 => _784.isInteractionEnabled]), () => ( true));
     this.element = document.createElement("div");
     this.element.style.position = "relative";
     this.element.style.overflow = "hidden";
     this.element.style.backgroundColor = "black";
+    this.warmupController = new RenderWarmupController(this.element);
     this.videoElement = document.createElement("video");
     this.statisticsController = new RenderStatisticsController(this.videoElement);
     this.videoElement.autoplay = true;
@@ -14159,7 +14372,7 @@ var XmaxVideoView = class {
    */
   set isInteractionEnabled(enabled) {
     this.interactionEnabled = enabled;
-    _optionalChain([this, 'access', _772 => _772.trajectoryOverlay, 'optionalAccess', _773 => _773.configure, 'call', _774 => _774(this.contentMode, this.mirrored, enabled)]);
+    _optionalChain([this, 'access', _785 => _785.trajectoryOverlay, 'optionalAccess', _786 => _786.configure, 'call', _787 => _787(this.contentMode, this.mirrored, enabled && !this.warmupController.isPending)]);
   }
   /**
    * 自定义轨迹视觉效果；undefined 表示使用 SDK 默认效果。
@@ -14260,6 +14473,7 @@ var XmaxVideoView = class {
     this.startInterpolation();
     this.startRenderStatistics();
     if ((this.videoElement.srcObject || this.videoElement.getAttribute("src")) && !this.hasNotifiedFrameDisplay) {
+      this.prepareRenderWarmup();
       this.armFrameDisplayNotification();
     }
   }
@@ -14272,6 +14486,8 @@ var XmaxVideoView = class {
     this.statisticsController.stop();
     this.stopInterpolation();
     this.cancelFrameDisplayNotification();
+    this.warmupController.reset();
+    this.hasNotifiedFrameDisplay = false;
     if (this.videoElement.getAttribute("src")) {
       this.videoElement.pause();
     }
@@ -14281,6 +14497,7 @@ var XmaxVideoView = class {
    * 设置网络视频预览；静音播放一次，不捕获或发布媒体轨道。 @internal
    */
   setVideoURL(url) {
+    this.warmupController.reset();
     this.statisticsController.stop();
     this.stopInterpolation();
     this.cancelFrameDisplayNotification();
@@ -14309,13 +14526,27 @@ var XmaxVideoView = class {
     this.cancelFrameDisplayNotification();
     this.hasNotifiedFrameDisplay = false;
     this.videoElement.srcObject = stream;
+    this.warmupController.reset();
     if (stream) {
       this.videoElement.autoplay = true;
+      this.prepareRenderWarmup();
       this.armFrameDisplayNotification();
       this.startInterpolation();
       this.startRenderStatistics();
     }
   }
+  /**
+   * 新生成任务重新等待首帧和预热，不替换正在播放的媒体流。 @internal
+   */
+  prepareForGeneration() {
+    this.cancelFrameDisplayNotification();
+    this.warmupController.reset();
+    this.hasNotifiedFrameDisplay = false;
+    this.prepareRenderWarmup();
+    if (!this.detached && this.videoElement.srcObject) {
+      this.armFrameDisplayNotification();
+    }
+  }
   /**
    * 由远端绑定注入配置；本地预览不走此管线。 @internal
    */
@@ -14348,11 +14579,11 @@ var XmaxVideoView = class {
       ...options,
       onActiveChange: (active) => {
         this.statisticsController.setInterpolationActive(active);
-        _optionalChain([options, 'access', _775 => _775.onActiveChange, 'optionalCall', _776 => _776(active)]);
+        _optionalChain([options, 'access', _788 => _788.onActiveChange, 'optionalCall', _789 => _789(active)]);
       },
       onFramePresented: (interpolated) => {
         this.statisticsController.recordCanvasFrame(interpolated);
-        _optionalChain([options, 'access', _777 => _777.onFramePresented, 'optionalCall', _778 => _778(interpolated)]);
+        _optionalChain([options, 'access', _790 => _790.onFramePresented, 'optionalCall', _791 => _791(interpolated)]);
       }
     });
     this.interpolationPipeline = pipeline;
@@ -14364,8 +14595,8 @@ var XmaxVideoView = class {
   stopInterpolation() {
     const pipeline = this.interpolationPipeline;
     this.interpolationPipeline = void 0;
-    _optionalChain([pipeline, 'optionalAccess', _779 => _779.stop, 'call', _780 => _780()]);
-    _optionalChain([this, 'access', _781 => _781.interpolationCanvas, 'optionalAccess', _782 => _782.remove, 'call', _783 => _783()]);
+    _optionalChain([pipeline, 'optionalAccess', _792 => _792.stop, 'call', _793 => _793()]);
+    _optionalChain([this, 'access', _794 => _794.interpolationCanvas, 'optionalAccess', _795 => _795.remove, 'call', _796 => _796()]);
     this.interpolationCanvas = void 0;
   }
   /**
@@ -14390,11 +14621,12 @@ var XmaxVideoView = class {
    * 解绑当前轨道并清空渲染内容。
    */
   detachCurrentTrack() {
+    this.warmupController.reset();
     this.disposeTrajectory();
     this.statisticsController.stop();
     const track = this.currentTrack;
     if (track) {
-      _optionalChain([VideoRenderRegistry, 'access', _784 => _784.binding, 'call', _785 => _785(track), 'optionalAccess', _786 => _786.detachHandler, 'call', _787 => _787(this)]);
+      _optionalChain([VideoRenderRegistry, 'access', _797 => _797.binding, 'call', _798 => _798(track), 'optionalAccess', _799 => _799.detachHandler, 'call', _800 => _800(this)]);
     }
     this.setFrameInterpolation(void 0);
     this.cancelFrameDisplayNotification();
@@ -14417,8 +14649,15 @@ var XmaxVideoView = class {
       }
       this.hasNotifiedFrameDisplay = true;
       this.cancelFrameDisplayNotification();
-      _optionalChain([binding, 'optionalAccess', _788 => _788.frameDisplayHandler, 'optionalCall', _789 => _789()]);
-      _optionalChain([this, 'access', _790 => _790.frameDisplayHandler, 'optionalCall', _791 => _791()]);
+      const notifiedSequence = this.frameNotificationSequence;
+      _optionalChain([binding, 'optionalAccess', _801 => _801.frameDisplayHandler, 'optionalCall', _802 => _802()]);
+      _optionalChain([this, 'access', _803 => _803.frameDisplayHandler, 'optionalCall', _804 => _804()]);
+      if (notifiedSequence === this.frameNotificationSequence) {
+        this.warmupController.start(() => {
+          this.applyContentMode();
+          _optionalChain([binding, 'optionalAccess', _805 => _805.renderWarmupCompletedHandler, 'optionalCall', _806 => _806()]);
+        });
+      }
     };
     if (typeof this.videoElement.requestVideoFrameCallback === "function") {
       this.videoFrameCallbackID = this.videoElement.requestVideoFrameCallback(notify);
@@ -14446,11 +14685,19 @@ var XmaxVideoView = class {
       this.onPlaying = void 0;
     }
   }
+  /**
+   * 仅远端渲染绑定启用预热，本地预览和普通媒体直接显示。
+   */
+  prepareRenderWarmup() {
+    const binding = this.currentTrack ? VideoRenderRegistry.binding(this.currentTrack) : void 0;
+    this.warmupController.prepare(_optionalChain([binding, 'optionalAccess', _807 => _807.renderWarmupMs]));
+    this.applyContentMode();
+  }
   /**
    * 应用显示模式与镜像样式。
    */
   applyContentMode() {
-    _optionalChain([this, 'access', _792 => _792.trajectoryOverlay, 'optionalAccess', _793 => _793.configure, 'call', _794 => _794(this.contentMode, this.mirrored, this.interactionEnabled)]);
+    _optionalChain([this, 'access', _808 => _808.trajectoryOverlay, 'optionalAccess', _809 => _809.configure, 'call', _810 => _810(this.contentMode, this.mirrored, this.interactionEnabled && !this.warmupController.isPending)]);
     this.videoElement.style.objectFit = OBJECT_FIT[this.contentMode];
     this.videoElement.style.transform = this.mirrored ? "scaleX(-1)" : "";
     if (this.interpolationCanvas) {
@@ -14477,7 +14724,7 @@ var XmaxVideoView = class {
     }
     const overlay = new TrajectoryOverlayView(_nullishCoalesce(this.customTrajectoryRenderer, () => ( new DefaultTrajectoryEffectRenderer())));
     this.trajectoryOverlay = overlay;
-    overlay.configure(this.contentMode, this.mirrored, this.interactionEnabled);
+    overlay.configure(this.contentMode, this.mirrored, this.interactionEnabled && !this.warmupController.isPending);
     this.element.appendChild(overlay.element);
     binding.attach(overlay);
   }
@@ -14485,7 +14732,7 @@ var XmaxVideoView = class {
    * 换轨或卸载时移除全部交互资源；再次挂载时重新建立绑定。
    */
   disposeTrajectory() {
-    _optionalChain([this, 'access', _795 => _795.trajectoryOverlay, 'optionalAccess', _796 => _796.dispose, 'call', _797 => _797()]);
+    _optionalChain([this, 'access', _811 => _811.trajectoryOverlay, 'optionalAccess', _812 => _812.dispose, 'call', _813 => _813()]);
     this.trajectoryOverlay = void 0;
   }
 };
@@ -14519,15 +14766,15 @@ var XmaxRealtimeVideoView = class {
     _chunk4DE2IREAcjs.__publicField.call(void 0, this, "currentLocalTrack");
     _chunk4DE2IREAcjs.__publicField.call(void 0, this, "currentRemoteTrack");
     _chunk4DE2IREAcjs.__publicField.call(void 0, this, "contentMode");
-    this.contentMode = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _798 => _798.videoContentMode]), () => ( "fill")) /* fill */;
-    this.currentLocalTrack = _optionalChain([options, 'optionalAccess', _799 => _799.localTrack]);
-    this.currentRemoteTrack = _optionalChain([options, 'optionalAccess', _800 => _800.remoteTrack]);
+    this.contentMode = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _814 => _814.videoContentMode]), () => ( "fill")) /* fill */;
+    this.currentLocalTrack = _optionalChain([options, 'optionalAccess', _815 => _815.localTrack]);
+    this.currentRemoteTrack = _optionalChain([options, 'optionalAccess', _816 => _816.remoteTrack]);
     this.element = document.createElement("div");
     this.element.style.position = "relative";
     this.element.style.overflow = "hidden";
     this.element.style.backgroundColor = "black";
     this.localVideoView = new XmaxVideoView({ videoContentMode: this.contentMode, isInteractionEnabled: false });
-    this.remoteVideoView = new XmaxVideoView({ videoContentMode: this.contentMode, isInteractionEnabled: _optionalChain([options, 'optionalAccess', _801 => _801.isInteractionEnabled]) });
+    this.remoteVideoView = new XmaxVideoView({ videoContentMode: this.contentMode, isInteractionEnabled: _optionalChain([options, 'optionalAccess', _817 => _817.isInteractionEnabled]) });
     for (const view of [this.localVideoView, this.remoteVideoView]) {
       view.element.style.position = "absolute";
       view.element.style.inset = "0";
@@ -14578,7 +14825,7 @@ var XmaxRealtimeVideoView = class {
   }
   /**
    * 当前显示的远端生成视频轨道。
-   * 设置新轨道后等待首帧提交显示再渐入；置空时立即恢复本地预览。
+   * SDK 远端轨道等待首帧及预热后渐入；置空时立即恢复本地预览。
    */
   get remoteTrack() {
     return this.currentRemoteTrack;
@@ -14639,18 +14886,23 @@ var XmaxRealtimeVideoView = class {
     this.element.remove();
   }
   /**
-   * 更新远端轨道绑定：重置渐入状态，等待首帧提交后再显示远端画面。
+   * 更新远端轨道绑定；SDK 轨道共用单轨视图的预热，普通轨道等待首帧后渐入。
    */
   updateRemoteTrack() {
     const remoteTrack = this.currentRemoteTrack;
     this.remoteVideoView.frameDisplayHandler = void 0;
+    this.remoteVideoView.track = void 0;
     this.remoteVideoView.element.style.transition = "";
     this.remoteVideoView.element.style.opacity = "0";
     this.remoteVideoView.element.style.visibility = "hidden";
-    this.remoteVideoView.track = void 0;
     if (!remoteTrack) {
       return;
     }
+    if (_optionalChain([VideoRenderRegistry, 'access', _818 => _818.binding, 'call', _819 => _819(remoteTrack), 'optionalAccess', _820 => _820.renderWarmupMs]) !== void 0) {
+      this.remoteVideoView.element.style.visibility = "visible";
+      this.remoteVideoView.track = remoteTrack;
+      return;
+    }
     this.remoteVideoView.frameDisplayHandler = () => {
       if (this.currentRemoteTrack !== remoteTrack) {
         return;
@@ -14713,4 +14965,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.VideoContentMode = VideoContentMode; exports.RealtimeRecordingEventType = RealtimeRecordingEventType; exports.RealtimeRecordingFinishReason = RealtimeRecordingFinishReason; 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.XmaxVideoView = XmaxVideoView; exports.XmaxRealtimeVideoView = XmaxRealtimeVideoView;
-//# sourceMappingURL=chunk-KROY2O4A.cjs.map
+//# sourceMappingURL=chunk-UF2RD42G.cjs.map