@nnepoch/dtc-sdk 3.0.16 → 3.0.17

package/docs/api/api/classes/GizmosTool.md

@@ -10,7 +10,7 @@
 
 ## Agent Capabilities
 
-开启模型编辑, 切换编辑目标, 退出模型编辑
+开启模型编辑, 切换编辑目标, 退出模型编辑, 模型表面吸附, 框选模型, 批量变换模型
 
 ## Extends
 
@@ -25,12 +25,13 @@
 开启或切换模型编辑目标，同时显示平移、旋转和缩放手柄，无需指定编辑模式。
 拖动过程中 UE 持续推送 ModelUpdate，SDK 不做时间防抖；业务端自行防抖保存。
 取消拖动时会回传恢复后的变换，不能把任意一次事件视为后端已保存。
+传 targets 可跨分组批量编辑，共用一个中心手柄；批量 ModelUpdate 包含整组选中模型。
 
 #### Parameters
 
 | Parameter | Type | Description |
 | ------ | ------ | ------ |
-| `payload` | [`GizmosStartSimpleRequest`](../../types/interfaces/GizmosStartSimpleRequest.md) | 网页 MODEL 的分组和点位标识。 |
+| `payload` | [`GizmosStartSimpleRequest`](../../types/interfaces/GizmosStartSimpleRequest.md) \| [`GizmosStartBatchRequest`](../../types/interfaces/GizmosStartBatchRequest.md) | 网页 MODEL 的分组和点位标识。 |
 | `callback?` | [`ApiCallback`](../../types/type-aliases/ApiCallback.md)\<[`ApiResponseEnvelope`](../../types/interfaces/ApiResponseEnvelope.md)\<`unknown`\>\> | 可选结果回调。 |
 
 #### Returns
@@ -92,3 +93,86 @@ low
 ```ts
 await dtcEngine.GizmosTool.endSimpleGizmoMode();
 ```
+
+***
+
+### selectModelsByPolygon()
+
+> **selectModelsByPolygon**(`payload`, `callback?`): `Promise`\<[`ApiResponseEnvelope`](../../types/interfaces/ApiResponseEnvelope.md)\<[`GizmosPolygonSelectResult`](../../types/interfaces/GizmosPolygonSelectResult.md)\>\>
+
+在指定网页分组及子分组中框选可见模型；不传 polygon 时左键拖框，Escape/右键取消。
+返回各模型的 parentId/id，不自动开启编辑；业务端取得全部分组锁后将 targets 传给 startSimpleGizmoMode。
+显式 polygon 使用视频图像归一化坐标，不含 contain 黑边；交互等待期间不占用 UE 请求超时。
+
+#### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `payload` | [`GizmosPolygonSelectRequest`](../../types/interfaces/GizmosPolygonSelectRequest.md) | 分组范围及可选多边形顶点。 |
+| `callback?` | [`ApiCallback`](../../types/type-aliases/ApiCallback.md)\<[`ApiResponseEnvelope`](../../types/interfaces/ApiResponseEnvelope.md)\<[`GizmosPolygonSelectResult`](../../types/interfaces/GizmosPolygonSelectResult.md)\>\> | 选择完成回调；取消或失败时收到 Error。 |
+
+#### Returns
+
+`Promise`\<[`ApiResponseEnvelope`](../../types/interfaces/ApiResponseEnvelope.md)\<[`GizmosPolygonSelectResult`](../../types/interfaces/GizmosPolygonSelectResult.md)\>\>
+
+选中模型身份列表，空区域返回空 targets。
+
+#### Agent Side Effects
+
+read
+
+#### Agent Preconditions
+
+WebRTC 已连接，UE 已编译框选服务
+
+#### Agent Risk Level
+
+low
+
+#### Agent Example
+
+***
+
+### modelSnapById()
+
+> **modelSnapById**(`payload`, `callback?`): `Promise`\<[`ApiResponseEnvelope`](../../types/interfaces/ApiResponseEnvelope.md)\<[`GizmosModelSnapResult`](../../types/interfaces/GizmosModelSnapResult.md)\>\>
+
+将指定模型或整个分组吸附到允许的最近表面，安装类型沿用 UE 资源绑定及点位安装属性。
+同步模型 POI，保留简易编辑手柄；整批成功点位通过一次 ModelUpdate 回传，由业务端防抖保存。
+未命中表面的模型保持原位；部分失败不会撤销其它成功模型，请检查 params.failedIds/errors。
+
+#### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `payload` | [`GizmosModelSnapRequest`](../../types/interfaces/GizmosModelSnapRequest.md) | 搜索分组及可选模型 ID，支持子分组；省略 ids 表示整个分组。 |
+| `callback?` | [`ApiCallback`](../../types/type-aliases/ApiCallback.md)\<[`ApiResponseEnvelope`](../../types/interfaces/ApiResponseEnvelope.md)\<[`GizmosModelSnapResult`](../../types/interfaces/GizmosModelSnapResult.md)\>\> | 可选结果回调。 |
+
+#### Returns
+
+`Promise`\<[`ApiResponseEnvelope`](../../types/interfaces/ApiResponseEnvelope.md)\<[`GizmosModelSnapResult`](../../types/interfaces/GizmosModelSnapResult.md)\>\>
+
+吸附明细，不代表平台已保存；请求无效或服务失败时 Promise 拒绝。
+
+#### Agent Side Effects
+
+write
+
+#### Agent Preconditions
+
+WebRTC 已连接；UE 已编译表面吸附服务；本地工作台未占用输入
+
+#### Agent Risk Level
+
+medium
+
+#### Agent Example
+
+#### Example
+
+```ts
+const result = await dtcEngine.GizmosTool.modelSnapById({ parentId: point.parentId, ids: [point.id] });
+console.log(result.params.snappedIds, result.params.failedIds);
+// 整组吸附（包括子分组）：
+await dtcEngine.GizmosTool.modelSnapById({ parentId: 'sdk3-point-editor-test' });
+```

