@nnepoch/dtc-sdk 3.0.10 → 3.0.12

package/dist/esm/index.d.ts

@@ -998,6 +998,17 @@ declare enum TrainBehavior {
   /** 反复播放（来回移动）。 */
   BackAndForward = "BackAndForward"
 }
+/** 简易模型编辑模式，数值与 sdk2 保持一致。 */
+declare enum GizmoType {
+  /** 平移。 */
+  Move = 1,
+  /** 旋转。 */
+  Rotate = 2,
+  /** 缩放。 */
+  Scale = 3,
+  /** 平移、旋转及可用缩放手柄。 */
+  Universal = 4
+}
 //#endregion
 //#region src/types/request.d.ts
 interface Vector3JsonInput {
@@ -1367,10 +1378,9 @@ interface LayerChildElementRequest {
  */
 interface WeatherTypeRequest {
   /** 天气类型名称。 */
-  type: number;
+  weatherType: string;
   /** 天气类型持续时间（秒）。 */
   timeDuration: number;
-  test?: string;
 }
 /**
  * WeatherSystem.changeWeatherType 参数。
@@ -1392,6 +1402,13 @@ interface WeatherSetTimeSyncRequest {
   /** 是否同步系统时间。 */
   syncSystemTime?: boolean;
 }
+/**
+ * WeatherSystem.setWeatherVolume 参数。
+ */
+interface WeatherSetVolumeRequest {
+  /** 天气声音是否开启，true 开启，false 关闭。默认 true。 */
+  volumeOn?: boolean;
+}
 /**
  * WeatherSystem.setAnimateTimeOfDay 参数。
  */
@@ -2559,6 +2576,120 @@ interface NetworkDiagnosticsSnapshot {
   traces: NetworkDecisionTrace[];
 }
 //#endregion
+//#region src/types/pointEditor.d.ts
+/** 简易 Gizmo 编辑目标。 */
+interface GizmosStartSimpleRequest {
+  /** 场景分组 ID，与运行时加载元数据一致，不能按重名对象猜测。 */
+  parentId: string;
+  /** MODEL 点位全局 ID。 */
+  id: string;
+}
+/** 点位向量；位置采用经纬高，旋转、缩放不做地理坐标转换。 */
+interface PointEditorVector {
+  /** 经度，或旋转/缩放的 X 分量。 */
+  x: number;
+  /** 纬度，或旋转/缩放的 Y 分量。 */
+  y: number;
+  /** 高度（米），或旋转/缩放的 Z 分量。 */
+  z: number;
+}
+/** UE 模型资源；由业务资源目录提供，不使用 Unity 资源路径。 */
+interface PointEditorResource {
+  /** 资源类别，仅支持 MODEL。 */
+  type?: 'MODEL';
+  /** 资源名称。 */
+  name?: string;
+  /** 可加载的 UE Actor 蓝图类路径。 */
+  path: string;
+  /** 模型附属 POI 的 UE Actor 蓝图路径；空字符串表示不创建图标。 */
+  poiAsset?: string;
+}
+/** 点位分类，保留业务目录的分类标识和名称。 */
+interface PointEditorCategory {
+  /** 分类业务编码，沿用 sdk2 的 code 字段。 */
+  code?: string;
+  /** 分类名称。 */
+  name?: string;
+  /** 分类类型，沿用现有资源目录的 type。 */
+  type?: string;
+}
+/** drop 当时的浏览器视口坐标，不是页面滚动坐标。 */
+interface PointEditorClientPosition {
+  /** 浏览器事件 clientX。 */
+  clientX: number;
+  /** 浏览器事件 clientY。 */
+  clientY: number;
+}
+/** 视频完整图像中的归一化位置，范围 [0,1]；需在实际 drop 时记录。 */
+interface PointEditorScreenPosition {
+  /** 图像从左到右的比例。 */
+  x: number;
+  /** 图像从上到下的比例。 */
+  y: number;
+}
+/** 模型点位创建参数；不传 position/screenPosition 时 addPoint 等待一次网页点击。 */
+interface PointEditorAddRequest {
+  /** 场景分组 ID；可使用既有 MQTT 加载的分组，不要求 SDK 新建分组。 */
+  parentId: string;
+  /** 点位全局标识，对应后端 globalId，不是数据库主键。 */
+  id: string;
+  /** 本期只支持 MODEL，不支持独立 POI。 */
+  type: 'MODEL';
+  /** 业务编码，不用于替代 id。 */
+  code?: string;
+  /** 点位显示名称。 */
+  name?: string;
+  /** 已知的经纬高位置；与 screenPosition 二选一。 */
+  position?: PointEditorVector;
+  /** drop 时记录的视频图像坐标；addPointByDrag 未传 position 时必填。 */
+  screenPosition?: PointEditorScreenPosition;
+  /** 旋转（度）；与既有 payload 约定一致：X=Roll、Y=Pitch、Z=Yaw。 */
+  rotation?: PointEditorVector;
+  /** 模型缩放，默认 (1, 1, 1)。 */
+  scale?: PointEditorVector;
+  /** 模型是否显示，默认 true。 */
+  show?: boolean;
+  /** 附属 POI 是否显示，默认 true。 */
+  poiEnabled?: boolean;
+  /** 附属 POI 向上偏移（米），默认 0。 */
+  poiOffsetY?: number;
+  /** 附属 POI 等比缩放，默认 1；允许 0。 */
+  poiScaleFactor?: number;
+  /** 附属 POI 是否显示名称，默认 true。 */
+  poiShowName?: boolean;
+  /** JSON 对象形式的业务属性，默认 {}；更新时整体替换此字段。 */
+  extraProps?: Record<string, unknown>;
+  /** 视角配置字符串，空字符串可清空。 */
+  lookAt?: string;
+  /** 模型及可选附属 POI 的资源。 */
+  resource: PointEditorResource;
+  /** 业务分类。 */
+  category?: PointEditorCategory;
+}
+/** 局部更新；只修改实际传入的字段，不套用创建默认值。 */
+type PointEditorUpdateRequest = Pick<PointEditorAddRequest, 'parentId' | 'id' | 'type'> & Partial<Omit<PointEditorAddRequest, 'parentId' | 'id' | 'type' | 'resource' | 'screenPosition'>> & {
+  /** 资源属性局部合并；当前阶段不支持替换已创建模型的 path。 */
+  resource?: Partial<PointEditorResource>;
+};
+/** 批量删除参数；先检查全部已存在目标的来源和类型，再执行删除。 */
+interface PointEditorDeleteRequest {
+  /** 网页分组 ID。 */
+  parentId: string;
+  /** 待删除点位全局 ID 列表，不允许空数组或重复 ID。 */
+  ids: string[];
+}
+/** 已创建点位，直接供 Promise 和 callback 读取 position 等属性。 */
+type PointEditorPoint = Omit<PointEditorAddRequest, 'screenPosition'> & Required<Pick<PointEditorAddRequest, 'position' | 'rotation' | 'scale' | 'show' | 'poiEnabled' | 'poiOffsetY' | 'poiScaleFactor' | 'poiShowName' | 'extraProps'>>;
+/** 创建失败通过 Error 回调，同时 Promise 拒绝。 */
+type PointEditorCreateCallback = ApiCallback<PointEditorPoint | Error>;
+/** 删除结果；不存在的 ID 进入 failedIds，不能视为全部成功。 */
+interface PointEditorDeleteResult {
+  /** 成功删除的点位 ID。 */
+  deletedIds: string[];
+  /** 未找到或未成功删除的点位 ID。 */
+  failedIds: string[];
+}
+//#endregion
 //#region src/types/qos.d.ts
 /**
  * QoS 事件阶段定义。
@@ -2694,6 +2825,8 @@ declare class PixelStreamingAdapter {
    * 断开当前 WebRTC 会话。
    */
   disconnect(): void;
+  /** 编辑时临时启用官方 HoveringMouse 输入（包括 cs 模式），退出后按原值恢复。 */
+  beginPointEditorMouseInput(): () => void;
   /**
    * 设置用于 `PixelStreaming.connect()` 的同步信令 URL 提供函数。
    */
@@ -5225,6 +5358,8 @@ interface EngineEventMap {
   'LoadingProgress': LoadingProgressInfo;
   'OnApiDataChannelStarted': void;
   'ModelClick': any;
+  /** UE 拖动时持续回传变换，取消时回传恢复值；保留 sdk2 的 param JSON 字符串，由业务端防抖保存。 */
+  'ModelUpdate': any;
   'CameraHeight': any;
   'MouseLeftButtonClick': any;
   'MouseLeftButtonDoubleClick': any;
@@ -5551,7 +5686,7 @@ declare class TimeLine extends BaseApi {
 /**
  * 天气与时间环境控制 API。
  * @agentTitle 天气时间环境
- * @agentCapabilities 天气类型查询, 天气切换, 天气重置, 天气时间重置, 场景时间设置, 时间同步控制, 昼夜动画控制, 昼夜模式设置, 季节切换, 季节重置, 雾效开启, 雾效关闭
+ * @agentCapabilities 天气类型查询, 天气切换, 天气重置, 天气时间重置, 场景时间设置, 时间同步控制, 昼夜动画控制, 昼夜模式设置, 季节切换, 季节重置, 雾效开启, 雾效关闭, 天气音量控制
  * @hideconstructor
  */
 declare class WeatherSystem extends BaseApi {
@@ -5561,33 +5696,33 @@ declare class WeatherSystem extends BaseApi {
    * @param payload - 天气类型参数。
    * @param callback - 可选回调函数。
    * @returns Promise 形式的接口响应。
-   * @agentSideEffects write
-   * @agentPreconditions DTCEngine 已完成鉴权并建立 WebRTC 连接
+ * @agentSideEffects write
+ * @agentPreconditions DTCEngine 已完成鉴权并建立 WebRTC 连接
    * @agentRiskLevel low
-   * @agentExample { type: 0, timeDuration: 60 }
+   * @agentExample { weatherType: 'Clear_Skies', timeDuration: 6 }
    * @example
    * ```ts
-   * dtcEngine.WeatherSystem.changeWeatherType({ type: 0, timeDuration: 60 }, (result) => {
-   *   console.log(result);
-   * });
+    dtcEngine.WeatherSystem.changeWeatherType({ weatherType: 'Clear_Skies', timeDuration: 6 }, (result) => {
+      console.log(result);
+    });
    * ```
    */
   changeWeatherType(payload: WeatherTypeRequest, callback?: ApiCallback<ApiResponseEnvelope<unknown>>): Promise<ApiResponseEnvelope<unknown>>;
   /**
-   * 得到所有天气类型
-   * 备注：（需在配置 提前预制UDS天气系统）
-   * @param param 参数
-   * @param callBack 回调
-   * @returns
-   * @agentSideEffects read
-   * @agentPreconditions DTCEngine 已完成鉴权并建立 WebRTC 连接
-   * @agentRiskLevel low
-   * @agentExample {}
-   * @example
-   * ```
-   * dtcEngine.WeatherSystem.getWeatherTypes((result)=>{console.log(result)})
-   * ```
-   */
+    * 得到所有天气类型。
+    * 备注：（需在配置 提前预制UDS天气系统）
+    * @param param 参数
+    * @param callBack 回调
+    * @returns
+     * @agentSideEffects read
+     * @agentPreconditions DTCEngine 已完成鉴权并建立 WebRTC 连接
+     * @agentRiskLevel low
+     * @agentExample {}
+    * @example
+    * ```
+     dtcEngine.WeatherSystem.getWeatherTypes((result)=>{console.log(result)})
+    * ```
+    */
   getWeatherTypes(callback?: ApiCallback<ApiResponseEnvelope<unknown>>): Promise<ApiResponseEnvelope<unknown>>;
   /**
    * 重置天气
@@ -5743,6 +5878,29 @@ declare class WeatherSystem extends BaseApi {
    * ```
    */
   setDayAndNight(payload: WeatherSetDayAndNightRequest, callback?: ApiCallback<ApiResponseEnvelope<unknown>>): Promise<ApiResponseEnvelope<unknown>>;
+  /**
+     * 设置天气声音的开关。
+     * 默认值：`volumeOn=true`。`true` 开启，`false` 关闭。
+     * @param payload - 天气声音开关参数。
+     * @param callback - 可选回调函数。
+     * @returns Promise 形式的接口响应。
+     * @agentSideEffects write
+     * @agentPreconditions DTCEngine 已完成鉴权并建立 WebRTC 连接
+     * @agentRiskLevel low
+     * @agentExample { volumeOn: false }
+     * @example
+     * ```ts
+     *示例1： 关闭天气声音
+      dtcEngine.WeatherSystem.setWeatherVolume({ volumeOn: false }, (result) => {
+        console.log(result);
+      });
+     * 示例2： 开启天气声音
+      dtcEngine.WeatherSystem.setWeatherVolume({ volumeOn: true }, (result) => {
+        console.log(result);
+      });
+     * ```
+     */
+  setWeatherVolume(payload: WeatherSetVolumeRequest, callback?: ApiCallback<ApiResponseEnvelope<unknown>>): Promise<ApiResponseEnvelope<unknown>>;
   /**
    * 开启并调整相机镜头雾效。
    * 默认值：未填的数值字段统一按 `-1` 下发（沿用 sdk2 语义）。
@@ -6122,6 +6280,182 @@ declare class Type {
   readonly Vector4: typeof Vector4;
 }
 //#endregion
+//#region src/api/PointEditor.d.ts
+interface PointEditorRuntimeOptions extends BaseApiRuntimeOptions {
+  /** 延迟获取当前实例的视频，不在模块创建时缓存可能尚未生成的元素。 */
+  getVideoElement?: () => HTMLVideoElement | null;
+}
+/**
+ * MODEL 打点 API，复用既有场景对象；不读写平台 JSON、PointTool 文件或修改 MQTT 流程。
+ * PointTool 本地工作台对象仍由其自身管理；本期不支持独立 POI。
+ * @agentTitle 模型点位编辑
+ * @agentCapabilities 按坐标创建点位, 点击创建点位, 拖放创建点位, 落点坐标换算, 取消点位放置, 局部更新点位, 批量删除点位
+ * @hideconstructor
+ */
+declare class PointEditor extends BaseApi {
+  private readonly placement;
+  private readonly getVideo;
+  /** 取消/断连发生在异步校验或点击完成后时，也不能让旧操作继续发出创建请求。 */
+  private readonly placementState;
+  constructor(bridge: ApiBridge, runtimeOptions?: PointEditorRuntimeOptions);
+  /**
+   * 创建模型点位；未传 position/screenPosition 时等待视频区域的一次有效点击，可按 Escape/右键取消。
+   * 默认显示模型和附属 POI，缩放为 (1,1,1)，旋转为 (0,0,0)。
+   * @param payload - 网页分组、全局 ID、坐标及 UE 资源。
+   * @param callback - 成功收到实际点位；失败收到 Error。
+   * @returns UE 实际创建的点位，不是通用响应信封。
+   * @agentSideEffects write
+   * @agentPreconditions 已建立 WebRTC 连接，UE CoreModules 支持 sdk3 点位编辑
+   * @agentRiskLevel medium
+   * @agentExample { parentId: 'sdk3-point-editor-test', id: 'G-test-1', type: 'MODEL', position: { x: 120, y: 30, z: 5 }, resource: { path: '/Game/Devices/BP_Camera.BP_Camera_C' } }
+   * @example
+   * ```ts
+   * const point = await dtcEngine.PointEditor.addPoint({
+   *   parentId: 'sdk3-point-editor-test', id: 'G-test-1', type: 'MODEL',
+   *   position: { x: 120, y: 30, z: 5 },
+   *   resource: { path: '/Game/Devices/BP_Camera.BP_Camera_C' }
+   * });
+   * console.log(point.position);
+   * ```
+   */
+  addPoint(payload: PointEditorAddRequest, callback?: PointEditorCreateCallback): Promise<PointEditorPoint>;
+  /**
+   * 拖放创建；使用 drop 当时保存的 screenPosition 或显式经纬高，不读取当前或上一次鼠标位置。
+   * @param payload - 点位参数及 position 或 screenPosition（二选一）。
+   * @param callback - 成功收到实际点位；失败收到 Error。
+   * @returns UE 实际创建的点位。
+   * @agentSideEffects write
+   * @agentPreconditions 已建立 WebRTC 连接；必须提供 position 或 drop 时记录的 screenPosition
+   * @agentRiskLevel medium
+   * @agentExample { parentId: 'sdk3-point-editor-test', id: 'G-test-2', type: 'MODEL', position: { x: 120, y: 30, z: 5 }, resource: { path: '/Game/Devices/BP_Camera.BP_Camera_C' } }
+   * @example
+   * ```ts
+   * await dtcEngine.PointEditor.addPointByDrag({ ...point, id: 'G-copy-1' }, (result) => {
+   *   if (result instanceof Error) return console.error(result);
+   *   console.log(result.position);
+   * });
+   * ```
+   */
+  addPointByDrag(payload: PointEditorAddRequest, callback?: PointEditorCreateCallback): Promise<PointEditorPoint>;
+  /**
+   * 在实际 drop 事件中同步换算位置，随后可等待后端保存；不在等待结束后重新读取鼠标。
+   * 校验有效视频区域并排除 contain 黑边，支持页面偏移、滚动及轴对齐 CSS 缩放。
+   * @param payload - 事件的 clientX/clientY，不是 pageX/pageY。
+   * @returns 视频完整图像中的归一化坐标。
+   * @agentSideEffects read
+   * @agentPreconditions 视频已就绪，必须使用真实 drop 事件坐标
+   * @agentRiskLevel low
+   * @agentExample { clientX: 400, clientY: 300 }
+   * @example
+   * ```ts
+   * const screenPosition = dtcEngine.PointEditor.getScreenPosition({ clientX: event.clientX, clientY: event.clientY });
+   * await savePointToBackend();
+   * await dtcEngine.PointEditor.addPointByDrag({ ...payload, screenPosition });
+   * ```
+   */
+  getScreenPosition(payload: PointEditorClientPosition): PointEditorScreenPosition;
+  /**
+   * 取消正在等待网页点击的放置操作并恢复输入；不撤销已经发送到 UE 的创建请求。
+   * @returns 取消完成；原 addPoint Promise 将以取消错误拒绝。
+   * @agentSideEffects write
+   * @agentRiskLevel low
+   * @example
+   * ```ts
+   * await dtcEngine.PointEditor.cancelPlacement();
+   * ```
+   */
+  cancelPlacement(): Promise<void>;
+  /**
+   * 局部更新 MODEL 及附属 POI；不传的字段保持原值，false、0 和空名称有效。
+   * @param payload - 点位定位条件及需要修改的属性；extraProps 整体替换。
+   * @param callback - 可选响应回调。
+   * @returns 通用响应信封。
+   * @agentSideEffects write
+   * @agentPreconditions 目标是既有场景加载或 API 创建的 MODEL；PointTool 本地工作台对象除外
+   * @agentRiskLevel medium
+   * @agentExample { parentId: 'sdk3-point-editor-test', id: 'G-test-1', type: 'MODEL', show: false }
+   * @example
+   * ```ts
+   * await dtcEngine.PointEditor.updatePoint({
+   *   parentId: 'sdk3-point-editor-test', id: 'G-test-1', type: 'MODEL',
+   *   name: '摄像机', poiOffsetY: 0, poiEnabled: false
+   * });
+   * ```
+   */
+  updatePoint(payload: PointEditorUpdateRequest, callback?: ApiCallback<ApiResponseEnvelope<unknown>>): Promise<ApiResponseEnvelope<unknown>>;
+  /**
+   * 批量删除网页模型点位及附属 POI；混入其他来源或纯 POI 目标时整批拒绝。
+   * @param payload - 分组与点位全局 ID。
+   * @param callback - 可选响应回调；params 中含 deletedIds 和 failedIds。
+   * @returns 通用响应信封，保留部分删除结果。
+   * @agentSideEffects write
+   * @agentPreconditions 目标属于场景 MODEL 点位管理范围，按 parentId/id 准确定位
+   * @agentRiskLevel high
+   * @agentExample { parentId: 'sdk3-point-editor-test', ids: ['G-test-1'] }
+   * @example
+   * ```ts
+   * await dtcEngine.PointEditor.deletePoints({ parentId: 'sdk3-point-editor-test', ids: ['G-test-1'] });
+   * ```
+   */
+  deletePoints(payload: PointEditorDeleteRequest, callback?: ApiCallback<ApiResponseEnvelope<PointEditorDeleteResult>>): Promise<ApiResponseEnvelope<PointEditorDeleteResult>>;
+  private readonly createPoint;
+}
+//#endregion
+//#region src/api/GizmosTool.d.ts
+/** @internal */
+interface GizmosToolRuntimeOptions extends BaseApiRuntimeOptions {
+  /** 编辑期间启用官方鼠标转发，返回仅调用一次的恢复函数。 */
+  beginMouseInput?: () => () => void;
+}
+/**
+ * 网页 MODEL 运行时编辑，不开启本地工作台，不保存 PointTool 文件。
+ * @agentTitle 模型交互编辑
+ * @agentCapabilities 开启模型编辑, 切换编辑目标, 退出模型编辑
+ * @hideconstructor
+ */
+declare class GizmosTool extends BaseApi {
+  private readonly options?;
+  private restoreInput?;
+  private sequence;
+  private sessionVersion;
+  constructor(bridge: ApiBridge, options?: GizmosToolRuntimeOptions | undefined);
+  /**
+   * 开启或切换模型编辑目标，同时显示平移、旋转和缩放手柄，无需指定编辑模式。
+   * 拖动过程中 UE 持续推送 ModelUpdate，SDK 不做时间防抖；业务端自行防抖保存。
+   * 取消拖动时会回传恢复后的变换，不能把任意一次事件视为后端已保存。
+   * @param payload - 网页 MODEL 的分组和点位标识。
+   * @param callback - 可选结果回调。
+   * @returns 开启结果，不代表后端已保存。
+   * @agentSideEffects write
+   * @agentPreconditions WebRTC 已连接；PointTool 本地工作台未占用输入
+   * @agentRiskLevel medium
+   * @agentExample { parentId: 'sdk3-point-editor-test', id: 'G-test-1' }
+   * @example
+   * ```ts
+   * await dtcEngine.GizmosTool.startSimpleGizmoMode({ parentId: point.parentId, id: point.id });
+   * ```
+   */
+  startSimpleGizmoMode(payload: GizmosStartSimpleRequest, callback?: ApiCallback<ApiResponseEnvelope<unknown>>): Promise<ApiResponseEnvelope<unknown>>;
+  /**
+   * 退出简易编辑并恢复进入前的鼠标转发配置，不保存本地点位文件。
+   * @param callback - 可选结果回调。
+   * @returns 退出结果。
+   * @agentSideEffects write
+   * @agentRiskLevel low
+   * @example
+   * ```ts
+   * await dtcEngine.GizmosTool.endSimpleGizmoMode();
+   * ```
+   */
+  endSimpleGizmoMode(callback?: ApiCallback<ApiResponseEnvelope<unknown>>): Promise<ApiResponseEnvelope<unknown>>;
+  /** @internal UE 因目标删除、Escape 等原因退出，恢复本地鼠标配置。 */
+  readonly finishFromEngine: () => void;
+  /** @internal 断连/重启时使旧队列失效，不让旧开启响应重新占用输入。 */
+  readonly resetRuntime: () => void;
+  /** 开启/退出串行执行，避免快速切换导致响应和本地输入状态乱序。 */
+  private readonly enqueue;
+}
+//#endregion
 //#region src/api/apiRegistry.d.ts
 /**
  * API 装配上下文，统一承载模块工厂需要的依赖。
@@ -6133,6 +6467,10 @@ interface ApiRegistryContext {
   createLogger: (moduleName: ApiModuleKey) => ModuleLogger;
   /** 前端 Popup 管理器。 */
   popupManager: PopupManager;
+  /** 当前实例的视频宿主，用于网页点位落点换算。 */
+  videoElementParent?: HTMLElement;
+  /** 临时启用官方鼠标输入，退出时恢复原配置。 */
+  beginPointEditorMouseInput?: () => () => void;
 }
 /**
  * 对外 API 门面与实例类型映射。
@@ -6152,6 +6490,10 @@ interface ApiInstanceMap {
   Navigation: Navigation;
   PathPatrol: PathPatrol;
   pointIcon: PointIcon;
+  /** 网页 MODEL 点位编辑（不支持独立 POI）。 */
+  PointEditor: PointEditor;
+  /** 网页 MODEL 的运行时 Gizmo。 */
+  GizmosTool: GizmosTool;
   HeatMap: HeatMap;
   HighlighterEffect: HighLighterEffect;
   Popup: Popup;
@@ -6809,6 +7151,8 @@ declare class DTCEngine {
     readonly SceneConfig: "SceneConfig";
     /** 模型点击事件 */
     readonly ModelClick: "ModelClick";
+    /** MODEL 拖动时持续推送变换；param 含 position/eulerAngles/scale，业务端自行防抖保存，取消时回传恢复值。 */
+    readonly ModelUpdate: "ModelUpdate";
     /** 相机高度 */
     readonly CameraHeight: "CameraHeight";
     /** 左键单击事件 */
@@ -6857,6 +7201,7 @@ declare class DTCEngine {
       readonly UltraPerformance: 7;
     };
     FilterMode: typeof FilterMode;
+    GizmoType: typeof GizmoType;
     LayerEnum: typeof LayerEnum;
     ModelTransformType: typeof ModelTransformType;
     ScreenRenderBitratePreset: {
@@ -6903,6 +7248,10 @@ declare class DTCEngine {
   readonly PathPatrol: ApiInstanceMap['PathPatrol'];
   /** 设备点位图标显隐控制模块。 */
   readonly pointIcon: ApiInstanceMap['pointIcon'];
+  /** 网页 MODEL 点位编辑，不接管 PointTool 本地点位。 */
+  readonly PointEditor: ApiInstanceMap['PointEditor'];
+  /** 网页模型交互编辑。 */
+  readonly GizmosTool: ApiInstanceMap['GizmosTool'];
   /** 高亮效果模块。 */
   readonly HighlighterEffect: ApiInstanceMap['HighlighterEffect'];
   /** 前端 Popup 模块。 */
@@ -7120,4 +7469,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 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 LayerResetPOINameRequest, type LayerSelectorRequest, type LayerShowUIPopRequest, type LayerSwitchModelRequest, type LayerUpdatePOINameRequest, 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, PointIcon, type PointIconIdsInput, type PointIconIdsRequest, type PointIconVisibilityResult, 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, TrainBehavior, TrainSimulate, type TrainSimulateSetCameraFollowTrainRequest, type TrainSimulateSetTrainBehaviorRequest, type TrainSimulateSetTrainVolumeRequest, type TrainSimulateStartTrainRequest, 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, GizmoType, type GizmosStartSimpleRequest, GizmosTool, 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 LayerResetPOINameRequest, type LayerSelectorRequest, type LayerShowUIPopRequest, type LayerSwitchModelRequest, type LayerUpdatePOINameRequest, 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, PointEditor, type PointEditorAddRequest, type PointEditorCategory, type PointEditorClientPosition, type PointEditorCreateCallback, type PointEditorDeleteRequest, type PointEditorDeleteResult, type PointEditorPoint, type PointEditorResource, type PointEditorScreenPosition, type PointEditorUpdateRequest, type PointEditorVector, PointIcon, type PointIconIdsInput, type PointIconIdsRequest, type PointIconVisibilityResult, 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, TrainBehavior, TrainSimulate, type TrainSimulateSetCameraFollowTrainRequest, type TrainSimulateSetTrainBehaviorRequest, type TrainSimulateSetTrainVolumeRequest, type TrainSimulateStartTrainRequest, 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, type WeatherSetVolumeRequest, WeatherSystem, type WeatherTypeRequest, WebView, type WebViewUpdateRequest, apiRegistry, createAgentBridgeMetadata, createApiFacade, createBridgeRuntime, getAgentBridgeMethodSchema, isAgentBridgeMethodExposed, isAgentBridgeModuleExposed, isAgentBridgeModuleName, listAgentBridgeMethods, listAgentBridgeModules, resolveAgentBridgeExposeConfig };