@nnepoch/dtc-sdk 3.0.3 → 3.0.5

package/dist/cjs/index.d.cts

@@ -47,427 +47,6 @@ interface SignallingAllocateResponse {
   status?: string;
 }
 //#endregion
-//#region src/types/common.d.ts
-type ApiCallback<T> = (result: T) => void;
-type EngineLogLevel = 'silent' | 'error' | 'warn' | 'info' | 'debug';
-type EngineViewMode = 'bs' | 'cs';
-/**
- * 引擎状态详情结构，与 sdk2 的 EngineStatusInfo 字段语义保持一致。
- */
-interface EngineStatusInfo {
-  CameraHeight: string;
-  FPS: string;
-  Width: string;
-  Height: string;
-  runTime: string;
-  bytePerSecond: string;
-  lostPacketsRate: string;
-  delayTime: string;
-  Codec: string;
-}
-interface EngineConfig {
-  /** 鉴权服务器地址 */
-  centerIP?: string;
-  /** 信令服务 HTTP 基地址，SDK 会基于该地址调用 `/api/v1/allocate` 获取最终 ws 播放地址 */
-  signalingServer?: string;
-  sceneName?: string;
-  token?: string;
-  dom?: HTMLDivElement;
-  showProgressBar?: boolean;
-  codec?: string;
-  viewMode?: EngineViewMode;
-  /** TURN 服务器地址 */
-  turnServer?: string;
-  /** TURN 用户名 */
-  turnUser?: string;
-  /** TURN 密码 */
-  turnPwd?: string;
-  /** 私有密钥 */
-  privateKey?: string;
-  engineUuid?: string;
-  mapType?: string;
-  operationType?: string;
-  freeCheckInterval?: number;
-  /** PixelStreaming initialSettings */
-  initialSettings?: Record<string, unknown>;
-  /** 日志级别，默认值为 info */
-  logger?: EngineLogLevel;
-  /** 从指定级别开始附加业务调用栈，默认值为 warn；silent 表示关闭 */
-  includeStack?: EngineLogLevel;
-  /** Pixel Streaming 依赖日志级别，默认值为 warn */
-  pixelStreamingLogger?: EngineLogLevel;
-}
-interface ApiRequestEnvelope<T = unknown> {
-  AssemblyName: string;
-  fn: string;
-  ClassName: string;
-  FunctionName: string;
-  Value?: any;
-  ts: number;
-}
-interface ApiResponseEnvelope<T = unknown> {
-  requestId: string;
-  success: boolean;
-  code: string;
-  message: string;
-  params?: any;
-  errorMsg?: string;
-  data?: T;
-  ts: number;
-}
-interface ResolvedEngineConfig {
-  centerIP: string;
-  signalingServer?: string;
-  sceneName: string;
-  token: string;
-  dom: HTMLDivElement;
-  showProgressBar: boolean;
-  codec: string;
-  viewMode: EngineViewMode;
-  turnServer?: string;
-  turnUser?: string;
-  turnPwd?: string;
-  privateKey: string;
-  engineUuid?: string;
-  mapType: string;
-  operationType: string;
-  freeCheckInterval: number;
-  initialSettings: Record<string, unknown>;
-  logger: EngineLogLevel;
-  includeStack: EngineLogLevel;
-  pixelStreamingLogger: EngineLogLevel;
-  centerHeartbeatIntervalMs: number;
-  centerHeartbeatTimeoutMs: number;
-}
-//#endregion
-//#region src/types/enums.d.ts
-/**
- * Dlss.setDlssQuality 参数。
- */
-declare const DlssQuality: {
-  /** 关闭 DLSS。默认值。 */
-  readonly Off: 0;
-  /** Auto 模式会根据系统性能自动选择最合适的 DLSS 质量档位，提供更智能的画质与性能平衡方案。 */
-  readonly Auto: 1;
-  /** 2倍效果 */
-  readonly DLAA: 2;
-  /** 超高质量。 */
-  readonly UltraQuality: 3;
-  /** 高质量。 */
-  readonly Quality: 4;
-  /** 平衡。 */
-  readonly Balanced: 5;
-  /** 性能。 */
-  readonly Performance: 6;
-  /** 超高性能。 */
-  readonly UltraPerformance: 7;
-};
-type DlssQuality = typeof DlssQuality[keyof typeof DlssQuality];
-/**
- * Screen.setSceneRenderBitrate 参数。
- */
-declare const ScreenRenderBitratePreset: {
-  /** 自动。 */
-  readonly Auto: "auto";
-  /** 标清。 */
-  readonly Low: "low";
-  /** 高清。 */
-  readonly High: "high";
-  /** 超清。 */
-  readonly Super: "super";
-  /** 蓝光。 */
-  readonly Blue: "blue";
-};
-type ScreenRenderBitratePreset = typeof ScreenRenderBitratePreset[keyof typeof ScreenRenderBitratePreset];
-declare const ScreenRenderBitratePresetOptions: readonly [{
-  readonly label: "自动";
-  readonly type: "auto";
-  readonly value: 12000000;
-}, {
-  readonly label: "标清";
-  readonly type: "low";
-  readonly value: 4000000;
-}, {
-  readonly label: "高清";
-  readonly type: "high";
-  readonly value: 8000000;
-}, {
-  readonly label: "超清";
-  readonly type: "super";
-  readonly value: 12000000;
-}, {
-  readonly label: "蓝光";
-  readonly type: "blue";
-  readonly value: 24000000;
-}];
-declare const ScreenRenderBitratePresetValueMap: {
-  readonly auto: 12000000;
-  readonly low: 4000000;
-  readonly high: 8000000;
-  readonly super: 12000000;
-  readonly blue: 24000000;
-};
-/**
- * 视频解码器类别
- */
-declare enum VideoCodeType {
-  /** VP8 */
-  VP8 = "VP8",
-  /** VP9  */
-  VP9 = "VP9",
-  /** AV1 */
-  AV1 = "AV1",
-  /** H264 */
-  H264 = "H264"
-}
-/**
- * Layer.addLayer 图层类别。
- */
-declare enum LayerEnum {
-  /** 模型图层。 */
-  Model = "MODEL",
-  /** POI 图层。 */
-  POI = "POI"
-}
-/**
- * WeatherSystem.changeSeason 参数。
- */
-declare const Season: {
-  /** 春季。 */
-  readonly Spring: 0;
-  /** 夏季。 */
-  readonly Summer: 1;
-  /** 秋季。 */
-  readonly Autumn: 2;
-  /** 冬季。 */
-  readonly Winter: 3;
-};
-type Season = typeof Season[keyof typeof Season];
-/**
- * ModelTransform 移动方式。
- */
-declare enum ModelTransformType {
-  Linear = 0,
-  EaseInQuad = 1,
-  EaseOutQuad = 2,
-  EaseInOutQuad = 3,
-  EaseOutInQuad = 4,
-  EaseInCubic = 5,
-  EaseOutCubic = 6,
-  EaseInOutCubic = 7,
-  EaseOutInCubic = 8,
-  EaseInQuart = 9,
-  EaseOutQuart = 10,
-  EaseInOutQuart = 11,
-  EaseOutInQuart = 12,
-  EaseInQuint = 13,
-  EaseOutQuint = 14,
-  EaseInOutQuint = 15,
-  EaseOutInQuint = 16,
-  EaseInSine = 17,
-  EaseOutSine = 18,
-  EaseInOutSine = 19,
-  EaseOutInSine = 20,
-  EaseInExpo = 21,
-  EaseOutExpo = 22,
-  EaseInOutExpo = 23,
-  EaseOutInExpo = 24,
-  EaseInCirc = 25,
-  EaseOutCirc = 26,
-  EaseInOutCirc = 27,
-  EaseOutInCirc = 28,
-  EaseInElastic = 29,
-  EaseOutElastic = 30,
-  EaseInOutElastic = 31,
-  EaseOutInElastic = 32,
-  EaseInBack = 33,
-  EaseOutBack = 34,
-  EaseInOutBack = 35,
-  EaseOutInBack = 36,
-  EaseInBounce = 37,
-  EaseOutBounce = 38,
-  EaseInOutBounce = 39,
-  EaseOutInBounce = 40
-}
-/**
- * Model.setVisibleByAttibute 过滤模式。
- */
-declare enum FilterMode {
-  /** 宽松过滤：只处理属性匹配的对象，不符合条件不理会。 */
-  Loose = 0,
-  /** 严格过滤：属性匹配的对象按 visible 控制，其它包含相同属性名但属性值不同的对象按 otherVisible 控制。 */
-  Strict = 1
-}
-//#endregion
-//#region src/types/network.d.ts
-/**
- * 弱网自适应档位。
- */
-type NetworkAdaptationLevel = 'Normal' | 'Mild' | 'Moderate' | 'Severe' | 'Recovering';
-/**
- * 弱网自适应运行模式：
- * - auto: 自动策略决策
- * - manual: 手动接管档位
- */
-type NetworkAdaptationMode = 'auto' | 'manual';
-/**
- * 媒体链路实时指标快照。
- */
-interface NetworkMetricsSnapshot {
-  ts: number;
-  connected: boolean;
-  fps?: number;
-  bitrateKbps?: number;
-  packetLossRate?: number;
-  jitterMs?: number;
-  rttMs?: number;
-  frameWidth?: number;
-  frameHeight?: number;
-}
-/**
- * 弱网状态变更事件载荷。
- */
-interface NetworkAdaptationState {
-  from: NetworkAdaptationLevel;
-  to: NetworkAdaptationLevel;
-  mode: NetworkAdaptationMode;
-  reason: string;
-  ts: number;
-  metrics?: NetworkMetricsSnapshot;
-}
-/**
- * 策略动作类型。
- */
-type NetworkAdaptationActionType = 'SetSceneRenderBitrate' | 'SetSceneFPS' | 'SetScreenResolution';
-/**
- * 单步策略动作执行结果。
- */
-interface NetworkAdaptationActionStep {
-  type: NetworkAdaptationActionType;
-  payload: Record<string, number>;
-  success: boolean;
-  error?: string;
-}
-/**
- * 策略动作执行事件。
- */
-interface NetworkAdaptationActionResult {
-  level: Exclude<NetworkAdaptationLevel, 'Recovering'>;
-  mode: NetworkAdaptationMode;
-  success: boolean;
-  skipped: boolean;
-  reason: string;
-  ts: number;
-  steps: NetworkAdaptationActionStep[];
-}
-/**
- * 策略决策轨迹条目，用于诊断面板回放。
- */
-interface NetworkDecisionTrace {
-  ts: number;
-  mode: NetworkAdaptationMode;
-  currentLevel: NetworkAdaptationLevel;
-  measuredLevel: Exclude<NetworkAdaptationLevel, 'Recovering'>;
-  targetLevel?: NetworkAdaptationLevel;
-  outcome: 'hold' | 'downgrade' | 'recover' | 'manual' | 'skip_hysteresis' | 'skip_cooldown';
-  reason: string;
-  metrics?: NetworkMetricsSnapshot;
-}
-/**
- * 诊断面板快照数据。
- */
-interface NetworkDiagnosticsSnapshot {
-  ts: number;
-  visible: boolean;
-  mode: NetworkAdaptationMode;
-  currentLevel: NetworkAdaptationLevel;
-  connected: boolean;
-  lastMetrics?: NetworkMetricsSnapshot;
-  lastAction?: NetworkAdaptationActionResult;
-  traces: NetworkDecisionTrace[];
-}
-//#endregion
-//#region src/types/qos.d.ts
-/**
- * QoS 事件阶段定义。
- */
-type QosStage = 'auth' | 'center' | 'webrtc' | 'media' | 'ue_api' | 'session';
-/**
- * QoS 事件状态定义。
- */
-type QosStatus = 'start' | 'success' | 'failed' | 'update' | 'end';
-/**
- * QoS 事件日志等级（仅用于事件严重程度标记）。
- */
-type QosLevel = 'info' | 'warn' | 'error';
-/**
- * QoS V1 事件名集合。
- */
-declare const QOS_EVENT_NAMES: readonly ["session_start", "auth_start", "auth_success", "auth_failed", "center_connect_start", "center_connected", "center_disconnected", "center_message_received", "webrtc_connect_start", "webrtc_connected", "webrtc_disconnected", "first_frame_rendered", "media_stats_sample", "ue_request_sent", "ue_response_received", "session_end"];
-/**
- * QoS V1 事件名类型。
- *
- * 注意：V1 明确不包含 `ue_request_timeout`。
- */
-type QosEventName = (typeof QOS_EVENT_NAMES)[number];
-/**
- * 会话维度上下文。
- */
-interface QosSessionContext {
-  sessionId: string;
-  traceId: string;
-  runMode: string;
-  viewMode: string;
-}
-/**
- * 运行环境上下文。
- */
-interface QosRuntimeContext {
-  appId?: string;
-  env?: string;
-  pageUrl?: string;
-  userAgent?: string;
-}
-/**
- * warn/error 聚合统计指标。
- */
-interface QosWarnErrorSummary {
-  logWarnCount: number;
-  logErrorCount: number;
-  logErrorByStage: Partial<Record<QosStage, number>>;
-  logErrorTopCodes: Array<{
-    code: string;
-    count: number;
-  }>;
-}
-/**
- * QoS 事件结构。
- */
-interface QosEvent {
-  eventName: QosEventName;
-  stage: QosStage;
-  status: QosStatus;
-  ts: number;
-  level: QosLevel;
-  durationMs?: number;
-  errorCode?: string;
-  errorMessage?: string;
-  attrs?: Record<string, unknown>;
-  metrics?: Record<string, unknown>;
-}
-/**
- * QoS 批量上报载荷。
- */
-interface QosReportingPayload {
-  schemaVersion: '1.0.0';
-  source: 'enginesdk3';
-  sdkVersion: string;
-  sentAt: number;
-  session: QosSessionContext;
-  context: QosRuntimeContext;
-  events: QosEvent[];
-}
-//#endregion
 //#region src/math/Vector2.d.ts
 /**
  * 二维向量坐标及计算方法
@@ -1250,6 +829,165 @@ declare class Vector3 {
   changeEPSGType(EPSGType: string): this | undefined;
 }
 //#endregion
+//#region src/types/enums.d.ts
+/**
+ * Dlss.setDlssQuality 参数。
+ */
+declare const DlssQuality: {
+  /** 关闭 DLSS。默认值。 */
+  readonly Off: 0;
+  /** Auto 模式会根据系统性能自动选择最合适的 DLSS 质量档位，提供更智能的画质与性能平衡方案。 */
+  readonly Auto: 1;
+  /** 2倍效果 */
+  readonly DLAA: 2;
+  /** 超高质量。 */
+  readonly UltraQuality: 3;
+  /** 高质量。 */
+  readonly Quality: 4;
+  /** 平衡。 */
+  readonly Balanced: 5;
+  /** 性能。 */
+  readonly Performance: 6;
+  /** 超高性能。 */
+  readonly UltraPerformance: 7;
+};
+type DlssQuality = typeof DlssQuality[keyof typeof DlssQuality];
+/**
+ * Screen.setSceneRenderBitrate 参数。
+ */
+declare const ScreenRenderBitratePreset: {
+  /** 自动。 */
+  readonly Auto: "auto";
+  /** 标清。 */
+  readonly Low: "low";
+  /** 高清。 */
+  readonly High: "high";
+  /** 超清。 */
+  readonly Super: "super";
+  /** 蓝光。 */
+  readonly Blue: "blue";
+};
+type ScreenRenderBitratePreset = typeof ScreenRenderBitratePreset[keyof typeof ScreenRenderBitratePreset];
+declare const ScreenRenderBitratePresetOptions: readonly [{
+  readonly label: "自动";
+  readonly type: "auto";
+  readonly value: 12000000;
+}, {
+  readonly label: "标清";
+  readonly type: "low";
+  readonly value: 4000000;
+}, {
+  readonly label: "高清";
+  readonly type: "high";
+  readonly value: 8000000;
+}, {
+  readonly label: "超清";
+  readonly type: "super";
+  readonly value: 12000000;
+}, {
+  readonly label: "蓝光";
+  readonly type: "blue";
+  readonly value: 24000000;
+}];
+declare const ScreenRenderBitratePresetValueMap: {
+  readonly auto: 12000000;
+  readonly low: 4000000;
+  readonly high: 8000000;
+  readonly super: 12000000;
+  readonly blue: 24000000;
+};
+/**
+ * 视频解码器类别
+ */
+declare enum VideoCodeType {
+  /** VP8 */
+  VP8 = "VP8",
+  /** VP9  */
+  VP9 = "VP9",
+  /** AV1 */
+  AV1 = "AV1",
+  /** H264 */
+  H264 = "H264"
+}
+/**
+ * Layer.addLayer 图层类别。
+ */
+declare enum LayerEnum {
+  /** 模型图层。 */
+  Model = "MODEL",
+  /** POI 图层。 */
+  POI = "POI"
+}
+/**
+ * WeatherSystem.changeSeason 参数。
+ */
+declare const Season: {
+  /** 春季。 */
+  readonly Spring: 0;
+  /** 夏季。 */
+  readonly Summer: 1;
+  /** 秋季。 */
+  readonly Autumn: 2;
+  /** 冬季。 */
+  readonly Winter: 3;
+};
+type Season = typeof Season[keyof typeof Season];
+/**
+ * ModelTransform 移动方式。
+ */
+declare enum ModelTransformType {
+  Linear = 0,
+  EaseInQuad = 1,
+  EaseOutQuad = 2,
+  EaseInOutQuad = 3,
+  EaseOutInQuad = 4,
+  EaseInCubic = 5,
+  EaseOutCubic = 6,
+  EaseInOutCubic = 7,
+  EaseOutInCubic = 8,
+  EaseInQuart = 9,
+  EaseOutQuart = 10,
+  EaseInOutQuart = 11,
+  EaseOutInQuart = 12,
+  EaseInQuint = 13,
+  EaseOutQuint = 14,
+  EaseInOutQuint = 15,
+  EaseOutInQuint = 16,
+  EaseInSine = 17,
+  EaseOutSine = 18,
+  EaseInOutSine = 19,
+  EaseOutInSine = 20,
+  EaseInExpo = 21,
+  EaseOutExpo = 22,
+  EaseInOutExpo = 23,
+  EaseOutInExpo = 24,
+  EaseInCirc = 25,
+  EaseOutCirc = 26,
+  EaseInOutCirc = 27,
+  EaseOutInCirc = 28,
+  EaseInElastic = 29,
+  EaseOutElastic = 30,
+  EaseInOutElastic = 31,
+  EaseOutInElastic = 32,
+  EaseInBack = 33,
+  EaseOutBack = 34,
+  EaseInOutBack = 35,
+  EaseOutInBack = 36,
+  EaseInBounce = 37,
+  EaseOutBounce = 38,
+  EaseInOutBounce = 39,
+  EaseOutInBounce = 40
+}
+/**
+ * Model.setVisibleByAttibute 过滤模式。
+ */
+declare enum FilterMode {
+  /** 宽松过滤：只处理属性匹配的对象，不符合条件不理会。 */
+  Loose = 0,
+  /** 严格过滤：属性匹配的对象按 visible 控制，其它包含相同属性名但属性值不同的对象按 otherVisible 控制。 */
+  Strict = 1
+}
+//#endregion
 //#region src/types/request.d.ts
 interface Vector3JsonInput {
   x: number;
@@ -1257,1162 +995,1559 @@ interface Vector3JsonInput {
   z: number;
   ePSGType: string;
 }
-type Vector3Input = Vector3 | Vector3JsonInput;
-interface Vector2JsonInput {
-  x: number;
-  y: number;
+type Vector3Input = Vector3 | Vector3JsonInput;
+interface Vector2JsonInput {
+  x: number;
+  y: number;
+}
+type Vector2Input = Vector2 | Vector2JsonInput;
+/**
+ * Camera.lookAt 参数。
+ */
+interface CameraLookAtRequest {
+  /** 模型所属父节点 ID，可选。 */
+  parentId?: string;
+  /** 模型 ID，支持单个或多个。 */
+  id: string | string[];
+  /** 视角方向偏移向量。 */
+  offSet?: Vector3Input;
+  /** 水平偏移量。 */
+  offSetX?: number;
+  /** 到目标的距离比例。 */
+  distance?: number;
+  /** 飞行时长（秒）。 */
+  time?: number;
+  /** 是否在飞行中旋转视角。 */
+  isRotate?: boolean;
+  /** 是否高亮目标。 */
+  isHighlight?: boolean;
+}
+/**
+ * Camera.flyToTarget 参数。
+ */
+interface CameraFlyToTargetRequest {
+  /** 飞行终点坐标。 */
+  point?: Vector3Input;
+  /** 飞行过程中看向目标点。 */
+  target?: Vector3Input;
+  /** Horizontal field of view in degrees (10–150), default 60. */
+  fov?: number;
+  /** 飞行时长（秒）。 */
+  time?: number;
+}
+/**
+ * Camera.flyByPath 参数。
+ */
+interface CameraFlyByPathRequest {
+  /** 相机路径点集合。 */
+  points?: Vector3[] | string;
+  /** 视线目标点集合。 */
+  lookAts?: Vector3[] | string;
+  /** 飞行时长（秒）。 */
+  time?: number;
+  /** 路径平滑模式。 */
+  smoothMode?: 0 | 1;
+}
+/**
+ * Camera.setFlySpeed 参数。
+ */
+interface CameraSetFlySpeedRequest {
+  /** 飞行速度。 */
+  speed: number;
+}
+/**
+ * Camera.setCameraPositionAndRotation 参数。
+ */
+interface CameraSetPositionAndRotationRequest {
+  /** 相机位置。 */
+  point: Vector3;
+  /** 相机旋转。 */
+  rotation: Vector3;
+}
+/**
+ * Camera.setCameraFov 参数。
+ */
+interface CameraSetFovRequest {
+  /** 相机视场角。 */
+  fov: number;
+}
+/**
+ * Camera.startCameraObjFollow 参数。
+ */
+interface CameraObjFollowRequest {
+  /** 模型所属父节点 ID，可选。 */
+  parentId?: string;
+  /** 相机跟随的对象编号。 */
+  id: string;
+  /** 相机位置偏移量（x, y, z）。 */
+  offSet?: Vector3;
+  /** 轨迹的平滑度，取值范围 0~1，默认 0.85；取值越大，相机跟随得越慢，跟随轨迹越平滑。 */
+  smooth?: number;
+}
+/**
+ * Scene.setFeatureToggle 参数。
+ */
+interface FeatureToggleRequest {
+  /** 特性开关键名。 */
+  key: string;
+  /** 是否开启。 */
+  enabled: boolean;
+}
+/**
+ * Scene.switchSceneByName 参数。
+ */
+interface SceneSwitchRequest {
+  /** 场景名称。 */
+  sceneName: string;
+}
+/**
+ * Scene.listenMapCompass 参数。
+ */
+interface SceneListenCompassRequest {
+  /** 是否开启指北针监听。 */
+  enable: boolean;
 }
-type Vector2Input = Vector2 | Vector2JsonInput;
 /**
- * Camera.lookAt 参数。
+ * 模型对象选择器。
  */
-interface CameraLookAtRequest {
-  /** 模型所属父节点 ID，可选。 */
+interface ModelSelectorRequest {
+  /** 父节点 ID。 */
+  parentId?: string;
+  /** 对象 ID。 */
+  id: string;
+}
+/**
+ * Model.setVisible 参数。
+ */
+interface ModelSetVisibleRequest {
+  /** 父节点 ID。 */
   parentId?: string;
   /** 模型 ID，支持单个或多个。 */
   id: string | string[];
-  /** 视角方向偏移向量。 */
+  /** 是否可见。 */
+  visible?: boolean;
+}
+/**
+ * Model.setVisible 参数。
+ */
+interface ModelSetVisibleByTagsRequest {
+  /** 标签，支持单个或多个。 */
+  tags: string | string[];
+  /** 是否可见。 */
+  visible?: boolean;
+}
+/**
+ * Model.setVisibleByAttibute 参数。
+ */
+interface ModelSetVisibleByAttributeRequest {
+  /** 属性对象，key 为属性名称，value 为属性值。 */
+  attributes: Record<string, unknown>;
+  /** 过滤模式，默认 FilterMode.Loose。 */
+  filterMode?: FilterMode;
+  /** 符合条件对象的显示/隐藏：true 显示，false 隐藏，默认 true。 */
+  visible?: boolean;
+  /** 仅在 filterMode=FilterMode.Strict 时生效：控制其它包含相同属性名但属性值不同的对象的显示/隐藏，默认 false。 */
+  otherVisible?: boolean;
+}
+/**
+ * WebView.updateWebView 参数。
+ */
+interface WebViewUpdateRequest {
+  /** 要创建的视频播放器的父对象（需要是 UI，为空时自动创建新的对象）。 */
+  parentId?: string;
+  /** 创建的视频播放器的名称。 */
+  id: string;
+  /** 网页的网址。 */
+  url: string;
+}
+/**
+ * Model.add 参数。
+ */
+interface ModelAddRequest {
+  /** 父节点 ID。 */
+  parentId: string;
+  /** 新模型对象 ID。 */
+  id: string;
+  /** 资源路径。 */
+  assetsPath?: string;
+  /** 位置。 */
+  position?: Vector3;
+  /** 旋转角。 */
+  angle?: Vector3;
+  /** 缩放。 */
+  scale?: Vector3;
+  /** 备注描述。 */
+  description?: string;
+}
+/**
+ * Model.remove 参数。
+ */
+interface ModelRemoveRequest {
+  /** 父节点 ID。 */
+  parentId: string;
+  /** 要删除的对象 ID 列表。 */
+  ids: string[];
+}
+/**
+ * Model.getModelBoundsInfo 参数。
+ */
+interface ModelBoundsRequest {
+  /** 父节点 ID。 */
+  parentId: string;
+  /** 目标模型 ID，支持单个或多个。 */
+  id: string | string[];
+}
+/**
+ * Layer.addLayer 参数。
+ */
+interface LayerAddRequest {
+  /** 父图层或分组 ID。仅传 parentId 时兼容作为 id 使用。 */
+  parentId?: string;
+  /** 图层对象 ID。 */
+  id: string;
+  /** 图层显示名称。 */
+  layerName?: string;
+  /** 图层默认是否显示。 */
+  show?: boolean;
+  /** 图层 POI 是否显示。 */
+  poiEnabled?: boolean;
+  /** 图层描述。 */
+  description?: string;
+  /** 图层是否为系统图层。true--断开连接不删除，false--断开连接删除。 */
+  isSystem?: boolean;
+  /**POI偏移量 */
+  poiOffsetY?: number;
+}
+/**
+ * Layer.removeLayer / Layer.isLayerOrGroupExit 参数。
+ */
+interface LayerSelectorRequest {
+  /** 父图层或分组 ID。仅传 parentId 时兼容作为 id 使用。 */
+  parentId?: string;
+  /** 图层或分组 ID。 */
+  id: string;
+}
+/**
+ * Layer.switchModelLayer 参数。
+ */
+interface LayerSwitchModelRequest {
+  /** 模型当前所属图层组 ID。 */
+  parentId: string;
+  /** 需要切换的模型 ID 列表。 */
+  ids: string[];
+  /** 目标图层组 ID。 */
+  toParentId: string;
+}
+interface LayerShowUIPopRequest {
+  /** 模型所属图层组 ID。 */
+  parentId?: string;
+  /** 新模型对象 ID。 */
+  id: string;
+  /** 资源路径。 */
+  assetsPath?: string;
+  /** poi的偏移量 */
   offSet?: Vector3Input;
-  /** 水平偏移量。 */
-  offSetX?: number;
-  /** 到目标的距离比例。 */
-  distance?: number;
-  /** 飞行时长（秒）。 */
-  time?: number;
-  /** 是否在飞行中旋转视角。 */
-  isRotate?: boolean;
-  /** 是否高亮目标。 */
-  isHighlight?: boolean;
+  /** 是否可见 */
+  visible?: boolean;
+  /** 缩放。 */
+  scale?: Vector3Input;
 }
 /**
- * Camera.flyToTarget 参数。
+ * Layer.addModel 参数。
  */
-interface CameraFlyToTargetRequest {
-  /** 飞行终点坐标。 */
-  point?: Vector3Input;
-  /** 飞行过程中看向目标点。 */
-  target?: Vector3Input;
-  /** 飞行时长（秒）。 */
-  time?: number;
+interface LayerPOIAddRequest {
+  /** 模型所属图层组 ID。 */
+  parentId?: string;
+  /** 新模型对象 ID。 */
+  id: string;
+  /** 资源路径。 */
+  assetsPath: string;
+  /** 位置。 */
+  position?: Vector3Input;
+  /**场景中参照绑定的位置的对象上级编号，防止重名，可不填写，但要保证  targetId是唯一的 */
+  targetParentId?: string;
+  /** 场景中参照绑定的位置的对象编号，与position功能一样，只需要存在一个 */
+  targetId?: string;
+  /** 旋转角。 */
+  rotation?: Vector3Input;
+  /** 缩放。 */
+  scale?: Vector3Input;
+  /**poi的偏移量 */
+  offSet?: Vector3Input;
+  /** 备注描述。 */
+  description?: string;
+  /** 模型是否为系统模型。true--断开连接不删除，false--断开连接删除。如果图层为非系统的，也会删除 */
+  isSystem?: boolean;
+  /** poi的文本 */
+  text?: string;
+  /** poi的字体大小,默认为 16 */
+  fontSize?: number;
+  /** 模型的标签 */
+  tags?: string[];
+  /** 扩展属性，json对象，可不填写 */
+  extraProps?: any;
+}
+/**
+ * Layer.addModel 参数。
+ */
+interface LayerModelAddRequest {
+  /** 模型所属图层组 ID。 */
+  parentId: string;
+  /** 新模型对象 ID。 */
+  id: string;
+  /** 资源路径。 */
+  assetsPath?: string;
+  /** 位置。 */
+  position?: Vector3Input;
+  /** 旋转角。 */
+  rotation?: Vector3Input;
+  /** 缩放。 */
+  scale?: Vector3Input;
+  /** 备注描述。 */
+  description?: string;
+  /** 模型是否为系统模型。true--断开连接不删除，false--断开连接删除。如果图层为非系统的，也会删除 */
+  isSystem?: boolean;
+  tags?: string[];
+  name?: string;
+  extraProps?: any;
+}
+/**
+ * Layer.removeModel 参数。
+ */
+interface LayerModelRemoveRequest {
+  /** 模型所属图层组 ID。 */
+  parentId: string;
+  /** 要删除的模型 ID 列表。 */
+  ids: string[];
+}
+/**
+ * Layer.getLayerChildElement 参数。
+ */
+interface LayerChildElementRequest {
+  /** 父图层或分组 ID。 */
+  parentId?: string;
+  /** 当前图层 ID。 */
+  id: string;
+}
+/**
+ * WeatherSystem.changeWeatherType 参数。
+ */
+interface WeatherTypeRequest {
+  /** 天气类型名称。 */
+  type: number;
+  /** 天气类型持续时间（秒）。 */
+  timeDuration: number;
+  test?: string;
 }
 /**
- * Camera.flyByPath 参数。
+ * WeatherSystem.changeWeatherType 参数。
  */
-interface CameraFlyByPathRequest {
-  /** 相机路径点集合。 */
-  points?: Vector3[] | string;
-  /** 视线目标点集合。 */
-  lookAts?: Vector3[] | string;
-  /** 飞行时长（秒）。 */
-  time?: number;
-  /** 路径平滑模式。 */
-  smoothMode?: 0 | 1;
-}
+type GetWeatherTypeRequest = Record<string, never>;
 /**
- * Camera.setFlySpeed 参数。
+ * WeatherSystem.setSceneTime 参数。
  */
-interface CameraSetFlySpeedRequest {
-  /** 飞行速度。 */
-  speed: number;
+interface WeatherSetSceneTimeRequest {
+  /** 小时值。 0~24小时 */
+  hour: number;
+  /** 时间变化持续的时间（秒）。*/
+  timeDuration?: number;
 }
 /**
- * Camera.setCameraPositionAndRotation 参数。
+ * WeatherSystem.setTimeSync 参数。
  */
-interface CameraSetPositionAndRotationRequest {
-  /** 相机位置。 */
-  point: Vector3;
-  /** 相机旋转。 */
-  rotation: Vector3;
+interface WeatherSetTimeSyncRequest {
+  /** 是否同步系统时间。 */
+  syncSystemTime?: boolean;
 }
 /**
- * Camera.setCameraFov 参数。
+ * WeatherSystem.setAnimateTimeOfDay 参数。
  */
-interface CameraSetFovRequest {
-  /** 相机视场角。 */
-  fov: number;
+interface WeatherSetAnimateTimeOfDayRequest {
+  /** 是否模拟白天，黑夜时间动画。 */
+  isAnimate?: boolean;
+  /** 白天持续时间（分）。 默认0.5分钟*/
+  dayLength?: number;
+  /** 夜晚持续时间（分）。 默认0.5分钟 */
+  nightLength?: number;
 }
 /**
- * Camera.startCameraObjFollow 参数。
+ * WeatherSystem.changeSeason 参数。
  */
-interface CameraObjFollowRequest {
-  /** 模型所属父节点 ID，可选。 */
-  parentId?: string;
-  /** 相机跟随的对象编号。 */
-  id: string;
-  /** 相机位置偏移量（x, y, z）。 */
-  offSet?: Vector3;
-  /** 轨迹的平滑度，取值范围 0~1，默认 0.85；取值越大，相机跟随得越慢，跟随轨迹越平滑。 */
-  smooth?: number;
+interface WeatherChangeSeasonRequest {
+  /** 季节标识。 */
+  season: Season;
+  /** 季节切换持续时间。 */
+  duration?: number;
 }
 /**
- * Scene.setFeatureToggle 参数。
+ * WeatherSystem.setDayAndNight 参数。
  */
-interface FeatureToggleRequest {
-  /** 特性开关键名。 */
-  key: string;
-  /** 是否开启。 */
-  enabled: boolean;
+interface WeatherSetDayAndNightRequest {
+  /** 日夜类型，如 day/night。 */
+  dayType: string;
 }
 /**
- * Scene.switchSceneByName 参数。
+ * WeatherSystem.openCameraFog 参数。
  */
-interface SceneSwitchRequest {
-  /** 场景名称。 */
-  sceneName: string;
+interface WeatherOpenCameraFogRequest {
+  /** 雾强度。 */
+  fogIntensity?: number;
+  /** 雾近端颜色。 */
+  fogStartColor?: string;
+  /** 雾远端颜色。 */
+  fogEndColor?: string;
+  /** 雾起始距离。 */
+  fogStartDistance?: number;
+  /** 雾终止距离。 */
+  fogEndDistance?: number;
+  /** 方向光强度。 */
+  directionalIntensity?: number;
+  /** 方向光衰减。 */
+  directionalFallOff?: number;
+  /** 方向光颜色。 */
+  directionalColor?: string;
 }
 /**
- * Scene.listenMapCompass 参数。
+ * UIPOI.add 参数。
  */
-interface SceneListenCompassRequest {
-  /** 是否开启指北针监听。 */
-  enable: boolean;
+interface UIPOIAddRequest {
+  /** 气泡分组名称。 */
+  groupName: string;
+  /** 气泡信息列表。 */
+  poiInfos: Array<Record<string, unknown>>;
 }
 /**
- * 模型对象选择器。
+ * UIPOI.deleteById 参数。
  */
-interface ModelSelectorRequest {
-  /** 父节点 ID。 */
-  parentId?: string;
-  /** 对象 ID。 */
+interface UIPOIDeleteByIdRequest {
+  /** 气泡分组名称。 */
+  groupName: string;
+  /** 气泡 ID。 */
   id: string;
 }
 /**
- * Model.setVisible 参数。
+ * UIPOI.deleteByGroup 参数。
  */
-interface ModelSetVisibleRequest {
-  /** 父节点 ID。 */
-  parentId?: string;
-  /** 模型 ID，支持单个或多个。 */
-  id: string | string[];
-  /** 是否可见。 */
-  visible?: boolean;
+interface UIPOIDeleteByGroupRequest {
+  /** 气泡分组名称。 */
+  groupName: string;
 }
 /**
- * Model.setVisible 参数。
+ * UIPOI.update 参数。
  */
-interface ModelSetVisibleByTagsRequest {
-  /** 标签，支持单个或多个。 */
-  tags: string | string[];
-  /** 是否可见。 */
-  visible?: boolean;
+interface UIPOIUpdateRequest {
+  /** 气泡分组名称。 */
+  groupName: string;
+  /** 更新后的气泡信息列表。 */
+  poiInfos: Array<Record<string, unknown>>;
 }
 /**
- * Model.setVisibleByAttibute 参数。
+ * UIPOI.updatePopStates 参数。
  */
-interface ModelSetVisibleByAttributeRequest {
-  /** 属性对象，key 为属性名称，value 为属性值。 */
-  attributes: Record<string, unknown>;
-  /** 过滤模式，默认 FilterMode.Loose。 */
-  filterMode?: FilterMode;
-  /** 符合条件对象的显示/隐藏：true 显示，false 隐藏，默认 true。 */
-  visible?: boolean;
-  /** 仅在 filterMode=FilterMode.Strict 时生效：控制其它包含相同属性名但属性值不同的对象的显示/隐藏，默认 false。 */
-  otherVisible?: boolean;
+interface UIPOIUpdateStateRequest {
+  /** 气泡分组名称。 */
+  groupName: string;
+  /** 气泡状态列表。 */
+  popStates: Array<Record<string, unknown>>;
 }
 /**
- * WebView.updateWebView 参数。
+ * UIPOI.enableOverlap 参数。
  */
-interface WebViewUpdateRequest {
-  /** 要创建的视频播放器的父对象（需要是 UI，为空时自动创建新的对象）。 */
-  parentId?: string;
-  /** 创建的视频播放器的名称。 */
-  id: string;
-  /** 网页的网址。 */
-  url: string;
+interface UIPOIEnableOverlapRequest {
+  /** 是否开启碰撞避让。 */
+  enable?: boolean;
 }
 /**
- * Model.add 参数。
+ * UIPOI.showDistance 参数。
  */
-interface ModelAddRequest {
-  /** 父节点 ID。 */
-  parentId: string;
-  /** 新模型对象 ID。 */
+interface UIPOIShowDistanceRequest {
+  /** 最远显示距离。 */
+  distance: number;
+}
+/**
+ * ModelPOI.add 参数。
+ */
+interface ModelPOIAddRequest {
+  /** 模型气泡 ID。 */
   id: string;
+  /** 分组名称。 */
+  groupName: string;
   /** 资源路径。 */
-  assetsPath?: string;
-  /** 位置。 */
-  position?: Vector3;
-  /** 旋转角。 */
-  angle?: Vector3;
-  /** 缩放。 */
-  scale?: Vector3;
-  /** 备注描述。 */
-  description?: string;
+  assetPath: string;
+  /** 目标父节点 ID。 */
+  targetParentId?: string;
+  /** 目标对象 ID。 */
+  targetId?: string;
+  /** 是否可见。 */
+  visible?: boolean;
 }
 /**
- * Model.remove 参数。
+ * ModelPOI.deleteById 参数。
  */
-interface ModelRemoveRequest {
-  /** 父节点 ID。 */
-  parentId: string;
-  /** 要删除的对象 ID 列表。 */
+interface ModelPOIDeleteByIdRequest {
+  /** 分组名称。 */
+  groupName: string;
+  /** 要删除的气泡 ID 列表。 */
   ids: string[];
 }
 /**
- * Model.getModelBoundsInfo 参数。
+ * ModelPOI.deleteByGroup 参数。
  */
-interface ModelBoundsRequest {
-  /** 父节点 ID。 */
-  parentId: string;
-  /** 目标模型 ID，支持单个或多个。 */
-  id: string | string[];
+interface ModelPOIDeleteByGroupRequest {
+  /** 分组名称。 */
+  groupName: string;
 }
 /**
- * Layer.addLayer 参数。
+ * ModelPOI.getPOIInfo 参数。
  */
-interface LayerAddRequest {
-  /** 父图层或分组 ID。仅传 parentId 时兼容作为 id 使用。 */
-  parentId?: string;
-  /** 图层对象 ID。 */
+interface ModelPOIGetInfoRequest {
+  /** 分组名称。 */
+  groupName: string;
+  /** 模型气泡 ID。 */
   id: string;
-  /** 图层显示名称。 */
-  layerName?: string;
-  /** 图层默认是否显示。 */
-  show?: boolean;
-  /** 图层 POI 是否显示。 */
-  poiEnabled?: boolean;
-  /** 图层描述。 */
-  description?: string;
-  /** 图层是否为系统图层。true--断开连接不删除，false--断开连接删除。 */
-  isSystem?: boolean;
-  /**POI偏移量 */
-  poiOffsetY?: number;
 }
 /**
- * Layer.removeLayer / Layer.isLayerOrGroupExit 参数。
+ * ModelPOI.update 参数。
+ */
+interface ModelPOIUpdateRequest {
+  /** 模型气泡 ID。 */
+  id: string;
+  /** 分组名称。 */
+  groupName: string;
+  /** 资源路径。 */
+  assetPath?: string;
+  /** 目标父节点 ID。 */
+  targetParentId?: string;
+  /** 目标对象 ID。 */
+  targetId?: string;
+  /** 是否可见。 */
+  visible?: boolean;
+}
+/**
+ * ModelPOI.setVisibleByGroup 参数。
  */
-interface LayerSelectorRequest {
-  /** 父图层或分组 ID。仅传 parentId 时兼容作为 id 使用。 */
-  parentId?: string;
-  /** 图层或分组 ID。 */
-  id: string;
+interface ModelPOIVisibleByGroupRequest {
+  /** 分组名称。 */
+  groupName: string;
+  /** 是否可见。 */
+  visible: boolean;
 }
 /**
- * Layer.switchModelLayer 参数。
+ * Popup.addPop 单项配置。
  */
-interface LayerSwitchModelRequest {
-  /** 模型当前所属图层组 ID。 */
-  parentId: string;
-  /** 需要切换的模型 ID 列表。 */
-  ids: string[];
-  /** 目标图层组 ID。 */
-  toParentId: string;
-}
-interface LayerShowUIPopRequest {
-  /** 模型所属图层组 ID。 */
-  parentId?: string;
-  /** 新模型对象 ID。 */
+interface PopupItemRequest {
+  /** 气泡 ID。 */
   id: string;
-  /** 资源路径。 */
-  assetsPath?: string;
-  /** poi的偏移量 */
-  offSet?: Vector3Input;
-  /** 是否可见 */
+  /** 父节点 ID。 */
+  parentId?: string;
+  /** 气泡 div 内容。 */
+  div: HTMLDivElement;
+  /** 是否可见。 */
   visible?: boolean;
-  /** 缩放。 */
-  scale?: Vector3Input;
+  /** 显示位置。 */
+  position?: Vector3;
+  /** X 方向偏移。 */
+  offSetX?: number;
+  /** Y 方向偏移。 */
+  offSetY?: number;
 }
 /**
- * Layer.addModel 参数。
+ * Popup.addPop 参数。
  */
-interface LayerPOIAddRequest {
-  /** 模型所属图层组 ID。 */
-  parentId?: string;
-  /** 新模型对象 ID。 */
-  id: string;
-  /** 资源路径。 */
-  assetsPath: string;
-  /** 位置。 */
-  position?: Vector3Input;
-  /**场景中参照绑定的位置的对象上级编号，防止重名，可不填写，但要保证  targetId是唯一的 */
-  targetParentId?: string;
-  /** 场景中参照绑定的位置的对象编号，与position功能一样，只需要存在一个 */
-  targetId?: string;
-  /** 旋转角。 */
-  rotation?: Vector3Input;
-  /** 缩放。 */
-  scale?: Vector3Input;
-  /**poi的偏移量 */
-  offSet?: Vector3Input;
-  /** 备注描述。 */
-  description?: string;
-  /** 模型是否为系统模型。true--断开连接不删除，false--断开连接删除。如果图层为非系统的，也会删除 */
-  isSystem?: boolean;
-  /** poi的文本 */
-  text?: string;
-  /** poi的字体大小,默认为 16 */
-  fontSize?: number;
-  /** 模型的标签 */
-  tags?: string[];
-  /** 扩展属性，json对象，可不填写 */
-  extraProps?: any;
+interface PopupAddRequest {
+  /** 分组名称。 */
+  groupName?: string;
+  /** 气泡配置列表。 */
+  popInfo?: PopupItemRequest[];
 }
 /**
- * Layer.addModel 参数。
+ * Popup 同步信息（引擎侧 SyncPops 推送 / 前端需同步的气泡条目）。
  */
-interface LayerModelAddRequest {
-  /** 模型所属图层组 ID。 */
-  parentId: string;
-  /** 新模型对象 ID。 */
+interface PopupSyncInfoRequest {
+  /** 分组名称。 */
+  groupName: string;
+  /** 气泡 ID。 */
   id: string;
-  /** 资源路径。 */
-  assetsPath?: string;
-  /** 位置。 */
+  /** 父节点 ID。 */
+  parentId?: string;
+  /** 显示位置。 */
   position?: Vector3Input;
-  /** 旋转角。 */
-  rotation?: Vector3Input;
-  /** 缩放。 */
-  scale?: Vector3Input;
-  /** 备注描述。 */
-  description?: string;
-  /** 模型是否为系统模型。true--断开连接不删除，false--断开连接删除。如果图层为非系统的，也会删除 */
-  isSystem?: boolean;
-  tags?: string[];
-  name?: string;
-  extraProps?: any;
 }
 /**
- * Layer.removeModel 参数。
+ * Popup.removePop 参数。
  */
-interface LayerModelRemoveRequest {
-  /** 模型所属图层组 ID。 */
-  parentId: string;
-  /** 要删除的模型 ID 列表。 */
-  ids: string[];
+interface PopupRemoveRequest {
+  /** 分组名称。 */
+  groupName?: string;
+  /** 待删除气泡 ID 列表。 */
+  ids?: string[];
 }
 /**
- * Layer.getLayerChildElement 参数。
+ * Popup.show 参数。
  */
-interface LayerChildElementRequest {
-  /** 父图层或分组 ID。 */
-  parentId?: string;
-  /** 当前图层 ID。 */
-  id: string;
+interface PopupShowRequest {
+  /** 分组名称。 */
+  groupName?: string;
+  /** 气泡 ID 列表。 */
+  ids?: string[];
+  /** 是否显示。 */
+  show?: boolean;
 }
 /**
- * WeatherSystem.changeWeatherType 参数。
+ * Popup.setPopDelayFrame 参数。
  */
-interface WeatherTypeRequest {
-  /** 天气类型名称。 */
-  type: number;
-  /** 天气类型持续时间（秒）。 */
-  timeDuration: number;
-  test?: string;
+interface PopupDelayRequest {
+  /** 延迟时间。 */
+  time: number;
 }
 /**
- * WeatherSystem.changeWeatherType 参数。
- */
-type GetWeatherTypeRequest = Record<string, never>;
-/**
- * WeatherSystem.setSceneTime 参数。
+ * Popup.setPopShowDistance 参数。
  */
-interface WeatherSetSceneTimeRequest {
-  /** 小时值。 0~24小时 */
-  hour: number;
-  /** 时间变化持续的时间（秒）。*/
-  timeDuration?: number;
+interface PopupShowDistanceRequest {
+  /** 最远显示距离。 */
+  distance: number;
 }
 /**
- * WeatherSystem.setTimeSync 参数。
+ * Animation.startLoopAnimation 参数。
  */
-interface WeatherSetTimeSyncRequest {
-  /** 是否同步系统时间。 */
-  syncSystemTime?: boolean;
+interface AnimationStartLoopRequest {
+  /** 父节点 ID。 */
+  parentId?: string;
+  /** 模型 ID。 */
+  id: string;
+  /** 动画状态名称。 */
+  stateName: string;
+  /** 循环起始时间。 */
+  loopStartTime?: number;
+  /** 循环结束时间。 */
+  loopEndTime?: number;
+  /** 播放速度。 */
+  speed?: number;
 }
 /**
- * WeatherSystem.setAnimateTimeOfDay 参数。
+ * Animation.stopLoopAnimation 参数。
  */
-interface WeatherSetAnimateTimeOfDayRequest {
-  /** 是否模拟白天，黑夜时间动画。 */
-  isAnimate?: boolean;
-  /** 白天持续时间（分）。 默认0.5分钟*/
-  dayLength?: number;
-  /** 夜晚持续时间（分）。 默认0.5分钟 */
-  nightLength?: number;
+interface AnimationStopLoopRequest {
+  /** 父节点 ID。 */
+  parentId?: string;
+  /** 模型 ID。 */
+  id: string;
 }
 /**
- * WeatherSystem.changeSeason 参数。
+ * Animation.playAnimator 参数。
  */
-interface WeatherChangeSeasonRequest {
-  /** 季节标识。 */
-  season: Season;
-  /** 季节切换持续时间。 */
-  duration?: number;
+interface AnimationPlayRequest {
+  /** 父节点 ID。 */
+  parentId?: string;
+  /** 模型 ID。 */
+  id: string;
+  /** 动画状态名称。 */
+  stateName: string;
+  /** 播放速度。 */
+  speed?: number;
+  /** 起始时间。 */
+  startTime?: number;
+  /** 结束时间。 */
+  endTime?: number;
+  /** 播放结束后是否停止。 */
+  isStop?: boolean;
 }
 /**
- * WeatherSystem.setDayAndNight 参数。
+ * Animation.setAnimatorSpeed 参数。
  */
-interface WeatherSetDayAndNightRequest {
-  /** 日夜类型，如 day/night。 */
-  dayType: string;
+interface AnimationSetSpeedRequest {
+  /** 父节点 ID。 */
+  parentId?: string;
+  /** 模型 ID。 */
+  id: string;
+  /** 播放速度。 */
+  speed: number;
 }
 /**
- * WeatherSystem.openCameraFog 参数。
+ * Animation.getAnimationLength 参数。
  */
-interface WeatherOpenCameraFogRequest {
-  /** 雾强度。 */
-  fogIntensity?: number;
-  /** 雾近端颜色。 */
-  fogStartColor?: string;
-  /** 雾远端颜色。 */
-  fogEndColor?: string;
-  /** 雾起始距离。 */
-  fogStartDistance?: number;
-  /** 雾终止距离。 */
-  fogEndDistance?: number;
-  /** 方向光强度。 */
-  directionalIntensity?: number;
-  /** 方向光衰减。 */
-  directionalFallOff?: number;
-  /** 方向光颜色。 */
-  directionalColor?: string;
+interface AnimationGetLengthRequest {
+  /** 父节点 ID。 */
+  parentId?: string;
+  /** 模型 ID。 */
+  id: string;
+  /** 动画状态名称。 */
+  stateName: string;
 }
 /**
- * UIPOI.add 参数。
+ * Animation.stopAnimator 参数。
  */
-interface UIPOIAddRequest {
-  /** 气泡分组名称。 */
-  groupName: string;
-  /** 气泡信息列表。 */
-  poiInfos: Array<Record<string, unknown>>;
+interface AnimationStopRequest {
+  /** 父节点 ID。 */
+  parentId?: string;
+  /** 模型 ID。 */
+  id: string;
 }
 /**
- * UIPOI.deleteById 参数。
+ * TimeLine.play 参数。
  */
-interface UIPOIDeleteByIdRequest {
-  /** 气泡分组名称。 */
-  groupName: string;
-  /** 气泡 ID。 */
-  id: string;
+interface TimelinePlayRequest {
+  /** 父节点 ID。 */
+  parentId?: string;
+  /** 时间线 ID（兼容字段）。 */
+  id?: string;
+  /** 时间线 ID。 */
+  timelineId?: string;
+  /** 初始时间。 */
+  initialTime?: number;
+  /** 播放速度。 */
+  speed?: number;
+  /** 是否保留最后一帧。 */
+  keepLastFrame?: boolean;
 }
 /**
- * UIPOI.deleteByGroup 参数。
+ * TimeLine.pause / resume 参数。
  */
-interface UIPOIDeleteByGroupRequest {
-  /** 气泡分组名称。 */
-  groupName: string;
+interface TimelineNodeRequest {
+  /** 父节点 ID。 */
+  parentId?: string;
+  /** 时间线 ID（兼容字段）。 */
+  id?: string;
 }
 /**
- * UIPOI.update 参数。
+ * TimeLine.stop 参数。
  */
-interface UIPOIUpdateRequest {
-  /** 气泡分组名称。 */
-  groupName: string;
-  /** 更新后的气泡信息列表。 */
-  poiInfos: Array<Record<string, unknown>>;
+interface TimelineStopRequest {
+  /** 父节点 ID。 */
+  parentId?: string;
+  /** 时间线 ID（兼容字段）。 */
+  id?: string;
+  /** 时间线 ID。 */
+  timelineId?: string;
+  /** 停止后重置到的时间。 */
+  resetTime?: number;
+  /** 停止后相机是否回到起点。 */
+  isCameraToStart?: boolean;
 }
 /**
- * UIPOI.updatePopStates 参数。
+ * TimeLine.setSpeed 参数。
  */
-interface UIPOIUpdateStateRequest {
-  /** 气泡分组名称。 */
-  groupName: string;
-  /** 气泡状态列表。 */
-  popStates: Array<Record<string, unknown>>;
+interface TimelineSetSpeedRequest {
+  /** 父节点 ID。 */
+  parentId?: string;
+  /** 时间线 ID（兼容字段）。 */
+  id?: string;
+  /** 时间线 ID。 */
+  timelineId?: string;
+  /** 播放速度。 */
+  speed: number;
 }
 /**
- * UIPOI.enableOverlap 参数。
+ * Screen.SetSceneRenderBitrate 参数。
  */
-interface UIPOIEnableOverlapRequest {
-  /** 是否开启碰撞避让。 */
-  enable?: boolean;
+interface ScreenSetSceneRenderBitrateRequest {
+  /**
+   * 渲染码率档位。
+   * 可选值：`auto / low / high / super / blue`。
+   * 默认值 `high`。
+   */
+  bitrate?: ScreenRenderBitratePreset;
 }
 /**
- * UIPOI.showDistance 参数。
+ * Screen.SetSceneFPS 参数。
  */
-interface UIPOIShowDistanceRequest {
-  /** 最远显示距离。 */
-  distance: number;
+interface ScreenSetSceneFPSRequest {
+  /**
+   * 渲染帧率。
+   * 默认值为 `150`，有效范围 `1-300`。
+   */
+  fps?: number;
 }
 /**
- * ModelPOI.add 参数。
+ * Screen.SetScreenResolution 参数。
  */
-interface ModelPOIAddRequest {
-  /** 模型气泡 ID。 */
-  id: string;
-  /** 分组名称。 */
-  groupName: string;
-  /** 资源路径。 */
-  assetPath: string;
-  /** 目标父节点 ID。 */
-  targetParentId?: string;
-  /** 目标对象 ID。 */
-  targetId?: string;
-  /** 是否可见。 */
-  visible?: boolean;
+interface ScreenSetScreenResolutionRequest {
+  /**
+   * 目标分辨率宽度。
+   * 默认值 `1920`。
+   */
+  width?: number;
+  /**
+   * 目标分辨率高度。
+   * 默认值 `1080`。
+   */
+  height?: number;
 }
 /**
- * ModelPOI.deleteById 参数。
+ * Screen.setVideoDecode 参数。
  */
-interface ModelPOIDeleteByIdRequest {
-  /** 分组名称。 */
-  groupName: string;
-  /** 要删除的气泡 ID 列表。 */
-  ids: string[];
+interface ScreenSetVideoDecodeRequest {
+  /**
+   * 视频解码器类型。
+   */
+  decode: VideoCodeType;
 }
 /**
- * ModelPOI.deleteByGroup 参数。
+ * Dlss.setDlssEnable 参数。
  */
-interface ModelPOIDeleteByGroupRequest {
-  /** 分组名称。 */
-  groupName: string;
+interface DlssSetEnableRequest {
+  /**
+   * 是否开启 DLSS。
+   * 默认值 `true`。
+   */
+  enable?: boolean;
+  /**
+   * DLSS 质量档位。
+   * 默认值 `DlssQuality.Balanced`。
+   */
+  quality?: DlssQuality;
 }
 /**
- * ModelPOI.getPOIInfo 参数。
+ * Dlss.setDlssQuality 参数。
  */
-interface ModelPOIGetInfoRequest {
-  /** 分组名称。 */
-  groupName: string;
-  /** 模型气泡 ID。 */
+interface DlssSetQualityRequest {
+  /**
+   * DLSS 质量档位。
+   * 默认值 `DlssQuality.Balanced`。
+   */
+  quality?: DlssQuality;
+}
+/**
+ * ModelTransform.startMoveByNodes 参数。
+ */
+interface ModelTransformStartMoveRequest {
+  /** 父节点 ID，可以为空。 */
+  parentId?: string;
+  /** 移动对象编号。 */
   id: string;
+  /** 移动轨迹点集合。 */
+  nodes: Vector3Input[];
+  /** 移动速度。默认 `1`。 */
+  speed?: number;
+  /** 移动方式，参见 `ModelTransformType` 枚举，默认 -1（引擎默认）。 */
+  linear?: number;
+  /** 是否看向移动的目标点。默认 `true`。 */
+  isLookAtTarget?: boolean;
+  /** 是否需要朝移动方向转向。默认 `true`。 */
+  needDirection?: boolean;
 }
 /**
- * ModelPOI.update 参数。
+ * ModelTransform.pauseMove / resumeMove / endMove / endRotate / endScale 参数。
  */
-interface ModelPOIUpdateRequest {
-  /** 模型气泡 ID。 */
+interface ModelTransformNodeRequest {
+  /** 父节点 ID，可以为空。 */
+  parentId?: string;
+  /** 对象编号。 */
   id: string;
-  /** 分组名称。 */
-  groupName: string;
-  /** 资源路径。 */
-  assetPath?: string;
-  /** 目标父节点 ID。 */
-  targetParentId?: string;
-  /** 目标对象 ID。 */
-  targetId?: string;
-  /** 是否可见。 */
-  visible?: boolean;
 }
 /**
- * ModelPOI.setVisibleByGroup 参数。
+ * ModelTransform.restoreMove / restoreRotate / restoreScale 参数。
  */
-interface ModelPOIVisibleByGroupRequest {
-  /** 分组名称。 */
-  groupName: string;
-  /** 是否可见。 */
-  visible: boolean;
+interface ModelTransformRestoreRequest {
+  /** 父节点 ID，可以为空。 */
+  parentId?: string;
+  /** 需要恢复的对象 ID 列表。 */
+  ids: string[];
 }
 /**
- * Popup.addPop 单项配置。
+ * ModelTransform.rotate / continuedRotate 参数。
  */
-interface PopupItemRequest {
-  /** 气泡 ID。 */
+interface ModelTransformRotateRequest {
+  /** 父节点 ID，可以为空。 */
+  parentId?: string;
+  /** 对象编号。 */
   id: string;
-  /** 父节点 ID。 */
+  /** 对象绕 x/y/z 轴旋转的值，不旋转填写为 0。 */
+  rotate: Vector3;
+}
+/**
+ * ModelTransform.rotateByTarget 参数。
+ */
+interface ModelTransformRotateByTargetRequest {
+  /** 父节点 ID，可以为空。 */
   parentId?: string;
-  /** 气泡 div 内容。 */
-  div: HTMLDivElement;
-  /** 是否可见。 */
-  visible?: boolean;
-  /** 显示位置。 */
-  position?: Vector3;
-  /** X 方向偏移。 */
-  offSetX?: number;
-  /** Y 方向偏移。 */
-  offSetY?: number;
+  /** 对象编号。 */
+  id: string;
+  /** 场景中参照位置的父级对象编号。 */
+  parentTargetId?: string;
+  /** 围绕的目标对象名称。 */
+  targetID: string;
+  /** 中心点；targetID 为空时为绕中心点，否则为相对 targetID 的偏移值。 */
+  point: Vector3;
+  /** 为正数则绕 x 轴旋转。默认 `0`。 */
+  axisX?: number;
+  /** 为正数则绕 y 轴旋转。默认 `0`。 */
+  axisY?: number;
+  /** 为正数则绕 z 轴旋转。默认 `0`。 */
+  axisZ?: number;
+  /** 旋转度数。默认 `0`。 */
+  angle?: number;
+  /** 是否持续旋转。默认 `false`。 */
+  isPersistence?: boolean;
 }
 /**
- * Popup.addPop 参数。
+ * ModelTransform.setScale 参数。
  */
-interface PopupAddRequest {
-  /** 分组名称。 */
-  groupName?: string;
-  /** 气泡配置列表。 */
-  popInfo?: PopupItemRequest[];
+interface ModelTransformScaleRequest {
+  /** 父节点 ID，可以为空。 */
+  parentId?: string;
+  /** 对象编号。 */
+  id: string;
+  /** 目标缩放值。 */
+  scale: Vector3;
+  /** 缩放时长（秒）。默认 `0.5`。 */
+  duration?: number;
 }
 /**
- * Popup 同步信息（引擎侧 SyncPops 推送 / 前端需同步的气泡条目）。
+ * HighLighterEffect.setHighLightModel 参数。
  */
-interface PopupSyncInfoRequest {
-  /** 分组名称。 */
-  groupName: string;
-  /** 气泡 ID。 */
-  id: string;
-  /** 父节点 ID。 */
+interface HighLighterSetHighLightModelRequest {
+  /** 对象组的父对象，可以为空。 */
   parentId?: string;
-  /** 显示位置。 */
-  position?: Vector3Input;
+  /** 需要添加高光的对象编号数组。 */
+  ids: string[];
+  /** 是否高亮模型背面。 */
+  showBack: boolean;
 }
-/**
- * Popup.removePop 参数。
- */
-interface PopupRemoveRequest {
-  /** 分组名称。 */
-  groupName?: string;
-  /** 待删除气泡 ID 列表。 */
-  ids?: string[];
+interface HighLighterEnableRequest {
+  /** 是否启用高亮效果。 */
+  enable: boolean;
 }
 /**
- * Popup.show 参数。
+ * HighLighterEffect.removeHighLightModel 参数。
  */
-interface PopupShowRequest {
-  /** 分组名称。 */
-  groupName?: string;
-  /** 气泡 ID 列表。 */
-  ids?: string[];
-  /** 是否显示。 */
-  show?: boolean;
+interface HighLighterRemoveHighLightModelRequest {
+  /** 对象组的父对象，可以为空。 */
+  parentId?: string;
+  /** 需要移除高光的对象名称数组。 */
+  ids: string[];
 }
 /**
- * Popup.setPopDelayFrame 参数。
+ * PathPatrol 时间序列节点。
  */
-interface PopupDelayRequest {
-  /** 延迟时间。 */
-  time: number;
+interface TimeSerialNode {
+  /** 路径点坐标。 */
+  node: Vector3Input;
+  /** 时间节点，格式为 "2025-09-10 00:05:00"。 */
+  time: string;
 }
 /**
- * Popup.setPopShowDistance 参数。
+ * PathPatrol.add 参数。
  */
-interface PopupShowDistanceRequest {
-  /** 最远显示距离。 */
-  distance: number;
+interface PathPatrolAddRequest {
+  /** 模型对象父对象编号。 */
+  parentId?: string;
+  /** 场景的模型对象编号。 */
+  id: string;
+  /** 场景的模型路径，可为空；为空时根据 id 到场景中寻找模型对象。 */
+  assetPath?: string;
+  /** 模型缩放的大小。 */
+  scale: Vector3Input;
+  /** 是否显示巡逻轨迹，默认 `true`。 */
+  showPath?: boolean;
+  /** 巡逻过的路径的显示颜色，默认 `#ffffff`。 */
+  passedColor?: string;
+  /** 未巡逻路径的颜色，默认 `#00ff00`。 */
+  lineColor?: string;
+  /** 线路的宽度。 */
+  lineWidth: number;
+  /** 全程所需时间。 */
+  duration?: number;
+  /** 路径点的集合，至少需要 2 个节点。 */
+  nodes?: Vector3Input[];
+  /** 路径点时间序列的集合。 */
+  timeNodes?: TimeSerialNode[];
+  /** 线的图层，如 TransparentFX。 */
+  lineLayer?: string;
+  /** 是否后渲染，默认 `false`；`true` 后渲染（渲染不会阻挡），`false` 前渲染。 */
+  afterRender?: boolean;
+  /** 是否自动清除，默认 `true`。 */
+  isAutoClear?: boolean;
 }
 /**
- * Animation.startLoopAnimation 参数。
+ * PathPatrol.update 参数。
  */
-interface AnimationStartLoopRequest {
-  /** 父节点 ID。 */
+interface PathPatrolUpdateRequest {
+  /** 模型对象父对象编号。 */
   parentId?: string;
-  /** 模型 ID。 */
+  /** 巡逻轨迹编号。 */
   id: string;
-  /** 动画状态名称。 */
-  stateName: string;
-  /** 循环起始时间。 */
-  loopStartTime?: number;
-  /** 循环结束时间。 */
-  loopEndTime?: number;
-  /** 播放速度。 */
+  /** 巡逻轨迹的颜色。 */
+  lineColor?: string;
+  /** 巡逻路线的宽度。 */
+  lineWidth?: number;
+  /** 巡逻过的路径的显示颜色。 */
+  passedColor?: string;
+  /** 调整速度，不能小于 0。 */
   speed?: number;
 }
 /**
- * Animation.stopLoopAnimation 参数。
+ * PathPatrol.setTimeNode 参数。
  */
-interface AnimationStopLoopRequest {
-  /** 父节点 ID。 */
+interface PathPatrolSetTimeNodeRequest {
+  /** 模型对象父对象编号。 */
   parentId?: string;
-  /** 模型 ID。 */
+  /** 巡逻对象编号。 */
   id: string;
+  /** 时间节点，格式为 "2025-09-10 00:05:00"。`timeStart` 与 `startNodeIndex` 只能有一个不为空。 */
+  timeStart?: string;
+  /** 开始节点索引，不能小于 0。`timeStart` 与 `startNodeIndex` 只能有一个不为空。 */
+  startNodeIndex?: string;
 }
 /**
- * Animation.playAnimator 参数。
+ * PathPatrol.pause / resume / stop 参数。
  */
-interface AnimationPlayRequest {
-  /** 父节点 ID。 */
+interface PathPatrolNodeRequest {
+  /** 模型对象父对象编号。 */
   parentId?: string;
-  /** 模型 ID。 */
+  /** 巡逻对象编号。 */
   id: string;
-  /** 动画状态名称。 */
-  stateName: string;
-  /** 播放速度。 */
-  speed?: number;
-  /** 起始时间。 */
-  startTime?: number;
-  /** 结束时间。 */
-  endTime?: number;
-  /** 播放结束后是否停止。 */
-  isStop?: boolean;
 }
 /**
- * Animation.setAnimatorSpeed 参数。
+ * 单个热力点数据（地理坐标 + 热度值）。
  */
-interface AnimationSetSpeedRequest {
-  /** 父节点 ID。 */
+interface HeatMapPointRequest {
+  /** 点位置（地理坐标，默认 EPSG4326）。 */
+  position: Vector3Input;
+  /** 该点的热度值（0~1），默认 1。 */
+  value?: number;
+}
+/**
+ * HeatMap.create 参数。
+ */
+interface HeatMapCreateRequest {
+  /** 热力图所属父节点 ID，可选。 */
   parentId?: string;
-  /** 模型 ID。 */
-  id: string;
-  /** 播放速度。 */
-  speed: number;
+  /** 热力图 ID；重复创建相同 ID 会更新该热力图数据，可空。 */
+  id?: string;
+  /** 热力图纹理尺寸（像素），默认 256x256；地理数据模式下由坐标范围自动计算。 */
+  textureSize?: Vector2Input;
+  /** 热力图在地图中的尺寸（厘米），默认 1000x1000；地理数据模式下由坐标范围自动计算。 */
+  mapSize?: Vector2Input;
+  /** 单个热力点的影响范围（像素），默认 50。 */
+  influenceSize?: number;
+  /** 热力点数据列表，支持 `{ position, value }` 对象数组或 `Vector3Input` 位置数组（热度值默认 1）。 */
+  points: HeatMapPointRequest[] | Vector3Input[];
+  /** 材质透明度，默认 0.7。 */
+  opacity?: number;
+  /** 高度缩放，默认 2500。 */
+  heightScale?: number;
+  /** 颜色过渡比例，默认 2.5。 */
+  lerpScale?: number;
+  /** 是否添加到场景中，默认 false */
+  isAddAsset?: boolean;
 }
 /**
- * Animation.getAnimationLength 参数。
+ * HeatMap.remove 参数。
  */
-interface AnimationGetLengthRequest {
-  /** 父节点 ID。 */
+interface HeatMapRemoveRequest {
+  /** 热力图所属父节点 ID，可选。 */
   parentId?: string;
-  /** 模型 ID。 */
+  /** 热力图 ID；为空时移除全部热力图。 */
+  id?: string;
+}
+/**
+ * HeatMap.setConfig 参数。
+ */
+interface HeatMapConfigRequest {
+  /** 热力图所属父节点 ID，可选。 */
+  parentId?: string;
+  /** 热力图 ID；为空时作用于最近创建的热力图。 */
+  id?: string;
+  /** 材质透明度，默认 0.7。 */
+  opacity?: number;
+  /** 高度缩放，默认 2500。 */
+  heightScale?: number;
+  /** 颜色过渡比例，默认 2.5。 */
+  lerpScale?: number;
+  /**影响范围 */
+  influenceSize?: number;
+}
+/**
+ * Navigation.startMeshNav / getMeshNavDistance 参数。
+ */
+interface NavigationMeshNavRequest {
+  /** 对象组的父对象，可以为空。 */
+  parentId?: string;
+  /** 对象名称数组集合。 */
   id: string;
-  /** 动画状态名称。 */
-  stateName: string;
+  /** 路径节点数组集合，与 `targetIds` 二选一。 */
+  nodes?: Vector3Input[];
+  /** 路径节点经过的目标对象名称数组集合，与 `nodes` 二选一；需保证场景中各编号对象唯一存在。 */
+  targetIds?: string[];
+  /** 物体移动的速度，默认 1。 */
+  speed?: number;
+  /** 是否作为导航缓存路径点，默认 `true`；`true` 表示将节点加入缓存路径，下次修改时前置节点仍会经过，`false` 表示按新路径导航。 */
+  isCache?: boolean;
+  /** 导航规划路径颜色。 */
+  planColor?: string;
+  /** 导航已走过的路径颜色。 */
+  passColor?: string;
+  /** 导航规划线的宽度，默认 1。 */
+  lineWidth?: number;
+  /** 是否自动播放，默认 `true`。 */
+  isAutoPlay?: boolean;
+  /** 场景的模型路径，可为空；为空时根据 id 到场景中寻找模型对象。 */
+  assetPath?: string;
+  /** 模型缩放比例，默认 1。 */
+  scale?: Vector3Input;
+  /** 是否自动清除，默认 `true`。 */
+  isAutoClear?: boolean;
+  offSetZ?: number;
 }
 /**
- * Animation.stopAnimator 参数。
+ * Navigation.pauseMeshNav / resumeMeshNav / stopMeshNav / pauseNavPath / resumeNavPath / stopNavPath 参数。
  */
-interface AnimationStopRequest {
-  /** 父节点 ID。 */
+interface NavigationNodeRequest {
+  /** 对象组的父对象，可以为空。 */
   parentId?: string;
-  /** 模型 ID。 */
+  /** 对象名称数组集合。 */
   id: string;
 }
 /**
- * TimeLine.play 参数。
+ * Navigation.updateMeshNav 参数。
  */
-interface TimelinePlayRequest {
-  /** 父节点 ID。 */
+interface NavigationUpdateMeshNavRequest {
+  /** 对象组的父对象，可以为空。 */
   parentId?: string;
-  /** 时间线 ID（兼容字段）。 */
-  id?: string;
-  /** 时间线 ID。 */
-  timelineId?: string;
-  /** 初始时间。 */
-  initialTime?: number;
-  /** 播放速度。 */
+  /** 对象名称数组集合。 */
+  id: string;
+  /** 物体移动的速度，默认 -1（不改变速度）。 */
   speed?: number;
-  /** 是否保留最后一帧。 */
-  keepLastFrame?: boolean;
+  /** 导航规划路径颜色。 */
+  planColor?: string;
+  /** 导航已走过的路径颜色。 */
+  passColor?: string;
 }
-/**
- * TimeLine.pause / resume 参数。
- */
-interface TimelineNodeRequest {
-  /** 父节点 ID。 */
+interface NavigationUpdateSpeedRequest {
+  /** 对象组的父对象，可以为空。 */
   parentId?: string;
-  /** 时间线 ID（兼容字段）。 */
-  id?: string;
+  /** 对象名称数组集合。 */
+  id: string;
+  /** 物体移动的速度，默认 -1（不改变速度）。 */
+  speed?: number;
 }
 /**
- * TimeLine.stop 参数。
+ * Navigation.startNavByPath 参数。
  */
-interface TimelineStopRequest {
-  /** 父节点 ID。 */
+interface NavigationNavByPathRequest {
+  /** 对象组的父对象，可以为空。 */
   parentId?: string;
-  /** 时间线 ID（兼容字段）。 */
-  id?: string;
-  /** 时间线 ID。 */
-  timelineId?: string;
-  /** 停止后重置到的时间。 */
-  resetTime?: number;
-  /** 停止后相机是否回到起点。 */
-  isCameraToStart?: boolean;
+  /** 对象名称数组集合。 */
+  id: string[];
+  /** 路径节点数组集合。 */
+  nodes: Vector3Input[];
+  /** 是否作为导航缓存路径点，默认 `true`。 */
+  isCache?: boolean;
+  /** 导航轨迹总时间（秒），默认 10。 */
+  duration?: number;
+  /** 导航规划路径颜色。 */
+  planColor?: string;
+  /** 导航已走过的路径颜色。 */
+  passColor?: string;
 }
 /**
- * TimeLine.setSpeed 参数。
+ * Navigation.updateNavPath 参数。
  */
-interface TimelineSetSpeedRequest {
-  /** 父节点 ID。 */
+interface NavigationUpdateNavPathRequest {
+  /** 对象组的父对象，可以为空。 */
   parentId?: string;
-  /** 时间线 ID（兼容字段）。 */
-  id?: string;
-  /** 时间线 ID。 */
-  timelineId?: string;
-  /** 播放速度。 */
-  speed: number;
-}
-/**
- * Screen.SetSceneRenderBitrate 参数。
- */
-interface ScreenSetSceneRenderBitrateRequest {
-  /**
-   * 渲染码率档位。
-   * 可选值：`auto / low / high / super / blue`。
-   * 默认值 `high`。
-   */
-  bitrate?: ScreenRenderBitratePreset;
+  /** 对象名称数组集合。 */
+  id: string[];
+  /** 导航轨迹总时间（秒），默认 -1（不改变时长）。 */
+  duration?: number;
+  /** 导航规划路径颜色。 */
+  planColor?: string;
+  /** 导航已走过的路径颜色。 */
+  passColor?: string;
 }
 /**
- * Screen.SetSceneFPS 参数。
+ * SpatialQuery.layerQueryByModel 参数。
  */
-interface ScreenSetSceneFPSRequest {
-  /**
-   * 渲染帧率。
-   * 默认值为 `150`，有效范围 `1-300`。
-   */
-  fps?: number;
+interface SpatialQueryLayerByModelRequest {
+  /** 场景查询位置的对象上级编号，可以为空。 */
+  parentId?: string;
+  /** 查询参照的位置对象唯一编号。 */
+  id?: string;
+  /** 查询的半径，单位米，默认 50。 */
+  queryRadius?: number;
+  /** 查询的最小高度，默认 0；值不能大于最大高度。 */
+  queryMinHeight?: number;
+  /** 查询的最大高度，默认 20；值不能小于最小高度。 */
+  queryMaxHeight?: number;
+  /** 查询的图层组编号集合，至少一个。 */
+  queryParentIds: string[];
+}
+/**
+ * SpatialQuery.layerQueryByPosition 参数。
+ */
+interface SpatialQueryLayerByPositionRequest {
+  /** 查询的中心位置。 */
+  queryPosition?: Vector3Input;
+  /** 查询的半径，单位米，默认 50。 */
+  queryRadius?: number;
+  /** 查询的最小高度，默认 0；值不能大于最大高度。 */
+  queryMinHeight?: number;
+  /** 查询的最大高度，默认 20；值不能小于最小高度。 */
+  queryMaxHeight?: number;
+  /** 查询的图层组编号集合，至少一个。 */
+  queryParentIds: string[];
+}
+/**
+ * SpatialQuery.layerQueryByModelBox 参数。
+ */
+interface SpatialQueryLayerByModelBoxRequest {
+  /** 场景查询位置的对象上级编号，可以为空。 */
+  parentId?: string;
+  /** 查询参照的位置对象唯一编号。 */
+  id?: string;
+  /** 查询的图层组编号集合，至少一个。 */
+  queryParentIds: string[];
 }
-/**
- * Screen.SetScreenResolution 参数。
- */
-interface ScreenSetScreenResolutionRequest {
-  /**
-   * 目标分辨率宽度。
-   * 默认值 `1920`。
-   */
-  width?: number;
-  /**
-   * 目标分辨率高度。
-   * 默认值 `1080`。
-   */
-  height?: number;
+//#endregion
+//#region src/types/buildingFloor.d.ts
+/** 建筑楼层固定视角。 */
+interface BuildingFloorViewPoint {
+  /** 相机位置。 */
+  position: Vector3Input;
+  /** 相机看向的目标点。 */
+  target: Vector3Input;
+  /** 水平视场角。 */
+  fov?: number;
+  /** 相机飞行时长（秒）。 */
+  time?: number;
 }
-/**
- * Screen.setVideoDecode 参数。
- */
-interface ScreenSetVideoDecodeRequest {
-  /**
-   * 视频解码器类型。
-   */
-  decode: VideoCodeType;
+/** 对象形式的楼层注册项。 */
+interface BuildingFloorItem {
+  /** UE 楼层节点 ID。 */
+  id: string;
+  /** 该楼层的可选固定视角。 */
+  viewPoint?: BuildingFloorViewPoint;
+  /** 切换到该楼层后显示的附属对象。 */
+  objects?: string[];
+}
+/** 楼层既可使用节点 ID，也可使用带固定视角的对象。 */
+type BuildingFloorInput = string | BuildingFloorItem;
+/** 建筑整栋视图配置。 */
+interface BuildingFloorOverview {
+  /** 仅在整栋视图中显示的附属对象。 */
+  objects?: string[];
+  /** 整栋视图的可选固定视角。 */
+  viewPoint?: BuildingFloorViewPoint;
+}
+/** 单栋建筑的楼层注册配置。 */
+interface BuildingFloorRegistration {
+  /** SDK 内唯一的建筑标识。 */
+  buildingId: string;
+  /** 楼层模型共同所属的 UE 父节点。 */
+  parentId: string;
+  /** 从低到高排列的楼层配置。 */
+  floors: BuildingFloorInput[];
+  /** 整栋视图配置。 */
+  overview?: BuildingFloorOverview;
+}
+/** 建筑注册结果。 */
+interface BuildingFloorRegistrationResult {
+  buildingIds: string[];
+}
+/** 楼层切换参数。 */
+interface BuildingFloorSwitchOptions {
+  buildingId: string;
+  floorId: string;
+  /** 是否在楼层动画结束后调整相机，默认 false。 */
+  focus?: boolean;
+}
+/** 恢复整栋视图参数。 */
+interface BuildingFloorOverviewOptions {
+  buildingId: string;
+  /** 是否在楼层动画结束后调整相机，默认 false。 */
+  focus?: boolean;
+}
+/** 取消楼层切换参数。 */
+interface BuildingFloorCancelOptions {
+  buildingId: string;
+}
+/** 查询楼层状态参数。 */
+interface BuildingFloorStateOptions {
+  buildingId: string;
+}
+type BuildingFloorRuntimeStatus = 'overview' | 'switching' | 'floor' | 'cancelled';
+type BuildingFloorTransitionStatus = 'completed' | 'cancelled';
+type BuildingFloorFocusMode = 'none' | 'viewPoint' | 'bounds';
+/** 楼层切换结果。 */
+interface BuildingFloorTransitionResult {
+  buildingId: string;
+  floorId?: string;
+  status: BuildingFloorTransitionStatus;
+  visibleFloorIds: string[];
+  focusMode: BuildingFloorFocusMode;
+  /** 当前版本按 SDK 预计时间完成收口，尚未获得 UE 动画完成事件确认。 */
+  completion: 'estimated';
+}
+/** 指定建筑的楼层运行状态快照。 */
+interface BuildingFloorState {
+  buildingId: string;
+  status: BuildingFloorRuntimeStatus;
+  currentFloorId?: string;
+  visibleFloorIds: string[];
+  transitionId: number;
 }
+//#endregion
+//#region src/types/common.d.ts
+type ApiCallback<T> = (result: T) => void;
+type EngineLogLevel = 'silent' | 'error' | 'warn' | 'info' | 'debug';
+type EngineViewMode = 'bs' | 'cs';
 /**
- * Dlss.setDlssEnable 参数。
+ * 引擎状态详情结构，与 sdk2 的 EngineStatusInfo 字段语义保持一致。
  */
-interface DlssSetEnableRequest {
-  /**
-   * 是否开启 DLSS。
-   * 默认值 `true`。
-   */
-  enable?: boolean;
-  /**
-   * DLSS 质量档位。
-   * 默认值 `DlssQuality.Balanced`。
-   */
-  quality?: DlssQuality;
+interface EngineStatusInfo {
+  CameraHeight: string;
+  FPS: string;
+  Width: string;
+  Height: string;
+  runTime: string;
+  bytePerSecond: string;
+  lostPacketsRate: string;
+  delayTime: string;
+  Codec: string;
 }
-/**
- * Dlss.setDlssQuality 参数。
- */
-interface DlssSetQualityRequest {
-  /**
-   * DLSS 质量档位。
-   * 默认值 `DlssQuality.Balanced`。
-   */
-  quality?: DlssQuality;
+interface EngineConfig {
+  /** 鉴权服务器地址 */
+  centerIP?: string;
+  /** 信令服务 HTTP 基地址，SDK 会基于该地址调用 `/api/v1/allocate` 获取最终 ws 播放地址 */
+  signalingServer?: string;
+  sceneName?: string;
+  token?: string;
+  dom?: HTMLDivElement;
+  showProgressBar?: boolean;
+  codec?: string;
+  viewMode?: EngineViewMode;
+  /** TURN 服务器地址 */
+  turnServer?: string;
+  /** TURN 用户名 */
+  turnUser?: string;
+  /** TURN 密码 */
+  turnPwd?: string;
+  /** 私有密钥 */
+  privateKey?: string;
+  engineUuid?: string;
+  mapType?: string;
+  operationType?: string;
+  freeCheckInterval?: number;
+  /** PixelStreaming initialSettings */
+  initialSettings?: Record<string, unknown>;
+  /** 日志级别，默认值为 info */
+  logger?: EngineLogLevel;
+  /** 从指定级别开始附加业务调用栈，默认值为 warn；silent 表示关闭 */
+  includeStack?: EngineLogLevel;
+  /** Pixel Streaming 依赖日志级别，默认值为 warn */
+  pixelStreamingLogger?: EngineLogLevel;
 }
-/**
- * ModelTransform.startMoveByNodes 参数。
- */
-interface ModelTransformStartMoveRequest {
-  /** 父节点 ID，可以为空。 */
-  parentId?: string;
-  /** 移动对象编号。 */
-  id: string;
-  /** 移动轨迹点集合。 */
-  nodes: Vector3Input[];
-  /** 移动速度。默认 `1`。 */
-  speed?: number;
-  /** 移动方式，参见 `ModelTransformType` 枚举，默认 -1（引擎默认）。 */
-  linear?: number;
-  /** 是否看向移动的目标点。默认 `true`。 */
-  isLookAtTarget?: boolean;
-  /** 是否需要朝移动方向转向。默认 `true`。 */
-  needDirection?: boolean;
+interface ApiRequestEnvelope<T = unknown> {
+  AssemblyName: string;
+  fn: string;
+  ClassName: string;
+  FunctionName: string;
+  Value?: any;
+  ts: number;
 }
-/**
- * ModelTransform.pauseMove / resumeMove / endMove / endRotate / endScale 参数。
- */
-interface ModelTransformNodeRequest {
-  /** 父节点 ID，可以为空。 */
-  parentId?: string;
-  /** 对象编号。 */
-  id: string;
+interface ApiResponseEnvelope<T = unknown> {
+  requestId: string;
+  success: boolean;
+  code: string;
+  message: string;
+  params?: any;
+  errorMsg?: string;
+  data?: T;
+  ts: number;
 }
-/**
- * ModelTransform.restoreMove / restoreRotate / restoreScale 参数。
- */
-interface ModelTransformRestoreRequest {
-  /** 父节点 ID，可以为空。 */
-  parentId?: string;
-  /** 需要恢复的对象 ID 列表。 */
-  ids: string[];
+interface ResolvedEngineConfig {
+  centerIP: string;
+  signalingServer?: string;
+  sceneName: string;
+  token: string;
+  dom: HTMLDivElement;
+  showProgressBar: boolean;
+  codec: string;
+  viewMode: EngineViewMode;
+  turnServer?: string;
+  turnUser?: string;
+  turnPwd?: string;
+  privateKey: string;
+  engineUuid?: string;
+  mapType: string;
+  operationType: string;
+  freeCheckInterval: number;
+  initialSettings: Record<string, unknown>;
+  logger: EngineLogLevel;
+  includeStack: EngineLogLevel;
+  pixelStreamingLogger: EngineLogLevel;
+  centerHeartbeatIntervalMs: number;
+  centerHeartbeatTimeoutMs: number;
 }
+//#endregion
+//#region src/types/network.d.ts
 /**
- * ModelTransform.rotate / continuedRotate 参数。
+ * 弱网自适应档位。
  */
-interface ModelTransformRotateRequest {
-  /** 父节点 ID，可以为空。 */
-  parentId?: string;
-  /** 对象编号。 */
-  id: string;
-  /** 对象绕 x/y/z 轴旋转的值，不旋转填写为 0。 */
-  rotate: Vector3;
-}
+type NetworkAdaptationLevel = 'Normal' | 'Mild' | 'Moderate' | 'Severe' | 'Recovering';
 /**
- * ModelTransform.rotateByTarget 参数。
+ * 弱网自适应运行模式：
+ * - auto: 自动策略决策
+ * - manual: 手动接管档位
  */
-interface ModelTransformRotateByTargetRequest {
-  /** 父节点 ID，可以为空。 */
-  parentId?: string;
-  /** 对象编号。 */
-  id: string;
-  /** 场景中参照位置的父级对象编号。 */
-  parentTargetId?: string;
-  /** 围绕的目标对象名称。 */
-  targetID: string;
-  /** 中心点；targetID 为空时为绕中心点，否则为相对 targetID 的偏移值。 */
-  point: Vector3;
-  /** 为正数则绕 x 轴旋转。默认 `0`。 */
-  axisX?: number;
-  /** 为正数则绕 y 轴旋转。默认 `0`。 */
-  axisY?: number;
-  /** 为正数则绕 z 轴旋转。默认 `0`。 */
-  axisZ?: number;
-  /** 旋转度数。默认 `0`。 */
-  angle?: number;
-  /** 是否持续旋转。默认 `false`。 */
-  isPersistence?: boolean;
-}
+type NetworkAdaptationMode = 'auto' | 'manual';
 /**
- * ModelTransform.setScale 参数。
+ * 媒体链路实时指标快照。
  */
-interface ModelTransformScaleRequest {
-  /** 父节点 ID，可以为空。 */
-  parentId?: string;
-  /** 对象编号。 */
-  id: string;
-  /** 目标缩放值。 */
-  scale: Vector3;
-  /** 缩放时长（秒）。默认 `0.5`。 */
-  duration?: number;
+interface NetworkMetricsSnapshot {
+  ts: number;
+  connected: boolean;
+  fps?: number;
+  bitrateKbps?: number;
+  packetLossRate?: number;
+  jitterMs?: number;
+  rttMs?: number;
+  frameWidth?: number;
+  frameHeight?: number;
 }
 /**
- * HighLighterEffect.setHighLightModel 参数。
+ * 弱网状态变更事件载荷。
  */
-interface HighLighterSetHighLightModelRequest {
-  /** 对象组的父对象，可以为空。 */
-  parentId?: string;
-  /** 需要添加高光的对象编号数组。 */
-  ids: string[];
-  /** 是否高亮模型背面。 */
-  showBack: boolean;
-}
-interface HighLighterEnableRequest {
-  /** 是否启用高亮效果。 */
-  enable: boolean;
+interface NetworkAdaptationState {
+  from: NetworkAdaptationLevel;
+  to: NetworkAdaptationLevel;
+  mode: NetworkAdaptationMode;
+  reason: string;
+  ts: number;
+  metrics?: NetworkMetricsSnapshot;
 }
 /**
- * HighLighterEffect.removeHighLightModel 参数。
+ * 策略动作类型。
  */
-interface HighLighterRemoveHighLightModelRequest {
-  /** 对象组的父对象，可以为空。 */
-  parentId?: string;
-  /** 需要移除高光的对象名称数组。 */
-  ids: string[];
-}
+type NetworkAdaptationActionType = 'SetSceneRenderBitrate' | 'SetSceneFPS' | 'SetScreenResolution';
 /**
- * PathPatrol 时间序列节点。
+ * 单步策略动作执行结果。
  */
-interface TimeSerialNode {
-  /** 路径点坐标。 */
-  node: Vector3Input;
-  /** 时间节点，格式为 "2025-09-10 00:05:00"。 */
-  time: string;
+interface NetworkAdaptationActionStep {
+  type: NetworkAdaptationActionType;
+  payload: Record<string, number>;
+  success: boolean;
+  error?: string;
 }
 /**
- * PathPatrol.add 参数。
+ * 策略动作执行事件。
  */
-interface PathPatrolAddRequest {
-  /** 模型对象父对象编号。 */
-  parentId?: string;
-  /** 场景的模型对象编号。 */
-  id: string;
-  /** 场景的模型路径，可为空；为空时根据 id 到场景中寻找模型对象。 */
-  assetPath?: string;
-  /** 模型缩放的大小。 */
-  scale: Vector3Input;
-  /** 是否显示巡逻轨迹，默认 `true`。 */
-  showPath?: boolean;
-  /** 巡逻过的路径的显示颜色，默认 `#ffffff`。 */
-  passedColor?: string;
-  /** 未巡逻路径的颜色，默认 `#00ff00`。 */
-  lineColor?: string;
-  /** 线路的宽度。 */
-  lineWidth: number;
-  /** 全程所需时间。 */
-  duration?: number;
-  /** 路径点的集合，至少需要 2 个节点。 */
-  nodes?: Vector3Input[];
-  /** 路径点时间序列的集合。 */
-  timeNodes?: TimeSerialNode[];
-  /** 线的图层，如 TransparentFX。 */
-  lineLayer?: string;
-  /** 是否后渲染，默认 `false`；`true` 后渲染（渲染不会阻挡），`false` 前渲染。 */
-  afterRender?: boolean;
-  /** 是否自动清除，默认 `true`。 */
-  isAutoClear?: boolean;
+interface NetworkAdaptationActionResult {
+  level: Exclude<NetworkAdaptationLevel, 'Recovering'>;
+  mode: NetworkAdaptationMode;
+  success: boolean;
+  skipped: boolean;
+  reason: string;
+  ts: number;
+  steps: NetworkAdaptationActionStep[];
 }
 /**
- * PathPatrol.update 参数。
+ * 策略决策轨迹条目，用于诊断面板回放。
  */
-interface PathPatrolUpdateRequest {
-  /** 模型对象父对象编号。 */
-  parentId?: string;
-  /** 巡逻轨迹编号。 */
-  id: string;
-  /** 巡逻轨迹的颜色。 */
-  lineColor?: string;
-  /** 巡逻路线的宽度。 */
-  lineWidth?: number;
-  /** 巡逻过的路径的显示颜色。 */
-  passedColor?: string;
-  /** 调整速度，不能小于 0。 */
-  speed?: number;
+interface NetworkDecisionTrace {
+  ts: number;
+  mode: NetworkAdaptationMode;
+  currentLevel: NetworkAdaptationLevel;
+  measuredLevel: Exclude<NetworkAdaptationLevel, 'Recovering'>;
+  targetLevel?: NetworkAdaptationLevel;
+  outcome: 'hold' | 'downgrade' | 'recover' | 'manual' | 'skip_hysteresis' | 'skip_cooldown';
+  reason: string;
+  metrics?: NetworkMetricsSnapshot;
 }
 /**
- * PathPatrol.setTimeNode 参数。
+ * 诊断面板快照数据。
  */
-interface PathPatrolSetTimeNodeRequest {
-  /** 模型对象父对象编号。 */
-  parentId?: string;
-  /** 巡逻对象编号。 */
-  id: string;
-  /** 时间节点，格式为 "2025-09-10 00:05:00"。`timeStart` 与 `startNodeIndex` 只能有一个不为空。 */
-  timeStart?: string;
-  /** 开始节点索引，不能小于 0。`timeStart` 与 `startNodeIndex` 只能有一个不为空。 */
-  startNodeIndex?: string;
+interface NetworkDiagnosticsSnapshot {
+  ts: number;
+  visible: boolean;
+  mode: NetworkAdaptationMode;
+  currentLevel: NetworkAdaptationLevel;
+  connected: boolean;
+  lastMetrics?: NetworkMetricsSnapshot;
+  lastAction?: NetworkAdaptationActionResult;
+  traces: NetworkDecisionTrace[];
 }
+//#endregion
+//#region src/types/qos.d.ts
 /**
- * PathPatrol.pause / resume / stop 参数。
+ * QoS 事件阶段定义。
  */
-interface PathPatrolNodeRequest {
-  /** 模型对象父对象编号。 */
-  parentId?: string;
-  /** 巡逻对象编号。 */
-  id: string;
-}
+type QosStage = 'auth' | 'center' | 'webrtc' | 'media' | 'ue_api' | 'session';
 /**
- * 单个热力点数据（地理坐标 + 热度值）。
+ * QoS 事件状态定义。
  */
-interface HeatMapPointRequest {
-  /** 点位置（地理坐标，默认 EPSG4326）。 */
-  position: Vector3Input;
-  /** 该点的热度值（0~1），默认 1。 */
-  value?: number;
-}
+type QosStatus = 'start' | 'success' | 'failed' | 'update' | 'end';
 /**
- * HeatMap.create 参数。
+ * QoS 事件日志等级（仅用于事件严重程度标记）。
  */
-interface HeatMapCreateRequest {
-  /** 热力图所属父节点 ID，可选。 */
-  parentId?: string;
-  /** 热力图 ID；重复创建相同 ID 会更新该热力图数据，可空。 */
-  id?: string;
-  /** 热力图纹理尺寸（像素），默认 256x256；地理数据模式下由坐标范围自动计算。 */
-  textureSize?: Vector2Input;
-  /** 热力图在地图中的尺寸（厘米），默认 1000x1000；地理数据模式下由坐标范围自动计算。 */
-  mapSize?: Vector2Input;
-  /** 单个热力点的影响范围（像素），默认 50。 */
-  influenceSize?: number;
-  /** 热力点数据列表，支持 `{ position, value }` 对象数组或 `Vector3Input` 位置数组（热度值默认 1）。 */
-  points: HeatMapPointRequest[] | Vector3Input[];
-  /** 材质透明度，默认 0.7。 */
-  opacity?: number;
-  /** 高度缩放，默认 2500。 */
-  heightScale?: number;
-  /** 颜色过渡比例，默认 2.5。 */
-  lerpScale?: number;
-  /** 是否添加到场景中，默认 false */
-  isAddAsset?: boolean;
-}
+type QosLevel = 'info' | 'warn' | 'error';
 /**
- * HeatMap.remove 参数。
+ * QoS V1 事件名集合。
  */
-interface HeatMapRemoveRequest {
-  /** 热力图所属父节点 ID，可选。 */
-  parentId?: string;
-  /** 热力图 ID；为空时移除全部热力图。 */
-  id?: string;
-}
+declare const QOS_EVENT_NAMES: readonly ["session_start", "auth_start", "auth_success", "auth_failed", "center_connect_start", "center_connected", "center_disconnected", "center_message_received", "webrtc_connect_start", "webrtc_connected", "webrtc_disconnected", "first_frame_rendered", "media_stats_sample", "ue_request_sent", "ue_response_received", "session_end"];
 /**
- * HeatMap.setConfig 参数。
+ * QoS V1 事件名类型。
+ *
+ * 注意：V1 明确不包含 `ue_request_timeout`。
  */
-interface HeatMapConfigRequest {
-  /** 热力图所属父节点 ID，可选。 */
-  parentId?: string;
-  /** 热力图 ID；为空时作用于最近创建的热力图。 */
-  id?: string;
-  /** 材质透明度，默认 0.7。 */
-  opacity?: number;
-  /** 高度缩放，默认 2500。 */
-  heightScale?: number;
-  /** 颜色过渡比例，默认 2.5。 */
-  lerpScale?: number;
-  /**影响范围 */
-  influenceSize?: number;
-}
+type QosEventName = (typeof QOS_EVENT_NAMES)[number];
 /**
- * Navigation.startMeshNav / getMeshNavDistance 参数。
+ * 会话维度上下文。
  */
-interface NavigationMeshNavRequest {
-  /** 对象组的父对象，可以为空。 */
-  parentId?: string;
-  /** 对象名称数组集合。 */
-  id: string;
-  /** 路径节点数组集合，与 `targetIds` 二选一。 */
-  nodes?: Vector3Input[];
-  /** 路径节点经过的目标对象名称数组集合，与 `nodes` 二选一；需保证场景中各编号对象唯一存在。 */
-  targetIds?: string[];
-  /** 物体移动的速度，默认 1。 */
-  speed?: number;
-  /** 是否作为导航缓存路径点，默认 `true`；`true` 表示将节点加入缓存路径，下次修改时前置节点仍会经过，`false` 表示按新路径导航。 */
-  isCache?: boolean;
-  /** 导航规划路径颜色。 */
-  planColor?: string;
-  /** 导航已走过的路径颜色。 */
-  passColor?: string;
-  /** 导航规划线的宽度，默认 1。 */
-  lineWidth?: number;
-  /** 是否自动播放，默认 `true`。 */
-  isAutoPlay?: boolean;
-  /** 场景的模型路径，可为空；为空时根据 id 到场景中寻找模型对象。 */
-  assetPath?: string;
-  /** 是否自动清除，默认 `true`。 */
-  isAutoClear?: boolean;
-  offSetZ?: number;
+interface QosSessionContext {
+  sessionId: string;
+  traceId: string;
+  runMode: string;
+  viewMode: string;
 }
 /**
- * Navigation.pauseMeshNav / resumeMeshNav / stopMeshNav / pauseNavPath / resumeNavPath / stopNavPath 参数。
+ * 运行环境上下文。
  */
-interface NavigationNodeRequest {
-  /** 对象组的父对象，可以为空。 */
-  parentId?: string;
-  /** 对象名称数组集合。 */
-  id: string;
+interface QosRuntimeContext {
+  appId?: string;
+  env?: string;
+  pageUrl?: string;
+  userAgent?: string;
 }
 /**
- * Navigation.updateMeshNav 参数。
+ * warn/error 聚合统计指标。
  */
-interface NavigationUpdateMeshNavRequest {
-  /** 对象组的父对象，可以为空。 */
-  parentId?: string;
-  /** 对象名称数组集合。 */
-  id: string;
-  /** 物体移动的速度，默认 -1（不改变速度）。 */
-  speed?: number;
-  /** 导航规划路径颜色。 */
-  planColor?: string;
-  /** 导航已走过的路径颜色。 */
-  passColor?: string;
-}
-interface NavigationUpdateSpeedRequest {
-  /** 对象组的父对象，可以为空。 */
-  parentId?: string;
-  /** 对象名称数组集合。 */
-  id: string;
-  /** 物体移动的速度，默认 -1（不改变速度）。 */
-  speed?: number;
+interface QosWarnErrorSummary {
+  logWarnCount: number;
+  logErrorCount: number;
+  logErrorByStage: Partial<Record<QosStage, number>>;
+  logErrorTopCodes: Array<{
+    code: string;
+    count: number;
+  }>;
 }
 /**
- * Navigation.startNavByPath 参数。
+ * QoS 事件结构。
  */
-interface NavigationNavByPathRequest {
-  /** 对象组的父对象，可以为空。 */
-  parentId?: string;
-  /** 对象名称数组集合。 */
-  id: string[];
-  /** 路径节点数组集合。 */
-  nodes: Vector3Input[];
-  /** 是否作为导航缓存路径点，默认 `true`。 */
-  isCache?: boolean;
-  /** 导航轨迹总时间（秒），默认 10。 */
-  duration?: number;
-  /** 导航规划路径颜色。 */
-  planColor?: string;
-  /** 导航已走过的路径颜色。 */
-  passColor?: string;
+interface QosEvent {
+  eventName: QosEventName;
+  stage: QosStage;
+  status: QosStatus;
+  ts: number;
+  level: QosLevel;
+  durationMs?: number;
+  errorCode?: string;
+  errorMessage?: string;
+  attrs?: Record<string, unknown>;
+  metrics?: Record<string, unknown>;
 }
 /**
- * Navigation.updateNavPath 参数。
+ * QoS 批量上报载荷。
  */
-interface NavigationUpdateNavPathRequest {
-  /** 对象组的父对象，可以为空。 */
-  parentId?: string;
-  /** 对象名称数组集合。 */
-  id: string[];
-  /** 导航轨迹总时间（秒），默认 -1（不改变时长）。 */
-  duration?: number;
-  /** 导航规划路径颜色。 */
-  planColor?: string;
-  /** 导航已走过的路径颜色。 */
-  passColor?: string;
+interface QosReportingPayload {
+  schemaVersion: '1.0.0';
+  source: 'enginesdk3';
+  sdkVersion: string;
+  sentAt: number;
+  session: QosSessionContext;
+  context: QosRuntimeContext;
+  events: QosEvent[];
 }
 //#endregion
 //#region src/types/response.d.ts
@@ -2452,6 +2587,7 @@ declare class PixelStreamingAdapter {
   private readonly modeStrategy;
   private readonly psConfig;
   private readonly streamerAssignedListeners;
+  private readonly videoElementParent?;
   /**
    * 使用 SDK 提供的配置创建并初始化 PixelStreaming 运行时。
    */
@@ -2508,6 +2644,8 @@ declare class PixelStreamingAdapter {
    * 返回底层运行时是否处于重连状态。
    */
   isReconnecting(): boolean;
+  private readonly handlePoiCursorResponse;
+  private setVideoCursor;
   /**
    * 设置 DTC 多 streamer 架构的 streamerAssigned 监听器。
    * 当信令服务器分配 streamer 后，自动设置 StreamerId 到配置中。
@@ -2558,6 +2696,20 @@ interface StreamRequestPromise<TResult> extends Promise<ApiResponseEnvelope<TRes
   readonly requestId: string;
   cancel: (reason?: string) => void;
 }
+/**
+ * 发送失败（UE 交互通道/视频未就绪）时的排队重试配置。
+ */
+interface RequestSendRetryOptions {
+  /**
+   * 是否在发送失败时排队重试（底层 Pixel Streaming 在视频 `readyState` 为 0 时会拒绝发送）。
+   * 默认 `true`。
+   */
+  enabled?: boolean;
+  /** 重试间隔（毫秒），默认 250。 */
+  intervalMs?: number;
+  /** 排队重试的最大等待时长（毫秒），超时仍未发出则 reject，默认 15000。 */
+  maxWaitMs?: number;
+}
 /**
  * RequestBridge 的 QoS 生命周期钩子。
  */
@@ -2586,6 +2738,14 @@ declare class RequestBridge {
    * 等待 UE 响应的进行中请求集合。
    */
   private pending;
+  /**
+   * 因 UE 交互通道未就绪而排队等待重发的请求集合。
+   */
+  private sendRetries;
+  /**
+   * 发送失败排队重试配置。
+   */
+  private readonly retryOptions;
   /**
    * SDK 运行时固定使用的响应事件通道名。
    */
@@ -2605,7 +2765,7 @@ declare class RequestBridge {
   /**
    * 初始化时立即注册响应监听，确保所有 API 调用共享同一桥接器。
    */
-  constructor(session: PixelStreamingAdapter, logger?: ModuleLogger, hooks?: RequestBridgeHooks);
+  constructor(session: PixelStreamingAdapter, logger?: ModuleLogger, hooks?: RequestBridgeHooks, retryOptions?: RequestSendRetryOptions);
   /**
    * 向 UE 发送请求信封，并在匹配响应到达后完成 Promise。
    */
@@ -2616,6 +2776,17 @@ declare class RequestBridge {
    */
   sendStreamRequest<TPayload, TResult>(module: string, method: string, payload?: TPayload, callback?: StreamRequestCallback<TResult>): StreamRequestPromise<TResult>;
   private sendPendingRequest;
+  /**
+   * 处理一次发送尝试：底层通道未就绪导致失败时按配置排队重试，
+   * 避免视频尚未就绪（`readyState === 0`）瞬间的请求被直接丢弃。
+   */
+  private handleSendAttempt;
+  private scheduleSendRetry;
+  private runSendRetry;
+  /**
+   * 清理指定请求的排队重试状态（取消定时器）。
+   */
+  private clearSendRetry;
   private settlePendingFailure;
   private handleResponse;
   private createRequestEnvelope;
@@ -4154,7 +4325,7 @@ declare class Navigation extends BaseApi {
      * @agentSideEffects write
      * @agentPreconditions DTCEngine 已完成鉴权并建立 WebRTC 连接
      * @agentRiskLevel low
-     * @agentExample { parentId: 'Players', id: 'Player1' nodes: [{ x: 114.7985155712282, y: 34.842421780635625, z: 2 }, { x: 114.79789723105696, y: 34.84218433379876, z: 1.5 }], isCache: false, planColor: '#00ff00', passColor: '#e1e1e1' }
+     * @agentExample { parentId: 'Players', id: 'Player1', nodes: [{ x: 114.7985155712282, y: 34.842421780635625, z: 2 }, { x: 114.79789723105696, y: 34.84218433379876, z: 1.5 }], isCache: false, planColor: '#00ff00', passColor: '#e1e1e1' }
      * @example
      * ```ts
       dtcEngine.Navigation.startNav({
@@ -4431,22 +4602,22 @@ declare class PathPatrol extends BaseApi {
    */
   add(payload: PathPatrolAddRequest, callback?: StreamRequestCallback<unknown>): StreamRequestPromise<unknown>;
   /**
-   * 修改巡逻路径的样式。
-   * @param payload - 巡逻样式参数。
-   * @param callback - 可选回调函数。
-   * @returns Promise 形式的接口响应。
-   * @agentSideEffects write
-   * @agentPreconditions DTCEngine 已完成鉴权并建立 WebRTC 连接
-   * @agentRiskLevel low
-   * @agentExample { parentId: 'patrolLayer', id: 'patrolMan', lineColor: '#ff00ff', lineWidth: 3.5 }
-   * @example
-   * ```ts
-   * dtcEngine.PathPatrol.update(
-   *   { parentId: 'patrolLayer', id: 'patrolMan', lineColor: '#ff00ff', lineWidth: 3.5 },
-   *   (result) => { console.log(result); }
-   * );
-   * ```
-   */
+     * 修改巡逻路径的样式。
+     * @param payload - 巡逻样式参数。
+     * @param callback - 可选回调函数。
+     * @returns Promise 形式的接口响应。
+     * @agentSideEffects write
+     * @agentPreconditions DTCEngine 已完成鉴权并建立 WebRTC 连接
+     * @agentRiskLevel low
+     * @agentExample { parentId: 'patrolLayer', id: 'patrolMan', lineColor: '#ff00ff', lineWidth: 3.5 }
+     * @example
+     * ```ts
+      dtcEngine.PathPatrol.update(
+        { parentId: 'patrolLayer', id: 'patrolMan', lineColor: '#ff00ff', lineWidth: 3.5 },
+        (result) => { console.log(result); }
+      );
+     * ```
+     */
   update(payload: PathPatrolUpdateRequest, callback?: ApiCallback<ApiResponseEnvelope<unknown>>): Promise<ApiResponseEnvelope<unknown>>;
   /**
    * 设置巡逻开始的时间节点或是节点索引。
@@ -5357,6 +5528,97 @@ declare class WebView extends BaseApi {
   updateWebView(payload: WebViewUpdateRequest, callback?: ApiCallback<ApiResponseEnvelope<unknown>>): Promise<ApiResponseEnvelope<unknown>>;
 }
 //#endregion
+//#region src/api/SpatialQuery.d.ts
+/**
+ * 场景缓冲空间查询 API，支持三种查询方式：
+ * 1. 根据场景模型当前的位置进行空间查询；
+ * 2. 根据场景坐标位置进行空间查询；
+ * 3. 根据场景模型的边界框进行空间查询。
+ * @agentTitle 空间查询
+ * @agentCapabilities 模型空间查询, 坐标空间查询, 模型包围盒空间查询
+ * @hideconstructor
+ */
+declare class SpatialQuery extends BaseApi {
+  constructor(bridge: ApiBridge, runtimeOptions?: BaseApiRuntimeOptions);
+  /**
+     * 模型空间查询：根据场景模型当前的位置进行空间查询。
+     * 默认值：`queryRadius=50`、`queryMinHeight=0`、`queryMaxHeight=20`。
+     * `queryParentIds` 不能为空，至少指定一个查询的图层组编号。
+     * @param payload - 空间查询参数。
+     * @param callback - 可选回调函数。
+     * @returns Promise 形式的接口响应。
+     * @agentSideEffects write
+     * @agentPreconditions DTCEngine 已完成鉴权并建立 WebRTC 连接
+     * @agentRiskLevel low
+     * @agentExample { parentId: '', id: 'LayerSearchCore', queryRadius: 10, queryMinHeight: 0, queryMaxHeight: 50, queryParentIds: ['SM_B8_XueShenSuShe', 'daoZha'] }
+     * @example
+     * ```ts
+      dtcEngine.SpatialQuery.layerQueryByModel(
+        {
+          parentId: '',
+          id: 'LayerSearchCore',
+          queryRadius: 10,
+          queryMinHeight: 0,
+          queryMaxHeight: 50,
+          queryParentIds: ['SM_B8_XueShenSuShe', 'daoZha']
+        },
+        (result) => { console.log(result); }
+      );
+     * ```
+     */
+  layerQueryByModel(payload: SpatialQueryLayerByModelRequest, callback?: ApiCallback<ApiResponseEnvelope<unknown>>): Promise<ApiResponseEnvelope<unknown>>;
+  /**
+     * 坐标空间查询：根据场景坐标位置进行空间查询。
+     * 默认值：`queryRadius=50`、`queryMinHeight=0`、`queryMaxHeight=20`。
+     * `queryParentIds` 不能为空，至少指定一个查询的图层组编号。
+     * @param payload - 空间查询参数。
+     * @param callback - 可选回调函数。
+     * @returns Promise 形式的接口响应。
+     * @agentSideEffects write
+     * @agentPreconditions DTCEngine 已完成鉴权并建立 WebRTC 连接
+     * @agentRiskLevel low
+     * @agentExample { queryPosition: { x: 120.40284254780221, y: 30.830451474524036, z: 10, ePSGType: '4326' }, queryRadius: 20, queryMinHeight: 0, queryMaxHeight: 50, queryParentIds: ['SM_B8_XueShenSuShe', 'daoZha'] }
+     * @example
+     * ```ts
+      dtcEngine.SpatialQuery.layerQueryByPosition(
+        {
+          queryPosition: new dtcEngine.Type.Vector3(120.2076273621342, 30.372304875047895, 16.01983620418444),
+          queryRadius: 20,
+          queryMinHeight: 0,
+          queryMaxHeight: 50,
+          queryParentIds: ['SM_B8_XueShenSuShe', 'daoZha']
+        }, (res) => {
+          console.log(res);
+        }
+      );
+     * ```
+     */
+  layerQueryByPosition(payload: SpatialQueryLayerByPositionRequest, callback?: ApiCallback<ApiResponseEnvelope<unknown>>): Promise<ApiResponseEnvelope<unknown>>;
+  /**
+     * 模型包围盒空间查询：根据场景模型的边界框进行空间查询。
+     * `queryParentIds` 不能为空，至少指定一个查询的图层组编号。
+     * @param payload - 空间查询参数。
+     * @param callback - 可选回调函数。
+     * @returns Promise 形式的接口响应。
+     * @agentSideEffects write
+     * @agentPreconditions DTCEngine 已完成鉴权并建立 WebRTC 连接
+     * @agentRiskLevel low
+     * @agentExample { parentId: '', id: 'LayerSearchCore', queryParentIds: ['JianKong_QiangJiTest', 'daoZha'] }
+     * @example
+     * ```ts
+      dtcEngine.SpatialQuery.layerQueryByModelBox(
+        {
+          parentId: '',
+          id: 'LayerSearchCore',
+          queryParentIds: ['JianKong_QiangJiTest', 'daoZha']
+        },
+        (result) => { console.log(result); }
+      );
+     * ```
+     */
+  layerQueryByModelBox(payload: SpatialQueryLayerByModelBoxRequest, callback?: ApiCallback<ApiResponseEnvelope<unknown>>): Promise<ApiResponseEnvelope<unknown>>;
+}
+//#endregion
 //#region src/api/validationSchemas.d.ts
 /**
  * 未覆盖模块的校验占位清单：
@@ -5499,6 +5761,7 @@ interface ApiInstanceMap {
   TimeLine: TimeLine;
   WeatherSystem: WeatherSystem;
   WebView: WebView;
+  SpatialQuery: SpatialQuery;
 }
 type ApiModuleKey = keyof ApiInstanceMap;
 /**
@@ -5597,6 +5860,67 @@ interface AgentBridgeRuntimeSnapshot {
   metadata?: Record<string, string>;
   engine?: AgentBridgeRuntimeEngineSnapshot;
 }
+type AgentBridgeBusinessProgramPermissionMode = 'query' | 'stage' | 'stream';
+interface AgentBridgeBusinessProgramManifest {
+  schemaVersion: 1;
+  programId: string;
+  version: string;
+  entry: {
+    file: string;
+    sha256: string;
+  };
+  data: Array<{
+    name: string;
+    file: string;
+    sha256: string;
+  }>;
+  inputSchema: Record<string, unknown>;
+  permissions: {
+    methods: Array<{
+      module: string;
+      method: string;
+      mode: AgentBridgeBusinessProgramPermissionMode;
+    }>;
+  };
+  limits: {
+    timeoutMs: number;
+    maxSdkCalls: number;
+    maxStageActions: number;
+    maxTotalDelayMs: number;
+    maxEventCount: number;
+    maxBundleBytes: number;
+    maxDataBytes: number;
+  };
+  risk: 'low' | 'medium' | 'high';
+}
+interface AgentBridgeLoadProgramRequest {
+  capsuleHash: string;
+  manifest: AgentBridgeBusinessProgramManifest;
+  bundle: string;
+  data: Record<string, string>;
+}
+interface AgentBridgeStartProgramRequest {
+  executionId: string;
+  capsuleHash: string;
+  inputs: unknown;
+  traceId: string;
+}
+interface AgentBridgeCancelProgramRequest {
+  executionId: string;
+  reason?: string;
+}
+interface AgentBridgeProgramEventPayload {
+  executionId: string;
+  traceId: string;
+  event: {
+    type: 'started' | 'progress' | 'action' | 'completed' | 'failed' | 'cancelled';
+    phase?: string;
+    message?: string;
+    data?: unknown;
+  };
+  terminal: boolean;
+  state?: 'running' | 'completed' | 'failed' | 'cancelled';
+}
 /** API 方法副作用描述，用于帮助 Agent 判断调用风险。 */
 type AgentBridgeMethodSideEffect = 'read' | 'write' | 'connection' | 'stream';
 /** API 的响应模式；与副作用风险是两个独立维度。 */
@@ -5653,7 +5977,7 @@ interface AgentBridgeMethodSchemaMetadata {
   responseMode: AgentBridgeMethodResponseMode;
 }
 /** bridge 统一错误码。 */
-type AgentBridgeErrorCode = 'API_NOT_FOUND' | 'API_NOT_EXPOSED' | 'METHOD_SCHEMA_NOT_FOUND' | 'SDK_NOT_READY' | 'INVALID_PAYLOAD' | 'API_EXECUTION_FAILED' | 'API_NOT_STREAMING' | 'STREAM_INVOKE_REQUIRED' | 'PROTOCOL_ERROR' | 'BRIDGE_NOT_CONNECTED';
+type AgentBridgeErrorCode = 'API_NOT_FOUND' | 'API_NOT_EXPOSED' | 'METHOD_SCHEMA_NOT_FOUND' | 'SDK_NOT_READY' | 'INVALID_PAYLOAD' | 'API_EXECUTION_FAILED' | 'API_NOT_STREAMING' | 'STREAM_INVOKE_REQUIRED' | 'PROTOCOL_ERROR' | 'BRIDGE_NOT_CONNECTED' | 'PROGRAM_INVALID' | 'PROGRAM_EXECUTION_FAILED';
 /**
  * bridge 结构化错误。
  */
@@ -5684,6 +6008,23 @@ interface AgentBridgeInvokeRequest {
   methodName: string;
   payload?: unknown;
 }
+/** 通用 Action Plan 在真正执行前提交给页面侧进行真实 schema 校验。 */
+interface AgentBridgeValidateAction extends AgentBridgeInvokeRequest {
+  id: string;
+  responseMode: 'single';
+}
+interface AgentBridgeValidateActionsRequest {
+  actions: AgentBridgeValidateAction[];
+}
+interface AgentBridgeValidateActionItem {
+  id: string;
+  valid: boolean;
+  error?: AgentBridgeStructuredError;
+}
+interface AgentBridgeValidateActionsResult {
+  valid: boolean;
+  items: AgentBridgeValidateActionItem[];
+}
 /** 启动流式 API 请求。streamId 由 MCP server 创建，用于跨进程关联事件。 */
 interface AgentBridgeStreamStartRequest extends AgentBridgeInvokeRequest {
   streamId: string;
@@ -5729,10 +6070,15 @@ interface AgentBridgeRuntimeAdapter {
   listModules(): AgentBridgeModuleCatalogItem[];
   listMethods(moduleName: string): AgentBridgeOperationResult<AgentBridgeMethodCatalogItem[]>;
   getMethodSchema(moduleName: string, methodName: string): AgentBridgeOperationResult<AgentBridgeMethodSchemaMetadata>;
+  validateActions(request: AgentBridgeValidateActionsRequest): AgentBridgeOperationResult<AgentBridgeValidateActionsResult>;
   invoke(request: AgentBridgeInvokeRequest): Promise<AgentBridgeOperationResult<unknown>>;
   startStream(request: AgentBridgeStreamStartRequest, onEvent: AgentBridgeStreamEventListener): Promise<AgentBridgeOperationResult<AgentBridgeStreamStartResult>>;
   closeStream(request: AgentBridgeStreamCloseRequest): Promise<AgentBridgeOperationResult<AgentBridgeStreamCloseResult>>;
+  loadProgram(request: AgentBridgeLoadProgramRequest): Promise<AgentBridgeOperationResult<unknown>>;
+  startProgram(request: AgentBridgeStartProgramRequest, onEvent: (payload: AgentBridgeProgramEventPayload) => void): Promise<AgentBridgeOperationResult<unknown>>;
+  cancelProgram(request: AgentBridgeCancelProgramRequest): Promise<AgentBridgeOperationResult<unknown>>;
   closeAllStreams?(reason?: string): void;
+  cancelAllPrograms?(reason?: string): void;
 }
 /** createBridgeRuntime 内部保存的浏览器流句柄。 */
 interface AgentBridgeActiveStream {
@@ -5747,7 +6093,7 @@ declare const AGENT_BRIDGE_PROTOCOL_VERSION = "sdk3-agent-bridge/v1";
 /**
  * 浏览器侧 bridge 与 MCP 服务端之间的协议消息类型。
  */
-type AgentBridgeMessageType = 'register' | 'unregister' | 'heartbeat' | 'catalog' | 'schema' | 'invoke' | 'stream-start' | 'stream-close' | 'stream-event' | 'result';
+type AgentBridgeMessageType = 'register' | 'unregister' | 'heartbeat' | 'catalog' | 'schema' | 'validate-actions' | 'invoke' | 'stream-start' | 'stream-close' | 'stream-event' | 'load-program' | 'start-program' | 'cancel-program' | 'program-event' | 'result';
 /**
  * 所有协议消息的基础信封。
  */
@@ -5756,6 +6102,7 @@ interface AgentBridgeMessageEnvelope<TPayload = unknown> {
   protocolVersion: typeof AGENT_BRIDGE_PROTOCOL_VERSION;
   bridgeId?: string;
   callId?: string;
+  traceId?: string;
   ts: number;
   payload: TPayload;
 }
@@ -5765,8 +6112,11 @@ interface AgentBridgeRegisterPayload extends AgentBridgeRuntimeSnapshot {
   capabilities: {
     catalog: true;
     schema: true;
+    validateActions: true;
     invoke: true;
     stream: true;
+    businessPrograms: true;
+    businessProgramProtocolVersion: 1;
   };
 }
 /** 关闭消息携带的原因。 */
@@ -5790,16 +6140,21 @@ interface AgentBridgeSchemaRequestPayload {
 }
 /** invoke 请求。 */
 type AgentBridgeInvokeRequestPayload = AgentBridgeInvokeRequest;
+type AgentBridgeValidateActionsRequestPayload = AgentBridgeValidateActionsRequest;
 /** 流式 invoke 与关闭请求。 */
 type AgentBridgeStreamStartRequestPayload = AgentBridgeStreamStartRequest;
 type AgentBridgeStreamCloseRequestPayload = AgentBridgeStreamCloseRequest;
+type AgentBridgeLoadProgramRequestPayload = AgentBridgeLoadProgramRequest;
+type AgentBridgeStartProgramRequestPayload = AgentBridgeStartProgramRequest;
+type AgentBridgeCancelProgramRequestPayload = AgentBridgeCancelProgramRequest;
 /** result 消息。 */
 interface AgentBridgeResultPayload<TData = unknown> {
-  requestType: 'catalog' | 'schema' | 'invoke' | 'stream-start' | 'stream-close';
+  requestType: 'catalog' | 'schema' | 'validate-actions' | 'invoke' | 'stream-start' | 'stream-close' | 'load-program' | 'start-program' | 'cancel-program';
   result: AgentBridgeOperationResult<TData>;
+  traceId?: string;
 }
-type AgentBridgeInboundMessage = AgentBridgeMessageEnvelope<AgentBridgeCatalogRequestPayload> | AgentBridgeMessageEnvelope<AgentBridgeSchemaRequestPayload> | AgentBridgeMessageEnvelope<AgentBridgeInvokeRequestPayload> | AgentBridgeMessageEnvelope<AgentBridgeStreamStartRequestPayload> | AgentBridgeMessageEnvelope<AgentBridgeStreamCloseRequestPayload>;
-type AgentBridgeOutboundMessage = AgentBridgeMessageEnvelope<AgentBridgeRegisterPayload> | AgentBridgeMessageEnvelope<AgentBridgeUnregisterPayload> | AgentBridgeMessageEnvelope<AgentBridgeHeartbeatPayload> | AgentBridgeMessageEnvelope<AgentBridgeStreamEventPayload> | AgentBridgeMessageEnvelope<AgentBridgeResultPayload>;
+type AgentBridgeInboundMessage = AgentBridgeMessageEnvelope<AgentBridgeCatalogRequestPayload> | AgentBridgeMessageEnvelope<AgentBridgeSchemaRequestPayload> | AgentBridgeMessageEnvelope<AgentBridgeValidateActionsRequestPayload> | AgentBridgeMessageEnvelope<AgentBridgeInvokeRequestPayload> | AgentBridgeMessageEnvelope<AgentBridgeStreamStartRequestPayload> | AgentBridgeMessageEnvelope<AgentBridgeStreamCloseRequestPayload> | AgentBridgeMessageEnvelope<AgentBridgeLoadProgramRequestPayload> | AgentBridgeMessageEnvelope<AgentBridgeStartProgramRequestPayload> | AgentBridgeMessageEnvelope<AgentBridgeCancelProgramRequestPayload>;
+type AgentBridgeOutboundMessage = AgentBridgeMessageEnvelope<AgentBridgeRegisterPayload> | AgentBridgeMessageEnvelope<AgentBridgeUnregisterPayload> | AgentBridgeMessageEnvelope<AgentBridgeHeartbeatPayload> | AgentBridgeMessageEnvelope<AgentBridgeStreamEventPayload> | AgentBridgeMessageEnvelope<AgentBridgeProgramEventPayload> | AgentBridgeMessageEnvelope<AgentBridgeResultPayload>;
 //#endregion
 //#region src/agentBridge/AgentRuntimeBridge.d.ts
 interface AgentBridgeSocket {
@@ -5851,11 +6206,21 @@ declare class AgentRuntimeBridge {
   private clearHeartbeat;
   private handleMessage;
   private sendStreamEvent;
+  private sendProgramEvent;
   private sendResult;
   private send;
   private clearSocketHandlers;
 }
 //#endregion
+//#region src/agentBridge/businessProgram/BusinessProgramRuntime.d.ts
+interface BusinessProgramWorker {
+  onmessage: ((event: MessageEvent) => void) | null;
+  onerror: ((event: ErrorEvent) => void) | null;
+  postMessage(message: unknown): void;
+  terminate(): void;
+}
+type BusinessProgramWorkerFactory = (source: string) => BusinessProgramWorker;
+//#endregion
 //#region src/agentBridge/createBridgeRuntime.d.ts
 interface AgentBridgeRuntimeFactoryOptions {
   bridgeId?: string;
@@ -5867,11 +6232,14 @@ interface AgentBridgeRuntimeFactoryOptions {
   getAuthSnapshot?: () => AuthSessionSnapshot;
   mockInvoke?: boolean;
 }
+interface AgentBridgeRuntimeFactoryDependencies {
+  businessProgramWorkerFactory?: BusinessProgramWorkerFactory;
+}
 /**
  * 将 DTCEngine 适配为 bridge 可消费的运行时接口。
  * 这里负责权限、ready 状态和 API 调用收口，WebSocket 协议由 AgentRuntimeBridge 处理。
  */
-declare function createBridgeRuntime(engine: DTCEngine, options?: AgentBridgeRuntimeFactoryOptions): AgentBridgeRuntimeAdapter;
+declare function createBridgeRuntime(engine: DTCEngine, options?: AgentBridgeRuntimeFactoryOptions, dependencies?: AgentBridgeRuntimeFactoryDependencies): AgentBridgeRuntimeAdapter;
 //#endregion
 //#region src/agentBridge/metadataGenerator/buildAgentBridgeMetadata.d.ts
 interface AgentBridgeGeneratedMethodMetadata extends AgentBridgeMethodCatalogItem {
@@ -5898,6 +6266,66 @@ declare function listAgentBridgeModules(expose?: AgentBridgeExposeConfig): Agent
 declare function listAgentBridgeMethods(moduleName: ApiModuleKey, expose?: AgentBridgeExposeConfig): AgentBridgeMethodCatalogItem[];
 declare function getAgentBridgeMethodSchema(moduleName: ApiModuleKey, methodName: string, expose?: AgentBridgeExposeConfig): AgentBridgeMethodSchemaMetadata | undefined;
 //#endregion
+//#region src/orchestration/BuildingFloor.d.ts
+type BuildingFloorErrorCode = 'INVALID_REGISTRATION' | 'BUILDING_ALREADY_REGISTERED' | 'BUILDING_NOT_REGISTERED' | 'FLOOR_NOT_FOUND' | 'MODEL_INFO_INVALID';
+/** 建筑楼层 API 配置或运行状态错误。 */
+declare class BuildingFloorError extends Error {
+  readonly code: BuildingFloorErrorCode;
+  readonly buildingId?: string | undefined;
+  readonly floorId?: string | undefined;
+  readonly name = "BuildingFloorError";
+  constructor(code: BuildingFloorErrorCode, message: string, buildingId?: string | undefined, floorId?: string | undefined);
+}
+interface BuildingFloorDependencies {
+  model: Pick<Model, 'getModelInfo' | 'setVisible'>;
+  modelTransform: Pick<ModelTransform, 'startMoveByNodes' | 'endMove'>;
+  camera: Pick<Camera, 'flyToTarget' | 'lookAt'>;
+}
+interface BuildingFloorRuntimeOptions {
+  logger?: ModuleLogger;
+}
+/**
+ * 建筑楼层高级编排 API。
+ *
+ * 组合模型查询、模型显隐、模型移动和相机定位能力，为项目提供统一的楼层切换状态机。
+ */
+declare class BuildingFloor {
+  private readonly dependencies;
+  private readonly buildings;
+  private readonly logger;
+  constructor(dependencies: BuildingFloorDependencies, runtimeOptions?: BuildingFloorRuntimeOptions);
+  register(building: BuildingFloorRegistration): Promise<BuildingFloorRegistrationResult>;
+  register(buildings: BuildingFloorRegistration[]): Promise<BuildingFloorRegistrationResult>;
+  switchTo(options: BuildingFloorSwitchOptions): Promise<BuildingFloorTransitionResult>;
+  showOverview(options: BuildingFloorOverviewOptions): Promise<BuildingFloorTransitionResult>;
+  cancel(options: BuildingFloorCancelOptions): Promise<void>;
+  getState(options: BuildingFloorStateOptions): BuildingFloorState;
+  private normalizeRegistrations;
+  private normalizeFloor;
+  private normalizeObjectIds;
+  private validateViewPoint;
+  private requireNonEmptyString;
+  private assertBuildingsRemainAvailable;
+  private measureFloorPositions;
+  private extractPosition;
+  private requireBuilding;
+  private transition;
+  private schedule;
+  private scheduleCompletion;
+  private completeTransition;
+  private focusTarget;
+  private failTransition;
+  private settleTransition;
+  private stopActiveTransition;
+  private stopActiveMoves;
+  private createResult;
+  private getHideOffset;
+  private getAccessoryObjectIds;
+  private getBatchDurationMs;
+  private getMotionSpeed;
+  private positionAtZ;
+}
+//#endregion
 //#region src/application/DTCEngine.d.ts
 /**
  * DTCEngine 对外构造参数。
@@ -6066,6 +6494,8 @@ declare class DTCEngine {
   readonly ModelPOI: ApiInstanceMap['ModelPOI'];
   /** 模型变换模块。 */
   readonly ModelTransform: ApiInstanceMap['ModelTransform'];
+  /** 建筑楼层分层控制模块。 */
+  readonly BuildingFloor: BuildingFloor;
   /** 路径巡逻模块。 */
   readonly PathPatrol: ApiInstanceMap['PathPatrol'];
   /** 高亮效果模块。 */
@@ -6285,4 +6715,4 @@ declare class SDKValidationError extends Error {
   toJSON(): Record<string, unknown>;
 }
 //#endregion
-export { AGENT_BRIDGE_API_METADATA, type AGENT_BRIDGE_PROTOCOL_VERSION, API_MODULE_KEYS, type AgentBridgeActiveStream, type AgentBridgeCatalogRequestPayload, type AgentBridgeErrorCode, type AgentBridgeExposeConfig, type AgentBridgeHeartbeatPayload, type AgentBridgeInboundMessage, type AgentBridgeInvokeRequest, type AgentBridgeInvokeRequestPayload, type AgentBridgeMessageEnvelope, type AgentBridgeMessageType, type AgentBridgeMethodCatalogItem, type AgentBridgeMethodResponseMode, type AgentBridgeMethodSchemaMetadata, type AgentBridgeMethodSideEffect, type AgentBridgeModuleCatalogItem, type AgentBridgeOperationResult, type AgentBridgeOutboundMessage, type AgentBridgeReconnectOptions, type AgentBridgeRegisterPayload, type AgentBridgeResultPayload, type AgentBridgeRuntimeAdapter, type AgentBridgeRuntimeEngineSnapshot, type AgentBridgeRuntimeFactoryOptions, type AgentBridgeRuntimeSnapshot, type AgentBridgeSchemaEnumOption, type AgentBridgeSchemaField, type AgentBridgeSchemaFieldType, type AgentBridgeSchemaRequestPayload, type AgentBridgeSocket, type AgentBridgeSocketFactory, type AgentBridgeStreamCloseRequest, type AgentBridgeStreamCloseRequestPayload, type AgentBridgeStreamCloseResult, type AgentBridgeStreamEventListener, type AgentBridgeStreamEventPayload, type AgentBridgeStreamStartRequest, type AgentBridgeStreamStartRequestPayload, type AgentBridgeStreamStartResult, type AgentBridgeStreamTerminalReason, type AgentBridgeStructuredError, type AgentBridgeUnregisterPayload, AgentRuntimeBridge, type AgentRuntimeBridgeDependencies, Animation, type AnimationGetLengthRequest, type AnimationPlayRequest, type AnimationSetSpeedRequest, type AnimationStartLoopRequest, type AnimationStopLoopRequest, type AnimationStopRequest, type ApiCallback, type ApiFacade, type ApiInstanceMap, type ApiModuleFactory, type ApiModuleKey, type ApiRegistry, type ApiRegistryContext, ApiRegistryError, type ApiRequestEnvelope, type ApiResponseEnvelope, type AuthErrorInfo, type AuthSessionSnapshot, type AuthWorkflowState, Camera, type CameraFlyByPathRequest, type CameraFlyToTargetRequest, type CameraLookAtRequest, type CameraObjFollowRequest, type CameraSetFlySpeedRequest, type CameraSetFovRequest, type CameraSetPositionAndRotationRequest, type CenterConnectResult, type CenterEnvelope, type CenterServiceInfo, type CenterTokenAuthorizeResult, Connect, DTCEngine, type DTCEngineAgentBridgeOptions, Dlss, DlssQuality, type DlssSetEnableRequest, type DlssSetQualityRequest, type EngineConfig, type EngineLogLevel, type EngineStatusInfo, type EngineViewMode, type FeatureToggleRequest, FilterMode, type GetWeatherTypeRequest, HeatMap, type HeatMapConfigRequest, type HeatMapCreateRequest, type HeatMapPointRequest, type HeatMapRemoveRequest, HighLighterEffect, type HighLighterEnableRequest, type HighLighterRemoveHighLightModelRequest, type HighLighterSetHighLightModelRequest, Layer, type LayerAddRequest, type LayerChildElementRequest, LayerEnum, type LayerModelAddRequest, type LayerModelRemoveRequest, type LayerPOIAddRequest, type LayerSelectorRequest, type LayerShowUIPopRequest, type LayerSwitchModelRequest, Model, type ModelAddRequest, type ModelBoundsRequest, ModelPOI, type ModelPOIAddRequest, type ModelPOIDeleteByGroupRequest, type ModelPOIDeleteByIdRequest, type ModelPOIGetInfoRequest, type ModelPOIUpdateRequest, type ModelPOIVisibleByGroupRequest, type ModelRemoveRequest, type ModelSelectorRequest, type ModelSetVisibleByAttributeRequest, type ModelSetVisibleByTagsRequest, type ModelSetVisibleRequest, ModelTransform, type ModelTransformNodeRequest, type ModelTransformRestoreRequest, type ModelTransformRotateByTargetRequest, type ModelTransformRotateRequest, type ModelTransformScaleRequest, type ModelTransformStartMoveRequest, ModelTransformType, Navigation, type NavigationMeshNavRequest, type NavigationNavByPathRequest, type NavigationNodeRequest, type NavigationUpdateMeshNavRequest, type NavigationUpdateNavPathRequest, type NavigationUpdateSpeedRequest, type NetworkAdaptationActionResult, type NetworkAdaptationActionStep, type NetworkAdaptationActionType, type NetworkAdaptationLevel, type NetworkAdaptationMode, type NetworkAdaptationState, type NetworkDecisionTrace, type NetworkDiagnosticsSnapshot, type NetworkMetricsSnapshot, PathPatrol, type PathPatrolAddRequest, type PathPatrolNodeRequest, type PathPatrolSetTimeNodeRequest, type PathPatrolUpdateRequest, PendingValidationSchemaMap, Popup, type PopupAddRequest, type PopupDelayRequest, type PopupItemRequest, type PopupRemoveRequest, type PopupShowDistanceRequest, type PopupShowRequest, type PopupSyncInfoRequest, type QOS_EVENT_NAMES, type QosEvent, type QosEventName, type QosLevel, type QosReportingPayload, type QosRuntimeContext, type QosSessionContext, type QosStage, type QosStatus, type QosWarnErrorSummary, type ResolvedEngineConfig, SDKValidationError, Scene, type SceneListenCompassRequest, type SceneSwitchRequest, Screen, ScreenRenderBitratePreset, ScreenRenderBitratePresetOptions, type ScreenRenderBitratePresetValueMap, type ScreenSetSceneFPSRequest, type ScreenSetSceneRenderBitrateRequest, type ScreenSetScreenResolutionRequest, type ScreenSetVideoDecodeRequest, Season, type SignallingAllocateResponse, type StandardResponse, TimeLine, type TimeSerialNode, type TimelineNodeRequest, type TimelinePlayRequest, type TimelineSetSpeedRequest, type TimelineStopRequest, UIPOI, type UIPOIAddRequest, type UIPOIDeleteByGroupRequest, type UIPOIDeleteByIdRequest, type UIPOIEnableOverlapRequest, type UIPOIShowDistanceRequest, type UIPOIUpdateRequest, type UIPOIUpdateStateRequest, type Vector2Input, type Vector2JsonInput, type Vector3Input, type Vector3JsonInput, VideoCodeType, type WeatherChangeSeasonRequest, type WeatherOpenCameraFogRequest, type WeatherSetAnimateTimeOfDayRequest, type WeatherSetDayAndNightRequest, type WeatherSetSceneTimeRequest, type WeatherSetTimeSyncRequest, WeatherSystem, type WeatherTypeRequest, WebView, type WebViewUpdateRequest, apiRegistry, createAgentBridgeMetadata, createApiFacade, createBridgeRuntime, getAgentBridgeMethodSchema, isAgentBridgeMethodExposed, isAgentBridgeModuleExposed, isAgentBridgeModuleName, listAgentBridgeMethods, listAgentBridgeModules, resolveAgentBridgeExposeConfig };
+export { AGENT_BRIDGE_API_METADATA, type AGENT_BRIDGE_PROTOCOL_VERSION, API_MODULE_KEYS, type AgentBridgeActiveStream, type AgentBridgeBusinessProgramManifest, type AgentBridgeBusinessProgramPermissionMode, type AgentBridgeCancelProgramRequest, type AgentBridgeCancelProgramRequestPayload, type AgentBridgeCatalogRequestPayload, type AgentBridgeErrorCode, type AgentBridgeExposeConfig, type AgentBridgeHeartbeatPayload, type AgentBridgeInboundMessage, type AgentBridgeInvokeRequest, type AgentBridgeInvokeRequestPayload, type AgentBridgeLoadProgramRequest, type AgentBridgeLoadProgramRequestPayload, type AgentBridgeMessageEnvelope, type AgentBridgeMessageType, type AgentBridgeMethodCatalogItem, type AgentBridgeMethodResponseMode, type AgentBridgeMethodSchemaMetadata, type AgentBridgeMethodSideEffect, type AgentBridgeModuleCatalogItem, type AgentBridgeOperationResult, type AgentBridgeOutboundMessage, type AgentBridgeProgramEventPayload, type AgentBridgeReconnectOptions, type AgentBridgeRegisterPayload, type AgentBridgeResultPayload, type AgentBridgeRuntimeAdapter, type AgentBridgeRuntimeEngineSnapshot, type AgentBridgeRuntimeFactoryOptions, type AgentBridgeRuntimeSnapshot, type AgentBridgeSchemaEnumOption, type AgentBridgeSchemaField, type AgentBridgeSchemaFieldType, type AgentBridgeSchemaRequestPayload, type AgentBridgeSocket, type AgentBridgeSocketFactory, type AgentBridgeStartProgramRequest, type AgentBridgeStartProgramRequestPayload, type AgentBridgeStreamCloseRequest, type AgentBridgeStreamCloseRequestPayload, type AgentBridgeStreamCloseResult, type AgentBridgeStreamEventListener, type AgentBridgeStreamEventPayload, type AgentBridgeStreamStartRequest, type AgentBridgeStreamStartRequestPayload, type AgentBridgeStreamStartResult, type AgentBridgeStreamTerminalReason, type AgentBridgeStructuredError, type AgentBridgeUnregisterPayload, type AgentBridgeValidateAction, type AgentBridgeValidateActionItem, type AgentBridgeValidateActionsRequest, type AgentBridgeValidateActionsRequestPayload, type AgentBridgeValidateActionsResult, AgentRuntimeBridge, type AgentRuntimeBridgeDependencies, Animation, type AnimationGetLengthRequest, type AnimationPlayRequest, type AnimationSetSpeedRequest, type AnimationStartLoopRequest, type AnimationStopLoopRequest, type AnimationStopRequest, type ApiCallback, type ApiFacade, type ApiInstanceMap, type ApiModuleFactory, type ApiModuleKey, type ApiRegistry, type ApiRegistryContext, ApiRegistryError, type ApiRequestEnvelope, type ApiResponseEnvelope, type AuthErrorInfo, type AuthSessionSnapshot, type AuthWorkflowState, BuildingFloor, type BuildingFloorCancelOptions, type BuildingFloorDependencies, BuildingFloorError, type BuildingFloorErrorCode, type BuildingFloorFocusMode, type BuildingFloorInput, type BuildingFloorItem, type BuildingFloorOverview, type BuildingFloorOverviewOptions, type BuildingFloorRegistration, type BuildingFloorRegistrationResult, type BuildingFloorRuntimeOptions, type BuildingFloorRuntimeStatus, type BuildingFloorState, type BuildingFloorStateOptions, type BuildingFloorSwitchOptions, type BuildingFloorTransitionResult, type BuildingFloorTransitionStatus, type BuildingFloorViewPoint, Camera, type CameraFlyByPathRequest, type CameraFlyToTargetRequest, type CameraLookAtRequest, type CameraObjFollowRequest, type CameraSetFlySpeedRequest, type CameraSetFovRequest, type CameraSetPositionAndRotationRequest, type CenterConnectResult, type CenterEnvelope, type CenterServiceInfo, type CenterTokenAuthorizeResult, Connect, DTCEngine, type DTCEngineAgentBridgeOptions, Dlss, DlssQuality, type DlssSetEnableRequest, type DlssSetQualityRequest, type EngineConfig, type EngineLogLevel, type EngineStatusInfo, type EngineViewMode, type FeatureToggleRequest, FilterMode, type GetWeatherTypeRequest, HeatMap, type HeatMapConfigRequest, type HeatMapCreateRequest, type HeatMapPointRequest, type HeatMapRemoveRequest, HighLighterEffect, type HighLighterEnableRequest, type HighLighterRemoveHighLightModelRequest, type HighLighterSetHighLightModelRequest, Layer, type LayerAddRequest, type LayerChildElementRequest, LayerEnum, type LayerModelAddRequest, type LayerModelRemoveRequest, type LayerPOIAddRequest, type LayerSelectorRequest, type LayerShowUIPopRequest, type LayerSwitchModelRequest, Model, type ModelAddRequest, type ModelBoundsRequest, ModelPOI, type ModelPOIAddRequest, type ModelPOIDeleteByGroupRequest, type ModelPOIDeleteByIdRequest, type ModelPOIGetInfoRequest, type ModelPOIUpdateRequest, type ModelPOIVisibleByGroupRequest, type ModelRemoveRequest, type ModelSelectorRequest, type ModelSetVisibleByAttributeRequest, type ModelSetVisibleByTagsRequest, type ModelSetVisibleRequest, ModelTransform, type ModelTransformNodeRequest, type ModelTransformRestoreRequest, type ModelTransformRotateByTargetRequest, type ModelTransformRotateRequest, type ModelTransformScaleRequest, type ModelTransformStartMoveRequest, ModelTransformType, Navigation, type NavigationMeshNavRequest, type NavigationNavByPathRequest, type NavigationNodeRequest, type NavigationUpdateMeshNavRequest, type NavigationUpdateNavPathRequest, type NavigationUpdateSpeedRequest, type NetworkAdaptationActionResult, type NetworkAdaptationActionStep, type NetworkAdaptationActionType, type NetworkAdaptationLevel, type NetworkAdaptationMode, type NetworkAdaptationState, type NetworkDecisionTrace, type NetworkDiagnosticsSnapshot, type NetworkMetricsSnapshot, PathPatrol, type PathPatrolAddRequest, type PathPatrolNodeRequest, type PathPatrolSetTimeNodeRequest, type PathPatrolUpdateRequest, PendingValidationSchemaMap, Popup, type PopupAddRequest, type PopupDelayRequest, type PopupItemRequest, type PopupRemoveRequest, type PopupShowDistanceRequest, type PopupShowRequest, type PopupSyncInfoRequest, type QOS_EVENT_NAMES, type QosEvent, type QosEventName, type QosLevel, type QosReportingPayload, type QosRuntimeContext, type QosSessionContext, type QosStage, type QosStatus, type QosWarnErrorSummary, type ResolvedEngineConfig, SDKValidationError, Scene, type SceneListenCompassRequest, type SceneSwitchRequest, Screen, ScreenRenderBitratePreset, ScreenRenderBitratePresetOptions, type ScreenRenderBitratePresetValueMap, type ScreenSetSceneFPSRequest, type ScreenSetSceneRenderBitrateRequest, type ScreenSetScreenResolutionRequest, type ScreenSetVideoDecodeRequest, Season, type SignallingAllocateResponse, SpatialQuery, type SpatialQueryLayerByModelBoxRequest, type SpatialQueryLayerByModelRequest, type SpatialQueryLayerByPositionRequest, type StandardResponse, TimeLine, type TimeSerialNode, type TimelineNodeRequest, type TimelinePlayRequest, type TimelineSetSpeedRequest, type TimelineStopRequest, UIPOI, type UIPOIAddRequest, type UIPOIDeleteByGroupRequest, type UIPOIDeleteByIdRequest, type UIPOIEnableOverlapRequest, type UIPOIShowDistanceRequest, type UIPOIUpdateRequest, type UIPOIUpdateStateRequest, type Vector2Input, type Vector2JsonInput, type Vector3Input, type Vector3JsonInput, VideoCodeType, type WeatherChangeSeasonRequest, type WeatherOpenCameraFogRequest, type WeatherSetAnimateTimeOfDayRequest, type WeatherSetDayAndNightRequest, type WeatherSetSceneTimeRequest, type WeatherSetTimeSyncRequest, WeatherSystem, type WeatherTypeRequest, WebView, type WebViewUpdateRequest, apiRegistry, createAgentBridgeMetadata, createApiFacade, createBridgeRuntime, getAgentBridgeMethodSchema, isAgentBridgeMethodExposed, isAgentBridgeModuleExposed, isAgentBridgeModuleName, listAgentBridgeMethods, listAgentBridgeModules, resolveAgentBridgeExposeConfig };