package/docs/api/api/classes/Layer.md

@@ -10,7 +10,7 @@
 
 ## Agent Capabilities
 
-图层添加, 图层删除, 图层存在性查询, 模型图层切换, 图层气泡显隐, 图层模型添加, 图层模型删除, 图层子对象查询, POI名称更新, POI名称重置
+图层添加, 图层删除, 图层存在性查询, 模型图层切换, 图层气泡显隐, 图层模型添加, 图层模型删除, 图层子对象查询, POI名称更新, POI名称重置, 气泡状态更新
 
 ## Extends
 
@@ -463,6 +463,55 @@ low
 
 ***
 
+### updatePoiStates()
+
+> **updatePoiStates**(`payload`, `callback?`): `Promise`\<[`ApiResponseEnvelope`](../../types/interfaces/ApiResponseEnvelope.md)\<`unknown`\>\>
+
+更新分组下气泡的状态。
+`popStates` 为气泡状态列表，至少一个；`state` 支持 `normal` 正常、`alert` 警告、`offline` 离线。
+
+#### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `payload` | [`LayerUpdatePoiStatesRequest`](../../types/interfaces/LayerUpdatePoiStatesRequest.md) | 气泡状态更新参数。 |
+| `callback?` | [`ApiCallback`](../../types/type-aliases/ApiCallback.md)\<[`ApiResponseEnvelope`](../../types/interfaces/ApiResponseEnvelope.md)\<`unknown`\>\> | 可选回调函数。 |
+
+#### Returns
+
+`Promise`\<[`ApiResponseEnvelope`](../../types/interfaces/ApiResponseEnvelope.md)\<`unknown`\>\>
+
+Promise 形式的接口响应。
+
+#### Agent Side Effects
+
+write
+
+#### Agent Preconditions
+
+DTCEngine 已完成鉴权并建立 WebRTC 连接
+
+#### Agent Risk Level
+
+low
+
+#### Agent Example
+
+#### Example
+
+```ts
+ let poiStates = [
+   { id: '1', state: 'normal' }, // normal 正常; alert 警告状态; offline 离线状态
+   { id: '2', state: 'alert' }
+ ];
+ dtcEngine.Layer.updatePoiStates(
+   { parentId: 'LCD80CunXianShiPingPop', poiStates: poiStates },
+   (result) => { console.log(result); }
+ );
+```
+
+***
+
 ### removeModel()
 
 > **removeModel**(`payload`, `callback?`): `Promise`\<[`ApiResponseEnvelope`](../../types/interfaces/ApiResponseEnvelope.md)\<`unknown`\>\>

