@nnepoch/dtc-sdk 3.0.4 → 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;
@@ -1292,6 +1030,8 @@ interface CameraFlyToTargetRequest {
   point?: Vector3Input;
   /** 飞行过程中看向目标点。 */
   target?: Vector3Input;
+  /** Horizontal field of view in degrees (10–150), default 60. */
+  fov?: number;
   /** 飞行时长（秒）。 */
   time?: number;
 }
@@ -1834,585 +1574,980 @@ interface PopupSyncInfoRequest {
   position?: Vector3Input;
 }
 /**
- * Popup.removePop 参数。
+ * Popup.removePop 参数。
+ */
+interface PopupRemoveRequest {
+  /** 分组名称。 */
+  groupName?: string;
+  /** 待删除气泡 ID 列表。 */
+  ids?: string[];
+}
+/**
+ * Popup.show 参数。
+ */
+interface PopupShowRequest {
+  /** 分组名称。 */
+  groupName?: string;
+  /** 气泡 ID 列表。 */
+  ids?: string[];
+  /** 是否显示。 */
+  show?: boolean;
+}
+/**
+ * Popup.setPopDelayFrame 参数。
+ */
+interface PopupDelayRequest {
+  /** 延迟时间。 */
+  time: number;
+}
+/**
+ * Popup.setPopShowDistance 参数。
+ */
+interface PopupShowDistanceRequest {
+  /** 最远显示距离。 */
+  distance: number;
+}
+/**
+ * Animation.startLoopAnimation 参数。
+ */
+interface AnimationStartLoopRequest {
+  /** 父节点 ID。 */
+  parentId?: string;
+  /** 模型 ID。 */
+  id: string;
+  /** 动画状态名称。 */
+  stateName: string;
+  /** 循环起始时间。 */
+  loopStartTime?: number;
+  /** 循环结束时间。 */
+  loopEndTime?: number;
+  /** 播放速度。 */
+  speed?: number;
+}
+/**
+ * Animation.stopLoopAnimation 参数。
+ */
+interface AnimationStopLoopRequest {
+  /** 父节点 ID。 */
+  parentId?: string;
+  /** 模型 ID。 */
+  id: string;
+}
+/**
+ * Animation.playAnimator 参数。
+ */
+interface AnimationPlayRequest {
+  /** 父节点 ID。 */
+  parentId?: string;
+  /** 模型 ID。 */
+  id: string;
+  /** 动画状态名称。 */
+  stateName: string;
+  /** 播放速度。 */
+  speed?: number;
+  /** 起始时间。 */
+  startTime?: number;
+  /** 结束时间。 */
+  endTime?: number;
+  /** 播放结束后是否停止。 */
+  isStop?: boolean;
+}
+/**
+ * Animation.setAnimatorSpeed 参数。
+ */
+interface AnimationSetSpeedRequest {
+  /** 父节点 ID。 */
+  parentId?: string;
+  /** 模型 ID。 */
+  id: string;
+  /** 播放速度。 */
+  speed: number;
+}
+/**
+ * Animation.getAnimationLength 参数。
+ */
+interface AnimationGetLengthRequest {
+  /** 父节点 ID。 */
+  parentId?: string;
+  /** 模型 ID。 */
+  id: string;
+  /** 动画状态名称。 */
+  stateName: string;
+}
+/**
+ * Animation.stopAnimator 参数。
+ */
+interface AnimationStopRequest {
+  /** 父节点 ID。 */
+  parentId?: string;
+  /** 模型 ID。 */
+  id: string;
+}
+/**
+ * TimeLine.play 参数。
+ */
+interface TimelinePlayRequest {
+  /** 父节点 ID。 */
+  parentId?: string;
+  /** 时间线 ID（兼容字段）。 */
+  id?: string;
+  /** 时间线 ID。 */
+  timelineId?: string;
+  /** 初始时间。 */
+  initialTime?: number;
+  /** 播放速度。 */
+  speed?: number;
+  /** 是否保留最后一帧。 */
+  keepLastFrame?: boolean;
+}
+/**
+ * TimeLine.pause / resume 参数。
+ */
+interface TimelineNodeRequest {
+  /** 父节点 ID。 */
+  parentId?: string;
+  /** 时间线 ID（兼容字段）。 */
+  id?: string;
+}
+/**
+ * TimeLine.stop 参数。
+ */
+interface TimelineStopRequest {
+  /** 父节点 ID。 */
+  parentId?: string;
+  /** 时间线 ID（兼容字段）。 */
+  id?: string;
+  /** 时间线 ID。 */
+  timelineId?: string;
+  /** 停止后重置到的时间。 */
+  resetTime?: number;
+  /** 停止后相机是否回到起点。 */
+  isCameraToStart?: boolean;
+}
+/**
+ * TimeLine.setSpeed 参数。
+ */
+interface TimelineSetSpeedRequest {
+  /** 父节点 ID。 */
+  parentId?: string;
+  /** 时间线 ID（兼容字段）。 */
+  id?: string;
+  /** 时间线 ID。 */
+  timelineId?: string;
+  /** 播放速度。 */
+  speed: number;
+}
+/**
+ * Screen.SetSceneRenderBitrate 参数。
+ */
+interface ScreenSetSceneRenderBitrateRequest {
+  /**
+   * 渲染码率档位。
+   * 可选值：`auto / low / high / super / blue`。
+   * 默认值 `high`。
+   */
+  bitrate?: ScreenRenderBitratePreset;
+}
+/**
+ * Screen.SetSceneFPS 参数。
+ */
+interface ScreenSetSceneFPSRequest {
+  /**
+   * 渲染帧率。
+   * 默认值为 `150`，有效范围 `1-300`。
+   */
+  fps?: number;
+}
+/**
+ * Screen.SetScreenResolution 参数。
+ */
+interface ScreenSetScreenResolutionRequest {
+  /**
+   * 目标分辨率宽度。
+   * 默认值 `1920`。
+   */
+  width?: number;
+  /**
+   * 目标分辨率高度。
+   * 默认值 `1080`。
+   */
+  height?: number;
+}
+/**
+ * Screen.setVideoDecode 参数。
+ */
+interface ScreenSetVideoDecodeRequest {
+  /**
+   * 视频解码器类型。
+   */
+  decode: VideoCodeType;
+}
+/**
+ * Dlss.setDlssEnable 参数。
+ */
+interface DlssSetEnableRequest {
+  /**
+   * 是否开启 DLSS。
+   * 默认值 `true`。
+   */
+  enable?: boolean;
+  /**
+   * DLSS 质量档位。
+   * 默认值 `DlssQuality.Balanced`。
+   */
+  quality?: DlssQuality;
+}
+/**
+ * Dlss.setDlssQuality 参数。
+ */
+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;
+}
+/**
+ * ModelTransform.pauseMove / resumeMove / endMove / endRotate / endScale 参数。
  */
