@nnepoch/dtc-sdk 3.0.9 → 3.0.10

package/dist/cjs/index.d.cts

@@ -1289,8 +1289,8 @@ interface LayerPOIAddRequest {
   description?: string;
   /** 模型是否为系统模型。true--断开连接不删除，false--断开连接删除。如果图层为非系统的，也会删除 */
   isSystem?: boolean;
-  /** poi的文本 */
-  text?: string;
+  /** poi的名称 */
+  name?: string;
   /** poi的字体大小,默认为 16 */
   fontSize?: number;
   /** 模型的标签 */
@@ -1298,6 +1298,28 @@ interface LayerPOIAddRequest {
   /** 扩展属性，json对象，可不填写 */
   extraProps?: any;
 }
+/**
+ * Layer.updatePOIName 参数。
+ */
+interface LayerUpdatePOINameRequest {
+  /** 场景中参照绑定的位置的对象上级编号，可不填，但要保证 id 唯一。 */
+  parentId?: string;
+  /** POI 对象编号，必填。 */
+  id: string;
+  /** POI 显示文本。 */
+  name: string;
+  /** 文本更新方式：update 更新、append 追加、remove 移除。默认 update。 */
+  updateType?: string;
+}
+/**
+ * Layer.resetPOIName 参数。
+ */
+interface LayerResetPOINameRequest {
+  /** 场景中参照绑定的位置的对象上级编号，可不填，但要保证 ids 唯一。 */
+  parentId?: string;
+  /** POI 对象编号集合，至少一个。 */
+  ids: string[];
+}
 /**
  * Layer.addModel 参数。
  */
@@ -3577,7 +3599,7 @@ declare class Scene extends BaseApi {
 /**
  * 场景图层对象管理 API。
  * @agentTitle 图层管理
- * @agentCapabilities 图层添加, 图层删除, 图层存在性查询, 模型图层切换, 图层气泡显隐, 图层模型添加, 图层模型删除, 图层子对象查询
+ * @agentCapabilities 图层添加, 图层删除, 图层存在性查询, 模型图层切换, 图层气泡显隐, 图层模型添加, 图层模型删除, 图层子对象查询, POI名称更新, POI名称重置
  * @hideconstructor
  */
 declare class Layer extends BaseApi {
@@ -3743,6 +3765,57 @@ declare class Layer extends BaseApi {
     * ```
     */
   addPOI(payload: LayerPOIAddRequest, callback?: ApiCallback<ApiResponseEnvelope<unknown>>): Promise<ApiResponseEnvelope<unknown>>;
+  /**
+     * 更新 POI 气泡的显示文本。
+     * 默认值：`updateType='update'`。`updateType` 支持 `update` 更新、`append` 追加、`remove` 移除。
+     * @param payload - POI 文本更新参数。
+     * @param callback - 可选回调函数。
+     * @returns Promise 形式的接口响应。
+     * @agentSideEffects write
+     * @agentPreconditions DTCEngine 已完成鉴权并建立 WebRTC 连接
+     * @agentRiskLevel low
+     * @agentExample { parentId: 'CameraLayerModel', id: 'camera01', name: '一体化球击摄像机', updateType: 'update' }
+     * @example
+     * ```ts
+     * 示例1： 追加文本
+      dtcEngine.Layer.updatePOIName(
+        { parentId: 'CameraLayerModel', id: 'camera01', name: '一体化球击摄像机', updateType: "append" },
+        (result) => { console.log(result); }
+      );
+  
+  
+     * 示例2： 移除文本
+      dtcEngine.Layer.updatePOIName(
+        { parentId: 'CameraLayerModel', id: 'camera01', name: '一体化球击摄像机', updateType: "remove" },
+        (result) => { console.log(result); }
+      );
+      * 示例3： 更新文本
+      dtcEngine.Layer.updatePOIName(
+        { parentId: 'CameraLayerModel', id: 'camera01', name: '一体化球击摄像机', updateType: "update" },
+        (result) => { console.log(result); }
+      );
+     * ```
+     */
+  updatePOIName(payload: LayerUpdatePOINameRequest, callback?: ApiCallback<ApiResponseEnvelope<unknown>>): Promise<ApiResponseEnvelope<unknown>>;
+  /***
+     * 重置 POI 气泡的显示文本。
+     * `ids` 为 POI 对象编号集合，至少一个。
+     * @param payload - POI 文本重置参数。
+     * @param callback - 可选回调函数。
+     * @returns Promise 形式的接口响应。
+     * @agentSideEffects write
+     * @agentPreconditions DTCEngine 已完成鉴权并建立 WebRTC 连接
+     * @agentRiskLevel low
+     * @agentExample { parentId: 'CameraLayerModel', ids: ['camera01', 'camera02'] }
+     * @example
+     * ```ts
+      dtcEngine.Layer.resetPOIName(
+        { parentId: 'CameraLayerModel', ids: ['camera01', 'camera02'] },
+        (result) => { console.log(result); }
+      );
+     * ```
+     */
+  resetPOIName(payload: LayerResetPOINameRequest, callback?: ApiCallback<ApiResponseEnvelope<unknown>>): Promise<ApiResponseEnvelope<unknown>>;
   /**
      * 删除图层下指定模型资源。
      * @param payload - 模型删除参数。
@@ -5916,13 +5989,14 @@ declare class TrainSimulate extends BaseApi {
      * @agentSideEffects write
      * @agentPreconditions DTCEngine 已完成鉴权并建立 WebRTC 连接
      * @agentRiskLevel low
-     * @agentExample { parentId: 'RailTrains', id: 'DTrain1', volumeOn: false } => { code: 0, message: 'success', data: null }
+     * @agentExample { parentId: 'RailTrains', id: 'DTrain1', volumeOn: false }
      * @example
      * ```ts
      dtcEngine.TrainSimulate.setTrainVolume(
         { parentId: '', id: 'Train1', volumeOn: false },
         (result) => { console.log(result); }
       );
+     // 响应示例：{ code: 0, message: 'success', data: null }
      * ```
      */
   setTrainVolume(payload: TrainSimulateSetTrainVolumeRequest, callback?: ApiCallback<ApiResponseEnvelope<unknown>>): Promise<ApiResponseEnvelope<unknown>>;
@@ -7046,4 +7120,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 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, 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, 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 };

package/dist/esm/index.d.ts

@@ -1289,8 +1289,8 @@ interface LayerPOIAddRequest {
   description?: string;
   /** 模型是否为系统模型。true--断开连接不删除，false--断开连接删除。如果图层为非系统的，也会删除 */
   isSystem?: boolean;
-  /** poi的文本 */
-  text?: string;
+  /** poi的名称 */
+  name?: string;
   /** poi的字体大小,默认为 16 */
   fontSize?: number;
   /** 模型的标签 */
@@ -1298,6 +1298,28 @@ interface LayerPOIAddRequest {
   /** 扩展属性，json对象，可不填写 */
   extraProps?: any;
 }
+/**
+ * Layer.updatePOIName 参数。
+ */
+interface LayerUpdatePOINameRequest {
+  /** 场景中参照绑定的位置的对象上级编号，可不填，但要保证 id 唯一。 */
+  parentId?: string;
+  /** POI 对象编号，必填。 */
+  id: string;
+  /** POI 显示文本。 */
+  name: string;
+  /** 文本更新方式：update 更新、append 追加、remove 移除。默认 update。 */
+  updateType?: string;
+}
+/**
+ * Layer.resetPOIName 参数。
+ */
+interface LayerResetPOINameRequest {
+  /** 场景中参照绑定的位置的对象上级编号，可不填，但要保证 ids 唯一。 */
+  parentId?: string;
+  /** POI 对象编号集合，至少一个。 */
+  ids: string[];
+}
 /**
  * Layer.addModel 参数。
  */
@@ -3577,7 +3599,7 @@ declare class Scene extends BaseApi {
 /**
  * 场景图层对象管理 API。
  * @agentTitle 图层管理
- * @agentCapabilities 图层添加, 图层删除, 图层存在性查询, 模型图层切换, 图层气泡显隐, 图层模型添加, 图层模型删除, 图层子对象查询
+ * @agentCapabilities 图层添加, 图层删除, 图层存在性查询, 模型图层切换, 图层气泡显隐, 图层模型添加, 图层模型删除, 图层子对象查询, POI名称更新, POI名称重置
  * @hideconstructor
  */
 declare class Layer extends BaseApi {
@@ -3743,6 +3765,57 @@ declare class Layer extends BaseApi {
     * ```
     */
   addPOI(payload: LayerPOIAddRequest, callback?: ApiCallback<ApiResponseEnvelope<unknown>>): Promise<ApiResponseEnvelope<unknown>>;
+  /**
+     * 更新 POI 气泡的显示文本。
+     * 默认值：`updateType='update'`。`updateType` 支持 `update` 更新、`append` 追加、`remove` 移除。
+     * @param payload - POI 文本更新参数。
+     * @param callback - 可选回调函数。
+     * @returns Promise 形式的接口响应。
+     * @agentSideEffects write
+     * @agentPreconditions DTCEngine 已完成鉴权并建立 WebRTC 连接
+     * @agentRiskLevel low
+     * @agentExample { parentId: 'CameraLayerModel', id: 'camera01', name: '一体化球击摄像机', updateType: 'update' }
+     * @example
+     * ```ts
+     * 示例1： 追加文本
+      dtcEngine.Layer.updatePOIName(
+        { parentId: 'CameraLayerModel', id: 'camera01', name: '一体化球击摄像机', updateType: "append" },
+        (result) => { console.log(result); }
+      );
+  
+  
+     * 示例2： 移除文本
+      dtcEngine.Layer.updatePOIName(
+        { parentId: 'CameraLayerModel', id: 'camera01', name: '一体化球击摄像机', updateType: "remove" },
+        (result) => { console.log(result); }
+      );
+      * 示例3： 更新文本
+      dtcEngine.Layer.updatePOIName(
+        { parentId: 'CameraLayerModel', id: 'camera01', name: '一体化球击摄像机', updateType: "update" },
+        (result) => { console.log(result); }
+      );
+     * ```
+     */
+  updatePOIName(payload: LayerUpdatePOINameRequest, callback?: ApiCallback<ApiResponseEnvelope<unknown>>): Promise<ApiResponseEnvelope<unknown>>;
+  /***
+     * 重置 POI 气泡的显示文本。
+     * `ids` 为 POI 对象编号集合，至少一个。
+     * @param payload - POI 文本重置参数。
+     * @param callback - 可选回调函数。
+     * @returns Promise 形式的接口响应。
+     * @agentSideEffects write
+     * @agentPreconditions DTCEngine 已完成鉴权并建立 WebRTC 连接
+     * @agentRiskLevel low
+     * @agentExample { parentId: 'CameraLayerModel', ids: ['camera01', 'camera02'] }
+     * @example
+     * ```ts
+      dtcEngine.Layer.resetPOIName(
+        { parentId: 'CameraLayerModel', ids: ['camera01', 'camera02'] },
+        (result) => { console.log(result); }
+      );
+     * ```
+     */
+  resetPOIName(payload: LayerResetPOINameRequest, callback?: ApiCallback<ApiResponseEnvelope<unknown>>): Promise<ApiResponseEnvelope<unknown>>;
   /**
      * 删除图层下指定模型资源。
      * @param payload - 模型删除参数。
@@ -5916,13 +5989,14 @@ declare class TrainSimulate extends BaseApi {
      * @agentSideEffects write
      * @agentPreconditions DTCEngine 已完成鉴权并建立 WebRTC 连接
      * @agentRiskLevel low
-     * @agentExample { parentId: 'RailTrains', id: 'DTrain1', volumeOn: false } => { code: 0, message: 'success', data: null }
+     * @agentExample { parentId: 'RailTrains', id: 'DTrain1', volumeOn: false }
      * @example
      * ```ts
      dtcEngine.TrainSimulate.setTrainVolume(
         { parentId: '', id: 'Train1', volumeOn: false },
         (result) => { console.log(result); }
       );
+     // 响应示例：{ code: 0, message: 'success', data: null }
      * ```
      */
   setTrainVolume(payload: TrainSimulateSetTrainVolumeRequest, callback?: ApiCallback<ApiResponseEnvelope<unknown>>): Promise<ApiResponseEnvelope<unknown>>;
@@ -7046,4 +7120,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 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, 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, 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 };