package/docs/api/api/classes/Model.md

@@ -108,9 +108,9 @@ low
 
 ***
 
-### setVisibleByAttibute()
+### setVisibleByAttribute()
 
-> **setVisibleByAttibute**(`payload`, `callback?`): `Promise`\<[`ApiResponseEnvelope`](../../types/interfaces/ApiResponseEnvelope.md)\<`unknown`\>\>
+> **setVisibleByAttribute**(`payload`, `callback?`): `Promise`\<[`ApiResponseEnvelope`](../../types/interfaces/ApiResponseEnvelope.md)\<`unknown`\>\>
 
 按对象属性过滤设置模型对象显隐状态。
 默认值：`filterMode=FilterMode.Loose`、`visible=true`、`otherVisible=false`。
@@ -148,20 +148,20 @@ low
 
 ```ts
 // 隐藏 floor='B2' 的对象
-dtcEngine.Model.setVisibleByAttibute({ attributes: { floor: 'B2' }, filterMode: dtcEngine.Enums.FilterMode.Loose, visible: false }, (result) => { console.log(result); });
+dtcEngine.Model.setVisibleByAttribute({ attributes: { floor: 'B2' }, filterMode: dtcEngine.Enums.FilterMode.Loose, visible: false }, (result) => { console.log(result); });
 // 显示 floor='B2' 的对象
-dtcEngine.Model.setVisibleByAttibute({ attributes: { floor: 'B2' }, filterMode: dtcEngine.Enums.FilterMode.Loose, visible: true }, (result) => { console.log(result); });
+dtcEngine.Model.setVisibleByAttribute({ attributes: { floor: 'B2' }, filterMode: dtcEngine.Enums.FilterMode.Loose, visible: true }, (result) => { console.log(result); });
 ```
 
 **严格过滤 Strict：floor='B1' 的对象按 visible 控制，其它楼层对象按 otherVisible 控制**
 
 ```ts
 // 隐藏 floor='B1' 的对象，其它楼层对象也隐藏
-dtcEngine.Model.setVisibleByAttibute({ attributes: { floor: 'B1' }, filterMode: dtcEngine.Enums.FilterMode.Strict, visible: false, otherVisible: false }, (result) => { console.log(result); });
+dtcEngine.Model.setVisibleByAttribute({ attributes: { floor: 'B1' }, filterMode: dtcEngine.Enums.FilterMode.Strict, visible: false, otherVisible: false }, (result) => { console.log(result); });
 // 隐藏 floor='B1' 的对象，其它楼层对象显示
-dtcEngine.Model.setVisibleByAttibute({ attributes: { floor: 'B1' }, filterMode: dtcEngine.Enums.FilterMode.Strict, visible: false, otherVisible: true }, (result) => { console.log(result); });
+dtcEngine.Model.setVisibleByAttribute({ attributes: { floor: 'B1' }, filterMode: dtcEngine.Enums.FilterMode.Strict, visible: false, otherVisible: true }, (result) => { console.log(result); });
 // 显示 floor='B1' 的对象，其它楼层对象隐藏
-dtcEngine.Model.setVisibleByAttibute({ attributes: { floor: 'B1' }, filterMode: dtcEngine.Enums.FilterMode.Strict, visible: true, otherVisible: false }, (result) => { console.log(result); });
+dtcEngine.Model.setVisibleByAttribute({ attributes: { floor: 'B1' }, filterMode: dtcEngine.Enums.FilterMode.Strict, visible: true, otherVisible: false }, (result) => { console.log(result); });
 ```
 
 ***

package/docs/api/api/classes/Scene.md

@@ -53,9 +53,9 @@ low
 #### Example
 
 ```ts
-dtcEngine.Scene.getAllSceneName((data) => {
-  console.log(data);
-});
+ dtcEngine.Scene.getAllSceneName((data) => {
+   console.log(data);
+ });
 ```
 
 ***