-interface PopupRemoveRequest {
-  /** 分组名称。 */
-  groupName?: string;
-  /** 待删除气泡 ID 列表。 */
-  ids?: string[];
+interface ModelTransformNodeRequest {
+  /** 父节点 ID，可以为空。 */
+  parentId?: string;
+  /** 对象编号。 */
+  id: string;
 }
 /**
- * Popup.show 参数。
+ * ModelTransform.restoreMove / restoreRotate / restoreScale 参数。
  */
-interface PopupShowRequest {
-  /** 分组名称。 */
-  groupName?: string;
-  /** 气泡 ID 列表。 */
-  ids?: string[];
-  /** 是否显示。 */
-  show?: boolean;
+interface ModelTransformRestoreRequest {
+  /** 父节点 ID，可以为空。 */
+  parentId?: string;
+  /** 需要恢复的对象 ID 列表。 */
+  ids: string[];
 }
 /**
- * Popup.setPopDelayFrame 参数。
+ * ModelTransform.rotate / continuedRotate 参数。
  */
-interface PopupDelayRequest {
-  /** 延迟时间。 */
-  time: number;
+interface ModelTransformRotateRequest {
+  /** 父节点 ID，可以为空。 */
+  parentId?: string;
+  /** 对象编号。 */
+  id: string;
+  /** 对象绕 x/y/z 轴旋转的值，不旋转填写为 0。 */
+  rotate: Vector3;
 }
 /**
- * Popup.setPopShowDistance 参数。
+ * ModelTransform.rotateByTarget 参数。
  */
-interface PopupShowDistanceRequest {
-  /** 最远显示距离。 */
-  distance: number;
+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;
 }
 /**
- * Animation.startLoopAnimation 参数。
+ * ModelTransform.setScale 参数。
  */
-interface AnimationStartLoopRequest {
-  /** 父节点 ID。 */
+interface ModelTransformScaleRequest {
+  /** 父节点 ID，可以为空。 */
   parentId?: string;
-  /** 模型 ID。 */
+  /** 对象编号。 */
   id: string;
-  /** 动画状态名称。 */
-  stateName: string;
-  /** 循环起始时间。 */
-  loopStartTime?: number;
-  /** 循环结束时间。 */
-  loopEndTime?: number;
-  /** 播放速度。 */
-  speed?: number;
+  /** 目标缩放值。 */
+  scale: Vector3;
+  /** 缩放时长（秒）。默认 `0.5`。 */
+  duration?: number;
 }
 /**
- * Animation.stopLoopAnimation 参数。
+ * HighLighterEffect.setHighLightModel 参数。
  */
-interface AnimationStopLoopRequest {
-  /** 父节点 ID。 */
+interface HighLighterSetHighLightModelRequest {
+  /** 对象组的父对象，可以为空。 */
   parentId?: string;
-  /** 模型 ID。 */
-  id: string;
+  /** 需要添加高光的对象编号数组。 */
+  ids: string[];
+  /** 是否高亮模型背面。 */
+  showBack: boolean;
+}
+interface HighLighterEnableRequest {
+  /** 是否启用高亮效果。 */
+  enable: boolean;
 }
 /**
- * Animation.playAnimator 参数。
+ * HighLighterEffect.removeHighLightModel 参数。
  */
-interface AnimationPlayRequest {
-  /** 父节点 ID。 */
+interface HighLighterRemoveHighLightModelRequest {
+  /** 对象组的父对象，可以为空。 */
   parentId?: string;
-  /** 模型 ID。 */
-  id: string;
-  /** 动画状态名称。 */
-  stateName: string;
-  /** 播放速度。 */
-  speed?: number;
-  /** 起始时间。 */
-  startTime?: number;
-  /** 结束时间。 */
-  endTime?: number;
-  /** 播放结束后是否停止。 */
-  isStop?: boolean;
+  /** 需要移除高光的对象名称数组。 */
+  ids: string[];
 }
 /**
- * Animation.setAnimatorSpeed 参数。
+ * PathPatrol 时间序列节点。
  */
-interface AnimationSetSpeedRequest {
-  /** 父节点 ID。 */
+interface TimeSerialNode {
+  /** 路径点坐标。 */
+  node: Vector3Input;
+  /** 时间节点，格式为 "2025-09-10 00:05:00"。 */
+  time: string;
+}
+/**
+ * PathPatrol.add 参数。
+ */
+interface PathPatrolAddRequest {
+  /** 模型对象父对象编号。 */
   parentId?: string;
-  /** 模型 ID。 */
+  /** 场景的模型对象编号。 */
   id: string;
-  /** 播放速度。 */
-  speed: number;
+  /** 场景的模型路径，可为空；为空时根据 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.getAnimationLength 参数。
+ * PathPatrol.update 参数。
  */
-interface AnimationGetLengthRequest {
-  /** 父节点 ID。 */
+interface PathPatrolUpdateRequest {
+  /** 模型对象父对象编号。 */
   parentId?: string;
-  /** 模型 ID。 */
+  /** 巡逻轨迹编号。 */
   id: string;
-  /** 动画状态名称。 */
-  stateName: string;
+  /** 巡逻轨迹的颜色。 */
+  lineColor?: string;
+  /** 巡逻路线的宽度。 */
+  lineWidth?: number;
+  /** 巡逻过的路径的显示颜色。 */
+  passedColor?: string;
+  /** 调整速度，不能小于 0。 */
+  speed?: number;
 }
 /**
- * Animation.stopAnimator 参数。
+ * PathPatrol.setTimeNode 参数。
  */
-interface AnimationStopRequest {
-  /** 父节点 ID。 */
+interface PathPatrolSetTimeNodeRequest {
+  /** 模型对象父对象编号。 */
   parentId?: string;
-  /** 模型 ID。 */
+  /** 巡逻对象编号。 */
   id: string;
+  /** 时间节点，格式为 "2025-09-10 00:05:00"。`timeStart` 与 `startNodeIndex` 只能有一个不为空。 */
+  timeStart?: string;
+  /** 开始节点索引，不能小于 0。`timeStart` 与 `startNodeIndex` 只能有一个不为空。 */
+  startNodeIndex?: string;
 }
 /**
- * TimeLine.play 参数。
+ * PathPatrol.pause / resume / stop 参数。
  */
-interface TimelinePlayRequest {
-  /** 父节点 ID。 */
+interface PathPatrolNodeRequest {
+  /** 模型对象父对象编号。 */
   parentId?: string;
-  /** 时间线 ID（兼容字段）。 */
-  id?: string;
-  /** 时间线 ID。 */
-  timelineId?: string;
-  /** 初始时间。 */
-  initialTime?: number;
-  /** 播放速度。 */
-  speed?: number;
-  /** 是否保留最后一帧。 */
-  keepLastFrame?: boolean;
+  /** 巡逻对象编号。 */
+  id: string;
 }
 /**
- * TimeLine.pause / resume 参数。
+ * 单个热力点数据（地理坐标 + 热度值）。
  */
-interface TimelineNodeRequest {
-  /** 父节点 ID。 */
-  parentId?: string;
-  /** 时间线 ID（兼容字段）。 */
-  id?: string;
+interface HeatMapPointRequest {
+  /** 点位置（地理坐标，默认 EPSG4326）。 */
+  position: Vector3Input;
+  /** 该点的热度值（0~1），默认 1。 */
+  value?: number;
 }
 /**
- * TimeLine.stop 参数。
+ * HeatMap.create 参数。
  */
-interface TimelineStopRequest {
-  /** 父节点 ID。 */
+interface HeatMapCreateRequest {
+  /** 热力图所属父节点 ID，可选。 */
   parentId?: string;
-  /** 时间线 ID（兼容字段）。 */
+  /** 热力图 ID；重复创建相同 ID 会更新该热力图数据，可空。 */
   id?: string;
-  /** 时间线 ID。 */
-  timelineId?: string;
-  /** 停止后重置到的时间。 */
-  resetTime?: number;
-  /** 停止后相机是否回到起点。 */
-  isCameraToStart?: boolean;
+  /** 热力图纹理尺寸（像素），默认 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;
 }
 /**
- * TimeLine.setSpeed 参数。
+ * HeatMap.remove 参数。
  */
-interface TimelineSetSpeedRequest {
-  /** 父节点 ID。 */
+interface HeatMapRemoveRequest {
+  /** 热力图所属父节点 ID，可选。 */
   parentId?: string;
-  /** 时间线 ID（兼容字段）。 */
+  /** 热力图 ID；为空时移除全部热力图。 */
   id?: string;
-  /** 时间线 ID。 */
-  timelineId?: string;
-  /** 播放速度。 */
-  speed: number;
 }
 /**
- * Screen.SetSceneRenderBitrate 参数。
+ * HeatMap.setConfig 参数。
  */
-interface ScreenSetSceneRenderBitrateRequest {
-  /**
-   * 渲染码率档位。
-   * 可选值：`auto / low / high / super / blue`。
-   * 默认值 `high`。
-   */
-  bitrate?: ScreenRenderBitratePreset;
+interface HeatMapConfigRequest {
+  /** 热力图所属父节点 ID，可选。 */
+  parentId?: string;
+  /** 热力图 ID；为空时作用于最近创建的热力图。 */
+  id?: string;
+  /** 材质透明度，默认 0.7。 */
+  opacity?: number;
+  /** 高度缩放，默认 2500。 */
+  heightScale?: number;
+  /** 颜色过渡比例，默认 2.5。 */
+  lerpScale?: number;
+  /**影响范围 */
+  influenceSize?: number;
 }
 /**
- * Screen.SetSceneFPS 参数。
+ * Navigation.startMeshNav / getMeshNavDistance 参数。
  */
-interface ScreenSetSceneFPSRequest {
-  /**
-   * 渲染帧率。
-   * 默认值为 `150`，有效范围 `1-300`。
-   */
-  fps?: number;
+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;
+  /** 模型缩放比例，默认 1。 */
+  scale?: Vector3Input;
+  /** 是否自动清除，默认 `true`。 */
+  isAutoClear?: boolean;
+  offSetZ?: number;
 }
 /**
- * Screen.SetScreenResolution 参数。
+ * Navigation.pauseMeshNav / resumeMeshNav / stopMeshNav / pauseNavPath / resumeNavPath / stopNavPath 参数。
  */
-interface ScreenSetScreenResolutionRequest {
-  /**
-   * 目标分辨率宽度。
-   * 默认值 `1920`。
-   */
-  width?: number;
-  /**
-   * 目标分辨率高度。
-   * 默认值 `1080`。
-   */
-  height?: number;
+interface NavigationNodeRequest {
+  /** 对象组的父对象，可以为空。 */
+  parentId?: string;
+  /** 对象名称数组集合。 */
+  id: string;
 }
 /**
- * Screen.setVideoDecode 参数。
+ * Navigation.updateMeshNav 参数。
  */
-interface ScreenSetVideoDecodeRequest {
-  /**
-   * 视频解码器类型。
-   */
-  decode: VideoCodeType;
+interface NavigationUpdateMeshNavRequest {
+  /** 对象组的父对象，可以为空。 */
+  parentId?: string;
+  /** 对象名称数组集合。 */
+  id: string;
+  /** 物体移动的速度，默认 -1（不改变速度）。 */
+  speed?: number;
+  /** 导航规划路径颜色。 */
+  planColor?: string;
+  /** 导航已走过的路径颜色。 */
+  passColor?: string;
 }
-/**
- * Dlss.setDlssEnable 参数。
- */
-interface DlssSetEnableRequest {
-  /**
-   * 是否开启 DLSS。
-   * 默认值 `true`。
-   */
-  enable?: boolean;
-  /**
-   * DLSS 质量档位。
-   * 默认值 `DlssQuality.Balanced`。
-   */
-  quality?: DlssQuality;
+interface NavigationUpdateSpeedRequest {
+  /** 对象组的父对象，可以为空。 */
+  parentId?: string;
+  /** 对象名称数组集合。 */
+  id: string;
+  /** 物体移动的速度，默认 -1（不改变速度）。 */
+  speed?: number;
 }
 /**
- * Dlss.setDlssQuality 参数。
+ * Navigation.startNavByPath 参数。
  */
-interface DlssSetQualityRequest {
-  /**
-   * DLSS 质量档位。
-   * 默认值 `DlssQuality.Balanced`。
-   */
-  quality?: DlssQuality;
+interface NavigationNavByPathRequest {
+  /** 对象组的父对象，可以为空。 */
+  parentId?: string;
+  /** 对象名称数组集合。 */
+  id: string[];
+  /** 路径节点数组集合。 */
+  nodes: Vector3Input[];
+  /** 是否作为导航缓存路径点，默认 `true`。 */
+  isCache?: boolean;
+  /** 导航轨迹总时间（秒），默认 10。 */
+  duration?: number;
+  /** 导航规划路径颜色。 */
+  planColor?: string;
+  /** 导航已走过的路径颜色。 */
+  passColor?: string;
 }
 /**
- * ModelTransform.startMoveByNodes 参数。
+ * Navigation.updateNavPath 参数。
  */
-interface ModelTransformStartMoveRequest {
-  /** 父节点 ID，可以为空。 */
+interface NavigationUpdateNavPathRequest {
+  /** 对象组的父对象，可以为空。 */
   parentId?: string;
-  /** 移动对象编号。 */
-  id: string;
-  /** 移动轨迹点集合。 */
-  nodes: Vector3Input[];
-  /** 移动速度。默认 `1`。 */
-  speed?: number;
-  /** 移动方式，参见 `ModelTransformType` 枚举，默认 -1（引擎默认）。 */
-  linear?: number;
-  /** 是否看向移动的目标点。默认 `true`。 */
-  isLookAtTarget?: boolean;
-  /** 是否需要朝移动方向转向。默认 `true`。 */
-  needDirection?: boolean;
+  /** 对象名称数组集合。 */
+  id: string[];
+  /** 导航轨迹总时间（秒），默认 -1（不改变时长）。 */
+  duration?: number;
+  /** 导航规划路径颜色。 */
+  planColor?: string;
+  /** 导航已走过的路径颜色。 */
+  passColor?: string;
 }
 /**
- * ModelTransform.pauseMove / resumeMove / endMove / endRotate / endScale 参数。
+ * SpatialQuery.layerQueryByModel 参数。
  */
-interface ModelTransformNodeRequest {
-  /** 父节点 ID，可以为空。 */
+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[];
+}
+//#endregion
+//#region src/types/buildingFloor.d.ts
+/** 建筑楼层固定视角。 */
+interface BuildingFloorViewPoint {
+  /** 相机位置。 */
+  position: Vector3Input;
+  /** 相机看向的目标点。 */
+  target: Vector3Input;
+  /** 水平视场角。 */
+  fov?: number;
+  /** 相机飞行时长（秒）。 */
+  time?: number;
+}
+/** 对象形式的楼层注册项。 */
+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';
 /**
- * ModelTransform.restoreMove / restoreRotate / restoreScale 参数。
+ * 引擎状态详情结构，与 sdk2 的 EngineStatusInfo 字段语义保持一致。
  */
-interface ModelTransformRestoreRequest {
-  /** 父节点 ID，可以为空。 */
-  parentId?: string;
-  /** 需要恢复的对象 ID 列表。 */
-  ids: string[];
+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;
 }
-/**
- * ModelTransform.rotate / continuedRotate 参数。
- */
-interface ModelTransformRotateRequest {
-  /** 父节点 ID，可以为空。 */
-  parentId?: string;
-  /** 对象编号。 */
-  id: string;
-  /** 对象绕 x/y/z 轴旋转的值，不旋转填写为 0。 */
-  rotate: Vector3;
+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.rotateByTarget 参数。
+ * 弱网自适应档位。
  */
-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 NetworkAdaptationLevel = 'Normal' | 'Mild' | 'Moderate' | 'Severe' | 'Recovering';
 /**
- * ModelTransform.setScale 参数。
+ * 弱网自适应运行模式：
+ * - auto: 自动策略决策
+ * - manual: 手动接管档位
  */
-interface ModelTransformScaleRequest {
-  /** 父节点 ID，可以为空。 */
-  parentId?: string;
-  /** 对象编号。 */
-  id: string;
-  /** 目标缩放值。 */
-  scale: Vector3;
-  /** 缩放时长（秒）。默认 `0.5`。 */
-  duration?: number;
-}
+type NetworkAdaptationMode = 'auto' | 'manual';
 /**
- * HighLighterEffect.setHighLightModel 参数。
+ * 媒体链路实时指标快照。
  */
-interface HighLighterSetHighLightModelRequest {
-  /** 对象组的父对象，可以为空。 */
-  parentId?: string;
-  /** 需要添加高光的对象编号数组。 */
-  ids: string[];
-  /** 是否高亮模型背面。 */
-  showBack: boolean;
-}
-interface HighLighterEnableRequest {
-  /** 是否启用高亮效果。 */
-  enable: boolean;
+interface NetworkMetricsSnapshot {
+  ts: number;
+  connected: boolean;
+  fps?: number;
+  bitrateKbps?: number;
+  packetLossRate?: number;
+  jitterMs?: number;
+  rttMs?: number;
+  frameWidth?: number;
+  frameHeight?: number;
 }
 /**
- * HighLighterEffect.removeHighLightModel 参数。
+ * 弱网状态变更事件载荷。
  */
-interface HighLighterRemoveHighLightModelRequest {
-  /** 对象组的父对象，可以为空。 */
-  parentId?: string;
-  /** 需要移除高光的对象名称数组。 */
-  ids: string[];
+interface NetworkAdaptationState {
+  from: NetworkAdaptationLevel;
+  to: NetworkAdaptationLevel;
+  mode: NetworkAdaptationMode;
+  reason: string;
+  ts: number;
+  metrics?: NetworkMetricsSnapshot;
 }
 /**
- * PathPatrol 时间序列节点。
+ * 策略动作类型。
  */
-interface TimeSerialNode {
-  /** 路径点坐标。 */
-  node: Vector3Input;
-  /** 时间节点，格式为 "2025-09-10 00:05:00"。 */
-  time: string;
-}
+type NetworkAdaptationActionType = 'SetSceneRenderBitrate' | 'SetSceneFPS' | 'SetScreenResolution';
 /**
- * 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 NetworkAdaptationActionStep {
+  type: NetworkAdaptationActionType;
+  payload: Record<string, number>;
+  success: boolean;
+  error?: string;
 }
 /**
- * PathPatrol.update 参数。
+ * 策略动作执行事件。
  */
-interface PathPatrolUpdateRequest {
-  /** 模型对象父对象编号。 */
-  parentId?: string;
-  /** 巡逻轨迹编号。 */
-  id: string;
-  /** 巡逻轨迹的颜色。 */
-  lineColor?: string;
-  /** 巡逻路线的宽度。 */
-  lineWidth?: number;
-  /** 巡逻过的路径的显示颜色。 */
-  passedColor?: string;
-  /** 调整速度，不能小于 0。 */
-  speed?: number;
+interface NetworkAdaptationActionResult {
+  level: Exclude<NetworkAdaptationLevel, 'Recovering'>;
+  mode: NetworkAdaptationMode;
+  success: boolean;
+  skipped: boolean;
+  reason: string;
+  ts: number;
+  steps: NetworkAdaptationActionStep[];
 }
 /**
- * PathPatrol.setTimeNode 参数。
+ * 策略决策轨迹条目，用于诊断面板回放。
  */
-interface PathPatrolSetTimeNodeRequest {
-  /** 模型对象父对象编号。 */
-  parentId?: string;
-  /** 巡逻对象编号。 */
-  id: string;
-  /** 时间节点，格式为 "2025-09-10 00:05:00"。`timeStart` 与 `startNodeIndex` 只能有一个不为空。 */
-  timeStart?: string;
-  /** 开始节点索引，不能小于 0。`timeStart` 与 `startNodeIndex` 只能有一个不为空。 */
-  startNodeIndex?: string;
+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.pause / resume / stop 参数。
+ * 诊断面板快照数据。
  */
-interface PathPatrolNodeRequest {
-  /** 模型对象父对象编号。 */
-  parentId?: string;
-  /** 巡逻对象编号。 */
-  id: 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
 /**
- * 单个热力点数据（地理坐标 + 热度值）。
+ * QoS 事件阶段定义。
  */
-interface HeatMapPointRequest {
-  /** 点位置（地理坐标，默认 EPSG4326）。 */
-  position: Vector3Input;
-  /** 该点的热度值（0~1），默认 1。 */
-  value?: number;
-}
+type QosStage = 'auth' | 'center' | 'webrtc' | 'media' | 'ue_api' | 'session';
 /**
- * HeatMap.create 参数。
- */
-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;
-}
+ * QoS 事件状态定义。
+ */
+type QosStatus = 'start' | 'success' | 'failed' | 'update' | 'end';
 /**
- * HeatMap.remove 参数。
+ * QoS 事件日志等级（仅用于事件严重程度标记）。
  */
-interface HeatMapRemoveRequest {
-  /** 热力图所属父节点 ID，可选。 */
-  parentId?: string;
-  /** 热力图 ID；为空时移除全部热力图。 */
-  id?: string;
-}
+type QosLevel = 'info' | 'warn' | 'error';
 /**
- * HeatMap.setConfig 参数。
+ * QoS V1 事件名集合。
  */
-interface HeatMapConfigRequest {
-  /** 热力图所属父节点 ID，可选。 */
-  parentId?: string;
-  /** 热力图 ID；为空时作用于最近创建的热力图。 */
-  id?: string;
-  /** 材质透明度，默认 0.7。 */
-  opacity?: number;
-  /** 高度缩放，默认 2500。 */
-  heightScale?: number;
-  /** 颜色过渡比例，默认 2.5。 */
-  lerpScale?: number;
-  /**影响范围 */
-  influenceSize?: number;
-}
+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"];
 /**
- * Navigation.startMeshNav / getMeshNavDistance 参数。
+ * QoS V1 事件名类型。
+ *
+ * 注意：V1 明确不包含 `ue_request_timeout`。
  */
-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;
-}
+type QosEventName = (typeof QOS_EVENT_NAMES)[number];
 /**
- * Navigation.pauseMeshNav / resumeMeshNav / stopMeshNav / pauseNavPath / resumeNavPath / stopNavPath 参数。
+ * 会话维度上下文。
  */
-interface NavigationNodeRequest {
-  /** 对象组的父对象，可以为空。 */
-  parentId?: string;
-  /** 对象名称数组集合。 */
-  id: string;
+interface QosSessionContext {
+  sessionId: string;
+  traceId: string;
+  runMode: string;
+  viewMode: string;
 }
 /**
- * Navigation.updateMeshNav 参数。
+ * 运行环境上下文。
  */
-interface NavigationUpdateMeshNavRequest {
-  /** 对象组的父对象，可以为空。 */
-  parentId?: string;
-  /** 对象名称数组集合。 */
-  id: string;
-  /** 物体移动的速度，默认 -1（不改变速度）。 */
-  speed?: number;
-  /** 导航规划路径颜色。 */
-  planColor?: string;
-  /** 导航已走过的路径颜色。 */
-  passColor?: string;
+interface QosRuntimeContext {
+  appId?: string;
+  env?: string;
+  pageUrl?: string;
+  userAgent?: string;
 }
-interface NavigationUpdateSpeedRequest {
-  /** 对象组的父对象，可以为空。 */
-  parentId?: string;
-  /** 对象名称数组集合。 */
-  id: string;
-  /** 物体移动的速度，默认 -1（不改变速度）。 */
-  speed?: number;
+/**
+ * warn/error 聚合统计指标。
+ */
+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 到配置中。
@@ -4464,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>>;
   /**
    * 设置巡逻开始的时间节点或是节点索引。
@@ -5390,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
 /**
  * 未覆盖模块的校验占位清单：
@@ -5532,6 +5761,7 @@ interface ApiInstanceMap {
   TimeLine: TimeLine;
   WeatherSystem: WeatherSystem;
   WebView: WebView;
+  SpatialQuery: SpatialQuery;
 }
 type ApiModuleKey = keyof ApiInstanceMap;
 /**
@@ -5630,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 的响应模式；与副作用风险是两个独立维度。 */
@@ -5686,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 结构化错误。
  */
@@ -5717,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;
@@ -5762,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 {
@@ -5780,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';
 /**
  * 所有协议消息的基础信封。
  */
@@ -5789,6 +6102,7 @@ interface AgentBridgeMessageEnvelope<TPayload = unknown> {
   protocolVersion: typeof AGENT_BRIDGE_PROTOCOL_VERSION;
   bridgeId?: string;
   callId?: string;
+  traceId?: string;
   ts: number;
   payload: TPayload;
 }
@@ -5798,8 +6112,11 @@ interface AgentBridgeRegisterPayload extends AgentBridgeRuntimeSnapshot {
   capabilities: {
     catalog: true;
     schema: true;
+    validateActions: true;
     invoke: true;
     stream: true;
+    businessPrograms: true;
+    businessProgramProtocolVersion: 1;
   };
 }
 /** 关闭消息携带的原因。 */
@@ -5823,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 {
@@ -5884,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;
@@ -5900,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 {
@@ -5931,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 对外构造参数。
@@ -6099,6 +6494,8 @@ declare class DTCEngine {
   readonly ModelPOI: ApiInstanceMap['ModelPOI'];
   /** 模型变换模块。 */
   readonly ModelTransform: ApiInstanceMap['ModelTransform'];
+  /** 建筑楼层分层控制模块。 */
+  readonly BuildingFloor: BuildingFloor;
   /** 路径巡逻模块。 */
   readonly PathPatrol: ApiInstanceMap['PathPatrol'];
   /** 高亮效果模块。 */
@@ -6318,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 };