@xmaxai/web-sdk 1.0.1 → 1.0.3

package/dist/{chunk-FH3OPC6F.cjs → chunk-JWAAS6P4.cjs}

@@ -9,10 +9,7 @@ var XmaxEnvironment = /* @__PURE__ */ ((XmaxEnvironment2) => {
   return XmaxEnvironment2;
 })(XmaxEnvironment || {});
 var API_BASE_URLS = {
-  /**
-   * 临时联调环境。
-   */
-  ["china" /* china */]: "https://dev.xmaxai.com/open/api/v1",
+  ["china" /* china */]: "https://cloud.xmax.22duck.cn/open/api/v1",
   ["global" /* global */]: "https://api.xmax.cloud/open/api/v1"
 };
 function apiBaseURL(environment) {
@@ -201,7 +198,7 @@ var XmaxError = class _XmaxError extends Error {
 };
 
 // src/Foundation/Runtime/RuntimeInfo.ts
-var XMAX_SDK_VERSION = "1.0.1";
+var XMAX_SDK_VERSION = "1.0.3";
 var _RuntimeInfo = class _RuntimeInfo {
   /**
    * 序列化为接口传输使用的 snake_case 字段。
@@ -266,10 +263,12 @@ var _ApiService = class _ApiService {
   }
   /**
    * 发送请求并返回统一响应中的数据。
+   *
+   * @param options.keepalive 为 true 时请求可存活于页面卸载之后。
    */
-  async request(method, path, body) {
+  async request(method, path, body, options) {
     this.validateConfiguration();
-    const request = this.makeRequest(method, path, body);
+    const request = this.makeRequest(method, path, body, options);
     const startedAt = Date.now();
     let status;
     let text;
@@ -316,8 +315,8 @@ var _ApiService = class _ApiService {
   /**
    * 发送 DELETE 请求。
    */
-  delete(path) {
-    return this.request("DELETE" /* delete */, path);
+  delete(path, options) {
+    return this.request("DELETE" /* delete */, path, void 0, options);
   }
   /**
    * 校验 API Key 与 Base URL 配置。
@@ -347,7 +346,7 @@ var _ApiService = class _ApiService {
   /**
    * 构造请求地址、请求头与请求体；路径必须相对且与 Base URL 同源。
    */
-  makeRequest(method, path, body) {
+  makeRequest(method, path, body, options) {
     const normalizedPath = path.trim();
     if (normalizedPath.length === 0 || normalizedPath.includes("://") || normalizedPath.startsWith("//")) {
       throw new XmaxError(
@@ -388,7 +387,8 @@ var _ApiService = class _ApiService {
           "X-SDK-Version": XMAX_SDK_VERSION
         },
         body: encodedBody,
-        signal: AbortSignal.timeout(this.timeoutMs)
+        signal: AbortSignal.timeout(this.timeoutMs),
+        ..._optionalChain([options, 'optionalAccess', _4 => _4.keepalive]) ? { keepalive: true } : {}
       }
     };
   }
@@ -406,7 +406,7 @@ var _ApiService = class _ApiService {
     }
     const ok = status >= 200 && status < 300;
     if (!ok || envelope.success !== true) {
-      const message = _optionalChain([envelope, 'access', _4 => _4.message, 'optionalAccess', _5 => _5.trim, 'call', _6 => _6()]);
+      const message = _optionalChain([envelope, 'access', _5 => _5.message, 'optionalAccess', _6 => _6.trim, 'call', _7 => _7()]);
       throw new XmaxError(
         "API_ERROR" /* apiError */,
         message || "Xmax API request failed",
@@ -565,7 +565,7 @@ var RealtimeVideoFormat = class _RealtimeVideoFormat {
 var RealtimeModel = /* @__PURE__ */ ((RealtimeModel2) => {
   RealtimeModel2["x2_0"] = "x2.0";
   RealtimeModel2["x2_0_pro"] = "x2.0-pro";
-  RealtimeModel2["x2_fast_1080p"] = "x2-fast-1080p";
+  RealtimeModel2["x2_0_trtc"] = "x2.0-trtc";
   return RealtimeModel2;
 })(RealtimeModel || {});
 var RESOLUTION_BUCKETS = {
@@ -574,7 +574,7 @@ var RESOLUTION_BUCKETS = {
     { width: 1024, height: 1920 },
     { width: 1920, height: 1024 }
   ],
-  ["x2-fast-1080p" /* x2_fast_1080p */]: [
+  ["x2.0-trtc" /* x2_0_trtc */]: [
     { width: 1024, height: 1920 },
     { width: 1920, height: 1024 }
   ]
@@ -582,7 +582,7 @@ var RESOLUTION_BUCKETS = {
 var MAXIMUM_INPUT_PIXELS = {
   ["x2.0" /* x2_0 */]: 128e4,
   ["x2.0-pro" /* x2_0_pro */]: 21e5,
-  ["x2-fast-1080p" /* x2_fast_1080p */]: 21e5
+  ["x2.0-trtc" /* x2_0_trtc */]: 21e5
 };
 function resolutionBuckets(model) {
   return RESOLUTION_BUCKETS[model];
@@ -612,7 +612,7 @@ async function frameInterpolationAdapter(size) {
   if (size && (!Number.isSafeInteger(size.width) || !Number.isSafeInteger(size.height) || size.width <= 0 || size.height <= 0)) return null;
   try {
     const adapter = await navigator.gpu.requestAdapter();
-    if (!_optionalChain([adapter, 'optionalAccess', _7 => _7.features, 'access', _8 => _8.has, 'call', _9 => _9("shader-f16")])) return null;
+    if (!_optionalChain([adapter, 'optionalAccess', _8 => _8.features, 'access', _9 => _9.has, 'call', _10 => _10("shader-f16")])) return null;
     if (size && (Math.ceil(size.width / 16) * 16 > adapter.limits.maxTextureDimension2D || Math.ceil(size.height / 16) * 16 > adapter.limits.maxTextureDimension2D)) return null;
     return adapter;
   } catch (e5) {
@@ -625,9 +625,9 @@ var MediaService = class {
   /**
    * 创建媒体服务。
    *
-   * @param model 媒体输入规则使用的模型，默认为 `x2-fast-1080p`。
+   * @param model 媒体输入规则使用的模型，默认为 `x2.0-trtc`。
    */
-  constructor(model = "x2-fast-1080p" /* x2_fast_1080p */) {
+  constructor(model = "x2.0-trtc" /* x2_0_trtc */) {
     /**
      * 模型约束
      */
@@ -826,7 +826,7 @@ var StorageService = class _StorageService {
     const startedAt = Date.now();
     try {
       const safeName = _StorageService.validateFileName(options.fileName);
-      const contentType = _optionalChain([options, 'access', _10 => _10.contentType, 'optionalAccess', _11 => _11.trim, 'call', _12 => _12()]) || _StorageService.inferContentType(safeName);
+      const contentType = _optionalChain([options, 'access', _11 => _11.contentType, 'optionalAccess', _12 => _12.trim, 'call', _13 => _13()]) || _StorageService.inferContentType(safeName);
       const body = _StorageService.makeBody(options.data, contentType);
       if (body.size === 0) {
         throw new XmaxError(
@@ -848,7 +848,7 @@ var StorageService = class _StorageService {
         Key: objectKey,
         Body: body,
         ContentType: contentType,
-        onProgress: options.onProgress ? (info) => _optionalChain([options, 'access', _13 => _13.onProgress, 'optionalCall', _14 => _14(info.loaded, info.total)]) : void 0
+        onProgress: options.onProgress ? (info) => _optionalChain([options, 'access', _14 => _14.onProgress, 'optionalCall', _15 => _15(info.loaded, info.total)]) : void 0
       });
       const url = _StorageService.resolveObjectURL(
         uploaded.Location,
@@ -880,9 +880,9 @@ var StorageService = class _StorageService {
     const bucket = _StorageService.nonEmpty(payload.bucket);
     const region = _StorageService.nonEmpty(payload.region);
     const prefix = _StorageService.nonEmpty(payload.prefix);
-    const accessKeyID = _StorageService.nonEmpty(_optionalChain([payload, 'access', _15 => _15.credentials, 'optionalAccess', _16 => _16.accessKeyId]));
-    const secretAccessKey = _StorageService.nonEmpty(_optionalChain([payload, 'access', _17 => _17.credentials, 'optionalAccess', _18 => _18.secretAccessKey]));
-    const sessionToken = _StorageService.nonEmpty(_optionalChain([payload, 'access', _19 => _19.credentials, 'optionalAccess', _20 => _20.sessionToken]));
+    const accessKeyID = _StorageService.nonEmpty(_optionalChain([payload, 'access', _16 => _16.credentials, 'optionalAccess', _17 => _17.accessKeyId]));
+    const secretAccessKey = _StorageService.nonEmpty(_optionalChain([payload, 'access', _18 => _18.credentials, 'optionalAccess', _19 => _19.secretAccessKey]));
+    const sessionToken = _StorageService.nonEmpty(_optionalChain([payload, 'access', _20 => _20.credentials, 'optionalAccess', _21 => _21.sessionToken]));
     if (!bucket || !region || !prefix || !accessKeyID || !secretAccessKey || !sessionToken) {
       throw new XmaxError("API_ERROR" /* apiError */, message);
     }
@@ -923,7 +923,7 @@ var StorageService = class _StorageService {
           reject(
             new XmaxError(
               "UPLOAD_ERROR" /* uploadError */,
-              _optionalChain([error, 'access', _21 => _21.message, 'optionalAccess', _22 => _22.trim, 'call', _23 => _23()]) || "Storage upload failed"
+              _optionalChain([error, 'access', _22 => _22.message, 'optionalAccess', _23 => _23.trim, 'call', _24 => _24()]) || "Storage upload failed"
             )
           );
           return;
@@ -937,14 +937,14 @@ var StorageService = class _StorageService {
    * 其次拼接自定义 endpoint，最后回退到默认 COS 域名。
    */
   static resolveObjectURL(location, configuration, objectKey) {
-    const candidate = _nullishCoalesce(_optionalChain([location, 'optionalAccess', _24 => _24.trim, 'call', _25 => _25()]), () => ( ""));
+    const candidate = _nullishCoalesce(_optionalChain([location, 'optionalAccess', _25 => _25.trim, 'call', _26 => _26()]), () => ( ""));
     if (candidate.startsWith("//")) {
       return `https:${candidate}`;
     }
     if (/^https?:\/\//i.test(candidate)) {
       return candidate;
     }
-    const endpoint = _optionalChain([configuration, 'access', _26 => _26.endpoint, 'optionalAccess', _27 => _27.trim, 'call', _28 => _28()]);
+    const endpoint = _optionalChain([configuration, 'access', _27 => _27.endpoint, 'optionalAccess', _28 => _28.trim, 'call', _29 => _29()]);
     if (endpoint) {
       const normalized = /^https?:\/\//i.test(endpoint) ? endpoint : `https://${endpoint}`;
       return `${normalized.replace(/\/+$/, "")}/${objectKey}`;
@@ -978,7 +978,7 @@ var StorageService = class _StorageService {
    * 按文件名后缀推断内容类型。
    */
   static inferContentType(fileName) {
-    const extension = _nullishCoalesce(_optionalChain([fileName, 'access', _29 => _29.split, 'call', _30 => _30("."), 'access', _31 => _31.pop, 'call', _32 => _32(), 'optionalAccess', _33 => _33.toLowerCase, 'call', _34 => _34()]), () => ( ""));
+    const extension = _nullishCoalesce(_optionalChain([fileName, 'access', _30 => _30.split, 'call', _31 => _31("."), 'access', _32 => _32.pop, 'call', _33 => _33(), 'optionalAccess', _34 => _34.toLowerCase, 'call', _35 => _35()]), () => ( ""));
     return _nullishCoalesce(CONTENT_TYPES[extension], () => ( "application/octet-stream"));
   }
   /**
@@ -997,7 +997,7 @@ var StorageService = class _StorageService {
    * 归一化可选字符串：去除首尾空白后为空时返回 `undefined`。
    */
   static nonEmpty(value) {
-    const normalized = _optionalChain([value, 'optionalAccess', _35 => _35.trim, 'call', _36 => _36()]);
+    const normalized = _optionalChain([value, 'optionalAccess', _36 => _36.trim, 'call', _37 => _37()]);
     return normalized || void 0;
   }
 };
@@ -1009,6 +1009,68 @@ var CameraPosition = /* @__PURE__ */ ((CameraPosition3) => {
   return CameraPosition3;
 })(CameraPosition || {});
 
+// src/Foundation/Permissions/MediaPermissionWatch.ts
+var PERMISSION_POLL_INTERVAL_MS = 100;
+async function watchMediaPermissionPrompt(includeMicrophone) {
+  if (typeof navigator === "undefined" || !_optionalChain([navigator, 'access', _38 => _38.permissions, 'optionalAccess', _39 => _39.query])) {
+    return void 0;
+  }
+  const names = ["camera", ...includeMicrophone ? ["microphone"] : []];
+  const queryOnce = () => Promise.all(
+    names.map(async (name) => {
+      const status = await navigator.permissions.query({
+        name
+      });
+      return status.state;
+    })
+  );
+  const queryStates = () => Promise.all(
+    names.map(async (name) => {
+      try {
+        const status = await navigator.permissions.query({
+          name
+        });
+        return status.state;
+      } catch (e6) {
+        return "prompt";
+      }
+    })
+  );
+  let states;
+  try {
+    states = await queryOnce();
+  } catch (e7) {
+    return void 0;
+  }
+  if (states.every((state2) => state2 === "granted")) {
+    return { decided: Promise.resolve(), dispose() {
+    } };
+  }
+  if (!states.includes("prompt")) {
+    return void 0;
+  }
+  let disposed = false;
+  let resolveDecided;
+  const decided = new Promise((resolve) => {
+    resolveDecided = resolve;
+  });
+  const finishIfDecided = (current) => {
+    if (disposed || current.includes("prompt")) {
+      return;
+    }
+    dispose();
+    resolveDecided();
+  };
+  const poll = setInterval(() => {
+    void queryStates().then(finishIfDecided);
+  }, PERMISSION_POLL_INTERVAL_MS);
+  function dispose() {
+    disposed = true;
+    clearInterval(poll);
+  }
+  return { decided, dispose };
+}
+
 // src/Foundation/RTC/RtcEngineManager.ts
 var RtcEngineLease = class {
   /**
@@ -1077,13 +1139,13 @@ var _RtcEngineManager = class _RtcEngineManager {
    * 释放有效租约、销毁 Engine，并把独占权交给下一个等待者。
    */
   release(lease) {
-    if (_optionalChain([this, 'access', _37 => _37.activeLease, 'optionalAccess', _38 => _38.id]) !== lease.id) {
+    if (_optionalChain([this, 'access', _40 => _40.activeLease, 'optionalAccess', _41 => _41.id]) !== lease.id) {
       return;
     }
     this.activeLease = void 0;
     try {
       lease.engine.destroy();
-    } catch (e6) {
+    } catch (e8) {
     }
     void this.fulfillNextRequest();
   }
@@ -1151,10 +1213,10 @@ var RtcStatsLogger = class {
         `${XmaxLogger.localized("\u7D2F\u8BA1\u63A5\u6536\uFF1A", "Bytes Received: ")}${this.value(stats.bytesReceived, "bytes")}`
       ])];
       const local = stats.localStatistics;
-      if (_optionalChain([local, 'optionalAccess', _39 => _39.audio])) {
+      if (_optionalChain([local, 'optionalAccess', _42 => _42.audio])) {
         blocks.push(this.audioBlock("\u672C\u5730\u97F3\u9891\u53D1\u9001 (Local Audio Uplink)", local.audio, false));
       }
-      for (const video of _nullishCoalesce(_optionalChain([local, 'optionalAccess', _40 => _40.video]), () => ( []))) {
+      for (const video of _nullishCoalesce(_optionalChain([local, 'optionalAccess', _43 => _43.video]), () => ( []))) {
         blocks.push(this.videoBlock("\u672C\u5730\u89C6\u9891\u53D1\u9001 (Local Video Uplink)", video, false));
       }
       for (const remote of _nullishCoalesce(stats.remoteStatistics, () => ( []))) {
@@ -1242,6 +1304,33 @@ var RtcStatsLogger = class {
   }
 };
 
+// src/Foundation/RTC/RtcVideoOrientation.ts
+function shouldTransposeRtcVideoSize(environment) {
+  const userAgent = _nullishCoalesce(_optionalChain([environment, 'optionalAccess', _44 => _44.userAgent]), () => ( (typeof navigator === "undefined" ? "" : navigator.userAgent)));
+  const maxTouchPoints = _nullishCoalesce(_optionalChain([environment, 'optionalAccess', _45 => _45.maxTouchPoints]), () => ( (typeof navigator === "undefined" ? 0 : _nullishCoalesce(navigator.maxTouchPoints, () => ( 0)))));
+  const mobile = /Android|webOS|iPhone|iPad|iPod|Mobile/i.test(userAgent) || /Macintosh/i.test(userAgent) && maxTouchPoints > 1;
+  if (!mobile) {
+    return false;
+  }
+  const orientationType = _nullishCoalesce(_optionalChain([environment, 'optionalAccess', _46 => _46.orientationType]), () => ( (typeof window === "undefined" ? void 0 : _optionalChain([window, 'access', _47 => _47.screen, 'optionalAccess', _48 => _48.orientation, 'optionalAccess', _49 => _49.type]))));
+  if (orientationType !== void 0) {
+    return orientationType.includes("portrait");
+  }
+  const degrees = _nullishCoalesce(_optionalChain([environment, 'optionalAccess', _50 => _50.orientationDegrees]), () => ( (typeof window === "undefined" ? void 0 : window.orientation)));
+  return degrees === 0 || degrees === 180;
+}
+function rtcOrientedVideoSize(size, environment) {
+  return shouldTransposeRtcVideoSize(environment) ? { width: size.height, height: size.width } : size;
+}
+
+// src/Foundation/RTC/RemoteAudioVolumeControl.ts
+function canControlRemoteAudioVolume(environment) {
+  const userAgent = _nullishCoalesce(_optionalChain([environment, 'optionalAccess', _51 => _51.userAgent]), () => ( (typeof navigator === "undefined" ? "" : navigator.userAgent)));
+  const maxTouchPoints = _nullishCoalesce(_optionalChain([environment, 'optionalAccess', _52 => _52.maxTouchPoints]), () => ( (typeof navigator === "undefined" ? 0 : _nullishCoalesce(navigator.maxTouchPoints, () => ( 0)))));
+  const ios = /iPhone|iPad|iPod/i.test(userAgent) || /Macintosh/i.test(userAgent) && maxTouchPoints > 1;
+  return !ios;
+}
+
 // src/Foundation/RTC/RtcManager.ts
 var RTC_EVENT = {
   remoteVideoAvailable: "remote-video-available",
@@ -1316,18 +1405,18 @@ var RtcManager = class {
     this.isCapturing = false;
     this.isAudioCapturing = false;
     this.isInRoom = false;
-    _optionalChain([this, 'access', _41 => _41.removeStatsListeners, 'optionalCall', _42 => _42()]);
+    _optionalChain([this, 'access', _53 => _53.removeStatsListeners, 'optionalCall', _54 => _54()]);
     this.removeStatsListeners = void 0;
     if (!lease) {
       return;
     }
     try {
       await lease.engine.stopLocalAudio();
-    } catch (e7) {
+    } catch (e9) {
     }
     try {
       await lease.engine.stopLocalVideo();
-    } catch (e8) {
+    } catch (e10) {
     }
     this.engineManager.release(lease);
   }
@@ -1346,13 +1435,17 @@ var RtcManager = class {
       );
     }
     try {
+      const captureSize = rtcOrientedVideoSize({
+        width: options.width,
+        height: options.height
+      });
       await engine.startLocalVideo({
         publish: false,
         option: {
           useFrontCamera: options.position === "front" /* front */,
           profile: {
-            width: options.width,
-            height: options.height,
+            width: captureSize.width,
+            height: captureSize.height,
             frameRate: options.frameRate,
             bitrate: CAPTURE_PLACEHOLDER_BITRATE
           }
@@ -1405,7 +1498,7 @@ var RtcManager = class {
    * 停止摄像头采集；引擎未初始化或采集未启动时不产生效果。
    */
   async stopCameraCapture() {
-    const engine = _optionalChain([this, 'access', _43 => _43.lease, 'optionalAccess', _44 => _44.engine]);
+    const engine = _optionalChain([this, 'access', _55 => _55.lease, 'optionalAccess', _56 => _56.engine]);
     this.isCapturing = false;
     if (!engine) {
       return;
@@ -1455,7 +1548,7 @@ var RtcManager = class {
    * 离开当前 RTC 房间；未在房间中或引擎未初始化时不产生效果，退房失败仅记录日志。
    */
   async leaveRoom() {
-    const engine = _optionalChain([this, 'access', _45 => _45.lease, 'optionalAccess', _46 => _46.engine]);
+    const engine = _optionalChain([this, 'access', _57 => _57.lease, 'optionalAccess', _58 => _58.engine]);
     if (!engine || !this.isInRoom) {
       return;
     }
@@ -1472,7 +1565,7 @@ var RtcManager = class {
   /**
    * 配置本地视频编码参数。
    *
-   * TRTC 只接受单一目标码率，以 `maximumBitrate` 作为目标码率；
+   * TRTC 只接受单一目标码率，以 `minimumBitrate`（流畅优先档）作为目标码率；
    * 编码策略偏好映射为 TRTC 弱网偏好。
    *
    * @throws 摄像头采集未启动或编码参数配置失败时抛出错误。
@@ -1486,13 +1579,17 @@ var RtcManager = class {
       );
     }
     try {
+      const encodingSize = rtcOrientedVideoSize({
+        width: configuration.width,
+        height: configuration.height
+      });
       await engine.updateLocalVideo({
         option: {
           profile: {
-            width: configuration.width,
-            height: configuration.height,
+            width: encodingSize.width,
+            height: encodingSize.height,
             frameRate: configuration.frameRate,
-            bitrate: configuration.maximumBitrate
+            bitrate: configuration.minimumBitrate
           },
           qosPreference: QOS_PREFERENCE_MAP[configuration.encoderPreference]
         }
@@ -1524,7 +1621,7 @@ var RtcManager = class {
    * 停止发布本地视频流；采集保持运行，本地预览不受影响。
    */
   async unpublishLocalVideo() {
-    const engine = _optionalChain([this, 'access', _47 => _47.lease, 'optionalAccess', _48 => _48.engine]);
+    const engine = _optionalChain([this, 'access', _59 => _59.lease, 'optionalAccess', _60 => _60.engine]);
     if (!engine || !this.isCapturing) {
       return;
     }
@@ -1556,7 +1653,7 @@ var RtcManager = class {
    * 停止发布本地音频流；麦克风采集保持运行。
    */
   async unpublishLocalAudio() {
-    const engine = _optionalChain([this, 'access', _49 => _49.lease, 'optionalAccess', _50 => _50.engine]);
+    const engine = _optionalChain([this, 'access', _61 => _61.lease, 'optionalAccess', _62 => _62.engine]);
     if (!engine || !this.isAudioCapturing) {
       return;
     }
@@ -1610,14 +1707,34 @@ var RtcManager = class {
       throw this.mapError(error);
     }
   }
+  /**
+   * 当前平台是否支持远端音量控制（iOS Safari/WKWebView 不支持）。
+   */
+  get supportsRemoteAudioVolumeControl() {
+    return canControlRemoteAudioVolume();
+  }
   /**
    * 设置指定远端用户的音频播放音量。
    *
+   * iOS Safari/WKWebView 不允许 JS 修改媒体元素音量（TRTC 官方标注
+   * `setRemoteAudioVolume` 不支持 iOS Safari），该平台上降级为
+   * 播放/静音二值控制：音量为 0 时停止播放该路音频，非 0 时恢复播放；
+   * 恢复播放需要重新拉流，会有短暂缓冲。
+   *
    * @param volume 音量，取值范围为 `0...100`，越界时收敛到边界。
    */
   setRemoteAudioVolume(volume, userID) {
     const engine = this.requireEngine();
     const normalized = Math.min(Math.max(Math.round(volume), 0), 100);
+    if (!canControlRemoteAudioVolume()) {
+      void engine.muteRemoteAudio(userID, normalized === 0).catch((error) => {
+        XmaxLogger.rtc.warning(
+          () => `\u8FDC\u7AEF\u97F3\u9891\u64AD\u653E\u72B6\u6001\u5207\u6362\u5931\u8D25 (Failed to Toggle Remote Audio Playback)
+\u2514\u2500 ${XmaxLogger.localized("\u539F\u56E0\uFF1A", "Reason: ")}${XmaxError.from(error).message}`
+        );
+      });
+      return;
+    }
     engine.setRemoteAudioVolume(userID, normalized);
   }
   /**
@@ -1657,19 +1774,19 @@ var RtcManager = class {
   registerEventBridge(engine) {
     const source = engine;
     const onStatistics = (stats) => {
-      if (this.isInRoom && _optionalChain([this, 'access', _51 => _51.lease, 'optionalAccess', _52 => _52.engine]) === engine) {
+      if (this.isInRoom && _optionalChain([this, 'access', _63 => _63.lease, 'optionalAccess', _64 => _64.engine]) === engine) {
         RtcStatsLogger.logStatistics(stats);
-        const video = _optionalChain([stats, 'access', _53 => _53.localStatistics, 'optionalAccess', _54 => _54.video, 'optionalAccess', _55 => _55.find, 'call', _56 => _56((item) => item.videoType === "big")]);
+        const video = _optionalChain([stats, 'access', _65 => _65.localStatistics, 'optionalAccess', _66 => _66.video, 'optionalAccess', _67 => _67.find, 'call', _68 => _68((item) => item.videoType === "big")]);
         const valid = (value, minimum) => typeof value === "number" && Number.isFinite(value) && value >= minimum ? value : void 0;
-        _optionalChain([this, 'access', _57 => _57.eventListener, 'optionalAccess', _58 => _58.onLocalVideoStatistics, 'optionalCall', _59 => _59(video ? Object.freeze({
+        _optionalChain([this, 'access', _69 => _69.eventListener, 'optionalAccess', _70 => _70.onLocalVideoStatistics, 'optionalCall', _71 => _71(video ? Object.freeze({
           width: valid(video.width, 1),
           height: valid(video.height, 1),
           frameRate: valid(video.frameRate, 0),
           bitrateKbps: valid(video.bitrate, 0)
         }) : void 0)]);
-        _optionalChain([this, 'access', _60 => _60.eventListener, 'optionalAccess', _61 => _61.onRemoteVideoStatistics, 'optionalCall', _62 => _62(Object.freeze(
+        _optionalChain([this, 'access', _72 => _72.eventListener, 'optionalAccess', _73 => _73.onRemoteVideoStatistics, 'optionalCall', _74 => _74(Object.freeze(
           (_nullishCoalesce(stats.remoteStatistics, () => ( []))).flatMap((remote) => {
-            const video2 = _optionalChain([remote, 'access', _63 => _63.video, 'optionalAccess', _64 => _64.find, 'call', _65 => _65((item) => item.videoType === "big")]);
+            const video2 = _optionalChain([remote, 'access', _75 => _75.video, 'optionalAccess', _76 => _76.find, 'call', _77 => _77((item) => item.videoType === "big")]);
             if (!video2) {
               return [];
             }
@@ -1691,11 +1808,11 @@ var RtcManager = class {
       }
     };
     const onNetworkQuality = (stats) => {
-      if (this.isInRoom && _optionalChain([this, 'access', _66 => _66.lease, 'optionalAccess', _67 => _67.engine]) === engine) {
+      if (this.isInRoom && _optionalChain([this, 'access', _78 => _78.lease, 'optionalAccess', _79 => _79.engine]) === engine) {
         RtcStatsLogger.logNetworkQuality(stats);
         const quality = (value) => Number.isInteger(value) && value >= 0 && value <= 6 ? value : void 0;
         const rtt = (value) => Number.isFinite(value) && value >= 0 ? value : void 0;
-        _optionalChain([this, 'access', _68 => _68.eventListener, 'optionalAccess', _69 => _69.onNetworkStatistics, 'optionalCall', _70 => _70(Object.freeze({
+        _optionalChain([this, 'access', _80 => _80.eventListener, 'optionalAccess', _81 => _81.onNetworkStatistics, 'optionalCall', _82 => _82(Object.freeze({
           uplinkQuality: quality(stats.uplinkNetworkQuality),
           downlinkQuality: quality(stats.downlinkNetworkQuality),
           uplinkRttMs: rtt(stats.uplinkRTT),
@@ -1713,13 +1830,13 @@ var RtcManager = class {
       if (event.streamType !== STREAM_TYPE_MAIN) {
         return;
       }
-      _optionalChain([this, 'access', _71 => _71.eventListener, 'optionalAccess', _72 => _72.onRemoteVideoPublished, 'call', _73 => _73(event.userId, true)]);
+      _optionalChain([this, 'access', _83 => _83.eventListener, 'optionalAccess', _84 => _84.onRemoteVideoPublished, 'call', _85 => _85(event.userId, true)]);
     });
     source.on(RTC_EVENT.remoteVideoUnavailable, (event) => {
       if (event.streamType !== STREAM_TYPE_MAIN) {
         return;
       }
-      _optionalChain([this, 'access', _74 => _74.eventListener, 'optionalAccess', _75 => _75.onRemoteVideoPublished, 'call', _76 => _76(event.userId, false)]);
+      _optionalChain([this, 'access', _86 => _86.eventListener, 'optionalAccess', _87 => _87.onRemoteVideoPublished, 'call', _88 => _88(event.userId, false)]);
     });
     source.on(RTC_EVENT.customMessage, (event) => {
       if (event.cmdId !== CUSTOM_MESSAGE_CMD_ID) {
@@ -1728,18 +1845,18 @@ var RtcManager = class {
       let message;
       try {
         message = new TextDecoder().decode(event.data);
-      } catch (e9) {
+      } catch (e11) {
         XmaxLogger.rtc.warning(() => "\u81EA\u5B9A\u4E49\u6D88\u606F\u89E3\u7801\u5931\u8D25 (Failed to Decode Custom Message)");
         return;
       }
-      _optionalChain([this, 'access', _77 => _77.eventListener, 'optionalAccess', _78 => _78.onCustomMessageReceived, 'call', _79 => _79(event.userId, message)]);
+      _optionalChain([this, 'access', _89 => _89.eventListener, 'optionalAccess', _90 => _90.onCustomMessageReceived, 'call', _91 => _91(event.userId, message)]);
     });
   }
   /**
    * 返回当前引擎实例；未初始化时抛出错误。
    */
   requireEngine() {
-    const engine = _optionalChain([this, 'access', _80 => _80.lease, 'optionalAccess', _81 => _81.engine]);
+    const engine = _optionalChain([this, 'access', _92 => _92.lease, 'optionalAccess', _93 => _93.engine]);
     if (!engine) {
       throw new XmaxError(
         "RTC_ERROR" /* rtcError */,
@@ -1756,8 +1873,8 @@ var RtcManager = class {
       return error;
     }
     const rtcError = error;
-    const originName = _nullishCoalesce(_optionalChain([rtcError, 'optionalAccess', _82 => _82.originError, 'optionalAccess', _83 => _83.name]), () => ( ""));
-    const message = typeof _optionalChain([rtcError, 'optionalAccess', _84 => _84.message]) === "string" && rtcError.message.trim().length > 0 ? rtcError.message.trim() : String(error);
+    const originName = _nullishCoalesce(_optionalChain([rtcError, 'optionalAccess', _94 => _94.originError, 'optionalAccess', _95 => _95.name]), () => ( ""));
+    const message = typeof _optionalChain([rtcError, 'optionalAccess', _96 => _96.message]) === "string" && rtcError.message.trim().length > 0 ? rtcError.message.trim() : String(error);
     if (originName === "NotAllowedError" || originName === "SecurityError" || /NotAllowed/i.test(message)) {
       return new XmaxError("CAMERA_PERMISSION_DENIED" /* cameraPermissionDenied */, message);
     }
@@ -1769,74 +1886,25 @@ var RtcManager = class {
 };
 
 // src/Foundation/Media/Camera/CameraFrameValidator.ts
-var FALLBACK_POLL_INTERVAL_MS = 16;
-var TIMEOUT_MS = 2e3;
-var CameraFrameValidator = class {
-  /**
-   * 单帧中央区域亮度达标即放行，不等待连续帧或曝光稳定。
-   */
-  accept(pixels) {
-    const size = pixels.length / 4;
-    if (!size || !Number.isInteger(size)) return false;
-    const histogram = new Uint32Array(256);
-    let total = 0;
-    let dark = 0;
-    for (let i = 0; i < pixels.length; i += 4) {
-      const luminance = Math.round(0.2126 * pixels[i] + 0.7152 * pixels[i + 1] + 0.0722 * pixels[i + 2]);
-      histogram[luminance] = histogram[luminance] + 1;
-      total += luminance;
-      if (luminance < 12) dark++;
-    }
-    let median = 0;
-    let accumulated = 0;
-    for (; median < 255; median++) {
-      accumulated += histogram[median];
-      if (accumulated >= size / 2) break;
-    }
-    const mean = total / size;
-    return mean >= 24 && median >= 18 && dark / size <= 0.75;
-  }
-};
+var CAMERA_WARMUP_MS = 200;
 function waitForValidCameraFrame(track, signal) {
   return new Promise((resolve, reject) => {
-    let video;
-    let timeout;
-    let poll;
-    let frameCallback;
-    let finished = false;
-    const started = performance.now();
-    const gate = new CameraFrameValidator();
-    const finish = (result = "valid") => {
-      if (finished) return;
-      finished = true;
-      clearTimeout(timeout);
-      clearTimeout(poll);
-      if (video) {
-        if (frameCallback !== void 0) video.cancelVideoFrameCallback(frameCallback);
-        video.pause();
-        video.srcObject = null;
-        video.remove();
-      }
+    let timer;
+    let settled = false;
+    const finish = (error) => {
+      if (settled) return;
+      settled = true;
+      clearTimeout(timer);
       signal.removeEventListener("abort", abort);
       track.removeEventListener("ended", ended);
-      if (result instanceof XmaxError) {
-        if (result.code !== "CANCELLED" /* cancelled */) XmaxLogger.media.warning(() => result.message);
-        reject(result);
+      if (error) {
+        reject(error);
       } else {
-        if (result === "timeout") {
-          XmaxLogger.media.warning(() => XmaxLogger.localized(
-            "\u76F8\u673A\u4EAE\u5EA6\u68C0\u67E5\u8D85\u65F6\uFF0C\u6309\u5F53\u524D\u753B\u9762\u7EE7\u7EED\u751F\u6210 (Camera Frame Validation Timed Out; Continuing)\n\u2514\u2500 \u672A\u83B7\u5F97\u4EAE\u5EA6\u5408\u683C\u5E27\uFF0C\u4E0D\u518D\u7B49\u5F85\u3002",
-            "Camera Frame Validation Timed Out; Continuing\n\u2514\u2500 No sufficiently bright frame received; proceeding without further waiting."
-          ));
-        } else {
-          XmaxLogger.media.info(() => `\u76F8\u673A\u66DD\u5149\u68C0\u67E5\u901A\u8FC7 (Camera Exposure Ready)
-\u2514\u2500 ${Math.round(performance.now() - started)} ms`);
-        }
         resolve();
       }
     };
-    const abort = () => finish(new XmaxError("CANCELLED" /* cancelled */, "Camera exposure check cancelled"));
-    const ended = () => finish(new XmaxError("MEDIA_ERROR" /* mediaError */, "Camera track ended before exposure was ready"));
+    const abort = () => finish(new XmaxError("CANCELLED" /* cancelled */, "Camera warmup cancelled"));
+    const ended = () => finish(new XmaxError("MEDIA_ERROR" /* mediaError */, "Camera track ended before warmup completed"));
     signal.addEventListener("abort", abort, { once: true });
     track.addEventListener("ended", ended, { once: true });
     if (signal.aborted) {
@@ -1847,70 +1915,7 @@ function waitForValidCameraFrame(track, signal) {
       ended();
       return;
     }
-    try {
-      video = document.createElement("video");
-      video.muted = true;
-      video.autoplay = true;
-      video.playsInline = true;
-      video.setAttribute("aria-hidden", "true");
-      video.style.cssText = "position:fixed;left:0;top:0;width:1px;height:1px;opacity:0;pointer-events:none;";
-      const canvas = document.createElement("canvas");
-      canvas.width = 64;
-      canvas.height = 48;
-      const context = canvas.getContext("2d", { willReadFrequently: true });
-      if (!context) throw new Error("Camera exposure sampling requires a 2D canvas");
-      video.srcObject = new MediaStream([track]);
-      document.body.appendChild(video);
-      const source = video;
-      let lastFrameTime = -Infinity;
-      const sample = (mediaTime) => {
-        if (source.readyState < 2 || !source.videoWidth || !source.videoHeight || track.muted || !track.enabled) {
-          return;
-        }
-        if (mediaTime === lastFrameTime) return;
-        lastFrameTime = mediaTime;
-        const width = source.videoWidth;
-        const height = source.videoHeight;
-        context.drawImage(source, width * 0.2, height * 0.2, width * 0.6, height * 0.6, 0, 0, 64, 48);
-        if (gate.accept(context.getImageData(0, 0, 64, 48).data)) finish();
-      };
-      const fail = (error) => finish(new XmaxError(
-        "MEDIA_ERROR" /* mediaError */,
-        `Camera exposure check failed: ${error instanceof Error ? error.message : String(error)}`
-      ));
-      const schedule = () => {
-        if (finished) return;
-        if (typeof source.requestVideoFrameCallback === "function") {
-          frameCallback = source.requestVideoFrameCallback((_now, metadata) => {
-            frameCallback = void 0;
-            try {
-              sample(metadata.mediaTime);
-              schedule();
-            } catch (error) {
-              fail(error);
-            }
-          });
-        } else {
-          poll = setTimeout(() => {
-            try {
-              const frameTime = typeof source.getVideoPlaybackQuality === "function" ? source.getVideoPlaybackQuality().totalVideoFrames : source.currentTime;
-              sample(frameTime);
-              schedule();
-            } catch (error) {
-              fail(error);
-            }
-          }, FALLBACK_POLL_INTERVAL_MS);
-        }
-      };
-      timeout = setTimeout(() => finish("timeout"), TIMEOUT_MS);
-      XmaxLogger.media.info(() => "\u7B49\u5F85\u9996\u5F20\u4EAE\u5EA6\u5408\u683C\u5E27 (Waiting for the First Sufficiently Bright Frame)");
-      void source.play().then(schedule, fail);
-    } catch (error) {
-      finish(new XmaxError(
-        "MEDIA_ERROR" /* mediaError */,
-        `Camera exposure check failed: ${error instanceof Error ? error.message : String(error)}`
-      ));
-    }
+    timer = setTimeout(() => finish(), CAMERA_WARMUP_MS);
   });
 }
 
@@ -1940,7 +1945,7 @@ var PermissionManager = class {
    * @param deniedCode 权限被拒绝时抛出的错误码。
    */
   async ensurePermission(name, deniedCode) {
-    if (typeof navigator === "undefined" || !_optionalChain([navigator, 'access', _85 => _85.mediaDevices, 'optionalAccess', _86 => _86.getUserMedia])) {
+    if (typeof navigator === "undefined" || !_optionalChain([navigator, 'access', _97 => _97.mediaDevices, 'optionalAccess', _98 => _98.getUserMedia])) {
       throw new XmaxError(
         deniedCode,
         "This browser does not support media capture (getUserMedia)"
@@ -1948,7 +1953,7 @@ var PermissionManager = class {
     }
     try {
       const permissions = navigator.permissions;
-      if (!_optionalChain([permissions, 'optionalAccess', _87 => _87.query])) {
+      if (!_optionalChain([permissions, 'optionalAccess', _99 => _99.query])) {
         return;
       }
       const status = await permissions.query({
@@ -2128,10 +2133,10 @@ var _CameraController = class _CameraController {
      */
     __publicField(this, "storedUseMicrophone", false);
     __publicField(this, "storedFrameValidationEnabled", true);
-    this.permissionManager = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _88 => _88.permissionManager]), () => ( new PermissionManager()));
-    this.rtcManager = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _89 => _89.rtcManager]), () => ( new RtcManager()));
-    this.mediaService = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _90 => _90.mediaService]), () => ( new MediaService()));
-    this.errorListener = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _91 => _91.errorListener]), () => ( (() => {
+    this.permissionManager = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _100 => _100.permissionManager]), () => ( new PermissionManager()));
+    this.rtcManager = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _101 => _101.rtcManager]), () => ( new RtcManager()));
+    this.mediaService = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _102 => _102.mediaService]), () => ( new MediaService()));
+    this.errorListener = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _103 => _103.errorListener]), () => ( (() => {
     })));
   }
   /**
@@ -2147,23 +2152,23 @@ var _CameraController = class _CameraController {
     return this.activeTrack !== void 0 && this.storedUseMicrophone;
   }
   /**
-   * 当前活动相机流是否启用发布前亮度检测；没有活动流时为 false。
+   * 当前活动相机流是否启用发布前预热等待；没有活动流时为 false。
    */
   get isFrameValidationEnabled() {
     return this.activeTrack !== void 0 && this.storedFrameValidationEnabled;
   }
   /**
-   * 等待当前轨道首张合格帧或超时放行；禁用时跳过，取消或轨道被替换时拒绝。
+   * 等待当前轨道预热完成（固定 200ms）；禁用时跳过，取消或轨道被替换时拒绝。
    */
   async waitForValidCameraFrame(signal) {
     const track = this.activeTrack;
-    const mediaTrack = _optionalChain([track, 'optionalAccess', _92 => _92.mediaStreamTrack]);
+    const mediaTrack = _optionalChain([track, 'optionalAccess', _104 => _104.mediaStreamTrack]);
     if (!mediaTrack) throw new XmaxError("MEDIA_ERROR" /* mediaError */, "Camera capture is not running");
     if (signal.aborted) throw new XmaxError("CANCELLED" /* cancelled */, "Camera frame validation cancelled");
     if (!this.isFrameValidationEnabled) return;
     await waitForValidCameraFrame(mediaTrack, signal);
     if (this.activeTrack !== track || track.mediaStreamTrack !== mediaTrack) {
-      throw new XmaxError("CANCELLED" /* cancelled */, "Camera track changed during exposure check");
+      throw new XmaxError("CANCELLED" /* cancelled */, "Camera track changed during warmup");
     }
   }
   /**
@@ -2182,7 +2187,7 @@ var _CameraController = class _CameraController {
    * @param options.videoFormat 期望的输出尺寸、帧率和编码配置；尺寸按模型规则调整。
    * @param options.position 首次启动时使用的摄像头位置。
    * @param options.useMicrophone 是否申请麦克风权限并允许实时连接时启动音频采集。
-   * @param options.enableFrameValidation 是否在发布前检测帧亮度，默认 true；false 跳过检测及其等待。
+   * @param options.enableFrameValidation 是否在发布前等待相机预热（固定 200ms），默认 true；false 跳过等待。
    * @returns 包含本地相机视频轨道的媒体流。
    * @throws 已有活动相机流、格式无效、权限不足或采集启动失败时抛出错误。
    */
@@ -2257,7 +2262,7 @@ var _CameraController = class _CameraController {
    */
   async switchCamera() {
     const track = this.activeTrack;
-    const position = _optionalChain([track, 'optionalAccess', _93 => _93.position]);
+    const position = _optionalChain([track, 'optionalAccess', _105 => _105.position]);
     if (!track || !position) {
       throw new XmaxError(
         "RTC_ERROR" /* rtcError */,
@@ -2275,7 +2280,7 @@ var _CameraController = class _CameraController {
       }
       this.previewStream.addTrack(mediaTrack);
     }
-    _optionalChain([this, 'access', _94 => _94.previewMirrorApplier, 'optionalCall', _95 => _95(nextPosition === "front" /* front */)]);
+    _optionalChain([this, 'access', _106 => _106.previewMirrorApplier, 'optionalCall', _107 => _107(nextPosition === "front" /* front */)]);
     this.observeMediaTrack(track, mediaTrack);
     return new RealtimeMediaStream({ id: "stream0" /* local */, videoTrack: track });
   }
@@ -2531,12 +2536,13 @@ var RealtimeSessionService = class _RealtimeSessionService {
     this.heartbeatVersion += 1;
   }
   /**
-   * 关闭指定实时会话。
+   * 关闭指定实时会话；请求带 keepalive，页面卸载后仍能发出。
    */
   async closeSession(sessionID) {
     try {
       await this.apiService.delete(
-        `/session/${sessionID}`
+        `/session/${sessionID}`,
+        { keepalive: true }
       );
     } catch (error) {
       throw XmaxError.from(error);
@@ -2557,7 +2563,7 @@ var RealtimeSessionService = class _RealtimeSessionService {
           return;
         }
         _RealtimeSessionService.ensureSessionActive(session);
-        _optionalChain([handlers, 'access', _96 => _96.onRefresh, 'optionalCall', _97 => _97(session)]);
+        _optionalChain([handlers, 'access', _108 => _108.onRefresh, 'optionalCall', _109 => _109(session)]);
       } catch (error) {
         if (this.heartbeatVersion !== version) {
           return;
@@ -2650,7 +2656,7 @@ var RealtimeSessionService = class _RealtimeSessionService {
     if (typeof modelExtra === "string") {
       try {
         return JSON.parse(modelExtra);
-      } catch (e10) {
+      } catch (e12) {
         return void 0;
       }
     }
@@ -2663,7 +2669,7 @@ var RealtimeSessionService = class _RealtimeSessionService {
    * 归一化可选字符串：去除首尾空白后为空时返回 `undefined`。
    */
   static nonEmpty(value) {
-    const normalized = _optionalChain([value, 'optionalAccess', _98 => _98.trim, 'call', _99 => _99()]);
+    const normalized = _optionalChain([value, 'optionalAccess', _110 => _110.trim, 'call', _111 => _111()]);
     return normalized || void 0;
   }
 };
@@ -2735,7 +2741,7 @@ var RealtimeState = class {
    * @param other 待比较的状态。
    */
   equals(other) {
-    return this.connectionState === other.connectionState && this.sessionID === other.sessionID && this.taskID === other.taskID && _optionalChain([this, 'access', _100 => _100.reason, 'optionalAccess', _101 => _101.kind]) === _optionalChain([other, 'access', _102 => _102.reason, 'optionalAccess', _103 => _103.kind]);
+    return this.connectionState === other.connectionState && this.sessionID === other.sessionID && this.taskID === other.taskID && _optionalChain([this, 'access', _112 => _112.reason, 'optionalAccess', _113 => _113.kind]) === _optionalChain([other, 'access', _114 => _114.reason, 'optionalAccess', _115 => _115.kind]);
   }
 };
 
@@ -2904,7 +2910,7 @@ var RoomEvent = class _RoomEvent {
   static encode(payload) {
     try {
       return JSON.stringify({ ...payload, runtime: RuntimeInfo.toJSON() });
-    } catch (e11) {
+    } catch (e13) {
       throw new XmaxError(
         "INTERNAL_ERROR" /* internalError */,
         "Failed to encode RTC room event"
@@ -3026,7 +3032,7 @@ var _RoomMessageCodec = class _RoomMessageCodec {
     let parsed;
     try {
       parsed = JSON.parse(message);
-    } catch (e12) {
+    } catch (e14) {
       XmaxLogger.room.warning(() => "\u623F\u95F4\u6D88\u606F\u4E0D\u662F\u5408\u6CD5 JSON (Room Message Is Not Valid JSON)");
       return void 0;
     }
@@ -3057,7 +3063,7 @@ var _RoomMessageCodec = class _RoomMessageCodec {
     const joined = parts.join("");
     try {
       return JSON.parse(joined);
-    } catch (e13) {
+    } catch (e15) {
       XmaxLogger.room.warning(
         () => `\u623F\u95F4\u6D88\u606F\u7EC4\u5305\u540E\u4E0D\u662F\u5408\u6CD5 JSON (Reassembled Message Is Not Valid JSON)
 \u2514\u2500 eventId: ${chunk.eventId}`
@@ -3355,7 +3361,7 @@ var RoomController = class {
     if (targetUserID && ownUserID && targetUserID !== ownUserID) {
       return;
     }
-    _optionalChain([this, 'access', _104 => _104.listener, 'optionalAccess', _105 => _105.onRoomMessage, 'call', _106 => _106(senderUserID, message)]);
+    _optionalChain([this, 'access', _116 => _116.listener, 'optionalAccess', _117 => _117.onRoomMessage, 'call', _118 => _118(senderUserID, message)]);
   }
   /**
    * 发送房间信令并输出日志。
@@ -3600,18 +3606,18 @@ var StreamController = class {
     this.rtcManager.setEventListener({
       onNetworkStatistics: (statistics) => {
         if (this.state.localVideoPublished) {
-          _optionalChain([this, 'access', _107 => _107.networkStatisticsListener, 'optionalCall', _108 => _108(statistics)]);
+          _optionalChain([this, 'access', _119 => _119.networkStatisticsListener, 'optionalCall', _120 => _120(statistics)]);
         }
       },
       onRemoteVideoStatistics: (statistics) => {
-        const userID = _optionalChain([this, 'access', _109 => _109.state, 'access', _110 => _110.activeRemoteStream, 'optionalAccess', _111 => _111.userID]);
-        _optionalChain([this, 'access', _112 => _112.remoteVideoStatisticsListener, 'optionalCall', _113 => _113(
+        const userID = _optionalChain([this, 'access', _121 => _121.state, 'access', _122 => _122.activeRemoteStream, 'optionalAccess', _123 => _123.userID]);
+        _optionalChain([this, 'access', _124 => _124.remoteVideoStatisticsListener, 'optionalCall', _125 => _125(
           userID ? statistics.find((item) => item.userID === userID) : void 0
         )]);
       },
       onLocalVideoStatistics: (statistics) => {
         if (this.state.localVideoPublished) {
-          _optionalChain([this, 'access', _114 => _114.localVideoStatisticsListener, 'optionalCall', _115 => _115(statistics)]);
+          _optionalChain([this, 'access', _126 => _126.localVideoStatisticsListener, 'optionalCall', _127 => _127(statistics)]);
         }
       },
       onCustomMessageReceived: (senderUserID, message) => {
@@ -3683,7 +3689,7 @@ var StreamController = class {
       () => `RTC \u623F\u95F4\u5DF2\u914D\u7F6E (RTC Room Configured)
 \u2514\u2500 roomID: ${connection.roomID}, botID: ${_nullishCoalesce(connection.botID, () => ( "(\u672A\u8BBE\u7F6E)"))}`
     );
-    await _optionalChain([beforePublish, 'optionalCall', _116 => _116()]);
+    await _optionalChain([beforePublish, 'optionalCall', _128 => _128()]);
     ensureActive();
     await this.publishLocalStream(includeLocalAudio);
   }
@@ -3754,7 +3760,7 @@ var StreamController = class {
       this.rejectGenerationStart(taskID, mapped);
       try {
         this.roomController.stopGeneration(taskID);
-      } catch (e14) {
+      } catch (e16) {
       }
       throw mapped;
     }
@@ -3843,7 +3849,7 @@ var StreamController = class {
    */
   configureRoom(options) {
     const roomID = options.roomID.trim();
-    const botID = _nullishCoalesce(_optionalChain([options, 'access', _117 => _117.botID, 'optionalAccess', _118 => _118.trim, 'call', _119 => _119()]), () => ( ""));
+    const botID = _nullishCoalesce(_optionalChain([options, 'access', _129 => _129.botID, 'optionalAccess', _130 => _130.trim, 'call', _131 => _131()]), () => ( ""));
     if (!roomID) {
       throw new XmaxError(
         "INVALID_CONFIGURATION" /* invalidConfiguration */,
@@ -3920,7 +3926,7 @@ var StreamController = class {
       return;
     }
     this.state.subscribedRemoteUserIDs.delete(trimmedUserID);
-    if (_optionalChain([this, 'access', _120 => _120.state, 'access', _121 => _121.activeRemoteStream, 'optionalAccess', _122 => _122.userID]) === trimmedUserID) {
+    if (_optionalChain([this, 'access', _132 => _132.state, 'access', _133 => _133.activeRemoteStream, 'optionalAccess', _134 => _134.userID]) === trimmedUserID) {
       await this.unsubscribeRemoteAudio(trimmedUserID);
       this.state.activeRemoteStream = void 0;
       this.clearRemoteStream();
@@ -3996,14 +4002,23 @@ var StreamController = class {
     }
   }
   /**
-   * 订阅远端音频：先应用当前音量再订阅。
+   * 订阅远端音频并按平台能力应用当前音量。
+   *
+   * 支持音量控制的平台先设音量再订阅，避免以默认音量短暂出声；
+   * iOS 上音量降级为播放/静音二值控制，必须先完成订阅（恢复播放）
+   * 再按需静音，否则订阅的恢复播放会覆盖音量 0 的静音状态。
    */
   async subscribeRemoteAudio(userID) {
     if (this.state.subscribedRemoteAudioUserIDs.has(userID)) {
       return;
     }
-    this.rtcManager.setRemoteAudioVolume(this.remoteAudioVolumePercentage, userID);
-    await this.rtcManager.subscribeRemoteAudio(userID, true);
+    if (this.rtcManager.supportsRemoteAudioVolumeControl) {
+      this.rtcManager.setRemoteAudioVolume(this.remoteAudioVolumePercentage, userID);
+      await this.rtcManager.subscribeRemoteAudio(userID, true);
+    } else {
+      await this.rtcManager.subscribeRemoteAudio(userID, true);
+      this.rtcManager.setRemoteAudioVolume(this.remoteAudioVolumePercentage, userID);
+    }
     this.state.subscribedRemoteAudioUserIDs.add(userID);
   }
   /**
@@ -4080,7 +4095,7 @@ var StreamController = class {
    */
   resolveGenerationStart(taskID) {
     const waiter = this.state.generationWaiter;
-    if (this.state.generationTaskID !== taskID || _optionalChain([waiter, 'optionalAccess', _123 => _123.taskID]) !== taskID) {
+    if (this.state.generationTaskID !== taskID || _optionalChain([waiter, 'optionalAccess', _135 => _135.taskID]) !== taskID) {
       return;
     }
     this.state.generationWaiter = void 0;
@@ -4092,7 +4107,7 @@ var StreamController = class {
    */
   rejectGenerationStart(taskID, error) {
     const waiter = this.state.generationWaiter;
-    if (this.state.generationTaskID !== taskID || _optionalChain([waiter, 'optionalAccess', _124 => _124.taskID]) !== taskID) {
+    if (this.state.generationTaskID !== taskID || _optionalChain([waiter, 'optionalAccess', _136 => _136.taskID]) !== taskID) {
       return;
     }
     this.state.generationWaiter = void 0;
@@ -4103,7 +4118,7 @@ var StreamController = class {
    * 通知渲染层清理远端生成流；失败仅记录日志。
    */
   clearRemoteStream() {
-    _optionalChain([this, 'access', _125 => _125.remoteVideoStatisticsListener, 'optionalCall', _126 => _126(void 0)]);
+    _optionalChain([this, 'access', _137 => _137.remoteVideoStatisticsListener, 'optionalCall', _138 => _138(void 0)]);
     try {
       this.remoteStreamListener(null);
     } catch (error) {
@@ -4374,7 +4389,7 @@ var RealtimeCoordinator = class _RealtimeCoordinator {
         }
         throw _RealtimeCoordinator.cancelledError();
       }
-      const terminationTask = await _asyncNullishCoalesce(await _asyncNullishCoalesce(operation.terminationTask, async () => ( _optionalChain([this, 'access', _127 => _127.termination, 'optionalAccess', _128 => _128.task]))), async () => ( await this.requestTermination(
+      const terminationTask = await _asyncNullishCoalesce(await _asyncNullishCoalesce(operation.terminationTask, async () => ( _optionalChain([this, 'access', _139 => _139.termination, 'optionalAccess', _140 => _140.task]))), async () => ( await this.requestTermination(
         _nullishCoalesce(operation.lease.failureScope, () => ( 0)) /* connection */,
         void 0,
         RealtimeReason.normal,
@@ -4503,7 +4518,7 @@ var RealtimeCoordinator = class _RealtimeCoordinator {
    * 结束指定操作，释放操作准入场。
    */
   finish(operation) {
-    if (_optionalChain([this, 'access', _129 => _129.activeOperation, 'optionalAccess', _130 => _130.id]) === operation.id) {
+    if (_optionalChain([this, 'access', _141 => _141.activeOperation, 'optionalAccess', _142 => _142.id]) === operation.id) {
       this.activeOperation = void 0;
     }
   }
@@ -4515,7 +4530,7 @@ var RealtimeCoordinator = class _RealtimeCoordinator {
       return;
     }
     this.state = nextState;
-    _optionalChain([this, 'access', _131 => _131.stateListener, 'optionalCall', _132 => _132(nextState)]);
+    _optionalChain([this, 'access', _143 => _143.stateListener, 'optionalCall', _144 => _144(nextState)]);
   }
   /**
    * 构造统一的操作取消错误。
@@ -4591,17 +4606,25 @@ var RealtimeLaunchTimer = class {
     this.notify();
     return complete;
   }
+  /**
+   * 开始等待用户授权系统媒体权限，返回授权决定时调用的记录函数。
+   * 仅在系统弹出授权请求时使用；已授权或未弹窗不记录该阶段。
+   */
+  startPermission() {
+    return this.measure("permissionMs", performance.now());
+  }
   /**
    * 开始会话与进房计时，返回连接阶段完成时调用的记录函数。
+   * 相机预热等待计入连接耗时。
    */
   startConnection() {
     return this.measure("connectionMs", performance.now());
   }
   /**
-   * 开始亮度检测计时；合格帧到达或超时放行时调用返回的记录函数。
+   * 开始发布本地流计时，返回发布完成时调用的记录函数。
    */
-  startFrameValidation() {
-    return this.measure("frameValidationMs", performance.now());
+  startPublish() {
+    return this.measure("publishMs", performance.now());
   }
   /**
    * 开始等待远端显示首帧；完成回调同时记录首帧耗时和实际总耗时。
@@ -4639,9 +4662,9 @@ var RealtimeLaunchTimer = class {
    */
   notify() {
     try {
-      void Promise.resolve(_optionalChain([this, 'access', _133 => _133.listener, 'optionalCall', _134 => _134(this.snapshot)])).catch(() => {
+      void Promise.resolve(_optionalChain([this, 'access', _145 => _145.listener, 'optionalCall', _146 => _146(this.snapshot)])).catch(() => {
       });
-    } catch (e15) {
+    } catch (e17) {
     }
   }
 };
@@ -4667,7 +4690,7 @@ var XmaxRealtimeConnectionManager = class {
    * 当前活动会话标识；尚未连接或清理完成后为空。
    */
   get currentSessionID() {
-    return _optionalChain([this, 'access', _135 => _135.activeSession, 'optionalAccess', _136 => _136.id]);
+    return _optionalChain([this, 'access', _147 => _147.activeSession, 'optionalAccess', _148 => _148.id]);
   }
   /**
    * 未配置 API 服务时在连接操作开始前报错，不影响本地预览。
@@ -4677,7 +4700,8 @@ var XmaxRealtimeConnectionManager = class {
   }
   /**
    * 创建会话、配置编码、进房并发布本地媒体，启动心跳后返回远端占位流。
-   * 进房结束即记录连接耗时；可选 beforePublish 检查只阻塞发布，不计入连接耗时。
+   * 进房结束即记录连接耗时；可选 beforePublish 检查阻塞发布，计入连接耗时；
+   * 发布本地流单独计时。
    * @throws 会话、进房、发布失败或操作租约已失效时抛出错误，由上层统一清理。
    */
   async connect(options) {
@@ -4704,15 +4728,17 @@ var XmaxRealtimeConnectionManager = class {
     }
     await streamController.setVideoEncoderConfig(videoFormat);
     options.ensureCurrent();
+    let completePublish;
     await streamController.connect(connection, options.includeLocalAudio, () => {
       options.ensureCurrent();
     }, async () => {
       options.ensureCurrent();
+      await _optionalChain([options, 'access', _149 => _149.beforePublish, 'optionalCall', _150 => _150()]);
       completeConnection();
-      options.ensureCurrent();
-      await _optionalChain([options, 'access', _137 => _137.beforePublish, 'optionalCall', _138 => _138()]);
+      completePublish = this.dependencies.timing.startPublish();
     });
     options.ensureCurrent();
+    _optionalChain([completePublish, 'optionalCall', _151 => _151()]);
     options.onPublished();
     sessionService.startHeartbeat(session.id, {
       onFailure: (sessionID, error) => {
@@ -4735,26 +4761,26 @@ var XmaxRealtimeConnectionManager = class {
    * 更新已绑定远端视图的插帧配置；传 undefined 停用插帧。
    */
   setFrameInterpolation(options) {
-    _optionalChain([this, 'access', _139 => _139.remoteTarget, 'optionalAccess', _140 => _140.setFrameInterpolation, 'optionalCall', _141 => _141(options)]);
+    _optionalChain([this, 'access', _152 => _152.remoteTarget, 'optionalAccess', _153 => _153.setFrameInterpolation, 'optionalCall', _154 => _154(options)]);
   }
   /**
    * 清空远端视图的媒体流，保留轨道与视图绑定以供统一清理。
    */
   clearRemoteMedia() {
-    _optionalChain([this, 'access', _142 => _142.remoteTarget, 'optionalAccess', _143 => _143.setMediaStream, 'call', _144 => _144(null)]);
+    _optionalChain([this, 'access', _155 => _155.remoteTarget, 'optionalAccess', _156 => _156.setMediaStream, 'call', _157 => _157(null)]);
   }
   /**
    * 停止会话心跳；未配置会话服务时不执行操作。
    */
   stopHeartbeat() {
-    _optionalChain([this, 'access', _145 => _145.dependencies, 'access', _146 => _146.sessionService, 'optionalAccess', _147 => _147.stopHeartbeat, 'call', _148 => _148()]);
+    _optionalChain([this, 'access', _158 => _158.dependencies, 'access', _159 => _159.sessionService, 'optionalAccess', _160 => _160.stopHeartbeat, 'call', _161 => _161()]);
   }
   /**
    * 等待接收轨解除静音；超时只警告，取消必须立即退出并移除监听。
    */
   async waitUntilRemoteTrackReady(timeoutMs, signal) {
     if (signal.aborted) throw RealtimeCoordinator.cancelledError();
-    const mediaTrack = _optionalChain([this, 'access', _149 => _149.activeRemoteTrack, 'optionalAccess', _150 => _150.mediaStreamTrack]);
+    const mediaTrack = _optionalChain([this, 'access', _162 => _162.activeRemoteTrack, 'optionalAccess', _163 => _163.mediaStreamTrack]);
     if (!mediaTrack || !mediaTrack.muted) return;
     await new Promise((resolve, reject) => {
       const cleanup = () => {
@@ -4791,7 +4817,7 @@ var XmaxRealtimeConnectionManager = class {
       if (track) {
         track.mediaStreamTrack = void 0;
       }
-      _optionalChain([this, 'access', _151 => _151.remoteTarget, 'optionalAccess', _152 => _152.setMediaStream, 'call', _153 => _153(null)]);
+      _optionalChain([this, 'access', _164 => _164.remoteTarget, 'optionalAccess', _165 => _165.setMediaStream, 'call', _166 => _166(null)]);
       return;
     }
     if (!track) {
@@ -4801,7 +4827,7 @@ var XmaxRealtimeConnectionManager = class {
       );
     }
     track.mediaStreamTrack = binding.videoTrack;
-    _optionalChain([this, 'access', _154 => _154.remoteTarget, 'optionalAccess', _155 => _155.setMediaStream, 'call', _156 => _156(new MediaStream([binding.videoTrack]))]);
+    _optionalChain([this, 'access', _167 => _167.remoteTarget, 'optionalAccess', _168 => _168.setMediaStream, 'call', _169 => _169(new MediaStream([binding.videoTrack]))]);
   }
   /**
    * 为远端轨道注册渲染绑定：attach 时挂流占位，媒体轨到达后送入画面。
@@ -4814,7 +4840,7 @@ var XmaxRealtimeConnectionManager = class {
         }
       },
       attachHandler: (view) => {
-        _optionalChain([this, 'access', _157 => _157.remoteTarget, 'optionalAccess', _158 => _158.setFrameInterpolation, 'optionalCall', _159 => _159(void 0)]);
+        _optionalChain([this, 'access', _170 => _170.remoteTarget, 'optionalAccess', _171 => _171.setFrameInterpolation, 'optionalCall', _172 => _172(void 0)]);
         view.isMirrored = this.dependencies.isMirrored();
         this.remoteTarget = view;
         this.dependencies.onRenderAttached();
@@ -4826,7 +4852,7 @@ var XmaxRealtimeConnectionManager = class {
           this.dependencies.onRenderDetached();
           this.remoteTarget = void 0;
         }
-        _optionalChain([view, 'access', _160 => _160.setFrameInterpolation, 'optionalCall', _161 => _161(void 0)]);
+        _optionalChain([view, 'access', _173 => _173.setFrameInterpolation, 'optionalCall', _174 => _174(void 0)]);
         view.setMediaStream(null);
       }
     });
@@ -4886,7 +4912,7 @@ var XmaxRealtimeConnectionManager = class {
    * 尽力清理全部连接资源，即使退房失败也关闭服务端会话。
    */
   async disconnect() {
-    const sessionID = _optionalChain([this, 'access', _162 => _162.activeSession, 'optionalAccess', _163 => _163.id]);
+    const sessionID = _optionalChain([this, 'access', _175 => _175.activeSession, 'optionalAccess', _176 => _176.id]);
     this.stopHeartbeat();
     this.clearRemoteMedia();
     try {
@@ -5019,7 +5045,7 @@ var XmaxRealtimeGenerationManager = class _XmaxRealtimeGenerationManager {
     try {
       await completion;
     } finally {
-      if (_optionalChain([this, 'access', _164 => _164.pendingStop, 'optionalAccess', _165 => _165.completion]) === completion) this.pendingStop = void 0;
+      if (_optionalChain([this, 'access', _177 => _177.pendingStop, 'optionalAccess', _178 => _178.completion]) === completion) this.pendingStop = void 0;
     }
   }
   /**
@@ -5101,6 +5127,10 @@ var XmaxRealtimeManager = class _XmaxRealtimeManager {
      */
     __publicField(this, "launchTimer", new RealtimeLaunchTimer());
     __publicField(this, "remoteFrameDisplayHandler");
+    /**
+     * 媒体权限弹窗观察
+     */
+    __publicField(this, "permissionWatchDispose");
     /**
      * 本地、远端和网络统计快照及观察者
      */
@@ -5125,18 +5155,18 @@ var XmaxRealtimeManager = class _XmaxRealtimeManager {
     this.options = options;
     this.mediaService = new MediaService(options.model);
     this.interpolationRequested = options.isFrameInterpolationEnabled;
-    this.supportsInterpolation = _nullishCoalesce(_optionalChain([dependencies, 'optionalAccess', _166 => _166.supportsFrameInterpolation]), () => ( (async (size) => await frameInterpolationAdapter(size) !== null)));
+    this.supportsInterpolation = _nullishCoalesce(_optionalChain([dependencies, 'optionalAccess', _179 => _179.supportsFrameInterpolation]), () => ( (async (size) => await frameInterpolationAdapter(size) !== null)));
     this.errorHandler = new RealtimeErrorHandler();
-    const rtcManager = _nullishCoalesce(_optionalChain([dependencies, 'optionalAccess', _167 => _167.rtcManager]), () => ( new RtcManager()));
-    this.cameraController = _nullishCoalesce(_optionalChain([dependencies, 'optionalAccess', _168 => _168.cameraController]), () => ( new CameraController({
+    const rtcManager = _nullishCoalesce(_optionalChain([dependencies, 'optionalAccess', _180 => _180.rtcManager]), () => ( new RtcManager()));
+    this.cameraController = _nullishCoalesce(_optionalChain([dependencies, 'optionalAccess', _181 => _181.cameraController]), () => ( new CameraController({
       rtcManager,
       mediaService: this.mediaService,
       errorListener: (error) => {
         void this.errorHandler.report(error);
       }
     })));
-    const sessionService = _nullishCoalesce(_optionalChain([dependencies, 'optionalAccess', _169 => _169.sessionService]), () => ( (_optionalChain([dependencies, 'optionalAccess', _170 => _170.apiService]) ? new RealtimeSessionService({ apiService: dependencies.apiService }) : void 0)));
-    this.streamController = _nullishCoalesce(_optionalChain([dependencies, 'optionalAccess', _171 => _171.streamController]), () => ( new StreamController({
+    const sessionService = _nullishCoalesce(_optionalChain([dependencies, 'optionalAccess', _182 => _182.sessionService]), () => ( (_optionalChain([dependencies, 'optionalAccess', _183 => _183.apiService]) ? new RealtimeSessionService({ apiService: dependencies.apiService }) : void 0)));
+    this.streamController = _nullishCoalesce(_optionalChain([dependencies, 'optionalAccess', _184 => _184.streamController]), () => ( new StreamController({
       rtcManager,
       errorListener: (error) => {
         void this.errorHandler.report(error);
@@ -5150,12 +5180,12 @@ var XmaxRealtimeManager = class _XmaxRealtimeManager {
       sessionService,
       streamController: this.streamController,
       timing: this.launchTimer,
-      isMirrored: () => _optionalChain([this, 'access', _172 => _172.cameraController, 'access', _173 => _173.currentTrack, 'optionalAccess', _174 => _174.position]) === "front" /* front */,
+      isMirrored: () => _optionalChain([this, 'access', _185 => _185.cameraController, 'access', _186 => _186.currentTrack, 'optionalAccess', _187 => _187.position]) === "front" /* front */,
       remoteAudioVolume: () => this.storedRemoteAudioVolume,
       onHeartbeatFailure: (sessionID, error) => {
         void this.handleHeartbeatFailure(sessionID, error);
       },
-      onFrameDisplayed: () => _optionalChain([this, 'access', _175 => _175.remoteFrameDisplayHandler, 'optionalCall', _176 => _176()]),
+      onFrameDisplayed: () => _optionalChain([this, 'access', _188 => _188.remoteFrameDisplayHandler, 'optionalCall', _189 => _189()]),
       onRenderAttached: () => this.applyRemoteInterpolation(),
       onRenderDetached: () => {
         this.interpolationRevision++;
@@ -5202,7 +5232,7 @@ var XmaxRealtimeManager = class _XmaxRealtimeManager {
    */
   async setFrameInterpolationEnabled(enabled) {
     await this.coordinator.run("configuration" /* configuration */, void 0, async (token) => {
-      const format = _optionalChain([this, 'access', _177 => _177.cameraController, 'access', _178 => _178.currentTrack, 'optionalAccess', _179 => _179.videoFormat]);
+      const format = _optionalChain([this, 'access', _190 => _190.cameraController, 'access', _191 => _191.currentTrack, 'optionalAccess', _192 => _192.videoFormat]);
       const size = format && enabled ? this.mediaService.resolveFrameInterpolationSize(format) : void 0;
       if (enabled && !await this.checkInterpolationSupport(size, token)) {
         token.ensureCurrent();
@@ -5328,9 +5358,9 @@ var XmaxRealtimeManager = class _XmaxRealtimeManager {
    */
   notifyRemoteVideoStatistics() {
     try {
-      void Promise.resolve(_optionalChain([this, 'access', _180 => _180.remoteVideoStatisticsListener, 'optionalCall', _181 => _181(this.remoteVideoStatistics)])).catch(() => {
+      void Promise.resolve(_optionalChain([this, 'access', _193 => _193.remoteVideoStatisticsListener, 'optionalCall', _194 => _194(this.remoteVideoStatistics)])).catch(() => {
       });
-    } catch (e16) {
+    } catch (e18) {
     }
   }
   /**
@@ -5345,9 +5375,9 @@ var XmaxRealtimeManager = class _XmaxRealtimeManager {
    */
   notifyNetworkStatistics() {
     try {
-      void Promise.resolve(_optionalChain([this, 'access', _182 => _182.networkStatisticsListener, 'optionalCall', _183 => _183(this.networkStatistics)])).catch(() => {
+      void Promise.resolve(_optionalChain([this, 'access', _195 => _195.networkStatisticsListener, 'optionalCall', _196 => _196(this.networkStatistics)])).catch(() => {
       });
-    } catch (e17) {
+    } catch (e19) {
     }
   }
   /**
@@ -5365,9 +5395,9 @@ var XmaxRealtimeManager = class _XmaxRealtimeManager {
    */
   notifyLocalVideoStatistics() {
     try {
-      void Promise.resolve(_optionalChain([this, 'access', _184 => _184.localVideoStatisticsListener, 'optionalCall', _185 => _185(this.localVideoStatistics)])).catch(() => {
+      void Promise.resolve(_optionalChain([this, 'access', _197 => _197.localVideoStatisticsListener, 'optionalCall', _198 => _198(this.localVideoStatistics)])).catch(() => {
       });
-    } catch (e18) {
+    } catch (e20) {
     }
   }
   /**
@@ -5419,7 +5449,7 @@ var XmaxRealtimeManager = class _XmaxRealtimeManager {
    *
    * 将返回的轨道绑定到预览视图；收到有效帧且视图已绑定后进入 `ready`。
    *
-   * @param options.enableFrameValidation 是否在发布前检测帧亮度，默认 true；false 跳过检测及其等待。
+   * @param options.enableFrameValidation 是否在发布前等待相机预热（固定 200ms），默认 true；false 跳过等待。
    * @returns 包含本地相机视频轨道的媒体流。
    * @throws 模型不支持相机输入、配置无效、权限或采集启动失败时抛出错误。
    */
@@ -5437,11 +5467,20 @@ var XmaxRealtimeManager = class _XmaxRealtimeManager {
         token.ensureCurrent();
         const completeCamera = this.launchTimer.startCamera();
         this.clearVideoStatistics();
+        this.disposePermissionWatch();
+        const permissionWatch = await watchMediaPermissionPrompt(_nullishCoalesce(_optionalChain([options, 'optionalAccess', _199 => _199.useMicrophone]), () => ( false)));
+        if (permissionWatch) {
+          const completePermission = this.launchTimer.startPermission();
+          void permissionWatch.decided.then(() => completePermission()).catch(() => {
+          });
+          this.permissionWatchDispose = permissionWatch.dispose;
+        }
         let stream;
         try {
           token.ensureCurrent();
           stream = await this.cameraController.createLocalCameraStream(options);
         } catch (error) {
+          this.disposePermissionWatch();
           this.launchTimer.cancel();
           throw error;
         }
@@ -5454,6 +5493,13 @@ var XmaxRealtimeManager = class _XmaxRealtimeManager {
       }
     );
   }
+  /**
+   * 移除媒体权限弹窗观察；授权决定已记录或不再需要观察时调用。
+   */
+  disposePermissionWatch() {
+    _optionalChain([this, 'access', _200 => _200.permissionWatchDispose, 'optionalCall', _201 => _201()]);
+    this.permissionWatchDispose = void 0;
+  }
   /**
    * 停止本地相机流并释放本地预览与 RTC 资源。
    */
@@ -5464,6 +5510,7 @@ var XmaxRealtimeManager = class _XmaxRealtimeManager {
       async (token) => {
         this.launchTimer.cancel();
         this.clearVideoStatistics();
+        this.disposePermissionWatch();
         await this.cameraController.stopLocalCameraStream();
         token.ensureCurrent();
         await this.coordinator.commit(
@@ -5497,8 +5544,7 @@ var XmaxRealtimeManager = class _XmaxRealtimeManager {
    * 使用当前 Manager 创建的本地流建立实时连接。
    *
    * 创建实时会话、加入 RTC 房间并发布本地流，成功后启动会话心跳。
-   * 启用帧检测时，发布前并行检查相机亮度，首张合格帧即放行；2 秒内未通过检查则
-   * 记录警告并按当前画面继续发布，不因环境较暗而阻断连接。
+   * 启用帧检测时，发布前并行等待相机预热（固定 200ms），避免把黑帧推给 RTC。
    * 返回的远端媒体流在生成开始后承载远端生成画面。
    *
    * @param localStream 由 `createLocalCameraStream` 创建的本地媒体流。
@@ -5607,17 +5653,15 @@ var XmaxRealtimeManager = class _XmaxRealtimeManager {
       new RealtimeState({ connectionState: "Connecting" /* connecting */ }),
       token
     );
-    const exposureController = new AbortController();
-    const abortExposure = () => exposureController.abort();
-    token.signal.addEventListener("abort", abortExposure, { once: true });
-    if (token.signal.aborted) abortExposure();
+    const warmupController = new AbortController();
+    const abortWarmup = () => warmupController.abort();
+    token.signal.addEventListener("abort", abortWarmup, { once: true });
+    if (token.signal.aborted) abortWarmup();
     try {
       let beforePublish;
       if (this.cameraController.isFrameValidationEnabled) {
-        const completeFrameValidation = this.launchTimer.startFrameValidation();
-        const cameraReady = this.cameraController.waitForValidCameraFrame(exposureController.signal).then(() => {
+        const cameraReady = this.cameraController.waitForValidCameraFrame(warmupController.signal).then(() => {
           token.ensureCurrent();
-          completeFrameValidation();
         });
         void cameraReady.catch(() => {
         });
@@ -5642,8 +5686,8 @@ var XmaxRealtimeManager = class _XmaxRealtimeManager {
       );
       return remote;
     } finally {
-      token.signal.removeEventListener("abort", abortExposure);
-      abortExposure();
+      token.signal.removeEventListener("abort", abortWarmup);
+      abortWarmup();
     }
   }
   /**
@@ -5700,6 +5744,7 @@ var XmaxRealtimeManager = class _XmaxRealtimeManager {
     await this.generationManager.reset(taskID);
     const sessionID = await this.connectionManager.disconnect();
     if (scope === 1 /* all */) {
+      this.disposePermissionWatch();
       try {
         await this.cameraController.stopLocalCameraStream();
       } catch (error) {
@@ -5815,9 +5860,9 @@ var XmaxClient = class {
   /**
    * 创建媒体处理与能力查询 Service。
    *
-   * @param model 媒体输入规则使用的模型，默认为 `x2-fast-1080p`。
+   * @param model 媒体输入规则使用的模型，默认为 `x2.0-trtc`。
    */
-  createMediaService(model = "x2-fast-1080p" /* x2_fast_1080p */) {
+  createMediaService(model = "x2.0-trtc" /* x2_0_trtc */) {
     return new MediaService(model);
   }
   /**
@@ -5859,11 +5904,11 @@ var RealtimeConfiguration = class {
      */
     __publicField(this, "frameInterpolation");
     this.model = init.model;
-    const targetFrameRate = _nullishCoalesce(_optionalChain([init, 'access', _186 => _186.frameInterpolation, 'optionalAccess', _187 => _187.targetFrameRate]), () => ( 60));
+    const targetFrameRate = _nullishCoalesce(_optionalChain([init, 'access', _202 => _202.frameInterpolation, 'optionalAccess', _203 => _203.targetFrameRate]), () => ( 60));
     if (!Number.isFinite(targetFrameRate) || targetFrameRate < 1 || targetFrameRate > 60) {
       throw new XmaxError("INVALID_CONFIGURATION" /* invalidConfiguration */, "Interpolation targetFrameRate must be between 1 and 60");
     }
-    this.isFrameInterpolationEnabled = _nullishCoalesce(_nullishCoalesce(_optionalChain([init, 'access', _188 => _188.frameInterpolation, 'optionalAccess', _189 => _189.enabled]), () => ( init.isFrameInterpolationEnabled)), () => ( false));
+    this.isFrameInterpolationEnabled = _nullishCoalesce(_nullishCoalesce(_optionalChain([init, 'access', _204 => _204.frameInterpolation, 'optionalAccess', _205 => _205.enabled]), () => ( init.isFrameInterpolationEnabled)), () => ( false));
     this.frameInterpolation = Object.freeze({ enabled: this.isFrameInterpolationEnabled, targetFrameRate });
   }
 };
@@ -5893,7 +5938,7 @@ var RealtimeContext = class {
      */
     __publicField(this, "referencePath");
     this.prompt = init.prompt.trim();
-    const normalizedReferencePath = _optionalChain([init, 'access', _190 => _190.referencePath, 'optionalAccess', _191 => _191.trim, 'call', _192 => _192()]);
+    const normalizedReferencePath = _optionalChain([init, 'access', _206 => _206.referencePath, 'optionalAccess', _207 => _207.trim, 'call', _208 => _208()]);
     this.referencePath = normalizedReferencePath || void 0;
   }
 };
@@ -8020,11 +8065,11 @@ var _FrameInterpolationManager = class _FrameInterpolationManager {
     if (this.destroyed) return;
     this.destroyed = true;
     this.device.removeEventListener("uncapturederror", this.onGPUError);
-    _optionalChain([this, 'access', _193 => _193.runtime, 'optionalAccess', _194 => _194.destroy, 'call', _195 => _195()]);
+    _optionalChain([this, 'access', _209 => _209.runtime, 'optionalAccess', _210 => _210.destroy, 'call', _211 => _211()]);
     this.runtime = void 0;
     this.textures.forEach((texture) => texture.destroy());
     this.textures = [];
-    _optionalChain([this, 'access', _196 => _196.context, 'optionalAccess', _197 => _197.unconfigure, 'call', _198 => _198()]);
+    _optionalChain([this, 'access', _212 => _212.context, 'optionalAccess', _213 => _213.unconfigure, 'call', _214 => _214()]);
     this.device.destroy();
   }
 };
@@ -8203,7 +8248,7 @@ var RemoteVideoFramePipeline = class {
   setActive(active) {
     if (active === this.active) return;
     this.active = active;
-    _optionalChain([this, 'access', _199 => _199.options, 'access', _200 => _200.onActiveChange, 'optionalCall', _201 => _201(active)]);
+    _optionalChain([this, 'access', _215 => _215.options, 'access', _216 => _216.onActiveChange, 'optionalCall', _217 => _217(active)]);
   }
   resetTimeline() {
     this.generation++;
@@ -8234,7 +8279,7 @@ var RemoteVideoFramePipeline = class {
     this.callback = void 0;
     clearTimeout(this.initializationTimer);
     this.resetTimeline();
-    _optionalChain([this, 'access', _202 => _202.processor, 'optionalAccess', _203 => _203.destroy, 'call', _204 => _204()]);
+    _optionalChain([this, 'access', _218 => _218.processor, 'optionalAccess', _219 => _219.destroy, 'call', _220 => _220()]);
     this.processor = void 0;
   }
 };
@@ -8292,7 +8337,7 @@ var XmaxVideoView = class {
      * DOM 挂载状态
      */
     __publicField(this, "detached", false);
-    this.contentMode = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _205 => _205.videoContentMode]), () => ( "fill")) /* fill */;
+    this.contentMode = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _221 => _221.videoContentMode]), () => ( "fill")) /* fill */;
     this.element = document.createElement("div");
     this.element.style.position = "relative";
     this.element.style.overflow = "hidden";
@@ -8439,8 +8484,8 @@ var XmaxVideoView = class {
   stopInterpolation() {
     const pipeline = this.interpolationPipeline;
     this.interpolationPipeline = void 0;
-    _optionalChain([pipeline, 'optionalAccess', _206 => _206.stop, 'call', _207 => _207()]);
-    _optionalChain([this, 'access', _208 => _208.interpolationCanvas, 'optionalAccess', _209 => _209.remove, 'call', _210 => _210()]);
+    _optionalChain([pipeline, 'optionalAccess', _222 => _222.stop, 'call', _223 => _223()]);
+    _optionalChain([this, 'access', _224 => _224.interpolationCanvas, 'optionalAccess', _225 => _225.remove, 'call', _226 => _226()]);
     this.interpolationCanvas = void 0;
   }
   /**
@@ -8466,7 +8511,7 @@ var XmaxVideoView = class {
   detachCurrentTrack() {
     const track = this.currentTrack;
     if (track) {
-      _optionalChain([VideoRenderRegistry, 'access', _211 => _211.binding, 'call', _212 => _212(track), 'optionalAccess', _213 => _213.detachHandler, 'call', _214 => _214(this)]);
+      _optionalChain([VideoRenderRegistry, 'access', _227 => _227.binding, 'call', _228 => _228(track), 'optionalAccess', _229 => _229.detachHandler, 'call', _230 => _230(this)]);
     }
     this.setFrameInterpolation(void 0);
     this.cancelFrameDisplayNotification();
@@ -8486,8 +8531,8 @@ var XmaxVideoView = class {
       }
       this.hasNotifiedFrameDisplay = true;
       this.cancelFrameDisplayNotification();
-      _optionalChain([binding, 'optionalAccess', _215 => _215.frameDisplayHandler, 'optionalCall', _216 => _216()]);
-      _optionalChain([this, 'access', _217 => _217.frameDisplayHandler, 'optionalCall', _218 => _218()]);
+      _optionalChain([binding, 'optionalAccess', _231 => _231.frameDisplayHandler, 'optionalCall', _232 => _232()]);
+      _optionalChain([this, 'access', _233 => _233.frameDisplayHandler, 'optionalCall', _234 => _234()]);
     };
     if (typeof this.videoElement.requestVideoFrameCallback === "function") {
       this.videoFrameCallbackID = this.videoElement.requestVideoFrameCallback(notify);
@@ -8557,9 +8602,9 @@ var XmaxRealtimeVideoView = class {
     __publicField(this, "currentLocalTrack");
     __publicField(this, "currentRemoteTrack");
     __publicField(this, "contentMode");
-    this.contentMode = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _219 => _219.videoContentMode]), () => ( "fill")) /* fill */;
-    this.currentLocalTrack = _optionalChain([options, 'optionalAccess', _220 => _220.localTrack]);
-    this.currentRemoteTrack = _optionalChain([options, 'optionalAccess', _221 => _221.remoteTrack]);
+    this.contentMode = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _235 => _235.videoContentMode]), () => ( "fill")) /* fill */;
+    this.currentLocalTrack = _optionalChain([options, 'optionalAccess', _236 => _236.localTrack]);
+    this.currentRemoteTrack = _optionalChain([options, 'optionalAccess', _237 => _237.remoteTrack]);
     this.element = document.createElement("div");
     this.element.style.position = "relative";
     this.element.style.overflow = "hidden";
@@ -8718,4 +8763,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.RealtimeModel = RealtimeModel; exports.defaultFrameRate = defaultFrameRate; exports.defaultCameraVideoFormat = defaultCameraVideoFormat; exports.MediaService = MediaService; exports.StoredFile = StoredFile; exports.StorageService = StorageService; exports.CameraPosition = CameraPosition; exports.RealtimeVideoTrack = RealtimeVideoTrack; exports.RealtimeMediaStream = RealtimeMediaStream; exports.RealtimeConnectionState = RealtimeConnectionState; exports.RealtimeReason = RealtimeReason; exports.RealtimeState = RealtimeState; exports.XmaxConfiguration = XmaxConfiguration; exports.XmaxClient = XmaxClient; exports.RealtimeConfiguration = RealtimeConfiguration; exports.VideoContentMode = VideoContentMode; exports.RealtimeContext = RealtimeContext; exports.XmaxVideoView = XmaxVideoView; exports.XmaxRealtimeVideoView = XmaxRealtimeVideoView;
-//# sourceMappingURL=chunk-FH3OPC6F.cjs.map
+//# sourceMappingURL=chunk-JWAAS6P4.cjs.map