@@ -96,9 +96,9 @@ low
 #### Example
 
 ```ts
-dtcEngine.Scene.switchSceneByName({ sceneName: 'TestScene' }, (result) => {
-  console.log(result);
-});
+ dtcEngine.Scene.switchSceneByName({ sceneName: 'TestScene' }, (result) => {
+   console.log(result);
+ });
 ```
 
 ***
@@ -142,131 +142,3 @@ dtcEngine.Scene.getCurrentSceneName((result) => {
   console.log(result);
 });
 ```
-
-***
-
-### listenMapCompass()
-
-> **listenMapCompass**(`payload`, `callback?`): `Promise`\<[`ApiResponseEnvelope`](../../types/interfaces/ApiResponseEnvelope.md)\<`unknown`\>\>
-
-监听地图指北针角度变化。
-
-#### Parameters
-
-| Parameter | Type | Description |
-| ------ | ------ | ------ |
-| `payload` | [`SceneListenCompassRequest`](../../types/interfaces/SceneListenCompassRequest.md) | 开关参数。 |
-| `callback?` | [`ApiCallback`](../../types/type-aliases/ApiCallback.md)\<[`ApiResponseEnvelope`](../../types/interfaces/ApiResponseEnvelope.md)\<`unknown`\>\> | 可选回调函数。 |
-
-#### Returns
-
-`Promise`\<[`ApiResponseEnvelope`](../../types/interfaces/ApiResponseEnvelope.md)\<`unknown`\>\>
-
-Promise 形式的接口响应。
-
-#### Agent Side Effects
-
-write
-
-#### Agent Preconditions
-
-DTCEngine 已完成鉴权并建立 WebRTC 连接
-
-#### Agent Risk Level
-
-low
-
-#### Agent Example
-
-#### Example
-
-```ts
-dtcEngine.Scene.listenMapCompass({ enable: true }, (result) => {
-  console.log(result);
-});
-```
-
-***
-
-### setFeatureToggle()
-
-> **setFeatureToggle**(`payload`, `callback?`): `Promise`\<[`ApiResponseEnvelope`](../../types/interfaces/ApiResponseEnvelope.md)\<`unknown`\>\>
-
-设置场景特性开关。
-
-#### Parameters
-
-| Parameter | Type | Description |
-| ------ | ------ | ------ |
-| `payload` | [`FeatureToggleRequest`](../../types/interfaces/FeatureToggleRequest.md) | 特性键值。 |
-| `callback?` | [`ApiCallback`](../../types/type-aliases/ApiCallback.md)\<[`ApiResponseEnvelope`](../../types/interfaces/ApiResponseEnvelope.md)\<`unknown`\>\> | 可选回调函数。 |
-
-#### Returns
-
-`Promise`\<[`ApiResponseEnvelope`](../../types/interfaces/ApiResponseEnvelope.md)\<`unknown`\>\>
-
-Promise 形式的接口响应。
-
-#### Agent Side Effects
-
-write
-
-#### Agent Preconditions
-
-DTCEngine 已完成鉴权并建立 WebRTC 连接
-
-#### Agent Risk Level
-
-low
-
-#### Agent Example
-
-#### Example
-
-```ts
-dtcEngine.Scene.setFeatureToggle({ key: 'minimap', enabled: true }, (result) => {
-  console.log(result);
-});
-```
-
-***
-
-### getSceneMeta()
-
-> **getSceneMeta**(`callback?`): `Promise`\<[`ApiResponseEnvelope`](../../types/interfaces/ApiResponseEnvelope.md)\<`unknown`\>\>
-
-获取当前场景扩展元信息。
-
-#### Parameters
-
-| Parameter | Type | Description |
-| ------ | ------ | ------ |
-| `callback?` | [`ApiCallback`](../../types/type-aliases/ApiCallback.md)\<[`ApiResponseEnvelope`](../../types/interfaces/ApiResponseEnvelope.md)\<`unknown`\>\> | 可选回调函数。 |
-
-#### Returns
-
-`Promise`\<[`ApiResponseEnvelope`](../../types/interfaces/ApiResponseEnvelope.md)\<`unknown`\>\>
-
-Promise 形式的接口响应。
-
-#### Agent Side Effects
-
-read
-
-#### Agent Preconditions
-
-DTCEngine 已完成鉴权并建立 WebRTC 连接
-
-#### Agent Risk Level
-
-low
-
-#### Agent Example
-
-#### Example
-
-```ts
-dtcEngine.Scene.getSceneMeta((result) => {
-  console.log(result);
-});
-```

package/docs/api/api/classes/UIPOI.md

@@ -192,9 +192,9 @@ dtcEngine.UIPOI.update(
 
 ***
 
-### updatePopStates()
+### updatePoiStates()
 
-> **updatePopStates**(`payload`, `callback?`): `Promise`\<[`ApiResponseEnvelope`](../../types/interfaces/ApiResponseEnvelope.md)\<`unknown`\>\>
+> **updatePoiStates**(`payload`, `callback?`): `Promise`\<[`ApiResponseEnvelope`](../../types/interfaces/ApiResponseEnvelope.md)\<`unknown`\>\>
 
 批量更新 UIPOI 状态。
 
@@ -228,8 +228,8 @@ low
 #### Example
 
 ```ts
