@ray-js/robot-map-sdk 0.0.14-beta.5 → 0.0.14
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/constant/methods.js +1 -1
- package/dist/index.d.ts +61 -6
- package/dist/index.rjs.js +1 -1
- package/dist-app/assets/{index-DkctDXPP.js → index-BNBxfMSM.js} +1 -1
- package/dist-app/index.html +1 -1
- package/dist-docs/404.html +2 -2
- package/dist-docs/assets/{app.BUmD6Vxj.js → app.DHRGs5Zc.js} +1 -1
- package/dist-docs/assets/chunks/@localSearchIndexroot.RPRwAWt3.js +1 -0
- package/dist-docs/assets/chunks/{BitmapFont.BrIzlOIW.js → BitmapFont.CcysO3pT.js} +1 -1
- package/dist-docs/assets/chunks/{BufferResource.COixOmAa.js → BufferResource.C_MJ8LV7.js} +1 -1
- package/dist-docs/assets/chunks/{CanvasRenderer.AJZQ5kNh.js → CanvasRenderer.AFx6MHtI.js} +1 -1
- package/dist-docs/assets/chunks/{RenderTargetSystem.D9L4DY-z.js → RenderTargetSystem.DlyLBS5z.js} +1 -1
- package/dist-docs/assets/chunks/{VPLocalSearchBox.BcIzulCn.js → VPLocalSearchBox.DeambLpp.js} +1 -1
- package/dist-docs/assets/chunks/{WebGLRenderer.C1UT4_Sf.js → WebGLRenderer.uIm0oBU6.js} +1 -1
- package/dist-docs/assets/chunks/{WebGPURenderer.BGf12giD.js → WebGPURenderer.KCAyMTek.js} +1 -1
- package/dist-docs/assets/chunks/{browserAll.A8YysdLT.js → browserAll.5RQbY4cm.js} +1 -1
- package/dist-docs/assets/chunks/index.BLj_eQCu.js +744 -0
- package/dist-docs/assets/chunks/{theme.DlUWvF3L.js → theme.DZz2Y3xc.js} +3 -3
- package/dist-docs/assets/chunks/{webworkerAll.BBKdt9Wn.js → webworkerAll.D3-je4ql.js} +1 -1
- package/dist-docs/assets/{guide_advanced-usage.md.COVLyRkA.js → guide_advanced-usage.md.B0nlUHzZ.js} +75 -4
- package/dist-docs/assets/{guide_advanced-usage.md.COVLyRkA.lean.js → guide_advanced-usage.md.B0nlUHzZ.lean.js} +1 -1
- package/dist-docs/assets/{guide_getting-started.md.BHbOm955.js → guide_getting-started.md.BxrBbc12.js} +1 -1
- package/dist-docs/assets/{reference_callbacks.md.DdQU431C.js → reference_callbacks.md.FoJwSjMy.js} +2 -2
- package/dist-docs/assets/{reference_callbacks.md.DdQU431C.lean.js → reference_callbacks.md.FoJwSjMy.lean.js} +1 -1
- package/dist-docs/assets/{reference_config.md.C6eF1KzO.js → reference_config.md.D3LT2kWa.js} +27 -4
- package/dist-docs/assets/reference_config.md.D3LT2kWa.lean.js +1 -0
- package/dist-docs/assets/reference_runtime.md.BBP2J_yR.js +20 -0
- package/dist-docs/assets/{reference_runtime.md.80-Ieel4.lean.js → reference_runtime.md.BBP2J_yR.lean.js} +1 -1
- package/dist-docs/assets/{reference_types.md.hikiO8Cq.js → reference_types.md.CfnUIfkB.js} +6 -1
- package/dist-docs/assets/{reference_types.md.hikiO8Cq.lean.js → reference_types.md.CfnUIfkB.lean.js} +1 -1
- package/dist-docs/guide/advanced-usage.html +78 -7
- package/dist-docs/guide/concepts.html +3 -3
- package/dist-docs/guide/getting-started.html +5 -5
- package/dist-docs/guide/mcp.html +3 -3
- package/dist-docs/hashmap.json +1 -1
- package/dist-docs/index.html +3 -3
- package/dist-docs/plans/2026-03-04-detected-objects-visibility-design.html +3 -3
- package/dist-docs/plans/2026-03-04-show-detected-objects-implementation-plan.html +3 -3
- package/dist-docs/plans/2026-03-10-simulator-debug-design.html +3 -3
- package/dist-docs/plans/2026-03-10-simulator-events-console-design.html +3 -3
- package/dist-docs/plans/2026-03-10-simulator-events-console-implementation-plan.html +3 -3
- package/dist-docs/plans/2026-03-10-simulator-runtime-controls-design.html +3 -3
- package/dist-docs/plans/2026-03-10-simulator-runtime-controls-implementation-plan.html +3 -3
- package/dist-docs/plans/2026-03-10-testing-rollout-next-steps-plan.html +3 -3
- package/dist-docs/plans/2026-03-11-simulator-logger-dump-implementation-plan.html +3 -3
- package/dist-docs/reference/callbacks.html +5 -5
- package/dist-docs/reference/config.html +30 -7
- package/dist-docs/reference/data.html +3 -3
- package/dist-docs/reference/methods.html +3 -3
- package/dist-docs/reference/runtime.html +5 -5
- package/dist-docs/reference/types.html +10 -5
- package/dist-docs/reference/utils.html +3 -3
- package/dist-docs/simulator/index.html +3 -3
- package/package.json +1 -1
- package/dist-docs/assets/chunks/@localSearchIndexroot.B4q8-ZG9.js +0 -1
- package/dist-docs/assets/chunks/index.tAXumaXj.js +0 -744
- package/dist-docs/assets/records_bugs_2026-02-28-fix-pixi-bindgroup-webgpu-snapshot-whitescreen-bugfix.md.BbQpA41Y.js +0 -2
- package/dist-docs/assets/records_bugs_2026-02-28-fix-pixi-bindgroup-webgpu-snapshot-whitescreen-bugfix.md.BbQpA41Y.lean.js +0 -1
- package/dist-docs/assets/records_bugs_2026-03-10-events-drawer-toolbar-scroll-bugfix.md.DbHxPv4D.js +0 -1
- package/dist-docs/assets/records_bugs_2026-03-10-events-drawer-toolbar-scroll-bugfix.md.DbHxPv4D.lean.js +0 -1
- package/dist-docs/assets/records_bugs_2026-03-10-simulator-initial-render-layout-bugfix.md.w7--2hvH.js +0 -1
- package/dist-docs/assets/records_bugs_2026-03-10-simulator-initial-render-layout-bugfix.md.w7--2hvH.lean.js +0 -1
- package/dist-docs/assets/records_bugs_2026-03-10-simulator-wheel-scroll-leak-bugfix.md.B6gIem2P.js +0 -1
- package/dist-docs/assets/records_bugs_2026-03-10-simulator-wheel-scroll-leak-bugfix.md.B6gIem2P.lean.js +0 -1
- package/dist-docs/assets/records_bugs_2026-03-11-docs-server-bin-clean-bugfix.md.GGWCjkok.js +0 -1
- package/dist-docs/assets/records_bugs_2026-03-11-docs-server-bin-clean-bugfix.md.GGWCjkok.lean.js +0 -1
- package/dist-docs/assets/records_bugs_2026-03-11-render-result-runtime-sync-bugfix.md.DRNUuaFT.js +0 -1
- package/dist-docs/assets/records_bugs_2026-03-11-render-result-runtime-sync-bugfix.md.DRNUuaFT.lean.js +0 -1
- package/dist-docs/assets/records_bugs_2026-03-26-fix-pixi-gc-deprecation-warning-bugfix.md.DaCuhvTA.js +0 -1
- package/dist-docs/assets/records_bugs_2026-03-26-fix-pixi-gc-deprecation-warning-bugfix.md.DaCuhvTA.lean.js +0 -1
- package/dist-docs/assets/records_bugs_2026-03-26-fix-room-floor-type-auto-gc-bugfix.md.DeytN_el.js +0 -1
- package/dist-docs/assets/records_bugs_2026-03-26-fix-room-floor-type-auto-gc-bugfix.md.DeytN_el.lean.js +0 -1
- package/dist-docs/assets/records_plans_2026-03-02-furniture-feature-plan.md.CqSsyNDo.js +0 -1
- package/dist-docs/assets/records_plans_2026-03-02-furniture-feature-plan.md.CqSsyNDo.lean.js +0 -1
- package/dist-docs/assets/records_plans_2026-03-05-testing-infrastructure-design.md.DLHGz5Ez.js +0 -77
- package/dist-docs/assets/records_plans_2026-03-05-testing-infrastructure-design.md.DLHGz5Ez.lean.js +0 -1
- package/dist-docs/assets/records_plans_2026-03-10-simulator-events-console-plan.md.CfHLEHcc.js +0 -1
- package/dist-docs/assets/records_plans_2026-03-10-simulator-events-console-plan.md.CfHLEHcc.lean.js +0 -1
- package/dist-docs/assets/records_plans_2026-03-10-simulator-last-successful-combo-cache-plan.md.Z2RoK239.js +0 -1
- package/dist-docs/assets/records_plans_2026-03-10-simulator-last-successful-combo-cache-plan.md.Z2RoK239.lean.js +0 -1
- package/dist-docs/assets/records_plans_2026-03-10-simulator-map-parsed-view-plan.md.S9jPz75o.js +0 -1
- package/dist-docs/assets/records_plans_2026-03-10-simulator-map-parsed-view-plan.md.S9jPz75o.lean.js +0 -1
- package/dist-docs/assets/records_plans_2026-03-10-simulator-map-playground-refactor-plan.md.BuILlmcV.js +0 -1
- package/dist-docs/assets/records_plans_2026-03-10-simulator-map-playground-refactor-plan.md.BuILlmcV.lean.js +0 -1
- package/dist-docs/assets/records_plans_2026-03-10-simulator-playground-plan.md.CQAR-T7p.js +0 -1
- package/dist-docs/assets/records_plans_2026-03-10-simulator-playground-plan.md.CQAR-T7p.lean.js +0 -1
- package/dist-docs/assets/records_plans_2026-03-10-simulator-runtime-controls-plan.md.DSVD-qCa.js +0 -1
- package/dist-docs/assets/records_plans_2026-03-10-simulator-runtime-controls-plan.md.DSVD-qCa.lean.js +0 -1
- package/dist-docs/assets/records_plans_2026-03-11-docs-cli-ui-polish-plan.md.B8oZt_5R.js +0 -1
- package/dist-docs/assets/records_plans_2026-03-11-docs-cli-ui-polish-plan.md.B8oZt_5R.lean.js +0 -1
- package/dist-docs/assets/records_plans_2026-03-11-simulator-logger-dump-plan.md.CkjDCM2N.js +0 -1
- package/dist-docs/assets/records_plans_2026-03-11-simulator-logger-dump-plan.md.CkjDCM2N.lean.js +0 -1
- package/dist-docs/assets/records_plans_2026-03-11-simulator-src-migration-implementation.md.FnB5Cx6R.js +0 -1
- package/dist-docs/assets/records_plans_2026-03-11-simulator-src-migration-implementation.md.FnB5Cx6R.lean.js +0 -1
- package/dist-docs/assets/records_plans_2026-03-11-simulator-src-migration-plan.md.BBfaeRrq.js +0 -1
- package/dist-docs/assets/records_plans_2026-03-11-simulator-src-migration-plan.md.BBfaeRrq.lean.js +0 -1
- package/dist-docs/assets/records_plans_2026-03-11-simulator-style-tokenization-plan.md.D4BgkNlO.js +0 -1
- package/dist-docs/assets/records_plans_2026-03-11-simulator-style-tokenization-plan.md.D4BgkNlO.lean.js +0 -1
- package/dist-docs/assets/reference_config.md.C6eF1KzO.lean.js +0 -1
- package/dist-docs/assets/reference_runtime.md.80-Ieel4.js +0 -20
- package/dist-docs/records/bugs/2026-02-28-fix-pixi-bindgroup-webgpu-snapshot-whitescreen-bugfix.html +0 -26
- package/dist-docs/records/bugs/2026-03-10-events-drawer-toolbar-scroll-bugfix.html +0 -25
- package/dist-docs/records/bugs/2026-03-10-simulator-initial-render-layout-bugfix.html +0 -25
- package/dist-docs/records/bugs/2026-03-10-simulator-wheel-scroll-leak-bugfix.html +0 -25
- package/dist-docs/records/bugs/2026-03-11-docs-server-bin-clean-bugfix.html +0 -25
- package/dist-docs/records/bugs/2026-03-11-render-result-runtime-sync-bugfix.html +0 -25
- package/dist-docs/records/bugs/2026-03-26-fix-pixi-gc-deprecation-warning-bugfix.html +0 -25
- package/dist-docs/records/bugs/2026-03-26-fix-room-floor-type-auto-gc-bugfix.html +0 -25
- package/dist-docs/records/plans/2026-03-02-furniture-feature-plan.html +0 -25
- package/dist-docs/records/plans/2026-03-05-testing-infrastructure-design.html +0 -101
- package/dist-docs/records/plans/2026-03-10-simulator-events-console-plan.html +0 -25
- package/dist-docs/records/plans/2026-03-10-simulator-last-successful-combo-cache-plan.html +0 -25
- package/dist-docs/records/plans/2026-03-10-simulator-map-parsed-view-plan.html +0 -25
- package/dist-docs/records/plans/2026-03-10-simulator-map-playground-refactor-plan.html +0 -25
- package/dist-docs/records/plans/2026-03-10-simulator-playground-plan.html +0 -25
- package/dist-docs/records/plans/2026-03-10-simulator-runtime-controls-plan.html +0 -25
- package/dist-docs/records/plans/2026-03-11-docs-cli-ui-polish-plan.html +0 -25
- package/dist-docs/records/plans/2026-03-11-simulator-logger-dump-plan.html +0 -25
- package/dist-docs/records/plans/2026-03-11-simulator-src-migration-implementation.html +0 -25
- package/dist-docs/records/plans/2026-03-11-simulator-src-migration-plan.html +0 -25
- package/dist-docs/records/plans/2026-03-11-simulator-style-tokenization-plan.html +0 -25
- /package/dist-docs/assets/{guide_getting-started.md.BHbOm955.lean.js → guide_getting-started.md.BxrBbc12.lean.js} +0 -0
|
@@ -9,11 +9,11 @@
|
|
|
9
9
|
<link rel="preload stylesheet" href="/assets/style.hiWmcVfN.css" as="style">
|
|
10
10
|
<link rel="preload stylesheet" href="/vp-icons.css" as="style">
|
|
11
11
|
|
|
12
|
-
<script type="module" src="/assets/app.
|
|
12
|
+
<script type="module" src="/assets/app.DHRGs5Zc.js"></script>
|
|
13
13
|
<link rel="preload" href="/assets/inter-roman-latin.Di8DUHzh.woff2" as="font" type="font/woff2" crossorigin="">
|
|
14
|
-
<link rel="modulepreload" href="/assets/chunks/theme.
|
|
14
|
+
<link rel="modulepreload" href="/assets/chunks/theme.DZz2Y3xc.js">
|
|
15
15
|
<link rel="modulepreload" href="/assets/chunks/framework.CBLqO2Q1.js">
|
|
16
|
-
<link rel="modulepreload" href="/assets/reference_config.md.
|
|
16
|
+
<link rel="modulepreload" href="/assets/reference_config.md.D3LT2kWa.lean.js">
|
|
17
17
|
<script id="check-dark-mode">(()=>{const e=localStorage.getItem("vitepress-theme-appearance")||"auto",a=window.matchMedia("(prefers-color-scheme: dark)").matches;(!e||e==="auto"?a:e==="dark")&&document.documentElement.classList.add("dark")})();</script>
|
|
18
18
|
<script id="check-mac-os">document.documentElement.classList.toggle("mac",/Mac|iPhone|iPod|iPad/i.test(navigator.platform));</script>
|
|
19
19
|
</head>
|
|
@@ -211,7 +211,7 @@
|
|
|
211
211
|
<span class="line"><span style="--shiki-light:#E36209;--shiki-dark:#FFAB70;"> src</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">:</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> string</span><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"> // 图片 URL</span></span>
|
|
212
212
|
<span class="line"><span style="--shiki-light:#E36209;--shiki-dark:#FFAB70;"> width</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">:</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> number</span><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"> // 默认宽度(米)</span></span>
|
|
213
213
|
<span class="line"><span style="--shiki-light:#E36209;--shiki-dark:#FFAB70;"> height</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">:</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> number</span><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"> // 默认高度(米)</span></span>
|
|
214
|
-
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">}</span></span></code></pre></div><div class="tip custom-block"><p class="custom-block-title">TIP</p><p><code>width</code> 和 <code>height</code> 的单位是米,用于 <code>getFurniturePointsByViewportCenter()</code> 生成初始矩形时确定家具的实际尺寸。SDK 内部会根据地图的 <code>resolution</code> 自动将米转换为像素坐标。</p><p>例如双人床默认 <code>width: 1.8</code>(1.8 米)、<code>height: 2.0</code>(2.0 米)。</p></div><h3 id="furniture-opacity" tabindex="-1">furniture.opacity <a class="header-anchor" href="#furniture-opacity" aria-label="Permalink to "furniture.opacity""></a></h3><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>1</code></li></ul><p>家具图片的全局透明度 (0-1)。</p><h3 id="furniture-iconwrapperfillcolor" tabindex="-1">furniture.iconWrapperFillColor <a class="header-anchor" href="#furniture-iconwrapperfillcolor" aria-label="Permalink to "furniture.iconWrapperFillColor""></a></h3><ul><li><strong>类型</strong>: <code>ColorSource</code></li><li><strong>默认值</strong>: <code>'#26a69a'</code></li></ul><p>编辑按钮(删除、旋转、缩放、移动)图标容器的填充颜色。</p><h3 id="furniture-outlineoffset" tabindex="-1">furniture.outlineOffset <a class="header-anchor" href="#furniture-outlineoffset" aria-label="Permalink to "furniture.outlineOffset""></a></h3><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>16</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>编辑轮廓相对于家具边界的偏移距离。</p><h3 id="furniture-outlinestrokecolor" tabindex="-1">furniture.outlineStrokeColor <a class="header-anchor" href="#furniture-outlinestrokecolor" aria-label="Permalink to "furniture.outlineStrokeColor""></a></h3><ul><li><strong>类型</strong>: <code>ColorSource</code></li><li><strong>默认值</strong>: <code>'#26a69a'</code></li></ul><p>编辑轮廓描边颜色。</p><h3 id="furniture-outlinestrokewidth" tabindex="-1">furniture.outlineStrokeWidth <a class="header-anchor" href="#furniture-outlinestrokewidth" aria-label="Permalink to "furniture.outlineStrokeWidth""></a></h3><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>1.5</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>编辑轮廓描边宽度。</p><h3 id="furniture-outlinefillcolor" tabindex="-1">furniture.outlineFillColor <a class="header-anchor" href="#furniture-outlinefillcolor" aria-label="Permalink to "furniture.outlineFillColor""></a></h3><ul><li><strong>类型</strong>: <code>ColorSource</code></li><li><strong>默认值</strong>: <code>'rgba(38, 166, 154, 0.05)'</code></li></ul><p>编辑轮廓填充颜色。</p><h3 id="furniture-outlinedashed" tabindex="-1">furniture.outlineDashed <a class="header-anchor" href="#furniture-outlinedashed" aria-label="Permalink to "furniture.outlineDashed""></a></h3><ul><li><strong>类型</strong>: <code>boolean</code></li><li><strong>默认值</strong>: <code>true</code></li></ul><p>编辑轮廓是否为虚线。</p><h3 id="furniture-outlinedasharray" tabindex="-1">furniture.outlineDashArray <a class="header-anchor" href="#furniture-outlinedasharray" aria-label="Permalink to "furniture.outlineDashArray""></a></h3><ul><li><strong>类型</strong>: <code>[number, number]</code></li><li><strong>默认值</strong>: <code>[4, 3]</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>编辑轮廓虚线样式 [实线长度, 间隙长度]。</p><h3 id="furniture-showsizetext" tabindex="-1">furniture.showSizeText <a class="header-anchor" href="#furniture-showsizetext" aria-label="Permalink to "furniture.showSizeText""></a></h3><ul><li><strong>类型</strong>: <code>boolean</code></li><li><strong>默认值</strong>: <code>true</code></li></ul><p>是否在编辑状态下显示家具的尺寸文本。</p><h3 id="furniture-textcolor" tabindex="-1">furniture.textColor <a class="header-anchor" href="#furniture-textcolor" aria-label="Permalink to "furniture.textColor""></a></h3><ul><li><strong>类型</strong>: <code>ColorSource</code></li><li><strong>默认值</strong>: <code>'#26a69a'</code></li></ul><p>尺寸文本颜色。</p><h3 id="furniture-textposition" tabindex="-1">furniture.textPosition <a class="header-anchor" href="#furniture-textposition" aria-label="Permalink to "furniture.textPosition""></a></h3><ul><li><strong>类型</strong>: <code>'top' | 'right' | 'bottom' | 'left'</code></li><li><strong>默认值</strong>: <code>'bottom'</code></li></ul><p>尺寸文本显示位置。</p><h3 id="furniture-textoffset" tabindex="-1">furniture.textOffset <a class="header-anchor" href="#furniture-textoffset" aria-label="Permalink to "furniture.textOffset""></a></h3><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>8</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>尺寸文本距离轮廓的偏移。</p><h3 id="furniture-minscaleratio" tabindex="-1">furniture.minScaleRatio <a class="header-anchor" href="#furniture-minscaleratio" aria-label="Permalink to "furniture.minScaleRatio""></a></h3><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>0.5</code></li></ul><p>缩放按钮允许的最小缩放倍数(相对于初始尺寸)。设为 <code>0</code> 表示不限制最小缩放。</p><h3 id="furniture-maxscaleratio" tabindex="-1">furniture.maxScaleRatio <a class="header-anchor" href="#furniture-maxscaleratio" aria-label="Permalink to "furniture.maxScaleRatio""></a></h3><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>2</code></li></ul><p>缩放按钮允许的最大缩放倍数(相对于初始尺寸)。设为 <code>Infinity</code> 表示不限制最大缩放。</p><h3 id="furniture-rotatedirection" tabindex="-1">furniture.rotateDirection <a class="header-anchor" href="#furniture-rotatedirection" aria-label="Permalink to "furniture.rotateDirection""></a></h3><ul><li><strong>类型</strong>: <code>'cw' | 'ccw'</code></li><li><strong>默认值</strong>: <code>'cw'</code></li></ul><p>点击旋转按钮时的旋转方向。</p><ul><li><code>'cw'</code>:顺时针旋转 90 度</li><li><code>'ccw'</code>:逆时针旋转 90 度</li></ul><div class="tip custom-block"><p class="custom-block-title">TIP</p><p>旋转后,编辑按钮(删除、旋转、缩放、移动)会保持在各自的视觉位置不变,用户可以连续点击旋转按钮。</p></div><h3 id="furniture-lockaspectratio" tabindex="-1">furniture.lockAspectRatio <a class="header-anchor" href="#furniture-lockaspectratio" aria-label="Permalink to "furniture.lockAspectRatio""></a></h3><ul><li><strong>类型</strong>: <code>boolean</code></li><li><strong>默认值</strong>: <code>false</code></li></ul><p>缩放时是否锁定宽高比。启用后,拖拽缩放手柄时宽度和高度将等比例缩放,保持家具原始的宽高比例不变。</p><h2 id="robot" tabindex="-1">robot <a class="header-anchor" href="#robot" aria-label="Permalink to "robot""></a></h2><p>机器人配置,控制机器人图标、动画和预警圈的显示。</p><h3 id="robot-icon" tabindex="-1">robot.icon <a class="header-anchor" href="#robot-icon" aria-label="Permalink to "robot.icon""></a></h3><p>机器人图标配置。</p><h4 id="robot-icon-sizefixed" tabindex="-1">robot.icon.sizeFixed <a class="header-anchor" href="#robot-icon-sizefixed" aria-label="Permalink to "robot.icon.sizeFixed""></a></h4><ul><li><strong>类型</strong>: <code>boolean</code></li><li><strong>默认值</strong>: <code>false</code></li></ul><p>机器人图标尺寸是否固定(不跟随地图缩放变化)。</p><h4 id="robot-icon-width" tabindex="-1">robot.icon.width <a class="header-anchor" href="#robot-icon-width" aria-label="Permalink to "robot.icon.width""></a></h4><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>8</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>机器人图标宽度。</p><h4 id="robot-icon-height" tabindex="-1">robot.icon.height <a class="header-anchor" href="#robot-icon-height" aria-label="Permalink to "robot.icon.height""></a></h4><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>8</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>机器人图标高度。</p><h4 id="robot-icon-src" tabindex="-1">robot.icon.src <a class="header-anchor" href="#robot-icon-src" aria-label="Permalink to "robot.icon.src""></a></h4><ul><li><strong>类型</strong>: <code>string</code></li><li><strong>默认值</strong>: <code>内置资源</code></li></ul><p>机器人图标资源路径。</p><h3 id="robot-speed" tabindex="-1">robot.speed <a class="header-anchor" href="#robot-speed" aria-label="Permalink to "robot.speed""></a></h3><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>0</code></li><li><strong>单位</strong>: <code>米/秒</code></li></ul><p>机器人移动速度,用于路径动画。</p><p>路径数据变化时,机器人和增量路径会按照 <code>speed</code> 配置的速度进行动画。</p><div class="tip custom-block"><p class="custom-block-title">TIP</p><p><code>speed</code> 设置为<strong>0</strong>可以关闭路径动画,机器人会直接绘制到目标位置。</p></div><h3 id="robot-rotationcorrection" tabindex="-1">robot.rotationCorrection <a class="header-anchor" href="#robot-rotationcorrection" aria-label="Permalink to "robot.rotationCorrection""></a></h3><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>0</code></li><li><strong>单位</strong>: <code>度</code></li></ul><p>机器人图标角度校正,用于校正图标默认朝向。</p><p>0度表示图标朝右,角度值按顺时针方向递增。</p><h3 id="robot-sleepanimation" tabindex="-1">robot.sleepAnimation <a class="header-anchor" href="#robot-sleepanimation" aria-label="Permalink to "robot.sleepAnimation""></a></h3><p>机器人睡眠动画配置。</p><h4 id="robot-sleepanimation-jsonsrc" tabindex="-1">robot.sleepAnimation.jsonSrc <a class="header-anchor" href="#robot-sleepanimation-jsonsrc" aria-label="Permalink to "robot.sleepAnimation.jsonSrc""></a></h4><ul><li><strong>类型</strong>: <code>string</code></li><li><strong>默认值</strong>: <code>内置资源</code></li></ul><p>睡眠动画JSON资源路径,使用<a href="https://www.texturepacker.com/" target="_blank" rel="noreferrer"><strong>TexturePacker</strong></a>生成的JSON文件</p><h4 id="robot-sleepanimation-imagesrc" tabindex="-1">robot.sleepAnimation.imageSrc <a class="header-anchor" href="#robot-sleepanimation-imagesrc" aria-label="Permalink to "robot.sleepAnimation.imageSrc""></a></h4><ul><li><strong>类型</strong>: <code>string</code></li><li><strong>默认值</strong>: <code>内置资源</code></li></ul><p>睡眠动画图片资源路径,使用<a href="https://www.texturepacker.com/" target="_blank" rel="noreferrer"><strong>TexturePacker</strong></a>生成的图片资源。</p><h4 id="robot-sleepanimation-imagesrc-1" tabindex="-1">robot.sleepAnimation.imageSrc <a class="header-anchor" href="#robot-sleepanimation-imagesrc-1" aria-label="Permalink to "robot.sleepAnimation.imageSrc""></a></h4><ul><li><strong>类型</strong>: <code>string</code></li><li><strong>默认值</strong>: <code>内置资源</code></li></ul><p>睡眠动画图片资源路径,使用<a href="https://www.texturepacker.com/" target="_blank" rel="noreferrer"><strong>TexturePacker</strong></a>生成的图片资源。</p><h4 id="robot-sleepanimation-frameprefix" tabindex="-1">robot.sleepAnimation.framePrefix <a class="header-anchor" href="#robot-sleepanimation-frameprefix" aria-label="Permalink to "robot.sleepAnimation.framePrefix""></a></h4><ul><li><strong>类型</strong>: <code>string</code></li><li><strong>默认值</strong>: <code>'sleep_'</code></li></ul><p>动画帧名称前缀。</p><h4 id="robot-sleepanimation-width" tabindex="-1">robot.sleepAnimation.width <a class="header-anchor" href="#robot-sleepanimation-width" aria-label="Permalink to "robot.sleepAnimation.width""></a></h4><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>16</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>睡眠动画宽度。</p><h4 id="robot-sleepanimation-height" tabindex="-1">robot.sleepAnimation.height <a class="header-anchor" href="#robot-sleepanimation-height" aria-label="Permalink to "robot.sleepAnimation.height""></a></h4><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>16</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>睡眠动画高度。</p><h4 id="robot-sleepanimation-sizefixed" tabindex="-1">robot.sleepAnimation.sizeFixed <a class="header-anchor" href="#robot-sleepanimation-sizefixed" aria-label="Permalink to "robot.sleepAnimation.sizeFixed""></a></h4><ul><li><strong>类型</strong>: <code>boolean</code></li><li><strong>默认值</strong>: <code>false</code></li></ul><p>睡眠动画尺寸是否固定。</p><h4 id="robot-sleepanimation-framecount" tabindex="-1">robot.sleepAnimation.frameCount <a class="header-anchor" href="#robot-sleepanimation-framecount" aria-label="Permalink to "robot.sleepAnimation.frameCount""></a></h4><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>96</code></li></ul><p>动画总帧数。</p><h4 id="robot-sleepanimation-offsetx" tabindex="-1">robot.sleepAnimation.offsetX <a class="header-anchor" href="#robot-sleepanimation-offsetx" aria-label="Permalink to "robot.sleepAnimation.offsetX""></a></h4><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>8</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>睡眠动画X轴偏移。</p><h4 id="robot-sleepanimation-offsety" tabindex="-1">robot.sleepAnimation.offsetY <a class="header-anchor" href="#robot-sleepanimation-offsety" aria-label="Permalink to "robot.sleepAnimation.offsetY""></a></h4><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>-8</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>睡眠动画Y轴偏移。</p><h3 id="robot-ring" tabindex="-1">robot.ring <a class="header-anchor" href="#robot-ring" aria-label="Permalink to "robot.ring""></a></h3><p>机器人预警圈配置。</p><h4 id="robot-ring-size" tabindex="-1">robot.ring.size <a class="header-anchor" href="#robot-ring-size" aria-label="Permalink to "robot.ring.size""></a></h4><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>1</code></li><li><strong>单位</strong>: <code>米</code></li></ul><p>预警圈大小。</p><h4 id="robot-ring-color" tabindex="-1">robot.ring.color <a class="header-anchor" href="#robot-ring-color" aria-label="Permalink to "robot.ring.color""></a></h4><ul><li><strong>类型</strong>: <code>ColorSource</code></li><li><strong>默认值</strong>: <code>'rgba(255, 68, 68, 0.2)'</code></li></ul><p>预警圈填充颜色。</p><h4 id="robot-ring-strokewidth" tabindex="-1">robot.ring.strokeWidth <a class="header-anchor" href="#robot-ring-strokewidth" aria-label="Permalink to "robot.ring.strokeWidth""></a></h4><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>1</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>预警圈描边宽度。</p><h4 id="robot-ring-strokecolor" tabindex="-1">robot.ring.strokeColor <a class="header-anchor" href="#robot-ring-strokecolor" aria-label="Permalink to "robot.ring.strokeColor""></a></h4><ul><li><strong>类型</strong>: <code>ColorSource</code></li><li><strong>默认值</strong>: <code>'#ffffff'</code></li></ul><p>预警圈描边颜色。</p><h4 id="robot-ring-strokedashed" tabindex="-1">robot.ring.strokeDashed <a class="header-anchor" href="#robot-ring-strokedashed" aria-label="Permalink to "robot.ring.strokeDashed""></a></h4><ul><li><strong>类型</strong>: <code>boolean</code></li><li><strong>默认值</strong>: <code>true</code></li></ul><p>预警圈描边是否为虚线。</p><h4 id="robot-ring-strokedasharray" tabindex="-1">robot.ring.strokeDashArray <a class="header-anchor" href="#robot-ring-strokedasharray" aria-label="Permalink to "robot.ring.strokeDashArray""></a></h4><ul><li><strong>类型</strong>: <code>[number, number]</code></li><li><strong>默认值</strong>: <code>[4, 4]</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>预警圈虚线样式 [实线长度, 间隙长度]。</p><h3 id="robot-pulsecircle" tabindex="-1">robot.pulseCircle <a class="header-anchor" href="#robot-pulsecircle" aria-label="Permalink to "robot.pulseCircle""></a></h3><p>机器人脉冲圈配置,控制呼吸动画效果。</p><h4 id="robot-pulsecircle-size" tabindex="-1">robot.pulseCircle.size <a class="header-anchor" href="#robot-pulsecircle-size" aria-label="Permalink to "robot.pulseCircle.size""></a></h4><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>12</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>脉冲圈的大小(直径)。</p><h4 id="robot-pulsecircle-color" tabindex="-1">robot.pulseCircle.color <a class="header-anchor" href="#robot-pulsecircle-color" aria-label="Permalink to "robot.pulseCircle.color""></a></h4><ul><li><strong>类型</strong>: <code>ColorSource</code></li><li><strong>默认值</strong>: <code>'#4cd964'</code></li></ul><p>脉冲圈填充颜色。</p><h4 id="robot-pulsecircle-strokewidth" tabindex="-1">robot.pulseCircle.strokeWidth <a class="header-anchor" href="#robot-pulsecircle-strokewidth" aria-label="Permalink to "robot.pulseCircle.strokeWidth""></a></h4><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>0</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>脉冲圈描边宽度。</p><h4 id="robot-pulsecircle-strokecolor" tabindex="-1">robot.pulseCircle.strokeColor <a class="header-anchor" href="#robot-pulsecircle-strokecolor" aria-label="Permalink to "robot.pulseCircle.strokeColor""></a></h4><ul><li><strong>类型</strong>: <code>ColorSource</code></li><li><strong>默认值</strong>: <code>'#ffffff'</code></li></ul><p>脉冲圈描边颜色。</p><h4 id="robot-pulsecircle-duration" tabindex="-1">robot.pulseCircle.duration <a class="header-anchor" href="#robot-pulsecircle-duration" aria-label="Permalink to "robot.pulseCircle.duration""></a></h4><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>1000</code></li><li><strong>单位</strong>: <code>毫秒</code></li></ul><p>脉冲圈呼吸动画的持续时间(一个完整的呼吸周期)。</p><h4 id="robot-pulsecircle-sizefixed" tabindex="-1">robot.pulseCircle.sizeFixed <a class="header-anchor" href="#robot-pulsecircle-sizefixed" aria-label="Permalink to "robot.pulseCircle.sizeFixed""></a></h4><ul><li><strong>类型</strong>: <code>boolean</code></li><li><strong>默认值</strong>: <code>false</code></li></ul><p>脉冲圈尺寸是否固定(不跟随地图缩放变化)。</p><h4 id="robot-pulsecircle-minscale" tabindex="-1">robot.pulseCircle.minScale <a class="header-anchor" href="#robot-pulsecircle-minscale" aria-label="Permalink to "robot.pulseCircle.minScale""></a></h4><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>0.5</code></li></ul><p>呼吸动画的最小缩放比例。</p><h4 id="robot-pulsecircle-maxscale" tabindex="-1">robot.pulseCircle.maxScale <a class="header-anchor" href="#robot-pulsecircle-maxscale" aria-label="Permalink to "robot.pulseCircle.maxScale""></a></h4><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>1</code></li></ul><p>呼吸动画的最大缩放比例。</p><h4 id="robot-pulsecircle-minalpha" tabindex="-1">robot.pulseCircle.minAlpha <a class="header-anchor" href="#robot-pulsecircle-minalpha" aria-label="Permalink to "robot.pulseCircle.minAlpha""></a></h4><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>0.5</code></li></ul><p>呼吸动画的最小透明度(0-1 之间)。</p><h4 id="robot-pulsecircle-maxalpha" tabindex="-1">robot.pulseCircle.maxAlpha <a class="header-anchor" href="#robot-pulsecircle-maxalpha" aria-label="Permalink to "robot.pulseCircle.maxAlpha""></a></h4><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>1</code></li></ul><p>呼吸动画的最大透明度(0-1 之间)。</p><div class="tip custom-block"><p class="custom-block-title">TIP</p><p>通过调整 <code>minScale/maxScale</code> 和 <code>minAlpha/maxAlpha</code> 可以自定义呼吸效果的幅度和透明度变化。 例如,更大的缩放范围(如 0.4 到 1.2)会产生更明显的呼吸效果。</p></div><h2 id="chargingstation" tabindex="-1">chargingStation <a class="header-anchor" href="#chargingstation" aria-label="Permalink to "chargingStation""></a></h2><p>充电桩配置,控制充电桩图标和预警圈的显示。</p><h3 id="chargingstation-icon" tabindex="-1">chargingStation.icon <a class="header-anchor" href="#chargingstation-icon" aria-label="Permalink to "chargingStation.icon""></a></h3><p>充电桩图标配置。</p><h4 id="chargingstation-icon-sizefixed" tabindex="-1">chargingStation.icon.sizeFixed <a class="header-anchor" href="#chargingstation-icon-sizefixed" aria-label="Permalink to "chargingStation.icon.sizeFixed""></a></h4><ul><li><strong>类型</strong>: <code>boolean</code></li><li><strong>默认值</strong>: <code>false</code></li></ul><p>充电桩图标尺寸是否固定。</p><h4 id="chargingstation-icon-width" tabindex="-1">chargingStation.icon.width <a class="header-anchor" href="#chargingstation-icon-width" aria-label="Permalink to "chargingStation.icon.width""></a></h4><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>8</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>充电桩图标宽度。</p><h4 id="chargingstation-icon-height" tabindex="-1">chargingStation.icon.height <a class="header-anchor" href="#chargingstation-icon-height" aria-label="Permalink to "chargingStation.icon.height""></a></h4><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>8</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>充电桩图标高度。</p><h4 id="chargingstation-icon-src" tabindex="-1">chargingStation.icon.src <a class="header-anchor" href="#chargingstation-icon-src" aria-label="Permalink to "chargingStation.icon.src""></a></h4><ul><li><strong>类型</strong>: <code>string</code></li><li><strong>默认值</strong>: <code>内置资源</code></li></ul><p>充电桩图标资源路径。</p><h3 id="chargingstation-rotationcorrection" tabindex="-1">chargingStation.rotationCorrection <a class="header-anchor" href="#chargingstation-rotationcorrection" aria-label="Permalink to "chargingStation.rotationCorrection""></a></h3><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>0</code></li><li><strong>单位</strong>: <code>度</code></li></ul><p>充电桩图标角度校正,用于校正图标默认朝向。</p><p>0度表示图标朝右,角度值按顺时针方向递增。</p><h3 id="chargingstation-ring" tabindex="-1">chargingStation.ring <a class="header-anchor" href="#chargingstation-ring" aria-label="Permalink to "chargingStation.ring""></a></h3><p>充电桩预警圈配置。</p><h4 id="chargingstation-ring-size" tabindex="-1">chargingStation.ring.size <a class="header-anchor" href="#chargingstation-ring-size" aria-label="Permalink to "chargingStation.ring.size""></a></h4><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>1</code></li><li><strong>单位</strong>: <code>米</code></li></ul><p>预警圈大小。</p><h4 id="chargingstation-ring-color" tabindex="-1">chargingStation.ring.color <a class="header-anchor" href="#chargingstation-ring-color" aria-label="Permalink to "chargingStation.ring.color""></a></h4><ul><li><strong>类型</strong>: <code>ColorSource</code></li><li><strong>默认值</strong>: <code>'rgba(255, 68, 68, 0.2)'</code></li></ul><p>预警圈填充颜色。</p><h4 id="chargingstation-ring-strokewidth" tabindex="-1">chargingStation.ring.strokeWidth <a class="header-anchor" href="#chargingstation-ring-strokewidth" aria-label="Permalink to "chargingStation.ring.strokeWidth""></a></h4><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>1</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>预警圈描边宽度。</p><h4 id="chargingstation-ring-strokecolor" tabindex="-1">chargingStation.ring.strokeColor <a class="header-anchor" href="#chargingstation-ring-strokecolor" aria-label="Permalink to "chargingStation.ring.strokeColor""></a></h4><ul><li><strong>类型</strong>: <code>ColorSource</code></li><li><strong>默认值</strong>: <code>'#ffffff'</code></li></ul><p>预警圈描边颜色。</p><h4 id="chargingstation-ring-strokedashed" tabindex="-1">chargingStation.ring.strokeDashed <a class="header-anchor" href="#chargingstation-ring-strokedashed" aria-label="Permalink to "chargingStation.ring.strokeDashed""></a></h4><ul><li><strong>类型</strong>: <code>boolean</code></li><li><strong>默认值</strong>: <code>true</code></li></ul><p>预警圈描边是否为虚线。</p><h4 id="chargingstation-ring-strokedasharray" tabindex="-1">chargingStation.ring.strokeDashArray <a class="header-anchor" href="#chargingstation-ring-strokedasharray" aria-label="Permalink to "chargingStation.ring.strokeDashArray""></a></h4><ul><li><strong>类型</strong>: <code>[number, number]</code></li><li><strong>默认值</strong>: <code>[4, 4]</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>预警圈虚线样式 [实线长度, 间隙长度]。</p><h2 id="controls" tabindex="-1">controls <a class="header-anchor" href="#controls" aria-label="Permalink to "controls""></a></h2><p>控制元素配置,包括各种编辑工具的样式和行为设置。</p><h3 id="controls-iconwrapperwidth" tabindex="-1">controls.iconWrapperWidth <a class="header-anchor" href="#controls-iconwrapperwidth" aria-label="Permalink to "controls.iconWrapperWidth""></a></h3><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>24</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>操作按钮图标容器宽度</p><h3 id="controls-iconwrapperheight" tabindex="-1">controls.iconWrapperHeight <a class="header-anchor" href="#controls-iconwrapperheight" aria-label="Permalink to "controls.iconWrapperHeight""></a></h3><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>24</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>操作按钮图标容器高度</p><h3 id="controls-iconwrapperborderradius" tabindex="-1">controls.iconWrapperBorderRadius <a class="header-anchor" href="#controls-iconwrapperborderradius" aria-label="Permalink to "controls.iconWrapperBorderRadius""></a></h3><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>16</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>操作按钮图标容器边框圆角</p><h3 id="controls-iconwidth" tabindex="-1">controls.iconWidth <a class="header-anchor" href="#controls-iconwidth" aria-label="Permalink to "controls.iconWidth""></a></h3><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>12</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>操作按钮图标宽度</p><h3 id="controls-iconheight" tabindex="-1">controls.iconHeight <a class="header-anchor" href="#controls-iconheight" aria-label="Permalink to "controls.iconHeight""></a></h3><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>12</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>操作按钮图标高度</p><h3 id="controls-deleteiconsrc" tabindex="-1">controls.deleteIconSrc <a class="header-anchor" href="#controls-deleteiconsrc" aria-label="Permalink to "controls.deleteIconSrc""></a></h3><ul><li><strong>类型</strong>: <code>string</code></li><li><strong>默认值</strong>: <code>内置资源</code></li></ul><p>删除按钮图标资源路径</p><h3 id="controls-rotateiconsrc" tabindex="-1">controls.rotateIconSrc <a class="header-anchor" href="#controls-rotateiconsrc" aria-label="Permalink to "controls.rotateIconSrc""></a></h3><ul><li><strong>类型</strong>: <code>string</code></li><li><strong>默认值</strong>: <code>内置资源</code></li></ul><p>旋转按钮图标资源路径</p><h3 id="controls-scaleiconsrc" tabindex="-1">controls.scaleIconSrc <a class="header-anchor" href="#controls-scaleiconsrc" aria-label="Permalink to "controls.scaleIconSrc""></a></h3><ul><li><strong>类型</strong>: <code>string</code></li><li><strong>默认值</strong>: <code>内置资源</code></li></ul><p>缩放按钮图标资源路径</p><h3 id="controls-moveiconsrc" tabindex="-1">controls.moveIconSrc <a class="header-anchor" href="#controls-moveiconsrc" aria-label="Permalink to "controls.moveIconSrc""></a></h3><ul><li><strong>类型</strong>: <code>string</code></li><li><strong>默认值</strong>: <code>内置资源</code></li></ul><p>移动按钮图标资源路径</p><h3 id="controls-horizontalscaleiconsrc" tabindex="-1">controls.horizontalScaleIconSrc <a class="header-anchor" href="#controls-horizontalscaleiconsrc" aria-label="Permalink to "controls.horizontalScaleIconSrc""></a></h3><ul><li><strong>类型</strong>: <code>string</code></li><li><strong>默认值</strong>: <code>内置资源</code></li></ul><p>横向缩放按钮图标资源路径。</p><h3 id="controls-verticalscaleiconsrc" tabindex="-1">controls.verticalScaleIconSrc <a class="header-anchor" href="#controls-verticalscaleiconsrc" aria-label="Permalink to "controls.verticalScaleIconSrc""></a></h3><ul><li><strong>类型</strong>: <code>string</code></li><li><strong>默认值</strong>: <code>内置资源</code></li></ul><p>纵向缩放按钮图标资源路径。</p><h3 id="controls-movebuttonoffset" tabindex="-1">controls.moveButtonOffset <a class="header-anchor" href="#controls-movebuttonoffset" aria-label="Permalink to "controls.moveButtonOffset""></a></h3><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>30</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>移动按钮偏移距离</p><h3 id="controls-textfontsize" tabindex="-1">controls.textFontSize <a class="header-anchor" href="#controls-textfontsize" aria-label="Permalink to "controls.textFontSize""></a></h3><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>12</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>尺寸标签文本字体大小</p><h3 id="controls-textfontfamily" tabindex="-1">controls.textFontFamily <a class="header-anchor" href="#controls-textfontfamily" aria-label="Permalink to "controls.textFontFamily""></a></h3><ul><li><strong>类型</strong>: <code>string</code></li><li><strong>默认值</strong>: <code>'system-ui, -apple-system, sans-serif'</code></li></ul><p>尺寸标签文本字体名称</p><h3 id="controls-textfontweight" tabindex="-1">controls.textFontWeight <a class="header-anchor" href="#controls-textfontweight" aria-label="Permalink to "controls.textFontWeight""></a></h3><ul><li><strong>类型</strong>: <code>TextStyleFontWeight</code></li><li><strong>默认值</strong>: <code>'400'</code></li></ul><p>尺寸标签文本字体粗细</p><h3 id="controls-renderorder" tabindex="-1">controls.renderOrder <a class="header-anchor" href="#controls-renderorder" aria-label="Permalink to "controls.renderOrder""></a></h3><ul><li><strong>类型</strong>: <code>ControlRenderItem[]</code></li><li><strong>默认值</strong>: <code>['forbiddenSweepZone', 'forbiddenMopZone', 'cleanZone', 'virtualWall', 'spot', 'wayPoint', 'divider']</code></li></ul><p>控制层内元素渲染顺序配置,数组从下到上生效(后面的元素显示在更上层)。</p><p><strong>可选值:</strong></p><ul><li><code>'forbiddenSweepZone'</code></li><li><code>'forbiddenMopZone'</code></li><li><code>'cleanZone'</code></li><li><code>'virtualWall'</code></li><li><code>'spot'</code></li><li><code>'wayPoint'</code></li><li><code>'divider'</code></li></ul><p>配置说明:</p><ul><li>你可以通过调整数组顺序来控制不同控制元素的覆盖关系。</li><li>如果配置中缺少某些元素,SDK 会自动按默认顺序补齐。</li><li>如果配置中存在重复元素,SDK 仅保留首次出现的位置。</li><li>如果配置中包含未知值,SDK 会忽略该项并输出日志告警。</li></ul><p>示例:让禁扫区域显示在禁拖区域上方</p><div class="language-ts vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">ts</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">const</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> app</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> =</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> new</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> MapApplication</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">()</span></span>
|
|
214
|
+
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">}</span></span></code></pre></div><div class="tip custom-block"><p class="custom-block-title">TIP</p><p><code>width</code> 和 <code>height</code> 的单位是米,用于 <code>getFurniturePointsByViewportCenter()</code> 生成初始矩形时确定家具的实际尺寸。SDK 内部会根据地图的 <code>resolution</code> 自动将米转换为像素坐标。</p><p>例如双人床默认 <code>width: 1.8</code>(1.8 米)、<code>height: 2.0</code>(2.0 米)。</p></div><h3 id="furniture-opacity" tabindex="-1">furniture.opacity <a class="header-anchor" href="#furniture-opacity" aria-label="Permalink to "furniture.opacity""></a></h3><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>1</code></li></ul><p>家具图片的全局透明度 (0-1)。</p><h3 id="furniture-iconwrapperfillcolor" tabindex="-1">furniture.iconWrapperFillColor <a class="header-anchor" href="#furniture-iconwrapperfillcolor" aria-label="Permalink to "furniture.iconWrapperFillColor""></a></h3><ul><li><strong>类型</strong>: <code>ColorSource</code></li><li><strong>默认值</strong>: <code>'#26a69a'</code></li></ul><p>编辑按钮(删除、旋转、缩放、移动)图标容器的填充颜色。</p><h3 id="furniture-outlineoffset" tabindex="-1">furniture.outlineOffset <a class="header-anchor" href="#furniture-outlineoffset" aria-label="Permalink to "furniture.outlineOffset""></a></h3><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>16</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>编辑轮廓相对于家具边界的偏移距离。</p><h3 id="furniture-outlinestrokecolor" tabindex="-1">furniture.outlineStrokeColor <a class="header-anchor" href="#furniture-outlinestrokecolor" aria-label="Permalink to "furniture.outlineStrokeColor""></a></h3><ul><li><strong>类型</strong>: <code>ColorSource</code></li><li><strong>默认值</strong>: <code>'#26a69a'</code></li></ul><p>编辑轮廓描边颜色。</p><h3 id="furniture-outlinestrokewidth" tabindex="-1">furniture.outlineStrokeWidth <a class="header-anchor" href="#furniture-outlinestrokewidth" aria-label="Permalink to "furniture.outlineStrokeWidth""></a></h3><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>1.5</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>编辑轮廓描边宽度。</p><h3 id="furniture-outlinefillcolor" tabindex="-1">furniture.outlineFillColor <a class="header-anchor" href="#furniture-outlinefillcolor" aria-label="Permalink to "furniture.outlineFillColor""></a></h3><ul><li><strong>类型</strong>: <code>ColorSource</code></li><li><strong>默认值</strong>: <code>'rgba(38, 166, 154, 0.05)'</code></li></ul><p>编辑轮廓填充颜色。</p><h3 id="furniture-outlinedashed" tabindex="-1">furniture.outlineDashed <a class="header-anchor" href="#furniture-outlinedashed" aria-label="Permalink to "furniture.outlineDashed""></a></h3><ul><li><strong>类型</strong>: <code>boolean</code></li><li><strong>默认值</strong>: <code>true</code></li></ul><p>编辑轮廓是否为虚线。</p><h3 id="furniture-outlinedasharray" tabindex="-1">furniture.outlineDashArray <a class="header-anchor" href="#furniture-outlinedasharray" aria-label="Permalink to "furniture.outlineDashArray""></a></h3><ul><li><strong>类型</strong>: <code>[number, number]</code></li><li><strong>默认值</strong>: <code>[4, 3]</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>编辑轮廓虚线样式 [实线长度, 间隙长度]。</p><h3 id="furniture-showsizetext" tabindex="-1">furniture.showSizeText <a class="header-anchor" href="#furniture-showsizetext" aria-label="Permalink to "furniture.showSizeText""></a></h3><ul><li><strong>类型</strong>: <code>boolean</code></li><li><strong>默认值</strong>: <code>true</code></li></ul><p>是否在编辑状态下显示家具的尺寸文本。</p><h3 id="furniture-textcolor" tabindex="-1">furniture.textColor <a class="header-anchor" href="#furniture-textcolor" aria-label="Permalink to "furniture.textColor""></a></h3><ul><li><strong>类型</strong>: <code>ColorSource</code></li><li><strong>默认值</strong>: <code>'#26a69a'</code></li></ul><p>尺寸文本颜色。</p><h3 id="furniture-textposition" tabindex="-1">furniture.textPosition <a class="header-anchor" href="#furniture-textposition" aria-label="Permalink to "furniture.textPosition""></a></h3><ul><li><strong>类型</strong>: <code>'top' | 'right' | 'bottom' | 'left'</code></li><li><strong>默认值</strong>: <code>'bottom'</code></li></ul><p>尺寸文本显示位置。</p><h3 id="furniture-textoffset" tabindex="-1">furniture.textOffset <a class="header-anchor" href="#furniture-textoffset" aria-label="Permalink to "furniture.textOffset""></a></h3><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>8</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>尺寸文本距离轮廓的偏移。</p><h3 id="furniture-minscaleratio" tabindex="-1">furniture.minScaleRatio <a class="header-anchor" href="#furniture-minscaleratio" aria-label="Permalink to "furniture.minScaleRatio""></a></h3><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>0.5</code></li></ul><p>缩放按钮允许的最小缩放倍数(相对于初始尺寸)。设为 <code>0</code> 表示不限制最小缩放。</p><h3 id="furniture-maxscaleratio" tabindex="-1">furniture.maxScaleRatio <a class="header-anchor" href="#furniture-maxscaleratio" aria-label="Permalink to "furniture.maxScaleRatio""></a></h3><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>2</code></li></ul><p>缩放按钮允许的最大缩放倍数(相对于初始尺寸)。设为 <code>Infinity</code> 表示不限制最大缩放。</p><h3 id="furniture-rotatedirection" tabindex="-1">furniture.rotateDirection <a class="header-anchor" href="#furniture-rotatedirection" aria-label="Permalink to "furniture.rotateDirection""></a></h3><ul><li><strong>类型</strong>: <code>'cw' | 'ccw'</code></li><li><strong>默认值</strong>: <code>'cw'</code></li></ul><p>点击旋转按钮时的旋转方向。</p><ul><li><code>'cw'</code>:顺时针旋转 90 度</li><li><code>'ccw'</code>:逆时针旋转 90 度</li></ul><div class="tip custom-block"><p class="custom-block-title">TIP</p><p>旋转后,编辑按钮(删除、旋转、缩放、移动)会保持在各自的视觉位置不变,用户可以连续点击旋转按钮。</p></div><h3 id="furniture-lockaspectratio" tabindex="-1">furniture.lockAspectRatio <a class="header-anchor" href="#furniture-lockaspectratio" aria-label="Permalink to "furniture.lockAspectRatio""></a></h3><ul><li><strong>类型</strong>: <code>boolean</code></li><li><strong>默认值</strong>: <code>false</code></li></ul><p>缩放时是否锁定宽高比。启用后,拖拽缩放手柄时宽度和高度将等比例缩放,保持家具原始的宽高比例不变。</p><h2 id="robot" tabindex="-1">robot <a class="header-anchor" href="#robot" aria-label="Permalink to "robot""></a></h2><p>机器人配置,控制机器人图标、动画和预警圈的显示。</p><h3 id="robot-icon" tabindex="-1">robot.icon <a class="header-anchor" href="#robot-icon" aria-label="Permalink to "robot.icon""></a></h3><p>机器人图标配置。</p><h4 id="robot-icon-sizefixed" tabindex="-1">robot.icon.sizeFixed <a class="header-anchor" href="#robot-icon-sizefixed" aria-label="Permalink to "robot.icon.sizeFixed""></a></h4><ul><li><strong>类型</strong>: <code>boolean</code></li><li><strong>默认值</strong>: <code>false</code></li></ul><p>机器人图标尺寸是否固定(不跟随地图缩放变化)。</p><h4 id="robot-icon-width" tabindex="-1">robot.icon.width <a class="header-anchor" href="#robot-icon-width" aria-label="Permalink to "robot.icon.width""></a></h4><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>8</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>机器人图标宽度。</p><h4 id="robot-icon-height" tabindex="-1">robot.icon.height <a class="header-anchor" href="#robot-icon-height" aria-label="Permalink to "robot.icon.height""></a></h4><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>8</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>机器人图标高度。</p><h4 id="robot-icon-src" tabindex="-1">robot.icon.src <a class="header-anchor" href="#robot-icon-src" aria-label="Permalink to "robot.icon.src""></a></h4><ul><li><strong>类型</strong>: <code>string</code></li><li><strong>默认值</strong>: <code>内置资源</code></li></ul><p>机器人图标资源路径。</p><h3 id="robot-speed" tabindex="-1">robot.speed <a class="header-anchor" href="#robot-speed" aria-label="Permalink to "robot.speed""></a></h3><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>0</code></li><li><strong>单位</strong>: <code>米/秒</code></li></ul><p>机器人移动速度,用于路径动画。</p><p>路径数据变化时,机器人和增量路径会按照 <code>speed</code> 配置的速度进行动画。</p><div class="tip custom-block"><p class="custom-block-title">TIP</p><p><code>speed</code> 设置为<strong>0</strong>可以关闭路径动画,机器人会直接绘制到目标位置。</p></div><h3 id="robot-rotationcorrection" tabindex="-1">robot.rotationCorrection <a class="header-anchor" href="#robot-rotationcorrection" aria-label="Permalink to "robot.rotationCorrection""></a></h3><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>0</code></li><li><strong>单位</strong>: <code>度</code></li></ul><p>机器人图标角度校正,用于校正图标默认朝向。</p><p>0度表示图标朝右,角度值按顺时针方向递增。</p><h3 id="robot-sleepanimation" tabindex="-1">robot.sleepAnimation <a class="header-anchor" href="#robot-sleepanimation" aria-label="Permalink to "robot.sleepAnimation""></a></h3><p>机器人睡眠动画配置。</p><h4 id="robot-sleepanimation-jsonsrc" tabindex="-1">robot.sleepAnimation.jsonSrc <a class="header-anchor" href="#robot-sleepanimation-jsonsrc" aria-label="Permalink to "robot.sleepAnimation.jsonSrc""></a></h4><ul><li><strong>类型</strong>: <code>string</code></li><li><strong>默认值</strong>: <code>内置资源</code></li></ul><p>睡眠动画JSON资源路径,使用<a href="https://www.texturepacker.com/" target="_blank" rel="noreferrer"><strong>TexturePacker</strong></a>生成的JSON文件</p><h4 id="robot-sleepanimation-imagesrc" tabindex="-1">robot.sleepAnimation.imageSrc <a class="header-anchor" href="#robot-sleepanimation-imagesrc" aria-label="Permalink to "robot.sleepAnimation.imageSrc""></a></h4><ul><li><strong>类型</strong>: <code>string</code></li><li><strong>默认值</strong>: <code>内置资源</code></li></ul><p>睡眠动画图片资源路径,使用<a href="https://www.texturepacker.com/" target="_blank" rel="noreferrer"><strong>TexturePacker</strong></a>生成的图片资源。</p><h4 id="robot-sleepanimation-imagesrc-1" tabindex="-1">robot.sleepAnimation.imageSrc <a class="header-anchor" href="#robot-sleepanimation-imagesrc-1" aria-label="Permalink to "robot.sleepAnimation.imageSrc""></a></h4><ul><li><strong>类型</strong>: <code>string</code></li><li><strong>默认值</strong>: <code>内置资源</code></li></ul><p>睡眠动画图片资源路径,使用<a href="https://www.texturepacker.com/" target="_blank" rel="noreferrer"><strong>TexturePacker</strong></a>生成的图片资源。</p><h4 id="robot-sleepanimation-frameprefix" tabindex="-1">robot.sleepAnimation.framePrefix <a class="header-anchor" href="#robot-sleepanimation-frameprefix" aria-label="Permalink to "robot.sleepAnimation.framePrefix""></a></h4><ul><li><strong>类型</strong>: <code>string</code></li><li><strong>默认值</strong>: <code>'sleep_'</code></li></ul><p>动画帧名称前缀。</p><h4 id="robot-sleepanimation-width" tabindex="-1">robot.sleepAnimation.width <a class="header-anchor" href="#robot-sleepanimation-width" aria-label="Permalink to "robot.sleepAnimation.width""></a></h4><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>16</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>睡眠动画宽度。</p><h4 id="robot-sleepanimation-height" tabindex="-1">robot.sleepAnimation.height <a class="header-anchor" href="#robot-sleepanimation-height" aria-label="Permalink to "robot.sleepAnimation.height""></a></h4><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>16</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>睡眠动画高度。</p><h4 id="robot-sleepanimation-sizefixed" tabindex="-1">robot.sleepAnimation.sizeFixed <a class="header-anchor" href="#robot-sleepanimation-sizefixed" aria-label="Permalink to "robot.sleepAnimation.sizeFixed""></a></h4><ul><li><strong>类型</strong>: <code>boolean</code></li><li><strong>默认值</strong>: <code>false</code></li></ul><p>睡眠动画尺寸是否固定。</p><h4 id="robot-sleepanimation-framecount" tabindex="-1">robot.sleepAnimation.frameCount <a class="header-anchor" href="#robot-sleepanimation-framecount" aria-label="Permalink to "robot.sleepAnimation.frameCount""></a></h4><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>96</code></li></ul><p>动画总帧数。</p><h4 id="robot-sleepanimation-offsetx" tabindex="-1">robot.sleepAnimation.offsetX <a class="header-anchor" href="#robot-sleepanimation-offsetx" aria-label="Permalink to "robot.sleepAnimation.offsetX""></a></h4><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>8</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>睡眠动画X轴偏移。</p><h4 id="robot-sleepanimation-offsety" tabindex="-1">robot.sleepAnimation.offsetY <a class="header-anchor" href="#robot-sleepanimation-offsety" aria-label="Permalink to "robot.sleepAnimation.offsetY""></a></h4><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>-8</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>睡眠动画Y轴偏移。</p><h3 id="robot-ring" tabindex="-1">robot.ring <a class="header-anchor" href="#robot-ring" aria-label="Permalink to "robot.ring""></a></h3><p>机器人预警圈配置。</p><h4 id="robot-ring-size" tabindex="-1">robot.ring.size <a class="header-anchor" href="#robot-ring-size" aria-label="Permalink to "robot.ring.size""></a></h4><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>1</code></li><li><strong>单位</strong>: <code>米</code></li></ul><p>预警圈大小。</p><h4 id="robot-ring-color" tabindex="-1">robot.ring.color <a class="header-anchor" href="#robot-ring-color" aria-label="Permalink to "robot.ring.color""></a></h4><ul><li><strong>类型</strong>: <code>ColorSource</code></li><li><strong>默认值</strong>: <code>'rgba(255, 68, 68, 0.2)'</code></li></ul><p>预警圈填充颜色。</p><h4 id="robot-ring-strokewidth" tabindex="-1">robot.ring.strokeWidth <a class="header-anchor" href="#robot-ring-strokewidth" aria-label="Permalink to "robot.ring.strokeWidth""></a></h4><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>1</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>预警圈描边宽度。</p><h4 id="robot-ring-strokecolor" tabindex="-1">robot.ring.strokeColor <a class="header-anchor" href="#robot-ring-strokecolor" aria-label="Permalink to "robot.ring.strokeColor""></a></h4><ul><li><strong>类型</strong>: <code>ColorSource</code></li><li><strong>默认值</strong>: <code>'#ffffff'</code></li></ul><p>预警圈描边颜色。</p><h4 id="robot-ring-strokedashed" tabindex="-1">robot.ring.strokeDashed <a class="header-anchor" href="#robot-ring-strokedashed" aria-label="Permalink to "robot.ring.strokeDashed""></a></h4><ul><li><strong>类型</strong>: <code>boolean</code></li><li><strong>默认值</strong>: <code>true</code></li></ul><p>预警圈描边是否为虚线。</p><h4 id="robot-ring-strokedasharray" tabindex="-1">robot.ring.strokeDashArray <a class="header-anchor" href="#robot-ring-strokedasharray" aria-label="Permalink to "robot.ring.strokeDashArray""></a></h4><ul><li><strong>类型</strong>: <code>[number, number]</code></li><li><strong>默认值</strong>: <code>[4, 4]</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>预警圈虚线样式 [实线长度, 间隙长度]。</p><h3 id="robot-pulsecircle" tabindex="-1">robot.pulseCircle <a class="header-anchor" href="#robot-pulsecircle" aria-label="Permalink to "robot.pulseCircle""></a></h3><p>机器人脉冲圈配置,控制呼吸动画效果。</p><h4 id="robot-pulsecircle-size" tabindex="-1">robot.pulseCircle.size <a class="header-anchor" href="#robot-pulsecircle-size" aria-label="Permalink to "robot.pulseCircle.size""></a></h4><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>12</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>脉冲圈的大小(直径)。</p><h4 id="robot-pulsecircle-color" tabindex="-1">robot.pulseCircle.color <a class="header-anchor" href="#robot-pulsecircle-color" aria-label="Permalink to "robot.pulseCircle.color""></a></h4><ul><li><strong>类型</strong>: <code>ColorSource</code></li><li><strong>默认值</strong>: <code>'#4cd964'</code></li></ul><p>脉冲圈填充颜色。</p><h4 id="robot-pulsecircle-strokewidth" tabindex="-1">robot.pulseCircle.strokeWidth <a class="header-anchor" href="#robot-pulsecircle-strokewidth" aria-label="Permalink to "robot.pulseCircle.strokeWidth""></a></h4><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>0</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>脉冲圈描边宽度。</p><h4 id="robot-pulsecircle-strokecolor" tabindex="-1">robot.pulseCircle.strokeColor <a class="header-anchor" href="#robot-pulsecircle-strokecolor" aria-label="Permalink to "robot.pulseCircle.strokeColor""></a></h4><ul><li><strong>类型</strong>: <code>ColorSource</code></li><li><strong>默认值</strong>: <code>'#ffffff'</code></li></ul><p>脉冲圈描边颜色。</p><h4 id="robot-pulsecircle-duration" tabindex="-1">robot.pulseCircle.duration <a class="header-anchor" href="#robot-pulsecircle-duration" aria-label="Permalink to "robot.pulseCircle.duration""></a></h4><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>1000</code></li><li><strong>单位</strong>: <code>毫秒</code></li></ul><p>脉冲圈呼吸动画的持续时间(一个完整的呼吸周期)。</p><h4 id="robot-pulsecircle-sizefixed" tabindex="-1">robot.pulseCircle.sizeFixed <a class="header-anchor" href="#robot-pulsecircle-sizefixed" aria-label="Permalink to "robot.pulseCircle.sizeFixed""></a></h4><ul><li><strong>类型</strong>: <code>boolean</code></li><li><strong>默认值</strong>: <code>false</code></li></ul><p>脉冲圈尺寸是否固定(不跟随地图缩放变化)。</p><h4 id="robot-pulsecircle-minscale" tabindex="-1">robot.pulseCircle.minScale <a class="header-anchor" href="#robot-pulsecircle-minscale" aria-label="Permalink to "robot.pulseCircle.minScale""></a></h4><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>0.5</code></li></ul><p>呼吸动画的最小缩放比例。</p><h4 id="robot-pulsecircle-maxscale" tabindex="-1">robot.pulseCircle.maxScale <a class="header-anchor" href="#robot-pulsecircle-maxscale" aria-label="Permalink to "robot.pulseCircle.maxScale""></a></h4><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>1</code></li></ul><p>呼吸动画的最大缩放比例。</p><h4 id="robot-pulsecircle-minalpha" tabindex="-1">robot.pulseCircle.minAlpha <a class="header-anchor" href="#robot-pulsecircle-minalpha" aria-label="Permalink to "robot.pulseCircle.minAlpha""></a></h4><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>0.5</code></li></ul><p>呼吸动画的最小透明度(0-1 之间)。</p><h4 id="robot-pulsecircle-maxalpha" tabindex="-1">robot.pulseCircle.maxAlpha <a class="header-anchor" href="#robot-pulsecircle-maxalpha" aria-label="Permalink to "robot.pulseCircle.maxAlpha""></a></h4><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>1</code></li></ul><p>呼吸动画的最大透明度(0-1 之间)。</p><div class="tip custom-block"><p class="custom-block-title">TIP</p><p>通过调整 <code>minScale/maxScale</code> 和 <code>minAlpha/maxAlpha</code> 可以自定义呼吸效果的幅度和透明度变化。 例如,更大的缩放范围(如 0.4 到 1.2)会产生更明显的呼吸效果。</p></div><h2 id="chargingstation" tabindex="-1">chargingStation <a class="header-anchor" href="#chargingstation" aria-label="Permalink to "chargingStation""></a></h2><p>充电桩配置,控制充电桩图标和预警圈的显示。</p><h3 id="chargingstation-icon" tabindex="-1">chargingStation.icon <a class="header-anchor" href="#chargingstation-icon" aria-label="Permalink to "chargingStation.icon""></a></h3><p>充电桩图标配置。</p><h4 id="chargingstation-icon-sizefixed" tabindex="-1">chargingStation.icon.sizeFixed <a class="header-anchor" href="#chargingstation-icon-sizefixed" aria-label="Permalink to "chargingStation.icon.sizeFixed""></a></h4><ul><li><strong>类型</strong>: <code>boolean</code></li><li><strong>默认值</strong>: <code>false</code></li></ul><p>充电桩图标尺寸是否固定。</p><h4 id="chargingstation-icon-width" tabindex="-1">chargingStation.icon.width <a class="header-anchor" href="#chargingstation-icon-width" aria-label="Permalink to "chargingStation.icon.width""></a></h4><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>8</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>充电桩图标宽度。</p><h4 id="chargingstation-icon-height" tabindex="-1">chargingStation.icon.height <a class="header-anchor" href="#chargingstation-icon-height" aria-label="Permalink to "chargingStation.icon.height""></a></h4><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>8</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>充电桩图标高度。</p><h4 id="chargingstation-icon-src" tabindex="-1">chargingStation.icon.src <a class="header-anchor" href="#chargingstation-icon-src" aria-label="Permalink to "chargingStation.icon.src""></a></h4><ul><li><strong>类型</strong>: <code>string</code></li><li><strong>默认值</strong>: <code>内置资源</code></li></ul><p>充电桩图标资源路径。</p><h3 id="chargingstation-rotationcorrection" tabindex="-1">chargingStation.rotationCorrection <a class="header-anchor" href="#chargingstation-rotationcorrection" aria-label="Permalink to "chargingStation.rotationCorrection""></a></h3><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>0</code></li><li><strong>单位</strong>: <code>度</code></li></ul><p>充电桩图标角度校正,用于校正图标默认朝向。</p><p>0度表示图标朝右,角度值按顺时针方向递增。</p><h3 id="chargingstation-ring" tabindex="-1">chargingStation.ring <a class="header-anchor" href="#chargingstation-ring" aria-label="Permalink to "chargingStation.ring""></a></h3><p>充电桩预警圈配置。</p><h4 id="chargingstation-ring-size" tabindex="-1">chargingStation.ring.size <a class="header-anchor" href="#chargingstation-ring-size" aria-label="Permalink to "chargingStation.ring.size""></a></h4><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>1</code></li><li><strong>单位</strong>: <code>米</code></li></ul><p>预警圈大小。</p><h4 id="chargingstation-ring-color" tabindex="-1">chargingStation.ring.color <a class="header-anchor" href="#chargingstation-ring-color" aria-label="Permalink to "chargingStation.ring.color""></a></h4><ul><li><strong>类型</strong>: <code>ColorSource</code></li><li><strong>默认值</strong>: <code>'rgba(255, 68, 68, 0.2)'</code></li></ul><p>预警圈填充颜色。</p><h4 id="chargingstation-ring-strokewidth" tabindex="-1">chargingStation.ring.strokeWidth <a class="header-anchor" href="#chargingstation-ring-strokewidth" aria-label="Permalink to "chargingStation.ring.strokeWidth""></a></h4><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>1</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>预警圈描边宽度。</p><h4 id="chargingstation-ring-strokecolor" tabindex="-1">chargingStation.ring.strokeColor <a class="header-anchor" href="#chargingstation-ring-strokecolor" aria-label="Permalink to "chargingStation.ring.strokeColor""></a></h4><ul><li><strong>类型</strong>: <code>ColorSource</code></li><li><strong>默认值</strong>: <code>'#ffffff'</code></li></ul><p>预警圈描边颜色。</p><h4 id="chargingstation-ring-strokedashed" tabindex="-1">chargingStation.ring.strokeDashed <a class="header-anchor" href="#chargingstation-ring-strokedashed" aria-label="Permalink to "chargingStation.ring.strokeDashed""></a></h4><ul><li><strong>类型</strong>: <code>boolean</code></li><li><strong>默认值</strong>: <code>true</code></li></ul><p>预警圈描边是否为虚线。</p><h4 id="chargingstation-ring-strokedasharray" tabindex="-1">chargingStation.ring.strokeDashArray <a class="header-anchor" href="#chargingstation-ring-strokedasharray" aria-label="Permalink to "chargingStation.ring.strokeDashArray""></a></h4><ul><li><strong>类型</strong>: <code>[number, number]</code></li><li><strong>默认值</strong>: <code>[4, 4]</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>预警圈虚线样式 [实线长度, 间隙长度]。</p><h2 id="controls" tabindex="-1">controls <a class="header-anchor" href="#controls" aria-label="Permalink to "controls""></a></h2><p>控制元素配置,包括各种编辑工具的样式和行为设置。</p><h3 id="controls-iconwrapperwidth" tabindex="-1">controls.iconWrapperWidth <a class="header-anchor" href="#controls-iconwrapperwidth" aria-label="Permalink to "controls.iconWrapperWidth""></a></h3><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>24</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>操作按钮图标容器宽度</p><h3 id="controls-iconwrapperheight" tabindex="-1">controls.iconWrapperHeight <a class="header-anchor" href="#controls-iconwrapperheight" aria-label="Permalink to "controls.iconWrapperHeight""></a></h3><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>24</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>操作按钮图标容器高度</p><h3 id="controls-iconwrapperborderradius" tabindex="-1">controls.iconWrapperBorderRadius <a class="header-anchor" href="#controls-iconwrapperborderradius" aria-label="Permalink to "controls.iconWrapperBorderRadius""></a></h3><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>16</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>操作按钮图标容器边框圆角</p><h3 id="controls-iconwidth" tabindex="-1">controls.iconWidth <a class="header-anchor" href="#controls-iconwidth" aria-label="Permalink to "controls.iconWidth""></a></h3><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>12</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>操作按钮图标宽度</p><h3 id="controls-iconheight" tabindex="-1">controls.iconHeight <a class="header-anchor" href="#controls-iconheight" aria-label="Permalink to "controls.iconHeight""></a></h3><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>12</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>操作按钮图标高度</p><h3 id="controls-deleteiconsrc" tabindex="-1">controls.deleteIconSrc <a class="header-anchor" href="#controls-deleteiconsrc" aria-label="Permalink to "controls.deleteIconSrc""></a></h3><ul><li><strong>类型</strong>: <code>string</code></li><li><strong>默认值</strong>: <code>内置资源</code></li></ul><p>删除按钮图标资源路径</p><h3 id="controls-rotateiconsrc" tabindex="-1">controls.rotateIconSrc <a class="header-anchor" href="#controls-rotateiconsrc" aria-label="Permalink to "controls.rotateIconSrc""></a></h3><ul><li><strong>类型</strong>: <code>string</code></li><li><strong>默认值</strong>: <code>内置资源</code></li></ul><p>旋转按钮图标资源路径</p><h3 id="controls-scaleiconsrc" tabindex="-1">controls.scaleIconSrc <a class="header-anchor" href="#controls-scaleiconsrc" aria-label="Permalink to "controls.scaleIconSrc""></a></h3><ul><li><strong>类型</strong>: <code>string</code></li><li><strong>默认值</strong>: <code>内置资源</code></li></ul><p>缩放按钮图标资源路径</p><h3 id="controls-moveiconsrc" tabindex="-1">controls.moveIconSrc <a class="header-anchor" href="#controls-moveiconsrc" aria-label="Permalink to "controls.moveIconSrc""></a></h3><ul><li><strong>类型</strong>: <code>string</code></li><li><strong>默认值</strong>: <code>内置资源</code></li></ul><p>移动按钮图标资源路径</p><h3 id="controls-horizontalscaleiconsrc" tabindex="-1">controls.horizontalScaleIconSrc <a class="header-anchor" href="#controls-horizontalscaleiconsrc" aria-label="Permalink to "controls.horizontalScaleIconSrc""></a></h3><ul><li><strong>类型</strong>: <code>string</code></li><li><strong>默认值</strong>: <code>内置资源</code></li></ul><p>横向缩放按钮图标资源路径。</p><h3 id="controls-verticalscaleiconsrc" tabindex="-1">controls.verticalScaleIconSrc <a class="header-anchor" href="#controls-verticalscaleiconsrc" aria-label="Permalink to "controls.verticalScaleIconSrc""></a></h3><ul><li><strong>类型</strong>: <code>string</code></li><li><strong>默认值</strong>: <code>内置资源</code></li></ul><p>纵向缩放按钮图标资源路径。</p><h3 id="controls-movebuttonoffset" tabindex="-1">controls.moveButtonOffset <a class="header-anchor" href="#controls-movebuttonoffset" aria-label="Permalink to "controls.moveButtonOffset""></a></h3><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>30</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>移动按钮偏移距离</p><h3 id="controls-textfontsize" tabindex="-1">controls.textFontSize <a class="header-anchor" href="#controls-textfontsize" aria-label="Permalink to "controls.textFontSize""></a></h3><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>12</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>尺寸标签文本字体大小</p><h3 id="controls-textfontfamily" tabindex="-1">controls.textFontFamily <a class="header-anchor" href="#controls-textfontfamily" aria-label="Permalink to "controls.textFontFamily""></a></h3><ul><li><strong>类型</strong>: <code>string</code></li><li><strong>默认值</strong>: <code>'system-ui, -apple-system, sans-serif'</code></li></ul><p>尺寸标签文本字体名称</p><h3 id="controls-textfontweight" tabindex="-1">controls.textFontWeight <a class="header-anchor" href="#controls-textfontweight" aria-label="Permalink to "controls.textFontWeight""></a></h3><ul><li><strong>类型</strong>: <code>TextStyleFontWeight</code></li><li><strong>默认值</strong>: <code>'400'</code></li></ul><p>尺寸标签文本字体粗细</p><h3 id="controls-renderorder" tabindex="-1">controls.renderOrder <a class="header-anchor" href="#controls-renderorder" aria-label="Permalink to "controls.renderOrder""></a></h3><ul><li><strong>类型</strong>: <code>ControlRenderItem[]</code></li><li><strong>默认值</strong>: <code>['forbiddenSweepZone', 'forbiddenMopZone', 'cleanZone', 'virtualWall', 'spot', 'wayPoint', 'divider']</code></li></ul><p>控制层内元素渲染顺序配置,数组从下到上生效(后面的元素显示在更上层)。</p><p><strong>可选值:</strong></p><ul><li><code>'forbiddenSweepZone'</code></li><li><code>'forbiddenMopZone'</code></li><li><code>'cleanZone'</code></li><li><code>'virtualWall'</code></li><li><code>'spot'</code></li><li><code>'wayPoint'</code></li><li><code>'divider'</code></li><li>任意通过 <a href="#customzonetypes"><code>customZoneTypes</code></a> 声明的自定义区域类型名</li></ul><p>配置说明:</p><ul><li>你可以通过调整数组顺序来控制不同控制元素的覆盖关系。</li><li>如果配置中缺少某些内置元素,SDK 会自动按默认顺序补齐(自定义类型不会被自动补齐)。</li><li>如果配置中存在重复元素,SDK 仅保留首次出现的位置。</li><li>未写入 <code>renderOrder</code> 的自定义类型会渲染在所有已声明元素之下,且它们之间的相对层级由创建顺序决定;建议把所有需要严格排序的自定义类型都显式写入 <code>renderOrder</code>。</li></ul><p>示例:让禁扫区域显示在禁拖区域上方</p><div class="language-ts vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">ts</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">const</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> app</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> =</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> new</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> MapApplication</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">()</span></span>
|
|
215
215
|
<span class="line"></span>
|
|
216
216
|
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">app.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">initialize</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">({</span></span>
|
|
217
217
|
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> config: {</span></span>
|
|
@@ -227,14 +227,37 @@
|
|
|
227
227
|
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> ],</span></span>
|
|
228
228
|
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> },</span></span>
|
|
229
229
|
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> },</span></span>
|
|
230
|
-
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">})</span></span></code></pre></div><h3 id="controls-forbiddensweepzone" tabindex="-1">controls.forbiddenSweepZone <a class="header-anchor" href="#controls-forbiddensweepzone" aria-label="Permalink to "controls.forbiddenSweepZone""></a></h3><p>禁扫区域配置。</p><h4 id="controls-forbiddensweepzone-minsize" tabindex="-1">controls.forbiddenSweepZone.minSize <a class="header-anchor" href="#controls-forbiddensweepzone-minsize" aria-label="Permalink to "controls.forbiddenSweepZone.minSize""></a></h4><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>1</code></li><li><strong>单位</strong>: <code>米</code></li></ul><p>禁扫区域最小尺寸</p><h4 id="controls-forbiddensweepzone-iconwrapperfillcolor" tabindex="-1">controls.forbiddenSweepZone.iconWrapperFillColor <a class="header-anchor" href="#controls-forbiddensweepzone-iconwrapperfillcolor" aria-label="Permalink to "controls.forbiddenSweepZone.iconWrapperFillColor""></a></h4><ul><li><strong>类型</strong>: <code>ColorSource</code></li><li><strong>默认值</strong>: <code>'#ff4444'</code></li></ul><p>图标容器填充颜色</p><h4 id="controls-forbiddensweepzone-strokecolor" tabindex="-1">controls.forbiddenSweepZone.strokeColor <a class="header-anchor" href="#controls-forbiddensweepzone-strokecolor" aria-label="Permalink to "controls.forbiddenSweepZone.strokeColor""></a></h4><ul><li><strong>类型</strong>: <code>ColorSource</code></li><li><strong>默认值</strong>: <code>'#ff4444'</code></li></ul><p>禁扫区域描边颜色</p><h4 id="controls-forbiddensweepzone-strokewidth" tabindex="-1">controls.forbiddenSweepZone.strokeWidth <a class="header-anchor" href="#controls-forbiddensweepzone-strokewidth" aria-label="Permalink to "controls.forbiddenSweepZone.strokeWidth""></a></h4><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>2</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>禁扫区域描边宽度</p><h4 id="controls-forbiddensweepzone-fillcolor" tabindex="-1">controls.forbiddenSweepZone.fillColor <a class="header-anchor" href="#controls-forbiddensweepzone-fillcolor" aria-label="Permalink to "controls.forbiddenSweepZone.fillColor""></a></h4><ul><li><strong>类型</strong>: <code>ColorSource</code></li><li><strong>默认值</strong>: <code>'rgba(255, 68, 68, 0.1)'</code></li></ul><p>禁扫区域填充颜色</p><h4 id="controls-forbiddensweepzone-outlineoffset" tabindex="-1">controls.forbiddenSweepZone.outlineOffset <a class="header-anchor" href="#controls-forbiddensweepzone-outlineoffset" aria-label="Permalink to "controls.forbiddenSweepZone.outlineOffset""></a></h4><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>16</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>禁扫区域编辑轮廓偏移</p><h4 id="controls-forbiddensweepzone-outlinestrokecolor" tabindex="-1">controls.forbiddenSweepZone.outlineStrokeColor <a class="header-anchor" href="#controls-forbiddensweepzone-outlinestrokecolor" aria-label="Permalink to "controls.forbiddenSweepZone.outlineStrokeColor""></a></h4><ul><li><strong>类型</strong>: <code>ColorSource</code></li><li><strong>默认值</strong>: <code>'#ff4444'</code></li></ul><p>禁扫区域编辑轮廓描边颜色</p><h4 id="controls-forbiddensweepzone-outlinestrokewidth" tabindex="-1">controls.forbiddenSweepZone.outlineStrokeWidth <a class="header-anchor" href="#controls-forbiddensweepzone-outlinestrokewidth" aria-label="Permalink to "controls.forbiddenSweepZone.outlineStrokeWidth""></a></h4><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>2</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>禁扫区域编辑轮廓描边宽度</p><h4 id="controls-forbiddensweepzone-outlinedashed" tabindex="-1">controls.forbiddenSweepZone.outlineDashed <a class="header-anchor" href="#controls-forbiddensweepzone-outlinedashed" aria-label="Permalink to "controls.forbiddenSweepZone.outlineDashed""></a></h4><ul><li><strong>类型</strong>: <code>boolean</code></li><li><strong>默认值</strong>: <code>true</code></li></ul><p>禁扫区域编辑轮廓是否为虚线</p><h4 id="controls-forbiddensweepzone-outlinedasharray" tabindex="-1">controls.forbiddenSweepZone.outlineDashArray <a class="header-anchor" href="#controls-forbiddensweepzone-outlinedasharray" aria-label="Permalink to "controls.forbiddenSweepZone.outlineDashArray""></a></h4><ul><li><strong>类型</strong>: <code>[number, number]</code></li><li><strong>默认值</strong>: <code>[4, 3]</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>禁扫区域编辑轮廓虚线样式</p><h4 id="controls-forbiddensweepzone-outlinefillcolor" tabindex="-1">controls.forbiddenSweepZone.outlineFillColor <a class="header-anchor" href="#controls-forbiddensweepzone-outlinefillcolor" aria-label="Permalink to "controls.forbiddenSweepZone.outlineFillColor""></a></h4><ul><li><strong>类型</strong>: <code>ColorSource</code></li><li><strong>默认值</strong>: <code>'rgba(255, 68, 68, 0.05)'</code></li></ul><p>禁扫区域编辑轮廓填充颜色</p><h4 id="controls-forbiddensweepzone-showrotatebutton" tabindex="-1">controls.forbiddenSweepZone.showRotateButton <a class="header-anchor" href="#controls-forbiddensweepzone-showrotatebutton" aria-label="Permalink to "controls.forbiddenSweepZone.showRotateButton""></a></h4><ul><li><strong>类型</strong>: <code>boolean</code></li><li><strong>默认值</strong>: <code>true</code></li></ul><p>是否显示旋转按钮</p><h4 id="controls-forbiddensweepzone-textcolor" tabindex="-1">controls.forbiddenSweepZone.textColor <a class="header-anchor" href="#controls-forbiddensweepzone-textcolor" aria-label="Permalink to "controls.forbiddenSweepZone.textColor""></a></h4><ul><li><strong>类型</strong>: <code>ColorSource</code></li><li><strong>默认值</strong>: <code>'#ff4444'</code></li></ul><p>禁扫区域尺寸标签文本颜色</p><h4 id="controls-forbiddensweepzone-textposition" tabindex="-1">controls.forbiddenSweepZone.textPosition <a class="header-anchor" href="#controls-forbiddensweepzone-textposition" aria-label="Permalink to "controls.forbiddenSweepZone.textPosition""></a></h4><ul><li><strong>类型</strong>: <code>'top' | 'right' | 'bottom' | 'left'</code></li><li><strong>默认值</strong>: <code>'bottom'</code></li></ul><p>禁扫区域尺寸标签文本位置</p><h4 id="controls-forbiddensweepzone-textoffset" tabindex="-1">controls.forbiddenSweepZone.textOffset <a class="header-anchor" href="#controls-forbiddensweepzone-textoffset" aria-label="Permalink to "controls.forbiddenSweepZone.textOffset""></a></h4><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>8</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>禁扫区域尺寸标签文本偏移</p><h4 id="controls-forbiddensweepzone-editing" tabindex="-1">controls.forbiddenSweepZone.editing <a class="header-anchor" href="#controls-forbiddensweepzone-editing" aria-label="Permalink to "controls.forbiddenSweepZone.editing""></a></h4><p>区域框编辑模式样式配置。</p><h5 id="controls-forbiddensweepzone-editing-isdashed" tabindex="-1">controls.forbiddenSweepZone.editing.isDashed <a class="header-anchor" href="#controls-forbiddensweepzone-editing-isdashed" aria-label="Permalink to "controls.forbiddenSweepZone.editing.isDashed""></a></h5><ul><li><strong>类型</strong>: <code>boolean</code></li><li><strong>默认值</strong>: <code>false</code></li></ul><p>编辑模式下禁扫区域框是否显示为虚线</p><h5 id="controls-forbiddensweepzone-editing-dasharray" tabindex="-1">controls.forbiddenSweepZone.editing.dashArray <a class="header-anchor" href="#controls-forbiddensweepzone-editing-dasharray" aria-label="Permalink to "controls.forbiddenSweepZone.editing.dashArray""></a></h5><ul><li><strong>类型</strong>: <code>[number, number]</code></li><li><strong>默认值</strong>: <code>[0, 0]</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>编辑模式下禁扫区域框虚线样式</p><h4 id="controls-forbiddensweepzone-normal" tabindex="-1">controls.forbiddenSweepZone.normal <a class="header-anchor" href="#controls-forbiddensweepzone-normal" aria-label="Permalink to "controls.forbiddenSweepZone.normal""></a></h4><p>区域框普通模式样式配置。</p><h5 id="controls-forbiddensweepzone-normal-isdashed" tabindex="-1">controls.forbiddenSweepZone.normal.isDashed <a class="header-anchor" href="#controls-forbiddensweepzone-normal-isdashed" aria-label="Permalink to "controls.forbiddenSweepZone.normal.isDashed""></a></h5><ul><li><strong>类型</strong>: <code>boolean</code></li><li><strong>默认值</strong>: <code>false</code></li></ul><p>普通模式下禁扫区域框是否显示为虚线</p><h5 id="controls-forbiddensweepzone-normal-dasharray" tabindex="-1">controls.forbiddenSweepZone.normal.dashArray <a class="header-anchor" href="#controls-forbiddensweepzone-normal-dasharray" aria-label="Permalink to "controls.forbiddenSweepZone.normal.dashArray""></a></h5><ul><li><strong>类型</strong>: <code>[number, number]</code></li><li><strong>默认值</strong>: <code>[0, 0]</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>普通模式下禁扫区域框虚线样式</p><h3 id="controls-forbiddenmopzone" tabindex="-1">controls.forbiddenMopZone <a class="header-anchor" href="#controls-forbiddenmopzone" aria-label="Permalink to "controls.forbiddenMopZone""></a></h3><p>禁拖区域配置。</p><h4 id="controls-forbiddenmopzone-minsize" tabindex="-1">controls.forbiddenMopZone.minSize <a class="header-anchor" href="#controls-forbiddenmopzone-minsize" aria-label="Permalink to "controls.forbiddenMopZone.minSize""></a></h4><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>1</code></li><li><strong>单位</strong>: <code>米</code></li></ul><p>禁拖区域最小尺寸</p><h4 id="controls-forbiddenmopzone-iconwrapperfillcolor" tabindex="-1">controls.forbiddenMopZone.iconWrapperFillColor <a class="header-anchor" href="#controls-forbiddenmopzone-iconwrapperfillcolor" aria-label="Permalink to "controls.forbiddenMopZone.iconWrapperFillColor""></a></h4><ul><li><strong>类型</strong>: <code>ColorSource</code></li><li><strong>默认值</strong>: <code>'#fe8a07'</code></li></ul><p>图标容器填充颜色</p><h4 id="controls-forbiddenmopzone-strokecolor" tabindex="-1">controls.forbiddenMopZone.strokeColor <a class="header-anchor" href="#controls-forbiddenmopzone-strokecolor" aria-label="Permalink to "controls.forbiddenMopZone.strokeColor""></a></h4><ul><li><strong>类型</strong>: <code>ColorSource</code></li><li><strong>默认值</strong>: <code>'#fe8a07'</code></li></ul><p>禁拖区域描边颜色</p><h4 id="controls-forbiddenmopzone-strokewidth" tabindex="-1">controls.forbiddenMopZone.strokeWidth <a class="header-anchor" href="#controls-forbiddenmopzone-strokewidth" aria-label="Permalink to "controls.forbiddenMopZone.strokeWidth""></a></h4><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>2</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>禁拖区域描边宽度</p><h4 id="controls-forbiddenmopzone-fillcolor" tabindex="-1">controls.forbiddenMopZone.fillColor <a class="header-anchor" href="#controls-forbiddenmopzone-fillcolor" aria-label="Permalink to "controls.forbiddenMopZone.fillColor""></a></h4><ul><li><strong>类型</strong>: <code>ColorSource</code></li><li><strong>默认值</strong>: <code>'rgba(254, 138, 7, 0.1)'</code></li></ul><p>禁拖区域填充颜色</p><h4 id="controls-forbiddenmopzone-outlineoffset" tabindex="-1">controls.forbiddenMopZone.outlineOffset <a class="header-anchor" href="#controls-forbiddenmopzone-outlineoffset" aria-label="Permalink to "controls.forbiddenMopZone.outlineOffset""></a></h4><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>16</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>禁拖区域轮廓偏移</p><h4 id="controls-forbiddenmopzone-outlinestrokecolor" tabindex="-1">controls.forbiddenMopZone.outlineStrokeColor <a class="header-anchor" href="#controls-forbiddenmopzone-outlinestrokecolor" aria-label="Permalink to "controls.forbiddenMopZone.outlineStrokeColor""></a></h4><ul><li><strong>类型</strong>: <code>ColorSource</code></li><li><strong>默认值</strong>: <code>'#fe8a07'</code></li></ul><p>禁拖区域轮廓描边颜色</p><h4 id="controls-forbiddenmopzone-outlinestrokewidth" tabindex="-1">controls.forbiddenMopZone.outlineStrokeWidth <a class="header-anchor" href="#controls-forbiddenmopzone-outlinestrokewidth" aria-label="Permalink to "controls.forbiddenMopZone.outlineStrokeWidth""></a></h4><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>2</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>禁拖区域轮廓描边宽度</p><h4 id="controls-forbiddenmopzone-outlinedashed" tabindex="-1">controls.forbiddenMopZone.outlineDashed <a class="header-anchor" href="#controls-forbiddenmopzone-outlinedashed" aria-label="Permalink to "controls.forbiddenMopZone.outlineDashed""></a></h4><ul><li><strong>类型</strong>: <code>boolean</code></li><li><strong>默认值</strong>: <code>true</code></li></ul><p>禁拖区域轮廓是否为虚线</p><h4 id="controls-forbiddenmopzone-outlinedasharray" tabindex="-1">controls.forbiddenMopZone.outlineDashArray <a class="header-anchor" href="#controls-forbiddenmopzone-outlinedasharray" aria-label="Permalink to "controls.forbiddenMopZone.outlineDashArray""></a></h4><ul><li><strong>类型</strong>: <code>[number, number]</code></li><li><strong>默认值</strong>: <code>[4, 3]</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>禁拖区域轮廓虚线样式</p><h4 id="controls-forbiddenmopzone-outlinefillcolor" tabindex="-1">controls.forbiddenMopZone.outlineFillColor <a class="header-anchor" href="#controls-forbiddenmopzone-outlinefillcolor" aria-label="Permalink to "controls.forbiddenMopZone.outlineFillColor""></a></h4><ul><li><strong>类型</strong>: <code>ColorSource</code></li><li><strong>默认值</strong>: <code>'rgba(254, 138, 7, 0.05)'</code></li></ul><p>禁拖区域轮廓填充颜色</p><h4 id="controls-forbiddenmopzone-showrotatebutton" tabindex="-1">controls.forbiddenMopZone.showRotateButton <a class="header-anchor" href="#controls-forbiddenmopzone-showrotatebutton" aria-label="Permalink to "controls.forbiddenMopZone.showRotateButton""></a></h4><ul><li><strong>类型</strong>: <code>boolean</code></li><li><strong>默认值</strong>: <code>true</code></li></ul><p>是否显示旋转按钮</p><h4 id="controls-forbiddenmopzone-textcolor" tabindex="-1">controls.forbiddenMopZone.textColor <a class="header-anchor" href="#controls-forbiddenmopzone-textcolor" aria-label="Permalink to "controls.forbiddenMopZone.textColor""></a></h4><ul><li><strong>类型</strong>: <code>ColorSource</code></li><li><strong>默认值</strong>: <code>'#fe8a07'</code></li></ul><p>禁拖区域文本颜色</p><h4 id="controls-forbiddenmopzone-textposition" tabindex="-1">controls.forbiddenMopZone.textPosition <a class="header-anchor" href="#controls-forbiddenmopzone-textposition" aria-label="Permalink to "controls.forbiddenMopZone.textPosition""></a></h4><ul><li><strong>类型</strong>: <code>'top' | 'right' | 'bottom' | 'left'</code></li><li><strong>默认值</strong>: <code>'bottom'</code></li></ul><p>禁拖区域文本位置</p><h4 id="controls-forbiddenmopzone-textoffset" tabindex="-1">controls.forbiddenMopZone.textOffset <a class="header-anchor" href="#controls-forbiddenmopzone-textoffset" aria-label="Permalink to "controls.forbiddenMopZone.textOffset""></a></h4><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>8</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>禁拖区域文本偏移</p><h4 id="controls-forbiddenmopzone-editing" tabindex="-1">controls.forbiddenMopZone.editing <a class="header-anchor" href="#controls-forbiddenmopzone-editing" aria-label="Permalink to "controls.forbiddenMopZone.editing""></a></h4><p>区域框编辑模式样式配置。</p><h5 id="controls-forbiddenmopzone-editing-isdashed" tabindex="-1">controls.forbiddenMopZone.editing.isDashed <a class="header-anchor" href="#controls-forbiddenmopzone-editing-isdashed" aria-label="Permalink to "controls.forbiddenMopZone.editing.isDashed""></a></h5><ul><li><strong>类型</strong>: <code>boolean</code></li><li><strong>默认值</strong>: <code>false</code></li></ul><p>编辑模式下禁拖区域框是否显示为虚线</p><h5 id="controls-forbiddenmopzone-editing-dasharray" tabindex="-1">controls.forbiddenMopZone.editing.dashArray <a class="header-anchor" href="#controls-forbiddenmopzone-editing-dasharray" aria-label="Permalink to "controls.forbiddenMopZone.editing.dashArray""></a></h5><ul><li><strong>类型</strong>: <code>[number, number]</code></li><li><strong>默认值</strong>: <code>[0, 0]</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>编辑模式下禁拖区域框虚线样式</p><h4 id="controls-forbiddenmopzone-normal" tabindex="-1">controls.forbiddenMopZone.normal <a class="header-anchor" href="#controls-forbiddenmopzone-normal" aria-label="Permalink to "controls.forbiddenMopZone.normal""></a></h4><p>区域框普通模式样式配置。</p><h5 id="controls-forbiddenmopzone-normal-isdashed" tabindex="-1">controls.forbiddenMopZone.normal.isDashed <a class="header-anchor" href="#controls-forbiddenmopzone-normal-isdashed" aria-label="Permalink to "controls.forbiddenMopZone.normal.isDashed""></a></h5><ul><li><strong>类型</strong>: <code>boolean</code></li><li><strong>默认值</strong>: <code>false</code></li></ul><p>普通模式下禁拖区域框是否显示为虚线</p><h5 id="controls-forbiddenmopzone-normal-dasharray" tabindex="-1">controls.forbiddenMopZone.normal.dashArray <a class="header-anchor" href="#controls-forbiddenmopzone-normal-dasharray" aria-label="Permalink to "controls.forbiddenMopZone.normal.dashArray""></a></h5><ul><li><strong>类型</strong>: <code>[number, number]</code></li><li><strong>默认值</strong>: <code>[0, 0]</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>普通模式下禁拖区域框虚线样式</p><h3 id="controls-carpet" tabindex="-1">controls.carpet <a class="header-anchor" href="#controls-carpet" aria-label="Permalink to "controls.carpet""></a></h3><p>自定义地毯编辑配置。</p><h4 id="controls-carpet-minsize" tabindex="-1">controls.carpet.minSize <a class="header-anchor" href="#controls-carpet-minsize" aria-label="Permalink to "controls.carpet.minSize""></a></h4><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>1</code></li><li><strong>单位</strong>: <code>米</code></li></ul><p>自定义地毯最小尺寸。</p><h4 id="controls-carpet-iconwrapperfillcolor" tabindex="-1">controls.carpet.iconWrapperFillColor <a class="header-anchor" href="#controls-carpet-iconwrapperfillcolor" aria-label="Permalink to "controls.carpet.iconWrapperFillColor""></a></h4><ul><li><strong>类型</strong>: <code>ColorSource</code></li><li><strong>默认值</strong>: <code>'#5d68fe'</code></li></ul><p>图标容器填充颜色。</p><h4 id="controls-carpet-strokecolor" tabindex="-1">controls.carpet.strokeColor <a class="header-anchor" href="#controls-carpet-strokecolor" aria-label="Permalink to "controls.carpet.strokeColor""></a></h4><ul><li><strong>类型</strong>: <code>ColorSource</code></li><li><strong>默认值</strong>: <code>'#5d68fe'</code></li></ul><p>地毯描边颜色。</p><h4 id="controls-carpet-strokewidth" tabindex="-1">controls.carpet.strokeWidth <a class="header-anchor" href="#controls-carpet-strokewidth" aria-label="Permalink to "controls.carpet.strokeWidth""></a></h4><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>2</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>地毯描边宽度。</p><h4 id="controls-carpet-fillcolor" tabindex="-1">controls.carpet.fillColor <a class="header-anchor" href="#controls-carpet-fillcolor" aria-label="Permalink to "controls.carpet.fillColor""></a></h4><ul><li><strong>类型</strong>: <code>ColorSource</code></li><li><strong>默认值</strong>: <code>'rgba(93, 104, 254, 0.1)'</code></li></ul><p>地毯填充颜色。</p><h4 id="controls-carpet-outlineoffset" tabindex="-1">controls.carpet.outlineOffset <a class="header-anchor" href="#controls-carpet-outlineoffset" aria-label="Permalink to "controls.carpet.outlineOffset""></a></h4><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>30</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>编辑轮廓偏移。</p><h4 id="controls-carpet-outlinestrokecolor" tabindex="-1">controls.carpet.outlineStrokeColor <a class="header-anchor" href="#controls-carpet-outlinestrokecolor" aria-label="Permalink to "controls.carpet.outlineStrokeColor""></a></h4><ul><li><strong>类型</strong>: <code>ColorSource</code></li><li><strong>默认值</strong>: <code>'rgba(0, 0, 0, 0.7)'</code></li></ul><p>编辑轮廓描边颜色。</p><h4 id="controls-carpet-outlinestrokewidth" tabindex="-1">controls.carpet.outlineStrokeWidth <a class="header-anchor" href="#controls-carpet-outlinestrokewidth" aria-label="Permalink to "controls.carpet.outlineStrokeWidth""></a></h4><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>2</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>编辑轮廓描边宽度。</p><h4 id="controls-carpet-outlinedashed" tabindex="-1">controls.carpet.outlineDashed <a class="header-anchor" href="#controls-carpet-outlinedashed" aria-label="Permalink to "controls.carpet.outlineDashed""></a></h4><ul><li><strong>类型</strong>: <code>boolean</code></li><li><strong>默认值</strong>: <code>true</code></li></ul><p>编辑轮廓是否虚线。</p><h4 id="controls-carpet-outlinedasharray" tabindex="-1">controls.carpet.outlineDashArray <a class="header-anchor" href="#controls-carpet-outlinedasharray" aria-label="Permalink to "controls.carpet.outlineDashArray""></a></h4><ul><li><strong>类型</strong>: <code>[number, number]</code></li><li><strong>默认值</strong>: <code>[4, 3]</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>编辑轮廓虚线样式。</p><h4 id="controls-carpet-outlinefillcolor" tabindex="-1">controls.carpet.outlineFillColor <a class="header-anchor" href="#controls-carpet-outlinefillcolor" aria-label="Permalink to "controls.carpet.outlineFillColor""></a></h4><ul><li><strong>类型</strong>: <code>ColorSource</code></li><li><strong>默认值</strong>: <code>'rgba(93, 104, 254, 0.05)'</code></li></ul><p>编辑轮廓填充颜色。</p><h4 id="controls-carpet-showrotatebutton" tabindex="-1">controls.carpet.showRotateButton <a class="header-anchor" href="#controls-carpet-showrotatebutton" aria-label="Permalink to "controls.carpet.showRotateButton""></a></h4><ul><li><strong>类型</strong>: <code>boolean</code></li><li><strong>默认值</strong>: <code>true</code></li></ul><p>是否显示旋转按钮。</p><h4 id="controls-carpet-enablefreerotate" tabindex="-1">controls.carpet.enableFreeRotate <a class="header-anchor" href="#controls-carpet-enablefreerotate" aria-label="Permalink to "controls.carpet.enableFreeRotate""></a></h4><ul><li><strong>类型</strong>: <code>boolean</code></li><li><strong>默认值</strong>: <code>false</code></li></ul><p>是否开启自由旋转模式。</p><h4 id="controls-carpet-textcolor" tabindex="-1">controls.carpet.textColor <a class="header-anchor" href="#controls-carpet-textcolor" aria-label="Permalink to "controls.carpet.textColor""></a></h4><ul><li><strong>类型</strong>: <code>ColorSource</code></li><li><strong>默认值</strong>: <code>'#5d68fe'</code></li></ul><p>尺寸文本颜色。</p><h4 id="controls-carpet-textposition" tabindex="-1">controls.carpet.textPosition <a class="header-anchor" href="#controls-carpet-textposition" aria-label="Permalink to "controls.carpet.textPosition""></a></h4><ul><li><strong>类型</strong>: <code>'top' | 'right' | 'bottom' | 'left'</code></li><li><strong>默认值</strong>: <code>'bottom'</code></li></ul><p>尺寸文本位置。</p><h4 id="controls-carpet-textoffset" tabindex="-1">controls.carpet.textOffset <a class="header-anchor" href="#controls-carpet-textoffset" aria-label="Permalink to "controls.carpet.textOffset""></a></h4><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>20</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>尺寸文本偏移。</p><h4 id="controls-carpet-editing" tabindex="-1">controls.carpet.editing <a class="header-anchor" href="#controls-carpet-editing" aria-label="Permalink to "controls.carpet.editing""></a></h4><h5 id="controls-carpet-editing-isdashed" tabindex="-1">controls.carpet.editing.isDashed <a class="header-anchor" href="#controls-carpet-editing-isdashed" aria-label="Permalink to "controls.carpet.editing.isDashed""></a></h5><ul><li><strong>类型</strong>: <code>boolean</code></li><li><strong>默认值</strong>: <code>true</code></li></ul><p>编辑模式是否虚线。</p><h5 id="controls-carpet-editing-dasharray" tabindex="-1">controls.carpet.editing.dashArray <a class="header-anchor" href="#controls-carpet-editing-dasharray" aria-label="Permalink to "controls.carpet.editing.dashArray""></a></h5><ul><li><strong>类型</strong>: <code>[number, number]</code></li><li><strong>默认值</strong>: <code>[4, 3]</code></li></ul><p>编辑模式虚线样式。</p><h4 id="controls-carpet-normal" tabindex="-1">controls.carpet.normal <a class="header-anchor" href="#controls-carpet-normal" aria-label="Permalink to "controls.carpet.normal""></a></h4><h5 id="controls-carpet-normal-isdashed" tabindex="-1">controls.carpet.normal.isDashed <a class="header-anchor" href="#controls-carpet-normal-isdashed" aria-label="Permalink to "controls.carpet.normal.isDashed""></a></h5><ul><li><strong>类型</strong>: <code>boolean</code></li><li><strong>默认值</strong>: <code>false</code></li></ul><p>普通模式是否虚线。</p><h5 id="controls-carpet-normal-dasharray" tabindex="-1">controls.carpet.normal.dashArray <a class="header-anchor" href="#controls-carpet-normal-dasharray" aria-label="Permalink to "controls.carpet.normal.dashArray""></a></h5><ul><li><strong>类型</strong>: <code>[number, number]</code></li><li><strong>默认值</strong>: <code>[0, 0]</code></li></ul><p>普通模式虚线样式。</p><h3 id="cleanzone" tabindex="-1">cleanZone <a class="header-anchor" href="#cleanzone" aria-label="Permalink to "cleanZone""></a></h3><p>清扫区域配置。</p><h4 id="controls-cleanzone-minsize" tabindex="-1">controls.cleanZone.minSize <a class="header-anchor" href="#controls-cleanzone-minsize" aria-label="Permalink to "controls.cleanZone.minSize""></a></h4><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>1</code></li><li><strong>单位</strong>: <code>米</code></li></ul><p>清扫区域最小尺寸</p><h4 id="controls-cleanzone-iconwrapperfillcolor" tabindex="-1">controls.cleanZone.iconWrapperFillColor <a class="header-anchor" href="#controls-cleanzone-iconwrapperfillcolor" aria-label="Permalink to "controls.cleanZone.iconWrapperFillColor""></a></h4><ul><li><strong>类型</strong>: <code>ColorSource</code></li><li><strong>默认值</strong>: <code>'#5d68fe'</code></li></ul><p>清扫区域图标容器填充颜色</p><h4 id="controls-cleanzone-strokecolor" tabindex="-1">controls.cleanZone.strokeColor <a class="header-anchor" href="#controls-cleanzone-strokecolor" aria-label="Permalink to "controls.cleanZone.strokeColor""></a></h4><ul><li><strong>类型</strong>: <code>ColorSource</code></li><li><strong>默认值</strong>: <code>'#5d68fe'</code></li></ul><p>清扫区域描边颜色</p><h4 id="controls-cleanzone-strokewidth" tabindex="-1">controls.cleanZone.strokeWidth <a class="header-anchor" href="#controls-cleanzone-strokewidth" aria-label="Permalink to "controls.cleanZone.strokeWidth""></a></h4><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>2</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>清扫区域描边宽度</p><h4 id="controls-cleanzone-fillcolor" tabindex="-1">controls.cleanZone.fillColor <a class="header-anchor" href="#controls-cleanzone-fillcolor" aria-label="Permalink to "controls.cleanZone.fillColor""></a></h4><ul><li><strong>类型</strong>: <code>ColorSource</code></li><li><strong>默认值</strong>: <code>'rgba(93, 104, 254, 0.1)'</code></li></ul><p>清扫区域填充颜色</p><h4 id="controls-cleanzone-outlineoffset" tabindex="-1">controls.cleanZone.outlineOffset <a class="header-anchor" href="#controls-cleanzone-outlineoffset" aria-label="Permalink to "controls.cleanZone.outlineOffset""></a></h4><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>16</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>清扫区域轮廓偏移</p><h4 id="controls-cleanzone-outlinestrokecolor" tabindex="-1">controls.cleanZone.outlineStrokeColor <a class="header-anchor" href="#controls-cleanzone-outlinestrokecolor" aria-label="Permalink to "controls.cleanZone.outlineStrokeColor""></a></h4><ul><li><strong>类型</strong>: <code>ColorSource</code></li><li><strong>默认值</strong>: <code>'#5d68fe'</code></li></ul><p>清扫区域轮廓描边颜色</p><h4 id="controls-cleanzone-outlinestrokewidth" tabindex="-1">controls.cleanZone.outlineStrokeWidth <a class="header-anchor" href="#controls-cleanzone-outlinestrokewidth" aria-label="Permalink to "controls.cleanZone.outlineStrokeWidth""></a></h4><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>2</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>清扫区域轮廓描边宽度</p><h4 id="controls-cleanzone-outlinedashed" tabindex="-1">controls.cleanZone.outlineDashed <a class="header-anchor" href="#controls-cleanzone-outlinedashed" aria-label="Permalink to "controls.cleanZone.outlineDashed""></a></h4><ul><li><strong>类型</strong>: <code>boolean</code></li><li><strong>默认值</strong>: <code>true</code></li></ul><p>清扫区域轮廓是否为虚线</p><h4 id="controls-cleanzone-outlinedasharray" tabindex="-1">controls.cleanZone.outlineDashArray <a class="header-anchor" href="#controls-cleanzone-outlinedasharray" aria-label="Permalink to "controls.cleanZone.outlineDashArray""></a></h4><ul><li><strong>类型</strong>: <code>[number, number]</code></li><li><strong>默认值</strong>: <code>[4, 3]</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>清扫区域轮廓虚线样式</p><h4 id="controls-cleanzone-outlinefillcolor" tabindex="-1">controls.cleanZone.outlineFillColor <a class="header-anchor" href="#controls-cleanzone-outlinefillcolor" aria-label="Permalink to "controls.cleanZone.outlineFillColor""></a></h4><ul><li><strong>类型</strong>: <code>ColorSource</code></li><li><strong>默认值</strong>: <code>'rgba(93, 104, 254, 0.05)'</code></li></ul><p>清扫区域轮廓填充颜色</p><h4 id="controls-cleanzone-showrotatebutton" tabindex="-1">controls.cleanZone.showRotateButton <a class="header-anchor" href="#controls-cleanzone-showrotatebutton" aria-label="Permalink to "controls.cleanZone.showRotateButton""></a></h4><ul><li><strong>类型</strong>: <code>boolean</code></li><li><strong>默认值</strong>: <code>true</code></li></ul><p>是否显示旋转按钮</p><h4 id="controls-cleanzone-textcolor" tabindex="-1">controls.cleanZone.textColor <a class="header-anchor" href="#controls-cleanzone-textcolor" aria-label="Permalink to "controls.cleanZone.textColor""></a></h4><ul><li><strong>类型</strong>: <code>ColorSource</code></li><li><strong>默认值</strong>: <code>'#5d68fe'</code></li></ul><p>清扫区域文本颜色</p><h4 id="controls-cleanzone-textposition" tabindex="-1">controls.cleanZone.textPosition <a class="header-anchor" href="#controls-cleanzone-textposition" aria-label="Permalink to "controls.cleanZone.textPosition""></a></h4><ul><li><strong>类型</strong>: <code>'top' | 'right' | 'bottom' | 'left'</code></li><li><strong>默认值</strong>: <code>'bottom'</code></li></ul><p>清扫区域文本位置</p><h4 id="controls-cleanzone-textoffset" tabindex="-1">controls.cleanZone.textOffset <a class="header-anchor" href="#controls-cleanzone-textoffset" aria-label="Permalink to "controls.cleanZone.textOffset""></a></h4><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>8</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>清扫区域文本偏移</p><h4 id="controls-cleanzone-editing" tabindex="-1">controls.cleanZone.editing <a class="header-anchor" href="#controls-cleanzone-editing" aria-label="Permalink to "controls.cleanZone.editing""></a></h4><p>区域框编辑模式样式配置。</p><h5 id="controls-cleanzone-editing-isdashed" tabindex="-1">controls.cleanZone.editing.isDashed <a class="header-anchor" href="#controls-cleanzone-editing-isdashed" aria-label="Permalink to "controls.cleanZone.editing.isDashed""></a></h5><ul><li><strong>类型</strong>: <code>boolean</code></li><li><strong>默认值</strong>: <code>false</code></li></ul><p>编辑模式下清扫区域框是否显示为虚线</p><h5 id="controls-cleanzone-editing-dasharray" tabindex="-1">controls.cleanZone.editing.dashArray <a class="header-anchor" href="#controls-cleanzone-editing-dasharray" aria-label="Permalink to "controls.cleanZone.editing.dashArray""></a></h5><ul><li><strong>类型</strong>: <code>[number, number]</code></li><li><strong>默认值</strong>: <code>[0, 0]</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>编辑模式下清扫区域框虚线样式</p><h4 id="controls-cleanzone-normal" tabindex="-1">controls.cleanZone.normal <a class="header-anchor" href="#controls-cleanzone-normal" aria-label="Permalink to "controls.cleanZone.normal""></a></h4><p>区域框普通模式样式配置。</p><h5 id="controls-cleanzone-normal-isdashed" tabindex="-1">controls.cleanZone.normal.isDashed <a class="header-anchor" href="#controls-cleanzone-normal-isdashed" aria-label="Permalink to "controls.cleanZone.normal.isDashed""></a></h5><ul><li><strong>类型</strong>: <code>boolean</code></li><li><strong>默认值</strong>: <code>false</code></li></ul><p>普通模式下清扫区域框是否显示为虚线</p><h5 id="controls-cleanzone-normal-dasharray" tabindex="-1">controls.cleanZone.normal.dashArray <a class="header-anchor" href="#controls-cleanzone-normal-dasharray" aria-label="Permalink to "controls.cleanZone.normal.dashArray""></a></h5><ul><li><strong>类型</strong>: <code>[number, number]</code></li><li><strong>默认值</strong>: <code>[0, 0]</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>普通模式下清扫区域框虚线样式</p><h3 id="controls-virtualwall" tabindex="-1">controls.virtualWall <a class="header-anchor" href="#controls-virtualwall" aria-label="Permalink to "controls.virtualWall""></a></h3><p>虚拟墙配置。</p><h4 id="controls-virtualwall-iconwrapperfillcolor" tabindex="-1">controls.virtualWall.iconWrapperFillColor <a class="header-anchor" href="#controls-virtualwall-iconwrapperfillcolor" aria-label="Permalink to "controls.virtualWall.iconWrapperFillColor""></a></h4><ul><li><strong>类型</strong>: <code>ColorSource</code></li><li><strong>默认值</strong>: <code>'#ff4444'</code></li></ul><p>虚拟墙图标容器填充颜色</p><h4 id="controls-virtualwall-linewidth" tabindex="-1">controls.virtualWall.lineWidth <a class="header-anchor" href="#controls-virtualwall-linewidth" aria-label="Permalink to "controls.virtualWall.lineWidth""></a></h4><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>2</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>虚拟墙线条宽度</p><h4 id="controls-virtualwall-linecolor" tabindex="-1">controls.virtualWall.lineColor <a class="header-anchor" href="#controls-virtualwall-linecolor" aria-label="Permalink to "controls.virtualWall.lineColor""></a></h4><ul><li><strong>类型</strong>: <code>ColorSource</code></li><li><strong>默认值</strong>: <code>'#ff4444'</code></li></ul><p>虚拟墙线条颜色</p><h4 id="controls-virtualwall-hitareathickness" tabindex="-1">controls.virtualWall.hitAreaThickness <a class="header-anchor" href="#controls-virtualwall-hitareathickness" aria-label="Permalink to "controls.virtualWall.hitAreaThickness""></a></h4><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>30</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>虚拟墙热区厚度</p><h4 id="controls-virtualwall-outlineoffset" tabindex="-1">controls.virtualWall.outlineOffset <a class="header-anchor" href="#controls-virtualwall-outlineoffset" aria-label="Permalink to "controls.virtualWall.outlineOffset""></a></h4><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>16</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>虚拟墙轮廓偏移</p><h4 id="controls-virtualwall-outlinestrokecolor" tabindex="-1">controls.virtualWall.outlineStrokeColor <a class="header-anchor" href="#controls-virtualwall-outlinestrokecolor" aria-label="Permalink to "controls.virtualWall.outlineStrokeColor""></a></h4><ul><li><strong>类型</strong>: <code>ColorSource</code></li><li><strong>默认值</strong>: <code>'#ff4444'</code></li></ul><p>虚拟墙轮廓描边颜色</p><h4 id="controls-virtualwall-outlinestrokewidth" tabindex="-1">controls.virtualWall.outlineStrokeWidth <a class="header-anchor" href="#controls-virtualwall-outlinestrokewidth" aria-label="Permalink to "controls.virtualWall.outlineStrokeWidth""></a></h4><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>2</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>虚拟墙轮廓描边宽度</p><h4 id="controls-virtualwall-outlinedashed" tabindex="-1">controls.virtualWall.outlineDashed <a class="header-anchor" href="#controls-virtualwall-outlinedashed" aria-label="Permalink to "controls.virtualWall.outlineDashed""></a></h4><ul><li><strong>类型</strong>: <code>boolean</code></li><li><strong>默认值</strong>: <code>true</code></li></ul><p>虚拟墙轮廓是否为虚线</p><h4 id="controls-virtualwall-outlinedasharray" tabindex="-1">controls.virtualWall.outlineDashArray <a class="header-anchor" href="#controls-virtualwall-outlinedasharray" aria-label="Permalink to "controls.virtualWall.outlineDashArray""></a></h4><ul><li><strong>类型</strong>: <code>[number, number]</code></li><li><strong>默认值</strong>: <code>[4, 3]</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>虚拟墙轮廓虚线样式</p><h4 id="controls-virtualwall-outlinefillcolor" tabindex="-1">controls.virtualWall.outlineFillColor <a class="header-anchor" href="#controls-virtualwall-outlinefillcolor" aria-label="Permalink to "controls.virtualWall.outlineFillColor""></a></h4><ul><li><strong>类型</strong>: <code>ColorSource</code></li><li><strong>默认值</strong>: <code>'rgba(255, 68, 68, 0.05)'</code></li></ul><p>虚拟墙轮廓填充颜色</p><h4 id="controls-virtualwall-minwidth" tabindex="-1">controls.virtualWall.minWidth <a class="header-anchor" href="#controls-virtualwall-minwidth" aria-label="Permalink to "controls.virtualWall.minWidth""></a></h4><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>1</code></li><li><strong>单位</strong>: <code>米</code></li></ul><p>虚拟墙最小宽度</p><h4 id="controls-virtualwall-textcolor" tabindex="-1">controls.virtualWall.textColor <a class="header-anchor" href="#controls-virtualwall-textcolor" aria-label="Permalink to "controls.virtualWall.textColor""></a></h4><ul><li><strong>类型</strong>: <code>ColorSource</code></li><li><strong>默认值</strong>: <code>'#ff4444'</code></li></ul><p>虚拟墙文本颜色</p><h4 id="controls-virtualwall-textoffset" tabindex="-1">controls.virtualWall.textOffset <a class="header-anchor" href="#controls-virtualwall-textoffset" aria-label="Permalink to "controls.virtualWall.textOffset""></a></h4><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>8</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>虚拟墙文本偏移</p><h4 id="controls-virtualwall-editing" tabindex="-1">controls.virtualWall.editing <a class="header-anchor" href="#controls-virtualwall-editing" aria-label="Permalink to "controls.virtualWall.editing""></a></h4><p>虚拟墙编辑模式样式配置。</p><h5 id="controls-virtualwall-editing-isdashed" tabindex="-1">controls.virtualWall.editing.isDashed <a class="header-anchor" href="#controls-virtualwall-editing-isdashed" aria-label="Permalink to "controls.virtualWall.editing.isDashed""></a></h5><ul><li><strong>类型</strong>: <code>boolean</code></li><li><strong>默认值</strong>: <code>false</code></li></ul><p>编辑模式下是否使用虚线。</p><h5 id="controls-virtualwall-editing-dasharray" tabindex="-1">controls.virtualWall.editing.dashArray <a class="header-anchor" href="#controls-virtualwall-editing-dasharray" aria-label="Permalink to "controls.virtualWall.editing.dashArray""></a></h5><ul><li><strong>类型</strong>: <code>[number, number]</code></li><li><strong>默认值</strong>: <code>[0, 0]</code></li></ul><p>编辑模式虚线样式。</p><h4 id="controls-virtualwall-normal" tabindex="-1">controls.virtualWall.normal <a class="header-anchor" href="#controls-virtualwall-normal" aria-label="Permalink to "controls.virtualWall.normal""></a></h4><p>虚拟墙普通模式样式配置。</p><h5 id="controls-virtualwall-normal-isdashed" tabindex="-1">controls.virtualWall.normal.isDashed <a class="header-anchor" href="#controls-virtualwall-normal-isdashed" aria-label="Permalink to "controls.virtualWall.normal.isDashed""></a></h5><ul><li><strong>类型</strong>: <code>boolean</code></li><li><strong>默认值</strong>: <code>false</code></li></ul><p>普通模式下是否使用虚线。</p><h5 id="controls-virtualwall-normal-dasharray" tabindex="-1">controls.virtualWall.normal.dashArray <a class="header-anchor" href="#controls-virtualwall-normal-dasharray" aria-label="Permalink to "controls.virtualWall.normal.dashArray""></a></h5><ul><li><strong>类型</strong>: <code>[number, number]</code></li><li><strong>默认值</strong>: <code>[0, 0]</code></li></ul><p>普通模式虚线样式。</p><h3 id="controls-spot" tabindex="-1">controls.spot <a class="header-anchor" href="#controls-spot" aria-label="Permalink to "controls.spot""></a></h3><p>定点清扫配置。</p><h4 id="controls-spot-iconsrc" tabindex="-1">controls.spot.iconSrc <a class="header-anchor" href="#controls-spot-iconsrc" aria-label="Permalink to "controls.spot.iconSrc""></a></h4><ul><li><strong>类型</strong>: <code>string</code></li><li><strong>默认值</strong>: <code>内置资源</code></li></ul><p>定点清扫图标资源路径</p><h4 id="controls-spot-iconsize" tabindex="-1">controls.spot.iconSize <a class="header-anchor" href="#controls-spot-iconsize" aria-label="Permalink to "controls.spot.iconSize""></a></h4><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>8</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>定点清扫图标大小</p><h4 id="controls-spot-iconsizefixed" tabindex="-1">controls.spot.iconSizeFixed <a class="header-anchor" href="#controls-spot-iconsizefixed" aria-label="Permalink to "controls.spot.iconSizeFixed""></a></h4><ul><li><strong>类型</strong>: <code>boolean</code></li><li><strong>默认值</strong>: <code>false</code></li></ul><p>定点清扫图标尺寸是否固定(不跟随地图缩放)</p><h4 id="controls-spot-size" tabindex="-1">controls.spot.size <a class="header-anchor" href="#controls-spot-size" aria-label="Permalink to "controls.spot.size""></a></h4><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>1</code></li><li><strong>单位</strong>: <code>米</code></li></ul><p>定点清扫区域尺寸</p><h4 id="controls-spot-strokecolor" tabindex="-1">controls.spot.strokeColor <a class="header-anchor" href="#controls-spot-strokecolor" aria-label="Permalink to "controls.spot.strokeColor""></a></h4><ul><li><strong>类型</strong>: <code>ColorSource</code></li><li><strong>默认值</strong>: <code>'#5d68fe'</code></li></ul><p>定点清扫描边颜色</p><h4 id="controls-spot-strokewidth" tabindex="-1">controls.spot.strokeWidth <a class="header-anchor" href="#controls-spot-strokewidth" aria-label="Permalink to "controls.spot.strokeWidth""></a></h4><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>2</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>定点清扫描边宽度</p><h4 id="controls-spot-fillcolor" tabindex="-1">controls.spot.fillColor <a class="header-anchor" href="#controls-spot-fillcolor" aria-label="Permalink to "controls.spot.fillColor""></a></h4><ul><li><strong>类型</strong>: <code>ColorSource</code></li><li><strong>默认值</strong>: <code>'rgba(93, 104, 254, 0.1)'</code></li></ul><p>定点清扫填充颜色</p><h4 id="controls-spot-showtext" tabindex="-1">controls.spot.showText <a class="header-anchor" href="#controls-spot-showtext" aria-label="Permalink to "controls.spot.showText""></a></h4><ul><li><strong>类型</strong>: <code>boolean</code></li><li><strong>默认值</strong>: <code>true</code></li></ul><p>是否显示定点清扫文本(米数)</p><h4 id="controls-spot-textcolor" tabindex="-1">controls.spot.textColor <a class="header-anchor" href="#controls-spot-textcolor" aria-label="Permalink to "controls.spot.textColor""></a></h4><ul><li><strong>类型</strong>: <code>ColorSource</code></li><li><strong>默认值</strong>: <code>'#5d68fe'</code></li></ul><p>定点清扫文本颜色</p><h4 id="controls-spot-textposition" tabindex="-1">controls.spot.textPosition <a class="header-anchor" href="#controls-spot-textposition" aria-label="Permalink to "controls.spot.textPosition""></a></h4><ul><li><strong>类型</strong>: <code>'top' | 'right' | 'bottom' | 'left'</code></li><li><strong>默认值</strong>: <code>'bottom'</code></li></ul><p>定点清扫文本位置</p><h4 id="controls-spot-textoffset" tabindex="-1">controls.spot.textOffset <a class="header-anchor" href="#controls-spot-textoffset" aria-label="Permalink to "controls.spot.textOffset""></a></h4><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>8</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>定点清扫文本偏移</p><h4 id="controls-spot-editing" tabindex="-1">controls.spot.editing <a class="header-anchor" href="#controls-spot-editing" aria-label="Permalink to "controls.spot.editing""></a></h4><p>定点清扫编辑模式样式配置。</p><h5 id="controls-spot-editing-isdashed" tabindex="-1">controls.spot.editing.isDashed <a class="header-anchor" href="#controls-spot-editing-isdashed" aria-label="Permalink to "controls.spot.editing.isDashed""></a></h5><ul><li><strong>类型</strong>: <code>boolean</code></li><li><strong>默认值</strong>: <code>false</code></li></ul><p>是否使用虚线边框。</p><h5 id="controls-spot-editing-dasharray" tabindex="-1">controls.spot.editing.dashArray <a class="header-anchor" href="#controls-spot-editing-dasharray" aria-label="Permalink to "controls.spot.editing.dashArray""></a></h5><ul><li><strong>类型</strong>: <code>[number, number]</code></li><li><strong>默认值</strong>: <code>[0, 0]</code></li></ul><p>虚线边框的间距配置。</p><h5 id="controls-spot-editing-showicon" tabindex="-1">controls.spot.editing.showIcon <a class="header-anchor" href="#controls-spot-editing-showicon" aria-label="Permalink to "controls.spot.editing.showIcon""></a></h5><ul><li><strong>类型</strong>: <code>boolean</code></li><li><strong>默认值</strong>: <code>true</code></li></ul><p>编辑模式下是否显示中心图标。</p><h5 id="controls-spot-editing-showframe" tabindex="-1">controls.spot.editing.showFrame <a class="header-anchor" href="#controls-spot-editing-showframe" aria-label="Permalink to "controls.spot.editing.showFrame""></a></h5><ul><li><strong>类型</strong>: <code>boolean</code></li><li><strong>默认值</strong>: <code>true</code></li></ul><p>编辑模式下是否显示框体(填充和边框)。</p><h4 id="controls-spot-normal" tabindex="-1">controls.spot.normal <a class="header-anchor" href="#controls-spot-normal" aria-label="Permalink to "controls.spot.normal""></a></h4><p>定点清扫普通模式样式配置。</p><h5 id="controls-spot-normal-isdashed" tabindex="-1">controls.spot.normal.isDashed <a class="header-anchor" href="#controls-spot-normal-isdashed" aria-label="Permalink to "controls.spot.normal.isDashed""></a></h5><ul><li><strong>类型</strong>: <code>boolean</code></li><li><strong>默认值</strong>: <code>false</code></li></ul><p>是否使用虚线边框。</p><h5 id="controls-spot-normal-dasharray" tabindex="-1">controls.spot.normal.dashArray <a class="header-anchor" href="#controls-spot-normal-dasharray" aria-label="Permalink to "controls.spot.normal.dashArray""></a></h5><ul><li><strong>类型</strong>: <code>[number, number]</code></li><li><strong>默认值</strong>: <code>[0, 0]</code></li></ul><p>虚线边框的间距配置。</p><h5 id="controls-spot-normal-showicon" tabindex="-1">controls.spot.normal.showIcon <a class="header-anchor" href="#controls-spot-normal-showicon" aria-label="Permalink to "controls.spot.normal.showIcon""></a></h5><ul><li><strong>类型</strong>: <code>boolean</code></li><li><strong>默认值</strong>: <code>false</code></li></ul><p>普通模式下是否显示中心图标。</p><h5 id="controls-spot-normal-showframe" tabindex="-1">controls.spot.normal.showFrame <a class="header-anchor" href="#controls-spot-normal-showframe" aria-label="Permalink to "controls.spot.normal.showFrame""></a></h5><ul><li><strong>类型</strong>: <code>boolean</code></li><li><strong>默认值</strong>: <code>true</code></li></ul><p>普通模式下是否显示框体(填充和边框)。</p><h3 id="controls-waypoint" tabindex="-1">controls.wayPoint <a class="header-anchor" href="#controls-waypoint" aria-label="Permalink to "controls.wayPoint""></a></h3><p>途径点配置。</p><h4 id="controls-waypoint-showorder" tabindex="-1">controls.wayPoint.showOrder <a class="header-anchor" href="#controls-waypoint-showorder" aria-label="Permalink to "controls.wayPoint.showOrder""></a></h4><ul><li><strong>类型</strong>: <code>boolean</code></li><li><strong>默认值</strong>: <code>true</code></li></ul><p>是否显示途径点序号。</p><h4 id="controls-waypoint-normal" tabindex="-1">controls.wayPoint.normal <a class="header-anchor" href="#controls-waypoint-normal" aria-label="Permalink to "controls.wayPoint.normal""></a></h4><p>途径点普通模式样式配置。</p><h5 id="controls-waypoint-normal-iconsrc" tabindex="-1">controls.wayPoint.normal.iconSrc <a class="header-anchor" href="#controls-waypoint-normal-iconsrc" aria-label="Permalink to "controls.wayPoint.normal.iconSrc""></a></h5><ul><li><strong>类型</strong>: <code>string</code></li><li><strong>默认值</strong>: <code>内置资源</code></li></ul><p>普通模式下途径点图标资源路径。</p><h5 id="controls-waypoint-normal-iconsize" tabindex="-1">controls.wayPoint.normal.iconSize <a class="header-anchor" href="#controls-waypoint-normal-iconsize" aria-label="Permalink to "controls.wayPoint.normal.iconSize""></a></h5><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>32</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>普通模式下途径点图标大小(固定屏幕像素)。</p><h5 id="controls-waypoint-normal-ordertext" tabindex="-1">controls.wayPoint.normal.orderText <a class="header-anchor" href="#controls-waypoint-normal-ordertext" aria-label="Permalink to "controls.wayPoint.normal.orderText""></a></h5><p>普通模式下序号文本样式配置。</p><h6 id="controls-waypoint-normal-ordertext-fontsize" tabindex="-1">controls.wayPoint.normal.orderText.fontSize <a class="header-anchor" href="#controls-waypoint-normal-ordertext-fontsize" aria-label="Permalink to "controls.wayPoint.normal.orderText.fontSize""></a></h6><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>10</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>序号文本字体大小。</p><h6 id="controls-waypoint-normal-ordertext-fontfamily" tabindex="-1">controls.wayPoint.normal.orderText.fontFamily <a class="header-anchor" href="#controls-waypoint-normal-ordertext-fontfamily" aria-label="Permalink to "controls.wayPoint.normal.orderText.fontFamily""></a></h6><ul><li><strong>类型</strong>: <code>string</code></li><li><strong>默认值</strong>: <code>'system-ui, -apple-system, sans-serif'</code></li></ul><p>序号文本字体。</p><h6 id="controls-waypoint-normal-ordertext-fontweight" tabindex="-1">controls.wayPoint.normal.orderText.fontWeight <a class="header-anchor" href="#controls-waypoint-normal-ordertext-fontweight" aria-label="Permalink to "controls.wayPoint.normal.orderText.fontWeight""></a></h6><ul><li><strong>类型</strong>: <code>TextStyleFontWeight</code></li><li><strong>默认值</strong>: <code>'600'</code></li></ul><p>序号文本字体粗细。</p><h6 id="controls-waypoint-normal-ordertext-color" tabindex="-1">controls.wayPoint.normal.orderText.color <a class="header-anchor" href="#controls-waypoint-normal-ordertext-color" aria-label="Permalink to "controls.wayPoint.normal.orderText.color""></a></h6><ul><li><strong>类型</strong>: <code>ColorSource</code></li><li><strong>默认值</strong>: <code>'#8a8a8a'</code></li></ul><p>序号文本颜色。</p><h5 id="controls-waypoint-normal-ordercontainer" tabindex="-1">controls.wayPoint.normal.orderContainer <a class="header-anchor" href="#controls-waypoint-normal-ordercontainer" aria-label="Permalink to "controls.wayPoint.normal.orderContainer""></a></h5><p>普通模式下序号容器样式配置。</p><h6 id="controls-waypoint-normal-ordercontainer-size" tabindex="-1">controls.wayPoint.normal.orderContainer.size <a class="header-anchor" href="#controls-waypoint-normal-ordercontainer-size" aria-label="Permalink to "controls.wayPoint.normal.orderContainer.size""></a></h6><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>12</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>序号容器大小(圆形直径)。</p><h6 id="controls-waypoint-normal-ordercontainer-backgroundcolor" tabindex="-1">controls.wayPoint.normal.orderContainer.backgroundColor <a class="header-anchor" href="#controls-waypoint-normal-ordercontainer-backgroundcolor" aria-label="Permalink to "controls.wayPoint.normal.orderContainer.backgroundColor""></a></h6><ul><li><strong>类型</strong>: <code>ColorSource</code></li><li><strong>默认值</strong>: <code>'#ffffff'</code></li></ul><p>序号容器背景颜色。</p><h6 id="controls-waypoint-normal-ordercontainer-offsety" tabindex="-1">controls.wayPoint.normal.orderContainer.offsetY <a class="header-anchor" href="#controls-waypoint-normal-ordercontainer-offsety" aria-label="Permalink to "controls.wayPoint.normal.orderContainer.offsetY""></a></h6><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>20</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>序号容器垂直偏移量。基准值为图标底部中心。</p><h6 id="controls-waypoint-normal-ordercontainer-offsetx" tabindex="-1">controls.wayPoint.normal.orderContainer.offsetX <a class="header-anchor" href="#controls-waypoint-normal-ordercontainer-offsetx" aria-label="Permalink to "controls.wayPoint.normal.orderContainer.offsetX""></a></h6><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>0</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>序号容器水平偏移量。基准值为图标底部中心。</p><h4 id="controls-waypoint-editing" tabindex="-1">controls.wayPoint.editing <a class="header-anchor" href="#controls-waypoint-editing" aria-label="Permalink to "controls.wayPoint.editing""></a></h4><p>途径点编辑模式样式配置。结构与 <code>normal</code> 相同,但可以设置不同的图标、尺寸和序号样式。</p><h5 id="controls-waypoint-editing-iconsrc" tabindex="-1">controls.wayPoint.editing.iconSrc <a class="header-anchor" href="#controls-waypoint-editing-iconsrc" aria-label="Permalink to "controls.wayPoint.editing.iconSrc""></a></h5><ul><li><strong>类型</strong>: <code>string</code></li><li><strong>默认值</strong>: <code>内置资源</code></li></ul><p>编辑模式下途径点图标资源路径。</p><h5 id="controls-waypoint-editing-iconsize" tabindex="-1">controls.wayPoint.editing.iconSize <a class="header-anchor" href="#controls-waypoint-editing-iconsize" aria-label="Permalink to "controls.wayPoint.editing.iconSize""></a></h5><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>38</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>编辑模式下途径点图标大小。</p><h5 id="controls-waypoint-editing-ordertext" tabindex="-1">controls.wayPoint.editing.orderText <a class="header-anchor" href="#controls-waypoint-editing-ordertext" aria-label="Permalink to "controls.wayPoint.editing.orderText""></a></h5><p>编辑模式下序号文本样式配置。</p><h6 id="controls-waypoint-editing-ordertext-fontsize" tabindex="-1">controls.wayPoint.editing.orderText.fontSize <a class="header-anchor" href="#controls-waypoint-editing-ordertext-fontsize" aria-label="Permalink to "controls.wayPoint.editing.orderText.fontSize""></a></h6><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>14</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>编辑模式序号文本字体大小。</p><h6 id="controls-waypoint-editing-ordertext-fontfamily" tabindex="-1">controls.wayPoint.editing.orderText.fontFamily <a class="header-anchor" href="#controls-waypoint-editing-ordertext-fontfamily" aria-label="Permalink to "controls.wayPoint.editing.orderText.fontFamily""></a></h6><ul><li><strong>类型</strong>: <code>string</code></li><li><strong>默认值</strong>: <code>'system-ui, -apple-system, sans-serif'</code></li></ul><p>编辑模式序号文本字体。</p><h6 id="controls-waypoint-editing-ordertext-fontweight" tabindex="-1">controls.wayPoint.editing.orderText.fontWeight <a class="header-anchor" href="#controls-waypoint-editing-ordertext-fontweight" aria-label="Permalink to "controls.wayPoint.editing.orderText.fontWeight""></a></h6><ul><li><strong>类型</strong>: <code>TextStyleFontWeight</code></li><li><strong>默认值</strong>: <code>'600'</code></li></ul><p>编辑模式序号文本字体粗细。</p><h6 id="controls-waypoint-editing-ordertext-color" tabindex="-1">controls.wayPoint.editing.orderText.color <a class="header-anchor" href="#controls-waypoint-editing-ordertext-color" aria-label="Permalink to "controls.wayPoint.editing.orderText.color""></a></h6><ul><li><strong>类型</strong>: <code>ColorSource</code></li><li><strong>默认值</strong>: <code>'#ff4444'</code></li></ul><p>编辑模式序号文本颜色。</p><h5 id="controls-waypoint-editing-ordercontainer" tabindex="-1">controls.wayPoint.editing.orderContainer <a class="header-anchor" href="#controls-waypoint-editing-ordercontainer" aria-label="Permalink to "controls.wayPoint.editing.orderContainer""></a></h5><p>编辑模式下序号容器样式配置。</p><h6 id="controls-waypoint-editing-ordercontainer-size" tabindex="-1">controls.wayPoint.editing.orderContainer.size <a class="header-anchor" href="#controls-waypoint-editing-ordercontainer-size" aria-label="Permalink to "controls.wayPoint.editing.orderContainer.size""></a></h6><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>16</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>编辑模式序号容器大小(圆形直径)。</p><h6 id="controls-waypoint-editing-ordercontainer-backgroundcolor" tabindex="-1">controls.wayPoint.editing.orderContainer.backgroundColor <a class="header-anchor" href="#controls-waypoint-editing-ordercontainer-backgroundcolor" aria-label="Permalink to "controls.wayPoint.editing.orderContainer.backgroundColor""></a></h6><ul><li><strong>类型</strong>: <code>ColorSource</code></li><li><strong>默认值</strong>: <code>'#ffffff'</code></li></ul><p>编辑模式序号容器背景颜色。</p><h6 id="controls-waypoint-editing-ordercontainer-offsety" tabindex="-1">controls.wayPoint.editing.orderContainer.offsetY <a class="header-anchor" href="#controls-waypoint-editing-ordercontainer-offsety" aria-label="Permalink to "controls.wayPoint.editing.orderContainer.offsetY""></a></h6><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>23</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>编辑模式序号容器垂直偏移量。</p><h6 id="controls-waypoint-editing-ordercontainer-offsetx" tabindex="-1">controls.wayPoint.editing.orderContainer.offsetX <a class="header-anchor" href="#controls-waypoint-editing-ordercontainer-offsetx" aria-label="Permalink to "controls.wayPoint.editing.orderContainer.offsetX""></a></h6><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>0</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>编辑模式序号容器水平偏移量。</p><h2 id="divider" tabindex="-1">divider <a class="header-anchor" href="#divider" aria-label="Permalink to "divider""></a></h2><p>分割线配置,控制房间分割线的样式和行为。</p><h3 id="divider-linecolor" tabindex="-1">divider.lineColor <a class="header-anchor" href="#divider-linecolor" aria-label="Permalink to "divider.lineColor""></a></h3><ul><li><strong>类型</strong>: <code>ColorSource</code></li><li><strong>默认值</strong>: <code>'#ff4444'</code></li></ul><p>分割线颜色。</p><h3 id="divider-dashlinewidth" tabindex="-1">divider.dashLineWidth <a class="header-anchor" href="#divider-dashlinewidth" aria-label="Permalink to "divider.dashLineWidth""></a></h3><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>2</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>分割线宽度。</p><h3 id="divider-dashlinedasharray" tabindex="-1">divider.dashLineDashArray <a class="header-anchor" href="#divider-dashlinedasharray" aria-label="Permalink to "divider.dashLineDashArray""></a></h3><ul><li><strong>类型</strong>: <code>[number, number]</code></li><li><strong>默认值</strong>: <code>[4, 3]</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>分割线样式。</p><h3 id="divider-solidlinewidth" tabindex="-1">divider.solidLineWidth <a class="header-anchor" href="#divider-solidlinewidth" aria-label="Permalink to "divider.solidLineWidth""></a></h3><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>2</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>分割线有效部分宽度。</p><h3 id="divider-endpointsize" tabindex="-1">divider.endPointSize <a class="header-anchor" href="#divider-endpointsize" aria-label="Permalink to "divider.endPointSize""></a></h3><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>12</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>分割线端点大小。</p><h3 id="divider-endpointcolor" tabindex="-1">divider.endPointColor <a class="header-anchor" href="#divider-endpointcolor" aria-label="Permalink to "divider.endPointColor""></a></h3><ul><li><strong>类型</strong>: <code>ColorSource</code></li><li><strong>默认值</strong>: <code>'#ff4444'</code></li></ul><p>分割线端点颜色。</p><h3 id="divider-endpointstrokecolor" tabindex="-1">divider.endPointStrokeColor <a class="header-anchor" href="#divider-endpointstrokecolor" aria-label="Permalink to "divider.endPointStrokeColor""></a></h3><ul><li><strong>类型</strong>: <code>ColorSource</code></li><li><strong>默认值</strong>: <code>'#ffffff'</code></li></ul><p>分割线端点描边颜色。</p><h3 id="divider-endpointstrokewidth" tabindex="-1">divider.endPointStrokeWidth <a class="header-anchor" href="#divider-endpointstrokewidth" aria-label="Permalink to "divider.endPointStrokeWidth""></a></h3><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>2</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>分割线端点描边宽度。</p><h3 id="divider-hitareathickness" tabindex="-1">divider.hitAreaThickness <a class="header-anchor" href="#divider-hitareathickness" aria-label="Permalink to "divider.hitAreaThickness""></a></h3><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>30</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>分割线热区厚度。</p><h3 id="divider-resetdividerwhenoutofroom" tabindex="-1">divider.resetDividerWhenOutOfRoom <a class="header-anchor" href="#divider-resetdividerwhenoutofroom" aria-label="Permalink to "divider.resetDividerWhenOutOfRoom""></a></h3><ul><li><strong>类型</strong>: <code>boolean</code></li><li><strong>默认值</strong>: <code>false</code></li></ul><p>当操作分割线到房间包围盒外时是否重置分割线到初始位置。</p><h3 id="divider-defaultextension" tabindex="-1">divider.defaultExtension <a class="header-anchor" href="#divider-defaultextension" aria-label="Permalink to "divider.defaultExtension""></a></h3><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>20</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>初始分割线端点超出房间包围盒的像素值。</p><h3 id="divider-defaultdirection" tabindex="-1">divider.defaultDirection <a class="header-anchor" href="#divider-defaultdirection" aria-label="Permalink to "divider.defaultDirection""></a></h3><ul><li><strong>类型</strong>: <code>'horizontal' | 'vertical'</code></li><li><strong>默认值</strong>: <code>'horizontal'</code></li></ul><p>初始分割线方向。</p><h2 id="detectedobject" tabindex="-1">detectedObject <a class="header-anchor" href="#detectedobject" aria-label="Permalink to "detectedObject""></a></h2><p>AI检测物体配置。</p><h3 id="detectedobject-height" tabindex="-1">detectedObject.height <a class="header-anchor" href="#detectedobject-height" aria-label="Permalink to "detectedObject.height""></a></h3><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>43</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>检测物体高度。</p><h3 id="detectedobject-width" tabindex="-1">detectedObject.width <a class="header-anchor" href="#detectedobject-width" aria-label="Permalink to "detectedObject.width""></a></h3><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>38</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>检测物体宽度。</p><h3 id="detectedobject-interactive" tabindex="-1">detectedObject.interactive <a class="header-anchor" href="#detectedobject-interactive" aria-label="Permalink to "detectedObject.interactive""></a></h3><ul><li><strong>类型</strong>: <code>boolean</code></li><li><strong>默认值</strong>: <code>false</code></li></ul><p>检测物体是否可交互。</p><h3 id="detectedobject-anchor" tabindex="-1">detectedObject.anchor <a class="header-anchor" href="#detectedobject-anchor" aria-label="Permalink to "detectedObject.anchor""></a></h3><ul><li><strong>类型</strong>: <code>Point</code></li><li><strong>默认值</strong>: <code>{ x: 0.5, y: 0.5 }</code></li></ul><p>检测物体图标的锚点位置,用于控制图标相对于坐标点的对齐方式。</p><p>锚点坐标系说明:</p><ul><li><code>{x: 0, y: 0}</code> 表示左上角</li><li><code>{x: 0.5, y: 0.5}</code> 表示中心点(默认)</li><li><code>{x: 0.5, y: 1}</code> 表示底部中心(适用于气泡形状的图标)</li><li><code>{x: 1, y: 1}</code> 表示右下角</li></ul><p><strong>注意</strong>: 所有 DetectedObject 统一使用此配置中的锚点值,以确保图标规范统一。</p><p><strong>示例</strong>:</p><div class="language-typescript vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">typescript</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">const</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> mapInstance</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> =</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> new</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> MapApplication</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">({</span></span>
|
|
230
|
+
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">})</span></span></code></pre></div><h3 id="controls-forbiddensweepzone" tabindex="-1">controls.forbiddenSweepZone <a class="header-anchor" href="#controls-forbiddensweepzone" aria-label="Permalink to "controls.forbiddenSweepZone""></a></h3><p>禁扫区域配置。</p><h4 id="controls-forbiddensweepzone-minsize" tabindex="-1">controls.forbiddenSweepZone.minSize <a class="header-anchor" href="#controls-forbiddensweepzone-minsize" aria-label="Permalink to "controls.forbiddenSweepZone.minSize""></a></h4><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>1</code></li><li><strong>单位</strong>: <code>米</code></li></ul><p>禁扫区域最小尺寸</p><h4 id="controls-forbiddensweepzone-maxsize" tabindex="-1">controls.forbiddenSweepZone.maxSize <a class="header-anchor" href="#controls-forbiddensweepzone-maxsize" aria-label="Permalink to "controls.forbiddenSweepZone.maxSize""></a></h4><ul><li><strong>类型</strong>: <code>number | undefined</code></li><li><strong>默认值</strong>: <code>undefined</code></li><li><strong>单位</strong>: <code>米</code></li></ul><p>禁扫区域最大尺寸(可选)。缺省、NaN、非正数或 ≤ minSize 时视为不限制,并会在控制台输出一次警告。</p><h4 id="controls-forbiddensweepzone-iconwrapperfillcolor" tabindex="-1">controls.forbiddenSweepZone.iconWrapperFillColor <a class="header-anchor" href="#controls-forbiddensweepzone-iconwrapperfillcolor" aria-label="Permalink to "controls.forbiddenSweepZone.iconWrapperFillColor""></a></h4><ul><li><strong>类型</strong>: <code>ColorSource</code></li><li><strong>默认值</strong>: <code>'#ff4444'</code></li></ul><p>图标容器填充颜色</p><h4 id="controls-forbiddensweepzone-strokecolor" tabindex="-1">controls.forbiddenSweepZone.strokeColor <a class="header-anchor" href="#controls-forbiddensweepzone-strokecolor" aria-label="Permalink to "controls.forbiddenSweepZone.strokeColor""></a></h4><ul><li><strong>类型</strong>: <code>ColorSource</code></li><li><strong>默认值</strong>: <code>'#ff4444'</code></li></ul><p>禁扫区域描边颜色</p><h4 id="controls-forbiddensweepzone-strokewidth" tabindex="-1">controls.forbiddenSweepZone.strokeWidth <a class="header-anchor" href="#controls-forbiddensweepzone-strokewidth" aria-label="Permalink to "controls.forbiddenSweepZone.strokeWidth""></a></h4><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>2</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>禁扫区域描边宽度</p><h4 id="controls-forbiddensweepzone-fillcolor" tabindex="-1">controls.forbiddenSweepZone.fillColor <a class="header-anchor" href="#controls-forbiddensweepzone-fillcolor" aria-label="Permalink to "controls.forbiddenSweepZone.fillColor""></a></h4><ul><li><strong>类型</strong>: <code>ColorSource</code></li><li><strong>默认值</strong>: <code>'rgba(255, 68, 68, 0.1)'</code></li></ul><p>禁扫区域填充颜色</p><h4 id="controls-forbiddensweepzone-outlineoffset" tabindex="-1">controls.forbiddenSweepZone.outlineOffset <a class="header-anchor" href="#controls-forbiddensweepzone-outlineoffset" aria-label="Permalink to "controls.forbiddenSweepZone.outlineOffset""></a></h4><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>16</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>禁扫区域编辑轮廓偏移</p><h4 id="controls-forbiddensweepzone-outlinestrokecolor" tabindex="-1">controls.forbiddenSweepZone.outlineStrokeColor <a class="header-anchor" href="#controls-forbiddensweepzone-outlinestrokecolor" aria-label="Permalink to "controls.forbiddenSweepZone.outlineStrokeColor""></a></h4><ul><li><strong>类型</strong>: <code>ColorSource</code></li><li><strong>默认值</strong>: <code>'#ff4444'</code></li></ul><p>禁扫区域编辑轮廓描边颜色</p><h4 id="controls-forbiddensweepzone-outlinestrokewidth" tabindex="-1">controls.forbiddenSweepZone.outlineStrokeWidth <a class="header-anchor" href="#controls-forbiddensweepzone-outlinestrokewidth" aria-label="Permalink to "controls.forbiddenSweepZone.outlineStrokeWidth""></a></h4><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>2</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>禁扫区域编辑轮廓描边宽度</p><h4 id="controls-forbiddensweepzone-outlinedashed" tabindex="-1">controls.forbiddenSweepZone.outlineDashed <a class="header-anchor" href="#controls-forbiddensweepzone-outlinedashed" aria-label="Permalink to "controls.forbiddenSweepZone.outlineDashed""></a></h4><ul><li><strong>类型</strong>: <code>boolean</code></li><li><strong>默认值</strong>: <code>true</code></li></ul><p>禁扫区域编辑轮廓是否为虚线</p><h4 id="controls-forbiddensweepzone-outlinedasharray" tabindex="-1">controls.forbiddenSweepZone.outlineDashArray <a class="header-anchor" href="#controls-forbiddensweepzone-outlinedasharray" aria-label="Permalink to "controls.forbiddenSweepZone.outlineDashArray""></a></h4><ul><li><strong>类型</strong>: <code>[number, number]</code></li><li><strong>默认值</strong>: <code>[4, 3]</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>禁扫区域编辑轮廓虚线样式</p><h4 id="controls-forbiddensweepzone-outlinefillcolor" tabindex="-1">controls.forbiddenSweepZone.outlineFillColor <a class="header-anchor" href="#controls-forbiddensweepzone-outlinefillcolor" aria-label="Permalink to "controls.forbiddenSweepZone.outlineFillColor""></a></h4><ul><li><strong>类型</strong>: <code>ColorSource</code></li><li><strong>默认值</strong>: <code>'rgba(255, 68, 68, 0.05)'</code></li></ul><p>禁扫区域编辑轮廓填充颜色</p><h4 id="controls-forbiddensweepzone-showrotatebutton" tabindex="-1">controls.forbiddenSweepZone.showRotateButton <a class="header-anchor" href="#controls-forbiddensweepzone-showrotatebutton" aria-label="Permalink to "controls.forbiddenSweepZone.showRotateButton""></a></h4><ul><li><strong>类型</strong>: <code>boolean</code></li><li><strong>默认值</strong>: <code>true</code></li></ul><p>是否显示旋转按钮</p><h4 id="controls-forbiddensweepzone-textcolor" tabindex="-1">controls.forbiddenSweepZone.textColor <a class="header-anchor" href="#controls-forbiddensweepzone-textcolor" aria-label="Permalink to "controls.forbiddenSweepZone.textColor""></a></h4><ul><li><strong>类型</strong>: <code>ColorSource</code></li><li><strong>默认值</strong>: <code>'#ff4444'</code></li></ul><p>禁扫区域尺寸标签文本颜色</p><h4 id="controls-forbiddensweepzone-textposition" tabindex="-1">controls.forbiddenSweepZone.textPosition <a class="header-anchor" href="#controls-forbiddensweepzone-textposition" aria-label="Permalink to "controls.forbiddenSweepZone.textPosition""></a></h4><ul><li><strong>类型</strong>: <code>'top' | 'right' | 'bottom' | 'left'</code></li><li><strong>默认值</strong>: <code>'bottom'</code></li></ul><p>禁扫区域尺寸标签文本位置</p><h4 id="controls-forbiddensweepzone-textoffset" tabindex="-1">controls.forbiddenSweepZone.textOffset <a class="header-anchor" href="#controls-forbiddensweepzone-textoffset" aria-label="Permalink to "controls.forbiddenSweepZone.textOffset""></a></h4><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>8</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>禁扫区域尺寸标签文本偏移</p><h4 id="controls-forbiddensweepzone-editing" tabindex="-1">controls.forbiddenSweepZone.editing <a class="header-anchor" href="#controls-forbiddensweepzone-editing" aria-label="Permalink to "controls.forbiddenSweepZone.editing""></a></h4><p>区域框编辑模式样式配置。</p><h5 id="controls-forbiddensweepzone-editing-isdashed" tabindex="-1">controls.forbiddenSweepZone.editing.isDashed <a class="header-anchor" href="#controls-forbiddensweepzone-editing-isdashed" aria-label="Permalink to "controls.forbiddenSweepZone.editing.isDashed""></a></h5><ul><li><strong>类型</strong>: <code>boolean</code></li><li><strong>默认值</strong>: <code>false</code></li></ul><p>编辑模式下禁扫区域框是否显示为虚线</p><h5 id="controls-forbiddensweepzone-editing-dasharray" tabindex="-1">controls.forbiddenSweepZone.editing.dashArray <a class="header-anchor" href="#controls-forbiddensweepzone-editing-dasharray" aria-label="Permalink to "controls.forbiddenSweepZone.editing.dashArray""></a></h5><ul><li><strong>类型</strong>: <code>[number, number]</code></li><li><strong>默认值</strong>: <code>[0, 0]</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>编辑模式下禁扫区域框虚线样式</p><h4 id="controls-forbiddensweepzone-normal" tabindex="-1">controls.forbiddenSweepZone.normal <a class="header-anchor" href="#controls-forbiddensweepzone-normal" aria-label="Permalink to "controls.forbiddenSweepZone.normal""></a></h4><p>区域框普通模式样式配置。</p><h5 id="controls-forbiddensweepzone-normal-isdashed" tabindex="-1">controls.forbiddenSweepZone.normal.isDashed <a class="header-anchor" href="#controls-forbiddensweepzone-normal-isdashed" aria-label="Permalink to "controls.forbiddenSweepZone.normal.isDashed""></a></h5><ul><li><strong>类型</strong>: <code>boolean</code></li><li><strong>默认值</strong>: <code>false</code></li></ul><p>普通模式下禁扫区域框是否显示为虚线</p><h5 id="controls-forbiddensweepzone-normal-dasharray" tabindex="-1">controls.forbiddenSweepZone.normal.dashArray <a class="header-anchor" href="#controls-forbiddensweepzone-normal-dasharray" aria-label="Permalink to "controls.forbiddenSweepZone.normal.dashArray""></a></h5><ul><li><strong>类型</strong>: <code>[number, number]</code></li><li><strong>默认值</strong>: <code>[0, 0]</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>普通模式下禁扫区域框虚线样式</p><h3 id="controls-forbiddenmopzone" tabindex="-1">controls.forbiddenMopZone <a class="header-anchor" href="#controls-forbiddenmopzone" aria-label="Permalink to "controls.forbiddenMopZone""></a></h3><p>禁拖区域配置。</p><h4 id="controls-forbiddenmopzone-minsize" tabindex="-1">controls.forbiddenMopZone.minSize <a class="header-anchor" href="#controls-forbiddenmopzone-minsize" aria-label="Permalink to "controls.forbiddenMopZone.minSize""></a></h4><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>1</code></li><li><strong>单位</strong>: <code>米</code></li></ul><p>禁拖区域最小尺寸</p><h4 id="controls-forbiddenmopzone-maxsize" tabindex="-1">controls.forbiddenMopZone.maxSize <a class="header-anchor" href="#controls-forbiddenmopzone-maxsize" aria-label="Permalink to "controls.forbiddenMopZone.maxSize""></a></h4><ul><li><strong>类型</strong>: <code>number | undefined</code></li><li><strong>默认值</strong>: <code>undefined</code></li><li><strong>单位</strong>: <code>米</code></li></ul><p>禁拖区域最大尺寸(可选)。缺省、NaN、非正数或 ≤ minSize 时视为不限制,并会在控制台输出一次警告。</p><h4 id="controls-forbiddenmopzone-iconwrapperfillcolor" tabindex="-1">controls.forbiddenMopZone.iconWrapperFillColor <a class="header-anchor" href="#controls-forbiddenmopzone-iconwrapperfillcolor" aria-label="Permalink to "controls.forbiddenMopZone.iconWrapperFillColor""></a></h4><ul><li><strong>类型</strong>: <code>ColorSource</code></li><li><strong>默认值</strong>: <code>'#fe8a07'</code></li></ul><p>图标容器填充颜色</p><h4 id="controls-forbiddenmopzone-strokecolor" tabindex="-1">controls.forbiddenMopZone.strokeColor <a class="header-anchor" href="#controls-forbiddenmopzone-strokecolor" aria-label="Permalink to "controls.forbiddenMopZone.strokeColor""></a></h4><ul><li><strong>类型</strong>: <code>ColorSource</code></li><li><strong>默认值</strong>: <code>'#fe8a07'</code></li></ul><p>禁拖区域描边颜色</p><h4 id="controls-forbiddenmopzone-strokewidth" tabindex="-1">controls.forbiddenMopZone.strokeWidth <a class="header-anchor" href="#controls-forbiddenmopzone-strokewidth" aria-label="Permalink to "controls.forbiddenMopZone.strokeWidth""></a></h4><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>2</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>禁拖区域描边宽度</p><h4 id="controls-forbiddenmopzone-fillcolor" tabindex="-1">controls.forbiddenMopZone.fillColor <a class="header-anchor" href="#controls-forbiddenmopzone-fillcolor" aria-label="Permalink to "controls.forbiddenMopZone.fillColor""></a></h4><ul><li><strong>类型</strong>: <code>ColorSource</code></li><li><strong>默认值</strong>: <code>'rgba(254, 138, 7, 0.1)'</code></li></ul><p>禁拖区域填充颜色</p><h4 id="controls-forbiddenmopzone-outlineoffset" tabindex="-1">controls.forbiddenMopZone.outlineOffset <a class="header-anchor" href="#controls-forbiddenmopzone-outlineoffset" aria-label="Permalink to "controls.forbiddenMopZone.outlineOffset""></a></h4><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>16</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>禁拖区域轮廓偏移</p><h4 id="controls-forbiddenmopzone-outlinestrokecolor" tabindex="-1">controls.forbiddenMopZone.outlineStrokeColor <a class="header-anchor" href="#controls-forbiddenmopzone-outlinestrokecolor" aria-label="Permalink to "controls.forbiddenMopZone.outlineStrokeColor""></a></h4><ul><li><strong>类型</strong>: <code>ColorSource</code></li><li><strong>默认值</strong>: <code>'#fe8a07'</code></li></ul><p>禁拖区域轮廓描边颜色</p><h4 id="controls-forbiddenmopzone-outlinestrokewidth" tabindex="-1">controls.forbiddenMopZone.outlineStrokeWidth <a class="header-anchor" href="#controls-forbiddenmopzone-outlinestrokewidth" aria-label="Permalink to "controls.forbiddenMopZone.outlineStrokeWidth""></a></h4><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>2</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>禁拖区域轮廓描边宽度</p><h4 id="controls-forbiddenmopzone-outlinedashed" tabindex="-1">controls.forbiddenMopZone.outlineDashed <a class="header-anchor" href="#controls-forbiddenmopzone-outlinedashed" aria-label="Permalink to "controls.forbiddenMopZone.outlineDashed""></a></h4><ul><li><strong>类型</strong>: <code>boolean</code></li><li><strong>默认值</strong>: <code>true</code></li></ul><p>禁拖区域轮廓是否为虚线</p><h4 id="controls-forbiddenmopzone-outlinedasharray" tabindex="-1">controls.forbiddenMopZone.outlineDashArray <a class="header-anchor" href="#controls-forbiddenmopzone-outlinedasharray" aria-label="Permalink to "controls.forbiddenMopZone.outlineDashArray""></a></h4><ul><li><strong>类型</strong>: <code>[number, number]</code></li><li><strong>默认值</strong>: <code>[4, 3]</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>禁拖区域轮廓虚线样式</p><h4 id="controls-forbiddenmopzone-outlinefillcolor" tabindex="-1">controls.forbiddenMopZone.outlineFillColor <a class="header-anchor" href="#controls-forbiddenmopzone-outlinefillcolor" aria-label="Permalink to "controls.forbiddenMopZone.outlineFillColor""></a></h4><ul><li><strong>类型</strong>: <code>ColorSource</code></li><li><strong>默认值</strong>: <code>'rgba(254, 138, 7, 0.05)'</code></li></ul><p>禁拖区域轮廓填充颜色</p><h4 id="controls-forbiddenmopzone-showrotatebutton" tabindex="-1">controls.forbiddenMopZone.showRotateButton <a class="header-anchor" href="#controls-forbiddenmopzone-showrotatebutton" aria-label="Permalink to "controls.forbiddenMopZone.showRotateButton""></a></h4><ul><li><strong>类型</strong>: <code>boolean</code></li><li><strong>默认值</strong>: <code>true</code></li></ul><p>是否显示旋转按钮</p><h4 id="controls-forbiddenmopzone-textcolor" tabindex="-1">controls.forbiddenMopZone.textColor <a class="header-anchor" href="#controls-forbiddenmopzone-textcolor" aria-label="Permalink to "controls.forbiddenMopZone.textColor""></a></h4><ul><li><strong>类型</strong>: <code>ColorSource</code></li><li><strong>默认值</strong>: <code>'#fe8a07'</code></li></ul><p>禁拖区域文本颜色</p><h4 id="controls-forbiddenmopzone-textposition" tabindex="-1">controls.forbiddenMopZone.textPosition <a class="header-anchor" href="#controls-forbiddenmopzone-textposition" aria-label="Permalink to "controls.forbiddenMopZone.textPosition""></a></h4><ul><li><strong>类型</strong>: <code>'top' | 'right' | 'bottom' | 'left'</code></li><li><strong>默认值</strong>: <code>'bottom'</code></li></ul><p>禁拖区域文本位置</p><h4 id="controls-forbiddenmopzone-textoffset" tabindex="-1">controls.forbiddenMopZone.textOffset <a class="header-anchor" href="#controls-forbiddenmopzone-textoffset" aria-label="Permalink to "controls.forbiddenMopZone.textOffset""></a></h4><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>8</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>禁拖区域文本偏移</p><h4 id="controls-forbiddenmopzone-editing" tabindex="-1">controls.forbiddenMopZone.editing <a class="header-anchor" href="#controls-forbiddenmopzone-editing" aria-label="Permalink to "controls.forbiddenMopZone.editing""></a></h4><p>区域框编辑模式样式配置。</p><h5 id="controls-forbiddenmopzone-editing-isdashed" tabindex="-1">controls.forbiddenMopZone.editing.isDashed <a class="header-anchor" href="#controls-forbiddenmopzone-editing-isdashed" aria-label="Permalink to "controls.forbiddenMopZone.editing.isDashed""></a></h5><ul><li><strong>类型</strong>: <code>boolean</code></li><li><strong>默认值</strong>: <code>false</code></li></ul><p>编辑模式下禁拖区域框是否显示为虚线</p><h5 id="controls-forbiddenmopzone-editing-dasharray" tabindex="-1">controls.forbiddenMopZone.editing.dashArray <a class="header-anchor" href="#controls-forbiddenmopzone-editing-dasharray" aria-label="Permalink to "controls.forbiddenMopZone.editing.dashArray""></a></h5><ul><li><strong>类型</strong>: <code>[number, number]</code></li><li><strong>默认值</strong>: <code>[0, 0]</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>编辑模式下禁拖区域框虚线样式</p><h4 id="controls-forbiddenmopzone-normal" tabindex="-1">controls.forbiddenMopZone.normal <a class="header-anchor" href="#controls-forbiddenmopzone-normal" aria-label="Permalink to "controls.forbiddenMopZone.normal""></a></h4><p>区域框普通模式样式配置。</p><h5 id="controls-forbiddenmopzone-normal-isdashed" tabindex="-1">controls.forbiddenMopZone.normal.isDashed <a class="header-anchor" href="#controls-forbiddenmopzone-normal-isdashed" aria-label="Permalink to "controls.forbiddenMopZone.normal.isDashed""></a></h5><ul><li><strong>类型</strong>: <code>boolean</code></li><li><strong>默认值</strong>: <code>false</code></li></ul><p>普通模式下禁拖区域框是否显示为虚线</p><h5 id="controls-forbiddenmopzone-normal-dasharray" tabindex="-1">controls.forbiddenMopZone.normal.dashArray <a class="header-anchor" href="#controls-forbiddenmopzone-normal-dasharray" aria-label="Permalink to "controls.forbiddenMopZone.normal.dashArray""></a></h5><ul><li><strong>类型</strong>: <code>[number, number]</code></li><li><strong>默认值</strong>: <code>[0, 0]</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>普通模式下禁拖区域框虚线样式</p><h3 id="controls-carpet" tabindex="-1">controls.carpet <a class="header-anchor" href="#controls-carpet" aria-label="Permalink to "controls.carpet""></a></h3><p>自定义地毯编辑配置。</p><h4 id="controls-carpet-minsize" tabindex="-1">controls.carpet.minSize <a class="header-anchor" href="#controls-carpet-minsize" aria-label="Permalink to "controls.carpet.minSize""></a></h4><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>1</code></li><li><strong>单位</strong>: <code>米</code></li></ul><p>自定义地毯最小尺寸。</p><h4 id="controls-carpet-maxsize" tabindex="-1">controls.carpet.maxSize <a class="header-anchor" href="#controls-carpet-maxsize" aria-label="Permalink to "controls.carpet.maxSize""></a></h4><ul><li><strong>类型</strong>: <code>number | undefined</code></li><li><strong>默认值</strong>: <code>undefined</code></li><li><strong>单位</strong>: <code>米</code></li></ul><p>地毯最大尺寸(可选)。缺省、NaN、非正数或 ≤ minSize 时视为不限制,并会在控制台输出一次警告。</p><h4 id="controls-carpet-iconwrapperfillcolor" tabindex="-1">controls.carpet.iconWrapperFillColor <a class="header-anchor" href="#controls-carpet-iconwrapperfillcolor" aria-label="Permalink to "controls.carpet.iconWrapperFillColor""></a></h4><ul><li><strong>类型</strong>: <code>ColorSource</code></li><li><strong>默认值</strong>: <code>'#5d68fe'</code></li></ul><p>图标容器填充颜色。</p><h4 id="controls-carpet-fillcolor" tabindex="-1">controls.carpet.fillColor <a class="header-anchor" href="#controls-carpet-fillcolor" aria-label="Permalink to "controls.carpet.fillColor""></a></h4><ul><li><strong>类型</strong>: <code>ColorSource</code></li><li><strong>默认值</strong>: <code>'rgba(93, 104, 254, 0.1)'</code></li></ul><p>地毯填充颜色。</p><h4 id="controls-carpet-outlineoffset" tabindex="-1">controls.carpet.outlineOffset <a class="header-anchor" href="#controls-carpet-outlineoffset" aria-label="Permalink to "controls.carpet.outlineOffset""></a></h4><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>30</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>编辑轮廓偏移。</p><h4 id="controls-carpet-outlinestrokecolor" tabindex="-1">controls.carpet.outlineStrokeColor <a class="header-anchor" href="#controls-carpet-outlinestrokecolor" aria-label="Permalink to "controls.carpet.outlineStrokeColor""></a></h4><ul><li><strong>类型</strong>: <code>ColorSource</code></li><li><strong>默认值</strong>: <code>'rgba(0, 0, 0, 0.7)'</code></li></ul><p>编辑轮廓描边颜色。</p><h4 id="controls-carpet-outlinestrokewidth" tabindex="-1">controls.carpet.outlineStrokeWidth <a class="header-anchor" href="#controls-carpet-outlinestrokewidth" aria-label="Permalink to "controls.carpet.outlineStrokeWidth""></a></h4><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>2</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>编辑轮廓描边宽度。</p><h4 id="controls-carpet-outlinedashed" tabindex="-1">controls.carpet.outlineDashed <a class="header-anchor" href="#controls-carpet-outlinedashed" aria-label="Permalink to "controls.carpet.outlineDashed""></a></h4><ul><li><strong>类型</strong>: <code>boolean</code></li><li><strong>默认值</strong>: <code>true</code></li></ul><p>编辑轮廓是否虚线。</p><h4 id="controls-carpet-outlinedasharray" tabindex="-1">controls.carpet.outlineDashArray <a class="header-anchor" href="#controls-carpet-outlinedasharray" aria-label="Permalink to "controls.carpet.outlineDashArray""></a></h4><ul><li><strong>类型</strong>: <code>[number, number]</code></li><li><strong>默认值</strong>: <code>[4, 3]</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>编辑轮廓虚线样式。</p><h4 id="controls-carpet-outlinefillcolor" tabindex="-1">controls.carpet.outlineFillColor <a class="header-anchor" href="#controls-carpet-outlinefillcolor" aria-label="Permalink to "controls.carpet.outlineFillColor""></a></h4><ul><li><strong>类型</strong>: <code>ColorSource</code></li><li><strong>默认值</strong>: <code>'rgba(93, 104, 254, 0.05)'</code></li></ul><p>编辑轮廓填充颜色。</p><h4 id="controls-carpet-showrotatebutton" tabindex="-1">controls.carpet.showRotateButton <a class="header-anchor" href="#controls-carpet-showrotatebutton" aria-label="Permalink to "controls.carpet.showRotateButton""></a></h4><ul><li><strong>类型</strong>: <code>boolean</code></li><li><strong>默认值</strong>: <code>true</code></li></ul><p>是否显示旋转按钮。</p><h4 id="controls-carpet-textcolor" tabindex="-1">controls.carpet.textColor <a class="header-anchor" href="#controls-carpet-textcolor" aria-label="Permalink to "controls.carpet.textColor""></a></h4><ul><li><strong>类型</strong>: <code>ColorSource</code></li><li><strong>默认值</strong>: <code>'#5d68fe'</code></li></ul><p>尺寸文本颜色。</p><h4 id="controls-carpet-textposition" tabindex="-1">controls.carpet.textPosition <a class="header-anchor" href="#controls-carpet-textposition" aria-label="Permalink to "controls.carpet.textPosition""></a></h4><ul><li><strong>类型</strong>: <code>'top' | 'right' | 'bottom' | 'left'</code></li><li><strong>默认值</strong>: <code>'bottom'</code></li></ul><p>尺寸文本位置。</p><h4 id="controls-carpet-textoffset" tabindex="-1">controls.carpet.textOffset <a class="header-anchor" href="#controls-carpet-textoffset" aria-label="Permalink to "controls.carpet.textOffset""></a></h4><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>20</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>尺寸文本偏移。</p><h4 id="controls-carpet-editing" tabindex="-1">controls.carpet.editing <a class="header-anchor" href="#controls-carpet-editing" aria-label="Permalink to "controls.carpet.editing""></a></h4><h5 id="controls-carpet-editing-isdashed" tabindex="-1">controls.carpet.editing.isDashed <a class="header-anchor" href="#controls-carpet-editing-isdashed" aria-label="Permalink to "controls.carpet.editing.isDashed""></a></h5><ul><li><strong>类型</strong>: <code>boolean</code></li><li><strong>默认值</strong>: <code>true</code></li></ul><p>编辑模式是否虚线。</p><h5 id="controls-carpet-editing-dasharray" tabindex="-1">controls.carpet.editing.dashArray <a class="header-anchor" href="#controls-carpet-editing-dasharray" aria-label="Permalink to "controls.carpet.editing.dashArray""></a></h5><ul><li><strong>类型</strong>: <code>[number, number]</code></li><li><strong>默认值</strong>: <code>[4, 3]</code></li></ul><p>编辑模式虚线样式。</p><h4 id="controls-carpet-normal" tabindex="-1">controls.carpet.normal <a class="header-anchor" href="#controls-carpet-normal" aria-label="Permalink to "controls.carpet.normal""></a></h4><h5 id="controls-carpet-normal-isdashed" tabindex="-1">controls.carpet.normal.isDashed <a class="header-anchor" href="#controls-carpet-normal-isdashed" aria-label="Permalink to "controls.carpet.normal.isDashed""></a></h5><ul><li><strong>类型</strong>: <code>boolean</code></li><li><strong>默认值</strong>: <code>false</code></li></ul><p>普通模式是否虚线。</p><h5 id="controls-carpet-normal-dasharray" tabindex="-1">controls.carpet.normal.dashArray <a class="header-anchor" href="#controls-carpet-normal-dasharray" aria-label="Permalink to "controls.carpet.normal.dashArray""></a></h5><ul><li><strong>类型</strong>: <code>[number, number]</code></li><li><strong>默认值</strong>: <code>[0, 0]</code></li></ul><p>普通模式虚线样式。</p><h3 id="cleanzone" tabindex="-1">cleanZone <a class="header-anchor" href="#cleanzone" aria-label="Permalink to "cleanZone""></a></h3><p>清扫区域配置。</p><h4 id="controls-cleanzone-minsize" tabindex="-1">controls.cleanZone.minSize <a class="header-anchor" href="#controls-cleanzone-minsize" aria-label="Permalink to "controls.cleanZone.minSize""></a></h4><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>1</code></li><li><strong>单位</strong>: <code>米</code></li></ul><p>清扫区域最小尺寸</p><h4 id="controls-cleanzone-maxsize" tabindex="-1">controls.cleanZone.maxSize <a class="header-anchor" href="#controls-cleanzone-maxsize" aria-label="Permalink to "controls.cleanZone.maxSize""></a></h4><ul><li><strong>类型</strong>: <code>number | undefined</code></li><li><strong>默认值</strong>: <code>undefined</code></li><li><strong>单位</strong>: <code>米</code></li></ul><p>清扫区域最大尺寸(可选)。缺省、NaN、非正数或 ≤ minSize 时视为不限制,并会在控制台输出一次警告。</p><h4 id="controls-cleanzone-iconwrapperfillcolor" tabindex="-1">controls.cleanZone.iconWrapperFillColor <a class="header-anchor" href="#controls-cleanzone-iconwrapperfillcolor" aria-label="Permalink to "controls.cleanZone.iconWrapperFillColor""></a></h4><ul><li><strong>类型</strong>: <code>ColorSource</code></li><li><strong>默认值</strong>: <code>'#5d68fe'</code></li></ul><p>清扫区域图标容器填充颜色</p><h4 id="controls-cleanzone-strokecolor" tabindex="-1">controls.cleanZone.strokeColor <a class="header-anchor" href="#controls-cleanzone-strokecolor" aria-label="Permalink to "controls.cleanZone.strokeColor""></a></h4><ul><li><strong>类型</strong>: <code>ColorSource</code></li><li><strong>默认值</strong>: <code>'#5d68fe'</code></li></ul><p>清扫区域描边颜色</p><h4 id="controls-cleanzone-strokewidth" tabindex="-1">controls.cleanZone.strokeWidth <a class="header-anchor" href="#controls-cleanzone-strokewidth" aria-label="Permalink to "controls.cleanZone.strokeWidth""></a></h4><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>2</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>清扫区域描边宽度</p><h4 id="controls-cleanzone-fillcolor" tabindex="-1">controls.cleanZone.fillColor <a class="header-anchor" href="#controls-cleanzone-fillcolor" aria-label="Permalink to "controls.cleanZone.fillColor""></a></h4><ul><li><strong>类型</strong>: <code>ColorSource</code></li><li><strong>默认值</strong>: <code>'rgba(93, 104, 254, 0.1)'</code></li></ul><p>清扫区域填充颜色</p><h4 id="controls-cleanzone-outlineoffset" tabindex="-1">controls.cleanZone.outlineOffset <a class="header-anchor" href="#controls-cleanzone-outlineoffset" aria-label="Permalink to "controls.cleanZone.outlineOffset""></a></h4><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>16</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>清扫区域轮廓偏移</p><h4 id="controls-cleanzone-outlinestrokecolor" tabindex="-1">controls.cleanZone.outlineStrokeColor <a class="header-anchor" href="#controls-cleanzone-outlinestrokecolor" aria-label="Permalink to "controls.cleanZone.outlineStrokeColor""></a></h4><ul><li><strong>类型</strong>: <code>ColorSource</code></li><li><strong>默认值</strong>: <code>'#5d68fe'</code></li></ul><p>清扫区域轮廓描边颜色</p><h4 id="controls-cleanzone-outlinestrokewidth" tabindex="-1">controls.cleanZone.outlineStrokeWidth <a class="header-anchor" href="#controls-cleanzone-outlinestrokewidth" aria-label="Permalink to "controls.cleanZone.outlineStrokeWidth""></a></h4><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>2</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>清扫区域轮廓描边宽度</p><h4 id="controls-cleanzone-outlinedashed" tabindex="-1">controls.cleanZone.outlineDashed <a class="header-anchor" href="#controls-cleanzone-outlinedashed" aria-label="Permalink to "controls.cleanZone.outlineDashed""></a></h4><ul><li><strong>类型</strong>: <code>boolean</code></li><li><strong>默认值</strong>: <code>true</code></li></ul><p>清扫区域轮廓是否为虚线</p><h4 id="controls-cleanzone-outlinedasharray" tabindex="-1">controls.cleanZone.outlineDashArray <a class="header-anchor" href="#controls-cleanzone-outlinedasharray" aria-label="Permalink to "controls.cleanZone.outlineDashArray""></a></h4><ul><li><strong>类型</strong>: <code>[number, number]</code></li><li><strong>默认值</strong>: <code>[4, 3]</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>清扫区域轮廓虚线样式</p><h4 id="controls-cleanzone-outlinefillcolor" tabindex="-1">controls.cleanZone.outlineFillColor <a class="header-anchor" href="#controls-cleanzone-outlinefillcolor" aria-label="Permalink to "controls.cleanZone.outlineFillColor""></a></h4><ul><li><strong>类型</strong>: <code>ColorSource</code></li><li><strong>默认值</strong>: <code>'rgba(93, 104, 254, 0.05)'</code></li></ul><p>清扫区域轮廓填充颜色</p><h4 id="controls-cleanzone-showrotatebutton" tabindex="-1">controls.cleanZone.showRotateButton <a class="header-anchor" href="#controls-cleanzone-showrotatebutton" aria-label="Permalink to "controls.cleanZone.showRotateButton""></a></h4><ul><li><strong>类型</strong>: <code>boolean</code></li><li><strong>默认值</strong>: <code>true</code></li></ul><p>是否显示旋转按钮</p><h4 id="controls-cleanzone-textcolor" tabindex="-1">controls.cleanZone.textColor <a class="header-anchor" href="#controls-cleanzone-textcolor" aria-label="Permalink to "controls.cleanZone.textColor""></a></h4><ul><li><strong>类型</strong>: <code>ColorSource</code></li><li><strong>默认值</strong>: <code>'#5d68fe'</code></li></ul><p>清扫区域文本颜色</p><h4 id="controls-cleanzone-textposition" tabindex="-1">controls.cleanZone.textPosition <a class="header-anchor" href="#controls-cleanzone-textposition" aria-label="Permalink to "controls.cleanZone.textPosition""></a></h4><ul><li><strong>类型</strong>: <code>'top' | 'right' | 'bottom' | 'left'</code></li><li><strong>默认值</strong>: <code>'bottom'</code></li></ul><p>清扫区域文本位置</p><h4 id="controls-cleanzone-textoffset" tabindex="-1">controls.cleanZone.textOffset <a class="header-anchor" href="#controls-cleanzone-textoffset" aria-label="Permalink to "controls.cleanZone.textOffset""></a></h4><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>8</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>清扫区域文本偏移</p><h4 id="controls-cleanzone-editing" tabindex="-1">controls.cleanZone.editing <a class="header-anchor" href="#controls-cleanzone-editing" aria-label="Permalink to "controls.cleanZone.editing""></a></h4><p>区域框编辑模式样式配置。</p><h5 id="controls-cleanzone-editing-isdashed" tabindex="-1">controls.cleanZone.editing.isDashed <a class="header-anchor" href="#controls-cleanzone-editing-isdashed" aria-label="Permalink to "controls.cleanZone.editing.isDashed""></a></h5><ul><li><strong>类型</strong>: <code>boolean</code></li><li><strong>默认值</strong>: <code>false</code></li></ul><p>编辑模式下清扫区域框是否显示为虚线</p><h5 id="controls-cleanzone-editing-dasharray" tabindex="-1">controls.cleanZone.editing.dashArray <a class="header-anchor" href="#controls-cleanzone-editing-dasharray" aria-label="Permalink to "controls.cleanZone.editing.dashArray""></a></h5><ul><li><strong>类型</strong>: <code>[number, number]</code></li><li><strong>默认值</strong>: <code>[0, 0]</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>编辑模式下清扫区域框虚线样式</p><h4 id="controls-cleanzone-normal" tabindex="-1">controls.cleanZone.normal <a class="header-anchor" href="#controls-cleanzone-normal" aria-label="Permalink to "controls.cleanZone.normal""></a></h4><p>区域框普通模式样式配置。</p><h5 id="controls-cleanzone-normal-isdashed" tabindex="-1">controls.cleanZone.normal.isDashed <a class="header-anchor" href="#controls-cleanzone-normal-isdashed" aria-label="Permalink to "controls.cleanZone.normal.isDashed""></a></h5><ul><li><strong>类型</strong>: <code>boolean</code></li><li><strong>默认值</strong>: <code>false</code></li></ul><p>普通模式下清扫区域框是否显示为虚线</p><h5 id="controls-cleanzone-normal-dasharray" tabindex="-1">controls.cleanZone.normal.dashArray <a class="header-anchor" href="#controls-cleanzone-normal-dasharray" aria-label="Permalink to "controls.cleanZone.normal.dashArray""></a></h5><ul><li><strong>类型</strong>: <code>[number, number]</code></li><li><strong>默认值</strong>: <code>[0, 0]</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>普通模式下清扫区域框虚线样式</p><h3 id="controls-virtualwall" tabindex="-1">controls.virtualWall <a class="header-anchor" href="#controls-virtualwall" aria-label="Permalink to "controls.virtualWall""></a></h3><p>虚拟墙配置。</p><h4 id="controls-virtualwall-iconwrapperfillcolor" tabindex="-1">controls.virtualWall.iconWrapperFillColor <a class="header-anchor" href="#controls-virtualwall-iconwrapperfillcolor" aria-label="Permalink to "controls.virtualWall.iconWrapperFillColor""></a></h4><ul><li><strong>类型</strong>: <code>ColorSource</code></li><li><strong>默认值</strong>: <code>'#ff4444'</code></li></ul><p>虚拟墙图标容器填充颜色</p><h4 id="controls-virtualwall-linewidth" tabindex="-1">controls.virtualWall.lineWidth <a class="header-anchor" href="#controls-virtualwall-linewidth" aria-label="Permalink to "controls.virtualWall.lineWidth""></a></h4><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>2</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>虚拟墙线条宽度</p><h4 id="controls-virtualwall-linecolor" tabindex="-1">controls.virtualWall.lineColor <a class="header-anchor" href="#controls-virtualwall-linecolor" aria-label="Permalink to "controls.virtualWall.lineColor""></a></h4><ul><li><strong>类型</strong>: <code>ColorSource</code></li><li><strong>默认值</strong>: <code>'#ff4444'</code></li></ul><p>虚拟墙线条颜色</p><h4 id="controls-virtualwall-hitareathickness" tabindex="-1">controls.virtualWall.hitAreaThickness <a class="header-anchor" href="#controls-virtualwall-hitareathickness" aria-label="Permalink to "controls.virtualWall.hitAreaThickness""></a></h4><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>30</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>虚拟墙热区厚度</p><h4 id="controls-virtualwall-outlineoffset" tabindex="-1">controls.virtualWall.outlineOffset <a class="header-anchor" href="#controls-virtualwall-outlineoffset" aria-label="Permalink to "controls.virtualWall.outlineOffset""></a></h4><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>16</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>虚拟墙轮廓偏移</p><h4 id="controls-virtualwall-outlinestrokecolor" tabindex="-1">controls.virtualWall.outlineStrokeColor <a class="header-anchor" href="#controls-virtualwall-outlinestrokecolor" aria-label="Permalink to "controls.virtualWall.outlineStrokeColor""></a></h4><ul><li><strong>类型</strong>: <code>ColorSource</code></li><li><strong>默认值</strong>: <code>'#ff4444'</code></li></ul><p>虚拟墙轮廓描边颜色</p><h4 id="controls-virtualwall-outlinestrokewidth" tabindex="-1">controls.virtualWall.outlineStrokeWidth <a class="header-anchor" href="#controls-virtualwall-outlinestrokewidth" aria-label="Permalink to "controls.virtualWall.outlineStrokeWidth""></a></h4><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>2</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>虚拟墙轮廓描边宽度</p><h4 id="controls-virtualwall-outlinedashed" tabindex="-1">controls.virtualWall.outlineDashed <a class="header-anchor" href="#controls-virtualwall-outlinedashed" aria-label="Permalink to "controls.virtualWall.outlineDashed""></a></h4><ul><li><strong>类型</strong>: <code>boolean</code></li><li><strong>默认值</strong>: <code>true</code></li></ul><p>虚拟墙轮廓是否为虚线</p><h4 id="controls-virtualwall-outlinedasharray" tabindex="-1">controls.virtualWall.outlineDashArray <a class="header-anchor" href="#controls-virtualwall-outlinedasharray" aria-label="Permalink to "controls.virtualWall.outlineDashArray""></a></h4><ul><li><strong>类型</strong>: <code>[number, number]</code></li><li><strong>默认值</strong>: <code>[4, 3]</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>虚拟墙轮廓虚线样式</p><h4 id="controls-virtualwall-outlinefillcolor" tabindex="-1">controls.virtualWall.outlineFillColor <a class="header-anchor" href="#controls-virtualwall-outlinefillcolor" aria-label="Permalink to "controls.virtualWall.outlineFillColor""></a></h4><ul><li><strong>类型</strong>: <code>ColorSource</code></li><li><strong>默认值</strong>: <code>'rgba(255, 68, 68, 0.05)'</code></li></ul><p>虚拟墙轮廓填充颜色</p><h4 id="controls-virtualwall-minwidth" tabindex="-1">controls.virtualWall.minWidth <a class="header-anchor" href="#controls-virtualwall-minwidth" aria-label="Permalink to "controls.virtualWall.minWidth""></a></h4><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>1</code></li><li><strong>单位</strong>: <code>米</code></li></ul><p>虚拟墙最小宽度</p><h4 id="controls-virtualwall-maxwidth" tabindex="-1">controls.virtualWall.maxWidth <a class="header-anchor" href="#controls-virtualwall-maxwidth" aria-label="Permalink to "controls.virtualWall.maxWidth""></a></h4><ul><li><strong>类型</strong>: <code>number | undefined</code></li><li><strong>默认值</strong>: <code>undefined</code></li><li><strong>单位</strong>: <code>米</code></li></ul><p>虚拟墙最大宽度(可选)。缺省、NaN、非正数或 ≤ minWidth 时视为不限制,并会在控制台输出一次警告。</p><h4 id="controls-virtualwall-textcolor" tabindex="-1">controls.virtualWall.textColor <a class="header-anchor" href="#controls-virtualwall-textcolor" aria-label="Permalink to "controls.virtualWall.textColor""></a></h4><ul><li><strong>类型</strong>: <code>ColorSource</code></li><li><strong>默认值</strong>: <code>'#ff4444'</code></li></ul><p>虚拟墙文本颜色</p><h4 id="controls-virtualwall-textoffset" tabindex="-1">controls.virtualWall.textOffset <a class="header-anchor" href="#controls-virtualwall-textoffset" aria-label="Permalink to "controls.virtualWall.textOffset""></a></h4><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>8</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>虚拟墙文本偏移</p><h4 id="controls-virtualwall-editing" tabindex="-1">controls.virtualWall.editing <a class="header-anchor" href="#controls-virtualwall-editing" aria-label="Permalink to "controls.virtualWall.editing""></a></h4><p>虚拟墙编辑模式样式配置。</p><h5 id="controls-virtualwall-editing-isdashed" tabindex="-1">controls.virtualWall.editing.isDashed <a class="header-anchor" href="#controls-virtualwall-editing-isdashed" aria-label="Permalink to "controls.virtualWall.editing.isDashed""></a></h5><ul><li><strong>类型</strong>: <code>boolean</code></li><li><strong>默认值</strong>: <code>false</code></li></ul><p>编辑模式下是否使用虚线。</p><h5 id="controls-virtualwall-editing-dasharray" tabindex="-1">controls.virtualWall.editing.dashArray <a class="header-anchor" href="#controls-virtualwall-editing-dasharray" aria-label="Permalink to "controls.virtualWall.editing.dashArray""></a></h5><ul><li><strong>类型</strong>: <code>[number, number]</code></li><li><strong>默认值</strong>: <code>[0, 0]</code></li></ul><p>编辑模式虚线样式。</p><h4 id="controls-virtualwall-normal" tabindex="-1">controls.virtualWall.normal <a class="header-anchor" href="#controls-virtualwall-normal" aria-label="Permalink to "controls.virtualWall.normal""></a></h4><p>虚拟墙普通模式样式配置。</p><h5 id="controls-virtualwall-normal-isdashed" tabindex="-1">controls.virtualWall.normal.isDashed <a class="header-anchor" href="#controls-virtualwall-normal-isdashed" aria-label="Permalink to "controls.virtualWall.normal.isDashed""></a></h5><ul><li><strong>类型</strong>: <code>boolean</code></li><li><strong>默认值</strong>: <code>false</code></li></ul><p>普通模式下是否使用虚线。</p><h5 id="controls-virtualwall-normal-dasharray" tabindex="-1">controls.virtualWall.normal.dashArray <a class="header-anchor" href="#controls-virtualwall-normal-dasharray" aria-label="Permalink to "controls.virtualWall.normal.dashArray""></a></h5><ul><li><strong>类型</strong>: <code>[number, number]</code></li><li><strong>默认值</strong>: <code>[0, 0]</code></li></ul><p>普通模式虚线样式。</p><h3 id="controls-spot" tabindex="-1">controls.spot <a class="header-anchor" href="#controls-spot" aria-label="Permalink to "controls.spot""></a></h3><p>定点清扫配置。</p><h4 id="controls-spot-iconsrc" tabindex="-1">controls.spot.iconSrc <a class="header-anchor" href="#controls-spot-iconsrc" aria-label="Permalink to "controls.spot.iconSrc""></a></h4><ul><li><strong>类型</strong>: <code>string</code></li><li><strong>默认值</strong>: <code>内置资源</code></li></ul><p>定点清扫图标资源路径</p><h4 id="controls-spot-iconsize" tabindex="-1">controls.spot.iconSize <a class="header-anchor" href="#controls-spot-iconsize" aria-label="Permalink to "controls.spot.iconSize""></a></h4><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>8</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>定点清扫图标大小</p><h4 id="controls-spot-iconsizefixed" tabindex="-1">controls.spot.iconSizeFixed <a class="header-anchor" href="#controls-spot-iconsizefixed" aria-label="Permalink to "controls.spot.iconSizeFixed""></a></h4><ul><li><strong>类型</strong>: <code>boolean</code></li><li><strong>默认值</strong>: <code>false</code></li></ul><p>定点清扫图标尺寸是否固定(不跟随地图缩放)</p><h4 id="controls-spot-size" tabindex="-1">controls.spot.size <a class="header-anchor" href="#controls-spot-size" aria-label="Permalink to "controls.spot.size""></a></h4><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>1</code></li><li><strong>单位</strong>: <code>米</code></li></ul><p>定点清扫区域尺寸</p><h4 id="controls-spot-strokecolor" tabindex="-1">controls.spot.strokeColor <a class="header-anchor" href="#controls-spot-strokecolor" aria-label="Permalink to "controls.spot.strokeColor""></a></h4><ul><li><strong>类型</strong>: <code>ColorSource</code></li><li><strong>默认值</strong>: <code>'#5d68fe'</code></li></ul><p>定点清扫描边颜色</p><h4 id="controls-spot-strokewidth" tabindex="-1">controls.spot.strokeWidth <a class="header-anchor" href="#controls-spot-strokewidth" aria-label="Permalink to "controls.spot.strokeWidth""></a></h4><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>2</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>定点清扫描边宽度</p><h4 id="controls-spot-fillcolor" tabindex="-1">controls.spot.fillColor <a class="header-anchor" href="#controls-spot-fillcolor" aria-label="Permalink to "controls.spot.fillColor""></a></h4><ul><li><strong>类型</strong>: <code>ColorSource</code></li><li><strong>默认值</strong>: <code>'rgba(93, 104, 254, 0.1)'</code></li></ul><p>定点清扫填充颜色</p><h4 id="controls-spot-showtext" tabindex="-1">controls.spot.showText <a class="header-anchor" href="#controls-spot-showtext" aria-label="Permalink to "controls.spot.showText""></a></h4><ul><li><strong>类型</strong>: <code>boolean</code></li><li><strong>默认值</strong>: <code>true</code></li></ul><p>是否显示定点清扫文本(米数)</p><h4 id="controls-spot-textcolor" tabindex="-1">controls.spot.textColor <a class="header-anchor" href="#controls-spot-textcolor" aria-label="Permalink to "controls.spot.textColor""></a></h4><ul><li><strong>类型</strong>: <code>ColorSource</code></li><li><strong>默认值</strong>: <code>'#5d68fe'</code></li></ul><p>定点清扫文本颜色</p><h4 id="controls-spot-textposition" tabindex="-1">controls.spot.textPosition <a class="header-anchor" href="#controls-spot-textposition" aria-label="Permalink to "controls.spot.textPosition""></a></h4><ul><li><strong>类型</strong>: <code>'top' | 'right' | 'bottom' | 'left'</code></li><li><strong>默认值</strong>: <code>'bottom'</code></li></ul><p>定点清扫文本位置</p><h4 id="controls-spot-textoffset" tabindex="-1">controls.spot.textOffset <a class="header-anchor" href="#controls-spot-textoffset" aria-label="Permalink to "controls.spot.textOffset""></a></h4><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>8</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>定点清扫文本偏移</p><h4 id="controls-spot-editing" tabindex="-1">controls.spot.editing <a class="header-anchor" href="#controls-spot-editing" aria-label="Permalink to "controls.spot.editing""></a></h4><p>定点清扫编辑模式样式配置。</p><h5 id="controls-spot-editing-isdashed" tabindex="-1">controls.spot.editing.isDashed <a class="header-anchor" href="#controls-spot-editing-isdashed" aria-label="Permalink to "controls.spot.editing.isDashed""></a></h5><ul><li><strong>类型</strong>: <code>boolean</code></li><li><strong>默认值</strong>: <code>false</code></li></ul><p>是否使用虚线边框。</p><h5 id="controls-spot-editing-dasharray" tabindex="-1">controls.spot.editing.dashArray <a class="header-anchor" href="#controls-spot-editing-dasharray" aria-label="Permalink to "controls.spot.editing.dashArray""></a></h5><ul><li><strong>类型</strong>: <code>[number, number]</code></li><li><strong>默认值</strong>: <code>[0, 0]</code></li></ul><p>虚线边框的间距配置。</p><h5 id="controls-spot-editing-showicon" tabindex="-1">controls.spot.editing.showIcon <a class="header-anchor" href="#controls-spot-editing-showicon" aria-label="Permalink to "controls.spot.editing.showIcon""></a></h5><ul><li><strong>类型</strong>: <code>boolean</code></li><li><strong>默认值</strong>: <code>true</code></li></ul><p>编辑模式下是否显示中心图标。</p><h5 id="controls-spot-editing-showframe" tabindex="-1">controls.spot.editing.showFrame <a class="header-anchor" href="#controls-spot-editing-showframe" aria-label="Permalink to "controls.spot.editing.showFrame""></a></h5><ul><li><strong>类型</strong>: <code>boolean</code></li><li><strong>默认值</strong>: <code>true</code></li></ul><p>编辑模式下是否显示框体(填充和边框)。</p><h4 id="controls-spot-normal" tabindex="-1">controls.spot.normal <a class="header-anchor" href="#controls-spot-normal" aria-label="Permalink to "controls.spot.normal""></a></h4><p>定点清扫普通模式样式配置。</p><h5 id="controls-spot-normal-isdashed" tabindex="-1">controls.spot.normal.isDashed <a class="header-anchor" href="#controls-spot-normal-isdashed" aria-label="Permalink to "controls.spot.normal.isDashed""></a></h5><ul><li><strong>类型</strong>: <code>boolean</code></li><li><strong>默认值</strong>: <code>false</code></li></ul><p>是否使用虚线边框。</p><h5 id="controls-spot-normal-dasharray" tabindex="-1">controls.spot.normal.dashArray <a class="header-anchor" href="#controls-spot-normal-dasharray" aria-label="Permalink to "controls.spot.normal.dashArray""></a></h5><ul><li><strong>类型</strong>: <code>[number, number]</code></li><li><strong>默认值</strong>: <code>[0, 0]</code></li></ul><p>虚线边框的间距配置。</p><h5 id="controls-spot-normal-showicon" tabindex="-1">controls.spot.normal.showIcon <a class="header-anchor" href="#controls-spot-normal-showicon" aria-label="Permalink to "controls.spot.normal.showIcon""></a></h5><ul><li><strong>类型</strong>: <code>boolean</code></li><li><strong>默认值</strong>: <code>false</code></li></ul><p>普通模式下是否显示中心图标。</p><h5 id="controls-spot-normal-showframe" tabindex="-1">controls.spot.normal.showFrame <a class="header-anchor" href="#controls-spot-normal-showframe" aria-label="Permalink to "controls.spot.normal.showFrame""></a></h5><ul><li><strong>类型</strong>: <code>boolean</code></li><li><strong>默认值</strong>: <code>true</code></li></ul><p>普通模式下是否显示框体(填充和边框)。</p><h3 id="controls-waypoint" tabindex="-1">controls.wayPoint <a class="header-anchor" href="#controls-waypoint" aria-label="Permalink to "controls.wayPoint""></a></h3><p>途径点配置。</p><h4 id="controls-waypoint-showorder" tabindex="-1">controls.wayPoint.showOrder <a class="header-anchor" href="#controls-waypoint-showorder" aria-label="Permalink to "controls.wayPoint.showOrder""></a></h4><ul><li><strong>类型</strong>: <code>boolean</code></li><li><strong>默认值</strong>: <code>true</code></li></ul><p>是否显示途径点序号。</p><h4 id="controls-waypoint-normal" tabindex="-1">controls.wayPoint.normal <a class="header-anchor" href="#controls-waypoint-normal" aria-label="Permalink to "controls.wayPoint.normal""></a></h4><p>途径点普通模式样式配置。</p><h5 id="controls-waypoint-normal-iconsrc" tabindex="-1">controls.wayPoint.normal.iconSrc <a class="header-anchor" href="#controls-waypoint-normal-iconsrc" aria-label="Permalink to "controls.wayPoint.normal.iconSrc""></a></h5><ul><li><strong>类型</strong>: <code>string</code></li><li><strong>默认值</strong>: <code>内置资源</code></li></ul><p>普通模式下途径点图标资源路径。</p><h5 id="controls-waypoint-normal-iconsize" tabindex="-1">controls.wayPoint.normal.iconSize <a class="header-anchor" href="#controls-waypoint-normal-iconsize" aria-label="Permalink to "controls.wayPoint.normal.iconSize""></a></h5><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>32</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>普通模式下途径点图标大小(固定屏幕像素)。</p><h5 id="controls-waypoint-normal-ordertext" tabindex="-1">controls.wayPoint.normal.orderText <a class="header-anchor" href="#controls-waypoint-normal-ordertext" aria-label="Permalink to "controls.wayPoint.normal.orderText""></a></h5><p>普通模式下序号文本样式配置。</p><h6 id="controls-waypoint-normal-ordertext-fontsize" tabindex="-1">controls.wayPoint.normal.orderText.fontSize <a class="header-anchor" href="#controls-waypoint-normal-ordertext-fontsize" aria-label="Permalink to "controls.wayPoint.normal.orderText.fontSize""></a></h6><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>10</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>序号文本字体大小。</p><h6 id="controls-waypoint-normal-ordertext-fontfamily" tabindex="-1">controls.wayPoint.normal.orderText.fontFamily <a class="header-anchor" href="#controls-waypoint-normal-ordertext-fontfamily" aria-label="Permalink to "controls.wayPoint.normal.orderText.fontFamily""></a></h6><ul><li><strong>类型</strong>: <code>string</code></li><li><strong>默认值</strong>: <code>'system-ui, -apple-system, sans-serif'</code></li></ul><p>序号文本字体。</p><h6 id="controls-waypoint-normal-ordertext-fontweight" tabindex="-1">controls.wayPoint.normal.orderText.fontWeight <a class="header-anchor" href="#controls-waypoint-normal-ordertext-fontweight" aria-label="Permalink to "controls.wayPoint.normal.orderText.fontWeight""></a></h6><ul><li><strong>类型</strong>: <code>TextStyleFontWeight</code></li><li><strong>默认值</strong>: <code>'600'</code></li></ul><p>序号文本字体粗细。</p><h6 id="controls-waypoint-normal-ordertext-color" tabindex="-1">controls.wayPoint.normal.orderText.color <a class="header-anchor" href="#controls-waypoint-normal-ordertext-color" aria-label="Permalink to "controls.wayPoint.normal.orderText.color""></a></h6><ul><li><strong>类型</strong>: <code>ColorSource</code></li><li><strong>默认值</strong>: <code>'#8a8a8a'</code></li></ul><p>序号文本颜色。</p><h5 id="controls-waypoint-normal-ordercontainer" tabindex="-1">controls.wayPoint.normal.orderContainer <a class="header-anchor" href="#controls-waypoint-normal-ordercontainer" aria-label="Permalink to "controls.wayPoint.normal.orderContainer""></a></h5><p>普通模式下序号容器样式配置。</p><h6 id="controls-waypoint-normal-ordercontainer-size" tabindex="-1">controls.wayPoint.normal.orderContainer.size <a class="header-anchor" href="#controls-waypoint-normal-ordercontainer-size" aria-label="Permalink to "controls.wayPoint.normal.orderContainer.size""></a></h6><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>12</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>序号容器大小(圆形直径)。</p><h6 id="controls-waypoint-normal-ordercontainer-backgroundcolor" tabindex="-1">controls.wayPoint.normal.orderContainer.backgroundColor <a class="header-anchor" href="#controls-waypoint-normal-ordercontainer-backgroundcolor" aria-label="Permalink to "controls.wayPoint.normal.orderContainer.backgroundColor""></a></h6><ul><li><strong>类型</strong>: <code>ColorSource</code></li><li><strong>默认值</strong>: <code>'#ffffff'</code></li></ul><p>序号容器背景颜色。</p><h6 id="controls-waypoint-normal-ordercontainer-offsety" tabindex="-1">controls.wayPoint.normal.orderContainer.offsetY <a class="header-anchor" href="#controls-waypoint-normal-ordercontainer-offsety" aria-label="Permalink to "controls.wayPoint.normal.orderContainer.offsetY""></a></h6><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>20</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>序号容器垂直偏移量。基准值为图标底部中心。</p><h6 id="controls-waypoint-normal-ordercontainer-offsetx" tabindex="-1">controls.wayPoint.normal.orderContainer.offsetX <a class="header-anchor" href="#controls-waypoint-normal-ordercontainer-offsetx" aria-label="Permalink to "controls.wayPoint.normal.orderContainer.offsetX""></a></h6><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>0</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>序号容器水平偏移量。基准值为图标底部中心。</p><h4 id="controls-waypoint-editing" tabindex="-1">controls.wayPoint.editing <a class="header-anchor" href="#controls-waypoint-editing" aria-label="Permalink to "controls.wayPoint.editing""></a></h4><p>途径点编辑模式样式配置。结构与 <code>normal</code> 相同,但可以设置不同的图标、尺寸和序号样式。</p><h5 id="controls-waypoint-editing-iconsrc" tabindex="-1">controls.wayPoint.editing.iconSrc <a class="header-anchor" href="#controls-waypoint-editing-iconsrc" aria-label="Permalink to "controls.wayPoint.editing.iconSrc""></a></h5><ul><li><strong>类型</strong>: <code>string</code></li><li><strong>默认值</strong>: <code>内置资源</code></li></ul><p>编辑模式下途径点图标资源路径。</p><h5 id="controls-waypoint-editing-iconsize" tabindex="-1">controls.wayPoint.editing.iconSize <a class="header-anchor" href="#controls-waypoint-editing-iconsize" aria-label="Permalink to "controls.wayPoint.editing.iconSize""></a></h5><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>38</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>编辑模式下途径点图标大小。</p><h5 id="controls-waypoint-editing-ordertext" tabindex="-1">controls.wayPoint.editing.orderText <a class="header-anchor" href="#controls-waypoint-editing-ordertext" aria-label="Permalink to "controls.wayPoint.editing.orderText""></a></h5><p>编辑模式下序号文本样式配置。</p><h6 id="controls-waypoint-editing-ordertext-fontsize" tabindex="-1">controls.wayPoint.editing.orderText.fontSize <a class="header-anchor" href="#controls-waypoint-editing-ordertext-fontsize" aria-label="Permalink to "controls.wayPoint.editing.orderText.fontSize""></a></h6><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>14</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>编辑模式序号文本字体大小。</p><h6 id="controls-waypoint-editing-ordertext-fontfamily" tabindex="-1">controls.wayPoint.editing.orderText.fontFamily <a class="header-anchor" href="#controls-waypoint-editing-ordertext-fontfamily" aria-label="Permalink to "controls.wayPoint.editing.orderText.fontFamily""></a></h6><ul><li><strong>类型</strong>: <code>string</code></li><li><strong>默认值</strong>: <code>'system-ui, -apple-system, sans-serif'</code></li></ul><p>编辑模式序号文本字体。</p><h6 id="controls-waypoint-editing-ordertext-fontweight" tabindex="-1">controls.wayPoint.editing.orderText.fontWeight <a class="header-anchor" href="#controls-waypoint-editing-ordertext-fontweight" aria-label="Permalink to "controls.wayPoint.editing.orderText.fontWeight""></a></h6><ul><li><strong>类型</strong>: <code>TextStyleFontWeight</code></li><li><strong>默认值</strong>: <code>'600'</code></li></ul><p>编辑模式序号文本字体粗细。</p><h6 id="controls-waypoint-editing-ordertext-color" tabindex="-1">controls.wayPoint.editing.orderText.color <a class="header-anchor" href="#controls-waypoint-editing-ordertext-color" aria-label="Permalink to "controls.wayPoint.editing.orderText.color""></a></h6><ul><li><strong>类型</strong>: <code>ColorSource</code></li><li><strong>默认值</strong>: <code>'#ff4444'</code></li></ul><p>编辑模式序号文本颜色。</p><h5 id="controls-waypoint-editing-ordercontainer" tabindex="-1">controls.wayPoint.editing.orderContainer <a class="header-anchor" href="#controls-waypoint-editing-ordercontainer" aria-label="Permalink to "controls.wayPoint.editing.orderContainer""></a></h5><p>编辑模式下序号容器样式配置。</p><h6 id="controls-waypoint-editing-ordercontainer-size" tabindex="-1">controls.wayPoint.editing.orderContainer.size <a class="header-anchor" href="#controls-waypoint-editing-ordercontainer-size" aria-label="Permalink to "controls.wayPoint.editing.orderContainer.size""></a></h6><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>16</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>编辑模式序号容器大小(圆形直径)。</p><h6 id="controls-waypoint-editing-ordercontainer-backgroundcolor" tabindex="-1">controls.wayPoint.editing.orderContainer.backgroundColor <a class="header-anchor" href="#controls-waypoint-editing-ordercontainer-backgroundcolor" aria-label="Permalink to "controls.wayPoint.editing.orderContainer.backgroundColor""></a></h6><ul><li><strong>类型</strong>: <code>ColorSource</code></li><li><strong>默认值</strong>: <code>'#ffffff'</code></li></ul><p>编辑模式序号容器背景颜色。</p><h6 id="controls-waypoint-editing-ordercontainer-offsety" tabindex="-1">controls.wayPoint.editing.orderContainer.offsetY <a class="header-anchor" href="#controls-waypoint-editing-ordercontainer-offsety" aria-label="Permalink to "controls.wayPoint.editing.orderContainer.offsetY""></a></h6><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>23</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>编辑模式序号容器垂直偏移量。</p><h6 id="controls-waypoint-editing-ordercontainer-offsetx" tabindex="-1">controls.wayPoint.editing.orderContainer.offsetX <a class="header-anchor" href="#controls-waypoint-editing-ordercontainer-offsetx" aria-label="Permalink to "controls.wayPoint.editing.orderContainer.offsetX""></a></h6><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>0</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>编辑模式序号容器水平偏移量。</p><h2 id="customzonetypes" tabindex="-1">customZoneTypes <a class="header-anchor" href="#customzonetypes" aria-label="Permalink to "customZoneTypes""></a></h2><ul><li><strong>类型</strong>: <code>Record<string, Partial<ZoneTypeDefinition>> | undefined</code></li><li><strong>默认值</strong>: <code>undefined</code></li></ul><p>自定义矩形区域类型声明。key 为自定义类型的名称(会作为 <code>customZones</code> prop 的分组 key、<a href="/reference/runtime.html#editingcustomzoneids"><code>runtime.editingCustomZoneIds</code></a> 的分组 key、以及 <a href="/reference/callbacks.html#onclickcustomzone"><code>onClickCustomZone</code></a> 等回调的 <code>type</code> 参数),value 为该类型的样式配置。</p><div class="warning custom-block"><p class="custom-block-title">WARNING</p><ul><li>key <strong>不得</strong>与三种内置区域类型(<code>forbiddenSweepZone</code> / <code>forbiddenMopZone</code> / <code>cleanZone</code>)重名;重名会被 SDK 忽略并打印告警。</li><li>内置区域继续使用 <a href="#controls-forbiddensweepzone"><code>controls.forbiddenSweepZone</code></a> 等独立的配置节点,不在此声明。</li></ul></div><p>每个自定义类型的 value 支持的字段与 <a href="#controls-forbiddensweepzone"><code>controls.forbiddenSweepZone</code></a> 一致:<code>minSize</code> / <code>maxSize</code> / <code>strokeColor</code> / <code>strokeWidth</code> / <code>fillColor</code> / <code>iconWrapperFillColor</code> / <code>outlineOffset</code> / <code>outlineStrokeColor</code> / <code>outlineStrokeWidth</code> / <code>outlineDashed</code> / <code>outlineDashArray</code> / <code>outlineFillColor</code> / <code>showRotateButton</code> / <code>textColor</code> / <code>textPosition</code> / <code>textOffset</code> / <code>editing</code> / <code>normal</code> 等。未显式声明的字段会回退到 SDK 默认值。</p><p><strong>示例</strong>:声明一个"宠物清洁区"类型</p><div class="language-tsx vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">tsx</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"><</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">RobotMap</span></span>
|
|
231
|
+
<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> config</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">=</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">{{</span></span>
|
|
232
|
+
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> customZoneTypes: {</span></span>
|
|
233
|
+
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> petCleanZone: {</span></span>
|
|
234
|
+
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> minSize: </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">1</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
|
|
235
|
+
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> strokeColor: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">'#7c3aed'</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
|
|
236
|
+
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> strokeWidth: </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">2</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
|
|
237
|
+
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> fillColor: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">'rgba(124, 58, 237, 0.15)'</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
|
|
238
|
+
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> outlineStrokeColor: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">'#7c3aed'</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
|
|
239
|
+
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> outlineFillColor: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">'rgba(124, 58, 237, 0.05)'</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
|
|
240
|
+
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> textColor: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">'#7c3aed'</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
|
|
241
|
+
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> iconWrapperFillColor: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">'#7c3aed'</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
|
|
242
|
+
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> },</span></span>
|
|
243
|
+
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> },</span></span>
|
|
244
|
+
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> }}</span></span>
|
|
245
|
+
<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> customZones</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">=</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">{{</span></span>
|
|
246
|
+
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> petCleanZone: [</span></span>
|
|
247
|
+
<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"> /* ZoneParam[] */</span></span>
|
|
248
|
+
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> ],</span></span>
|
|
249
|
+
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> }}</span></span>
|
|
250
|
+
<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> onClickCustomZone</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">=</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">{(</span><span style="--shiki-light:#E36209;--shiki-dark:#FFAB70;">type</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, </span><span style="--shiki-light:#E36209;--shiki-dark:#FFAB70;">zone</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">) </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">=></span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> {</span></span>
|
|
251
|
+
<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"> /* ... */</span></span>
|
|
252
|
+
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> }}</span></span>
|
|
253
|
+
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">/></span></span></code></pre></div><p>更多用法参见 <a href="/guide/advanced-usage.html#自定义区域">进阶使用 · 自定义区域</a>。</p><h2 id="divider" tabindex="-1">divider <a class="header-anchor" href="#divider" aria-label="Permalink to "divider""></a></h2><p>分割线配置,控制房间分割线的样式和行为。</p><h3 id="divider-linecolor" tabindex="-1">divider.lineColor <a class="header-anchor" href="#divider-linecolor" aria-label="Permalink to "divider.lineColor""></a></h3><ul><li><strong>类型</strong>: <code>ColorSource</code></li><li><strong>默认值</strong>: <code>'#ff4444'</code></li></ul><p>分割线颜色。</p><h3 id="divider-dashlinewidth" tabindex="-1">divider.dashLineWidth <a class="header-anchor" href="#divider-dashlinewidth" aria-label="Permalink to "divider.dashLineWidth""></a></h3><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>2</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>分割线宽度。</p><h3 id="divider-dashlinedasharray" tabindex="-1">divider.dashLineDashArray <a class="header-anchor" href="#divider-dashlinedasharray" aria-label="Permalink to "divider.dashLineDashArray""></a></h3><ul><li><strong>类型</strong>: <code>[number, number]</code></li><li><strong>默认值</strong>: <code>[4, 3]</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>分割线样式。</p><h3 id="divider-solidlinewidth" tabindex="-1">divider.solidLineWidth <a class="header-anchor" href="#divider-solidlinewidth" aria-label="Permalink to "divider.solidLineWidth""></a></h3><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>2</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>分割线有效部分宽度。</p><h3 id="divider-endpointsize" tabindex="-1">divider.endPointSize <a class="header-anchor" href="#divider-endpointsize" aria-label="Permalink to "divider.endPointSize""></a></h3><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>12</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>分割线端点大小。</p><h3 id="divider-endpointcolor" tabindex="-1">divider.endPointColor <a class="header-anchor" href="#divider-endpointcolor" aria-label="Permalink to "divider.endPointColor""></a></h3><ul><li><strong>类型</strong>: <code>ColorSource</code></li><li><strong>默认值</strong>: <code>'#ff4444'</code></li></ul><p>分割线端点颜色。</p><h3 id="divider-endpointstrokecolor" tabindex="-1">divider.endPointStrokeColor <a class="header-anchor" href="#divider-endpointstrokecolor" aria-label="Permalink to "divider.endPointStrokeColor""></a></h3><ul><li><strong>类型</strong>: <code>ColorSource</code></li><li><strong>默认值</strong>: <code>'#ffffff'</code></li></ul><p>分割线端点描边颜色。</p><h3 id="divider-endpointstrokewidth" tabindex="-1">divider.endPointStrokeWidth <a class="header-anchor" href="#divider-endpointstrokewidth" aria-label="Permalink to "divider.endPointStrokeWidth""></a></h3><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>2</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>分割线端点描边宽度。</p><h3 id="divider-hitareathickness" tabindex="-1">divider.hitAreaThickness <a class="header-anchor" href="#divider-hitareathickness" aria-label="Permalink to "divider.hitAreaThickness""></a></h3><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>30</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>分割线热区厚度。</p><h3 id="divider-resetdividerwhenoutofroom" tabindex="-1">divider.resetDividerWhenOutOfRoom <a class="header-anchor" href="#divider-resetdividerwhenoutofroom" aria-label="Permalink to "divider.resetDividerWhenOutOfRoom""></a></h3><ul><li><strong>类型</strong>: <code>boolean</code></li><li><strong>默认值</strong>: <code>false</code></li></ul><p>当操作分割线到房间包围盒外时是否重置分割线到初始位置。</p><h3 id="divider-defaultextension" tabindex="-1">divider.defaultExtension <a class="header-anchor" href="#divider-defaultextension" aria-label="Permalink to "divider.defaultExtension""></a></h3><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>20</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>初始分割线端点超出房间包围盒的像素值。</p><h3 id="divider-defaultdirection" tabindex="-1">divider.defaultDirection <a class="header-anchor" href="#divider-defaultdirection" aria-label="Permalink to "divider.defaultDirection""></a></h3><ul><li><strong>类型</strong>: <code>'horizontal' | 'vertical'</code></li><li><strong>默认值</strong>: <code>'horizontal'</code></li></ul><p>初始分割线方向。</p><h2 id="detectedobject" tabindex="-1">detectedObject <a class="header-anchor" href="#detectedobject" aria-label="Permalink to "detectedObject""></a></h2><p>AI检测物体配置。</p><h3 id="detectedobject-height" tabindex="-1">detectedObject.height <a class="header-anchor" href="#detectedobject-height" aria-label="Permalink to "detectedObject.height""></a></h3><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>43</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>检测物体高度。</p><h3 id="detectedobject-width" tabindex="-1">detectedObject.width <a class="header-anchor" href="#detectedobject-width" aria-label="Permalink to "detectedObject.width""></a></h3><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>38</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>检测物体宽度。</p><h3 id="detectedobject-interactive" tabindex="-1">detectedObject.interactive <a class="header-anchor" href="#detectedobject-interactive" aria-label="Permalink to "detectedObject.interactive""></a></h3><ul><li><strong>类型</strong>: <code>boolean</code></li><li><strong>默认值</strong>: <code>false</code></li></ul><p>检测物体是否可交互。</p><h3 id="detectedobject-anchor" tabindex="-1">detectedObject.anchor <a class="header-anchor" href="#detectedobject-anchor" aria-label="Permalink to "detectedObject.anchor""></a></h3><ul><li><strong>类型</strong>: <code>Point</code></li><li><strong>默认值</strong>: <code>{ x: 0.5, y: 0.5 }</code></li></ul><p>检测物体图标的锚点位置,用于控制图标相对于坐标点的对齐方式。</p><p>锚点坐标系说明:</p><ul><li><code>{x: 0, y: 0}</code> 表示左上角</li><li><code>{x: 0.5, y: 0.5}</code> 表示中心点(默认)</li><li><code>{x: 0.5, y: 1}</code> 表示底部中心(适用于气泡形状的图标)</li><li><code>{x: 1, y: 1}</code> 表示右下角</li></ul><p><strong>注意</strong>: 所有 DetectedObject 统一使用此配置中的锚点值,以确保图标规范统一。</p><p><strong>示例</strong>:</p><div class="language-typescript vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">typescript</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">const</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> mapInstance</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> =</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> new</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> MapApplication</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">({</span></span>
|
|
231
254
|
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> config: {</span></span>
|
|
232
255
|
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> detectedObject: {</span></span>
|
|
233
256
|
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> anchor: { x: </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">0.5</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, y: </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">1.0</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> }, </span><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;">// 所有检测物体都使用底部中心作为锚点</span></span>
|
|
234
257
|
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> },</span></span>
|
|
235
258
|
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> },</span></span>
|
|
236
|
-
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">})</span></span></code></pre></div><h2 id="snapshot" tabindex="-1">snapshot <a class="header-anchor" href="#snapshot" aria-label="Permalink to "snapshot""></a></h2><p>截图配置。</p><h3 id="snapshot-format" tabindex="-1">snapshot.format <a class="header-anchor" href="#snapshot-format" aria-label="Permalink to "snapshot.format""></a></h3><ul><li><strong>类型</strong>: <code>'png' | 'jpg' | 'webp'</code></li><li><strong>默认值</strong>: <code>'png'</code></li></ul><p>截图输出格式。</p><h3 id="snapshot-quality" tabindex="-1">snapshot.quality <a class="header-anchor" href="#snapshot-quality" aria-label="Permalink to "snapshot.quality""></a></h3><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>1</code></li></ul><p>截图质量 (0-1)。</p><h3 id="snapshot-antialias" tabindex="-1">snapshot.antialias <a class="header-anchor" href="#snapshot-antialias" aria-label="Permalink to "snapshot.antialias""></a></h3><ul><li><strong>类型</strong>: <code>boolean</code></li><li><strong>默认值</strong>: <code>true</code></li></ul><p>截图是否开启抗锯齿。</p><h3 id="snapshot-resolution" tabindex="-1">snapshot.resolution <a class="header-anchor" href="#snapshot-resolution" aria-label="Permalink to "snapshot.resolution""></a></h3><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>4</code></li></ul><p>截图分辨率倍数。</p></div></div></main><footer class="VPDocFooter" data-v-39a288b8 data-v-e257564d><!--[--><!--]--><div class="edit-info" data-v-e257564d><!----><div class="last-updated" data-v-e257564d><p class="VPLastUpdated" data-v-e257564d data-v-e98dd255>最后更新于: <time datetime="2026-
|
|
237
|
-
<script>window.__VP_HASH_MAP__=JSON.parse("{\"guide_advanced-usage.md\":\"
|
|
259
|
+
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">})</span></span></code></pre></div><h2 id="snapshot" tabindex="-1">snapshot <a class="header-anchor" href="#snapshot" aria-label="Permalink to "snapshot""></a></h2><p>截图配置。</p><h3 id="snapshot-format" tabindex="-1">snapshot.format <a class="header-anchor" href="#snapshot-format" aria-label="Permalink to "snapshot.format""></a></h3><ul><li><strong>类型</strong>: <code>'png' | 'jpg' | 'webp'</code></li><li><strong>默认值</strong>: <code>'png'</code></li></ul><p>截图输出格式。</p><h3 id="snapshot-quality" tabindex="-1">snapshot.quality <a class="header-anchor" href="#snapshot-quality" aria-label="Permalink to "snapshot.quality""></a></h3><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>1</code></li></ul><p>截图质量 (0-1)。</p><h3 id="snapshot-antialias" tabindex="-1">snapshot.antialias <a class="header-anchor" href="#snapshot-antialias" aria-label="Permalink to "snapshot.antialias""></a></h3><ul><li><strong>类型</strong>: <code>boolean</code></li><li><strong>默认值</strong>: <code>true</code></li></ul><p>截图是否开启抗锯齿。</p><h3 id="snapshot-resolution" tabindex="-1">snapshot.resolution <a class="header-anchor" href="#snapshot-resolution" aria-label="Permalink to "snapshot.resolution""></a></h3><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>4</code></li></ul><p>截图分辨率倍数。</p></div></div></main><footer class="VPDocFooter" data-v-39a288b8 data-v-e257564d><!--[--><!--]--><div class="edit-info" data-v-e257564d><!----><div class="last-updated" data-v-e257564d><p class="VPLastUpdated" data-v-e257564d data-v-e98dd255>最后更新于: <time datetime="2026-04-30T07:56:26.000Z" data-v-e98dd255></time></p></div></div><nav class="prev-next" aria-labelledby="doc-footer-aria-label" data-v-e257564d><span class="visually-hidden" id="doc-footer-aria-label" data-v-e257564d>Pager</span><div class="pager" data-v-e257564d><a class="VPLink link pager-link prev" href="/reference/data.html" data-v-e257564d><!--[--><span class="desc" data-v-e257564d>Previous page</span><span class="title" data-v-e257564d>数据</span><!--]--></a></div><div class="pager" data-v-e257564d><a class="VPLink link pager-link next" href="/reference/runtime.html" data-v-e257564d><!--[--><span class="desc" data-v-e257564d>Next page</span><span class="title" data-v-e257564d>运行时</span><!--]--></a></div></nav></footer><!--[--><!--]--></div></div></div><!--[--><!--]--></div></div><!----><!--[--><!--]--></div></div>
|
|
260
|
+
<script>window.__VP_HASH_MAP__=JSON.parse("{\"guide_advanced-usage.md\":\"B0nlUHzZ\",\"guide_concepts.md\":\"CJ87tk-r\",\"guide_getting-started.md\":\"BxrBbc12\",\"guide_mcp.md\":\"CabCiX8Z\",\"index.md\":\"wTsFvv0N\",\"plans_2026-03-04-detected-objects-visibility-design.md\":\"Dqboot5W\",\"plans_2026-03-04-show-detected-objects-implementation-plan.md\":\"CDWwQtWj\",\"plans_2026-03-10-simulator-debug-design.md\":\"BZibn7uw\",\"plans_2026-03-10-simulator-events-console-design.md\":\"BVmEzCbR\",\"plans_2026-03-10-simulator-events-console-implementation-plan.md\":\"S2f1zs9-\",\"plans_2026-03-10-simulator-runtime-controls-design.md\":\"mqeNaYgg\",\"plans_2026-03-10-simulator-runtime-controls-implementation-plan.md\":\"BXG1UWFt\",\"plans_2026-03-10-testing-rollout-next-steps-plan.md\":\"CGR6uZic\",\"plans_2026-03-11-simulator-logger-dump-implementation-plan.md\":\"Ck5BGdoX\",\"reference_callbacks.md\":\"FoJwSjMy\",\"reference_config.md\":\"D3LT2kWa\",\"reference_data.md\":\"B_XpUFrn\",\"reference_methods.md\":\"BvtVJ2dG\",\"reference_runtime.md\":\"BBP2J_yR\",\"reference_types.md\":\"CfnUIfkB\",\"reference_utils.md\":\"Dy6XKVWh\",\"simulator_index.md\":\"CF95Y_c9\"}");window.__VP_SITE_DATA__=JSON.parse("{\"lang\":\"en-US\",\"dir\":\"ltr\",\"title\":\"Tuya Robot Map\",\"description\":\"涂鸦扫地机地图组件\",\"base\":\"/\",\"head\":[],\"router\":{\"prefetchLinks\":true},\"appearance\":true,\"themeConfig\":{\"siteTitle\":\"Tuya Robot Map\",\"outline\":{\"level\":[2,6],\"label\":\"页面导航\"},\"nav\":[{\"text\":\"首页\",\"link\":\"/\"},{\"text\":\"指南\",\"link\":\"/guide/concepts\",\"activeMatch\":\"^/guide/\"},{\"text\":\"参考\",\"link\":\"/reference/data\",\"activeMatch\":\"^/reference/\"},{\"text\":\"模拟调试\",\"link\":\"/simulator/\",\"activeMatch\":\"^/simulator/\"}],\"sidebar\":{\"/guide/\":[{\"text\":\"指南\",\"items\":[{\"text\":\"基本概念\",\"link\":\"/guide/concepts\"},{\"text\":\"快速开始\",\"link\":\"/guide/getting-started\"},{\"text\":\"进阶使用\",\"link\":\"/guide/advanced-usage\"}]}],\"/reference/\":[{\"text\":\"组件Props\",\"items\":[{\"text\":\"数据\",\"link\":\"/reference/data\"},{\"text\":\"配置\",\"link\":\"/reference/config\"},{\"text\":\"运行时\",\"link\":\"/reference/runtime\"},{\"text\":\"地图事件回调\",\"link\":\"/reference/callbacks\"}]},{\"text\":\"方法\",\"items\":[{\"text\":\"地图方法\",\"link\":\"/reference/methods\"},{\"text\":\"工具方法\",\"link\":\"/reference/utils\"}]},{\"text\":\"类型定义\",\"items\":[{\"text\":\"类型定义\",\"link\":\"/reference/types\"}]}],\"/simulator/\":[{\"text\":\"模拟调试\",\"items\":[{\"text\":\"实时模拟调试\",\"link\":\"/simulator/\"}]}]},\"search\":{\"provider\":\"local\"},\"lastUpdated\":{\"text\":\"最后更新于\",\"formatOptions\":{\"dateStyle\":\"short\",\"timeStyle\":\"short\"}}},\"locales\":{},\"scrollOffset\":134,\"cleanUrls\":false}");</script>
|
|
238
261
|
|
|
239
262
|
</body>
|
|
240
263
|
</html>
|