-dtcEngine.UIPOI.updatePopStates(
-  { groupName: 'LCD80CunXianShiPingPop', popStates: [{ id: '1', state: 'normal' }] },
+dtcEngine.UIPOI.updatePoiStates(
+  { parentId: 'LCD80CunXianShiPingPop', poiStates: [{ id: '1', state: 'normal' }] },
   (result) => { console.log(result); }
 );
 ```

package/docs/api/application/DTCEngine/classes/DTCEngine.md

@@ -467,6 +467,10 @@ Auto 模式会根据系统性能自动选择最合适的 DLSS 质量档位，提
 
 > **TrainBehavior**: *typeof* [`TrainBehavior`](../../../types/enumerations/TrainBehavior.md)
 
+#### UIPopState
+
+> **UIPopState**: *typeof* [`UIPopState`](../../../types/enumerations/UIPopState.md)
+
 #### VideoCodeType
 
 > **VideoCodeType**: *typeof* [`VideoCodeType`](../../../types/enumerations/VideoCodeType.md)

package/docs/api/index.md

@@ -1,4 +1,4 @@
-# @nnepoch/dtc-sdk v3.0.11
+# @nnepoch/dtc-sdk v3.0.17
 
 ## Modules
 

package/docs/api/typedoc-sidebar.json

@@ -250,6 +250,10 @@
             "text": "TrainBehavior",
             "link": "/api/types/enumerations/TrainBehavior.md"
           },
+          {
+            "text": "UIPopState",
+            "link": "/api/types/enumerations/UIPopState.md"
+          },
           {
             "text": "GizmoType",
             "link": "/api/types/enumerations/GizmoType.md"
@@ -380,6 +384,18 @@
             "text": "GizmosStartSimpleRequest",
             "link": "/api/types/interfaces/GizmosStartSimpleRequest.md"
           },
+          {
+            "text": "GizmosStartBatchRequest",
+            "link": "/api/types/interfaces/GizmosStartBatchRequest.md"
+          },
+          {
+            "text": "GizmosPolygonSelectRequest",
+            "link": "/api/types/interfaces/GizmosPolygonSelectRequest.md"
+          },
+          {
+            "text": "GizmosPolygonSelectResult",
+            "link": "/api/types/interfaces/GizmosPolygonSelectResult.md"
+          },
           {
             "text": "PointEditorVector",
             "link": "/api/types/interfaces/PointEditorVector.md"
@@ -412,6 +428,14 @@
             "text": "PointEditorDeleteResult",
             "link": "/api/types/interfaces/PointEditorDeleteResult.md"
           },
+          {
+            "text": "GizmosModelSnapRequest",
+            "link": "/api/types/interfaces/GizmosModelSnapRequest.md"
+          },
+          {
+            "text": "GizmosModelSnapResult",
+            "link": "/api/types/interfaces/GizmosModelSnapResult.md"
+          },
           {
             "text": "QosSessionContext",
             "link": "/api/types/interfaces/QosSessionContext.md"
@@ -540,6 +564,14 @@
             "text": "LayerResetPOINameRequest",
             "link": "/api/types/interfaces/LayerResetPOINameRequest.md"
           },
+          {
+            "text": "LayerPoiStateRequest",
+            "link": "/api/types/interfaces/LayerPoiStateRequest.md"
+          },
+          {
+            "text": "LayerUpdatePoiStatesRequest",
+            "link": "/api/types/interfaces/LayerUpdatePoiStatesRequest.md"
+          },
           {
             "text": "LayerModelAddRequest",
             "link": "/api/types/interfaces/LayerModelAddRequest.md"
@@ -918,6 +950,10 @@
             "text": "NetworkAdaptationActionType",
             "link": "/api/types/type-aliases/NetworkAdaptationActionType.md"
           },
+          {
+            "text": "GizmosModelTarget",
+            "link": "/api/types/type-aliases/GizmosModelTarget.md"
+          },
           {
             "text": "PointEditorUpdateRequest",
             "link": "/api/types/type-aliases/PointEditorUpdateRequest.md"

package/docs/api/types/enumerations/FilterMode.md

@@ -2,7 +2,7 @@
 
 # Enumeration: FilterMode
 
-Model.setVisibleByAttibute 过滤模式。
+Model.setVisibleByAttribute 过滤模式。
 
 ## Enumeration Members
 

package/docs/api/types/enumerations/UIPopState.md

@@ -0,0 +1,29 @@
+[@nnepoch/dtc-sdk](../../index.md) / [types](../index.md) / UIPopState
+
+# Enumeration: UIPopState
+
+Layer.updatePoiStates 气泡状态。
+
+## Enumeration Members
+
+### Normal
+
+> **Normal**: `"normal"`
+
+正常状态。
+
+***
+
+### Alert
+
+> **Alert**: `"alert"`
+
+警告状态。
+
+***
+
+### Offline
+
+> **Offline**: `"offline"`
+
+离线状态。

package/docs/api/types/index.md

@@ -9,6 +9,7 @@
 - [ModelTransformType](enumerations/ModelTransformType.md)
 - [FilterMode](enumerations/FilterMode.md)
 - [TrainBehavior](enumerations/TrainBehavior.md)
+- [UIPopState](enumerations/UIPopState.md)
 - [GizmoType](enumerations/GizmoType.md)
 
 ## Interfaces
@@ -43,6 +44,9 @@
 - [NetworkDecisionTrace](interfaces/NetworkDecisionTrace.md)
 - [NetworkDiagnosticsSnapshot](interfaces/NetworkDiagnosticsSnapshot.md)
 - [GizmosStartSimpleRequest](interfaces/GizmosStartSimpleRequest.md)
+- [GizmosStartBatchRequest](interfaces/GizmosStartBatchRequest.md)
+- [GizmosPolygonSelectRequest](interfaces/GizmosPolygonSelectRequest.md)
+- [GizmosPolygonSelectResult](interfaces/GizmosPolygonSelectResult.md)
 - [PointEditorVector](interfaces/PointEditorVector.md)
 - [PointEditorResource](interfaces/PointEditorResource.md)
 - [PointEditorCategory](interfaces/PointEditorCategory.md)
@@ -51,6 +55,8 @@
 - [PointEditorAddRequest](interfaces/PointEditorAddRequest.md)
 - [PointEditorDeleteRequest](interfaces/PointEditorDeleteRequest.md)
 - [PointEditorDeleteResult](interfaces/PointEditorDeleteResult.md)
+- [GizmosModelSnapRequest](interfaces/GizmosModelSnapRequest.md)
+- [GizmosModelSnapResult](interfaces/GizmosModelSnapResult.md)
 - [QosSessionContext](interfaces/QosSessionContext.md)
 - [QosRuntimeContext](interfaces/QosRuntimeContext.md)
 - [QosWarnErrorSummary](interfaces/QosWarnErrorSummary.md)
@@ -83,6 +89,8 @@
 - [LayerPOIAddRequest](interfaces/LayerPOIAddRequest.md)
 - [LayerUpdatePOINameRequest](interfaces/LayerUpdatePOINameRequest.md)
 - [LayerResetPOINameRequest](interfaces/LayerResetPOINameRequest.md)
+- [LayerPoiStateRequest](interfaces/LayerPoiStateRequest.md)
+- [LayerUpdatePoiStatesRequest](interfaces/LayerUpdatePoiStatesRequest.md)
 - [LayerModelAddRequest](interfaces/LayerModelAddRequest.md)
 - [LayerModelRemoveRequest](interfaces/LayerModelRemoveRequest.md)
 - [LayerChildElementRequest](interfaces/LayerChildElementRequest.md)
@@ -179,6 +187,7 @@
 - [NetworkAdaptationLevel](type-aliases/NetworkAdaptationLevel.md)
 - [NetworkAdaptationMode](type-aliases/NetworkAdaptationMode.md)
 - [NetworkAdaptationActionType](type-aliases/NetworkAdaptationActionType.md)
+- [GizmosModelTarget](type-aliases/GizmosModelTarget.md)
 - [PointEditorUpdateRequest](type-aliases/PointEditorUpdateRequest.md)
 - [PointEditorPoint](type-aliases/PointEditorPoint.md)
 - [PointEditorCreateCallback](type-aliases/PointEditorCreateCallback.md)

package/docs/api/types/interfaces/BuildingFloorItem.md

@@ -27,3 +27,19 @@ UE 楼层节点 ID。
 > `optional` **objects?**: `string`[]
 
 切换到该楼层后显示的附属对象。
+
+***
+
+### showLayers?
+
+> `optional` **showLayers?**: `string`[]
+
+切层动画开始前显示的对象 ID；不限定于楼层父节点。
+
+***
+
+### hideLayers?
+
+> `optional` **hideLayers?**: `string`[]
+
+切层动画开始前隐藏的对象 ID；与 objects/showLayers 重复时隐藏优先。

package/docs/api/types/interfaces/BuildingFloorOverview.md

@@ -14,6 +14,22 @@
 
 ***
 
+### showLayers?
+
+> `optional` **showLayers?**: `string`[]
+
+恢复整栋视图时，在动画开始前显示的对象 ID。
+
+***
+
+### hideLayers?
+
+> `optional` **hideLayers?**: `string`[]
+
+恢复整栋视图时，在动画开始前隐藏的对象 ID；隐藏优先。
+
+***
+
 ### viewPoint?
 
 > `optional` **viewPoint?**: [`BuildingFloorViewPoint`](BuildingFloorViewPoint.md)

package/docs/api/types/interfaces/GizmosModelSnapRequest.md

@@ -0,0 +1,21 @@
+[@nnepoch/dtc-sdk](../../index.md) / [types](../index.md) / GizmosModelSnapRequest
+
+# Interface: GizmosModelSnapRequest
+
+在网页模型分组（含子分组）中执行表面吸附。
+
+## Properties
+
+### parentId
+
+> **parentId**: `string`
+
+搜索范围对应的分组 ID；跨组选择时可使用 EditorLayerGroup。
+
+***
+
+### ids?
+
+> `optional` **ids?**: `string`[]
+
+指定点位全局 ID；省略时吸附整个分组，不允许空数组或重复 ID。

package/docs/api/types/interfaces/GizmosModelSnapResult.md

@@ -0,0 +1,37 @@
+[@nnepoch/dtc-sdk](../../index.md) / [types](../index.md) / GizmosModelSnapResult
+
+# Interface: GizmosModelSnapResult
+
+吸附允许部分成功；只对成功点位触发 ModelUpdate，不代表平台已保存。
+
+## Properties
+
+### snappedIds
+
+> **snappedIds**: `string`[]
+
+成功吸附的模型 ID。
+
+***
+
+### failedIds
+
+> **failedIds**: `string`[]
+
+未命中允许表面、坐标转换失败等原因导致未吸附的模型 ID。
+
+***
+
+### errors
+
+> **errors**: `object`[]
+
+对应失败点位的具体原因。
+
+#### id
+
+> **id**: `string`
+
+#### message
+
+> **message**: `string`