@ray-js/robot-map-sdk 0.0.15-beta.3 → 0.0.15-beta.5
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/index.d.ts +9 -1
- package/dist/index.rjs.js +1 -1
- package/dist-app/assets/{index-BeiPDWUx.js → index-B1nugPi1.js} +1 -1
- package/dist-app/index.html +1 -1
- package/dist-docs/404.html +2 -2
- package/dist-docs/assets/{app.BxnZmRJz.js → app.bnP_bf_l.js} +1 -1
- package/dist-docs/assets/chunks/@localSearchIndexroot.CwXt9v1Y.js +1 -0
- package/dist-docs/assets/chunks/{BitmapFont.CWow1Z4d.js → BitmapFont.5fW5VBJF.js} +1 -1
- package/dist-docs/assets/chunks/{BufferResource.D7mg1YPa.js → BufferResource.Dxdb5weM.js} +1 -1
- package/dist-docs/assets/chunks/{CanvasRenderer.CIhNDvyh.js → CanvasRenderer.CpVNemlG.js} +1 -1
- package/dist-docs/assets/chunks/{RenderTargetSystem.C3jRWjhS.js → RenderTargetSystem.CeBSxmjk.js} +1 -1
- package/dist-docs/assets/chunks/{VPLocalSearchBox.BCocgYNw.js → VPLocalSearchBox.BY5mG4tS.js} +1 -1
- package/dist-docs/assets/chunks/{WebGLRenderer.DGgjkcO6.js → WebGLRenderer.TIV07BXg.js} +1 -1
- package/dist-docs/assets/chunks/{WebGPURenderer.JZilOIh9.js → WebGPURenderer.4ehrKGWk.js} +1 -1
- package/dist-docs/assets/chunks/{browserAll.Bs2t6Fbp.js → browserAll.B5Aa-vuR.js} +1 -1
- package/dist-docs/assets/chunks/{index.BYSGWvBH.js → index.CgkVFHcL.js} +16 -16
- package/dist-docs/assets/chunks/{theme.BluH8Q7i.js → theme.DeJ2cHsN.js} +3 -3
- package/dist-docs/assets/chunks/{webworkerAll.BNr16NOT.js → webworkerAll.S3LCCO8A.js} +1 -1
- package/dist-docs/assets/{guide_advanced-usage.md.BboplJc2.js → guide_advanced-usage.md.Cpp8XDrz.js} +3 -3
- package/dist-docs/assets/{guide_advanced-usage.md.BboplJc2.lean.js → guide_advanced-usage.md.Cpp8XDrz.lean.js} +1 -1
- package/dist-docs/assets/{guide_getting-started.md.DOh8beTe.js → guide_getting-started.md.s2PQDUaI.js} +2 -2
- package/dist-docs/assets/guide_getting-started.md.s2PQDUaI.lean.js +1 -0
- package/dist-docs/assets/{reference_config.md.BW7btOQc.js → reference_config.md.DfWCSVSm.js} +4 -4
- package/dist-docs/assets/reference_config.md.DfWCSVSm.lean.js +1 -0
- package/dist-docs/guide/advanced-usage.html +7 -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 +3 -3
- package/dist-docs/reference/config.html +7 -7
- package/dist-docs/reference/data.html +3 -3
- package/dist-docs/reference/methods.html +3 -3
- package/dist-docs/reference/runtime.html +3 -3
- package/dist-docs/reference/types.html +3 -3
- 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.Dh4oiMq8.js +0 -1
- package/dist-docs/assets/guide_getting-started.md.DOh8beTe.lean.js +0 -1
- package/dist-docs/assets/reference_config.md.BW7btOQc.lean.js +0 -1
package/dist-docs/assets/{reference_config.md.BW7btOQc.js → reference_config.md.DfWCSVSm.js}
RENAMED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import{_ as e,c as i,o as a,aq as t}from"./chunks/framework.CBLqO2Q1.js";const g=JSON.parse('{"title":"配置","description":"","frontmatter":{},"headers":[],"relativePath":"reference/config.md","filePath":"reference/config.md","lastUpdated":
|
|
1
|
+
import{_ as e,c as i,o as a,aq as t}from"./chunks/framework.CBLqO2Q1.js";const g=JSON.parse('{"title":"配置","description":"","frontmatter":{},"headers":[],"relativePath":"reference/config.md","filePath":"reference/config.md","lastUpdated":1778638153000}'),s={name:"reference/config.md"};function l(r,o,n,c,d,h){return a(),i("div",null,[...o[0]||(o[0]=[t(`<h1 id="配置" tabindex="-1">配置 <a class="header-anchor" href="#配置" aria-label="Permalink to "配置""></a></h1><p>了解 RobotMap 的配置选项，用于定制地图的视觉样式、素材资源、交互行为等。</p><div class="tip custom-block"><p class="custom-block-title">响应式配置</p><p>配置是<strong>响应式</strong>的，当你修改传入的 <code>config</code> prop 时，地图会自动更新视觉效果，无需重新初始化。这使得主题切换、颜色调整等功能的实现变得简单直接。</p></div><div class="tip custom-block"><p class="custom-block-title">TIP</p><ul><li>本文档部分配置项的单位与<strong>米</strong>相关，该配置的值会根据地图数据里的分辨率转换为像素单位。</li></ul></div><h2 id="使用示例" tabindex="-1">使用示例 <a class="header-anchor" href="#使用示例" aria-label="Permalink to "使用示例""></a></h2><h3 id="基础配置" tabindex="-1">基础配置 <a class="header-anchor" href="#基础配置" aria-label="Permalink to "基础配置""></a></h3><p>配置通过 <code>config</code> 传递，所有配置项都是可选的，你可以只覆盖需要修改的部分。</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:#D73A49;--shiki-dark:#F97583;">import</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> React </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">from</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> 'react'</span></span>
|
|
2
2
|
<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">import</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> { RobotMap } </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">from</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> '@ray-js/robot-map'</span></span>
|
|
3
3
|
<span class="line"></span>
|
|
4
4
|
<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">function</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> MapPage</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">() {</span></span>
|
|
@@ -166,7 +166,7 @@ import{_ as e,c as i,o as a,aq as t}from"./chunks/framework.CBLqO2Q1.js";const g
|
|
|
166
166
|
<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> repeat</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">false</span><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"> // 是否平铺（暂未实现）</span></span>
|
|
167
167
|
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> }</span></span>
|
|
168
168
|
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> }</span></span>
|
|
169
|
-
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">}</span></span></code></pre></div><p><strong>fit 模式说明：</strong></p><ul><li><code>fill</code>：拉伸填充整个视口</li><li><code>contain</code>：完整显示图片，保持宽高比，可能有留白</li><li><code>cover</code>（默认）：覆盖整个视口，保持宽高比，可能裁剪</li><li><code>none</code>：原始尺寸显示</li></ul><h3 id="global-backgroundalpha" tabindex="-1">global.backgroundAlpha <a class="header-anchor" href="#global-backgroundalpha" aria-label="Permalink to "global.backgroundAlpha""></a></h3><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>1</code></li></ul><p>地图容器背景透明度。</p><div class="warning custom-block"><p class="custom-block-title">注意</p><p>该配置仅对<strong>纯色背景</strong> (<code>backgroundColor</code>) 和<strong>图片背景</strong> (<code>backgroundImage</code>) 生效。</p><p>对于<strong>渐变背景</strong> (<code>backgroundGradient</code>)，请直接在 <code>colorStops</code> 中使用 <code>rgba</code> 颜色值（如 <code>'rgba(255, 255, 255, 0.5)'</code>）来控制透明度。</p></div><h3 id="global-performancemode" tabindex="-1">global.performanceMode <a class="header-anchor" href="#global-performancemode" aria-label="Permalink to "global.performanceMode""></a></h3><ul><li><strong>类型</strong>: <code>boolean</code></li><li><strong>默认值</strong>: <code>false</code></li></ul><p>是否开启高性能模式。开启后，SDK 会优化渲染性能（如强制关闭抗锯齿、共享时钟等），建议在多地图展示等对性能要求较高的场景下开启。</p><h3 id="global-resolution" tabindex="-1">global.resolution <a class="header-anchor" href="#global-resolution" aria-label="Permalink to "global.resolution""></a></h3><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>window.devicePixelRatio</code></li></ul><p>渲染分辨率倍率。通常不需要手动设置，SDK 会自动获取设备的像素密度。在性能极度受限的场景下，可以手动将其设为 <code>1</code> 或 <code>1.5</code> 来降低 GPU 渲染压力。</p><h3 id="global-enablelogger" tabindex="-1">global.enableLogger <a class="header-anchor" href="#global-enablelogger" aria-label="Permalink to "global.enableLogger""></a></h3><ul><li><strong>类型</strong>: <code>boolean</code></li><li><strong>默认值</strong>: <code>import.meta.env.DEV</code></li></ul><p>是否启用日志输出的旧配置项。当设置为 <code>true</code> 时，SDK 会输出内部日志（<code>Logger.log</code>、<code>Logger.warn</code>、<code>Logger.error</code>、<code>Logger.debug</code>、<code>Logger.success</code>）；当设置为 <code>false</code> 时，所有日志都不会输出。</p><div class="tip custom-block"><p class="custom-block-title">TIP</p><p>默认值会跟随构建环境：开发环境通常为 <code>true</code>，生产环境通常为 <code>false</code>。 建议仅在排查问题时开启此选项。</p><p>对于新接入，优先使用 <code>logger.enabled</code>。<code>global.enableLogger</code> 仅作为控制控制台日志的兼容兜底，不再负责 App 日志转发。</p></div><h3 id="global-rendererpreference" tabindex="-1">global.rendererPreference <a class="header-anchor" href="#global-rendererpreference" aria-label="Permalink to "global.rendererPreference""></a></h3><ul><li><strong>类型</strong>: <code>'webgpu' | 'webgl'</code></li><li><strong>默认值</strong>: <code>'webgpu'</code></li></ul><p>渲染器偏好，设置 PIXI.js 优先使用的渲染后端。</p><h2 id="logger" tabindex="-1">logger <a class="header-anchor" href="#logger" aria-label="Permalink to "logger""></a></h2><p><code>logger</code> 配置用于控制 SDK 的控制台日志和可选的宿主日志转发。这一组配置不会强依赖任何业务日志库；只有当宿主层实现了 <code>onLogger</code> 回调时，日志才会被转发到 App 层。</p><h3 id="logger-enabled" tabindex="-1">logger.enabled <a class="header-anchor" href="#logger-enabled" aria-label="Permalink to "logger.enabled""></a></h3><p><code>logger.enabled</code> 控制 SDK 在 webview 控制台中的日志输出。</p><ul><li><strong>类型</strong>: <code>boolean</code></li><li><strong>默认值</strong>: <code>import.meta.env.DEV</code></li></ul><p>当设置为 <code>true</code> 时，SDK 会输出内部日志到控制台；当设置为 <code>false</code> 时，控制台日志关闭。这个字段优先级高于 <code>global.enableLogger</code>。</p><h3 id="logger-hostsinkenabled" tabindex="-1">logger.hostSinkEnabled <a class="header-anchor" href="#logger-hostsinkenabled" aria-label="Permalink to "logger.hostSinkEnabled""></a></h3><p><code>logger.hostSinkEnabled</code> 控制是否尝试把结构化日志转发给宿主层。</p><ul><li><strong>类型</strong>: <code>boolean</code></li><li><strong>默认值</strong>: <code>false</code></li></ul><p>当设置为 <code>true</code> 时，SDK 会在满足 <code>hostLevels</code> 过滤条件后，把日志 payload 转发给宿主层的 <code>onLogger</code> 回调。如果宿主层没有实现 <code>onLogger</code>，SDK 会静默跳过，不会报错。</p><h3 id="logger-hostlevels" tabindex="-1">logger.hostLevels <a class="header-anchor" href="#logger-hostlevels" aria-label="Permalink to "logger.hostLevels""></a></h3><p><code>logger.hostLevels</code> 控制哪些日志级别会被转发到宿主层。</p><ul><li><strong>类型</strong>: <code>Array<'warn' | 'error' | 'info' | 'debug'></code></li><li><strong>默认值</strong>: <code>['warn', 'error']</code></li></ul><p>默认只转发 <code>warn</code> 和 <code>error</code>。如果你需要在诊断阶段同时采集 <code>info</code> 或 <code>debug</code>，可以显式把这些级别加入数组中。</p><h3 id="logger-tag" tabindex="-1">logger.tag <a class="header-anchor" href="#logger-tag" aria-label="Permalink to "logger.tag""></a></h3><p><code>logger.tag</code> 用于标识日志来源，方便宿主层在 App 日志里检索和过滤。</p><ul><li><strong>类型</strong>: <code>string</code></li><li><strong>默认值</strong>: <code>'ray-robot-map-sdk'</code></li></ul><p>业务侧可以直接使用这个字段作为日志前缀，也可以组合自己的 App tag 一起输出。</p><h2 id="interaction" tabindex="-1">interaction <a class="header-anchor" href="#interaction" aria-label="Permalink to "interaction""></a></h2><p>交互配置，控制地图的缩放和手势操作。</p><h3 id="interaction-zoomrange" tabindex="-1">interaction.zoomRange <a class="header-anchor" href="#interaction-zoomrange" aria-label="Permalink to "interaction.zoomRange""></a></h3><p>缩放范围配置。</p><h4 id="interaction-zoomrange-min" tabindex="-1">interaction.zoomRange.min <a class="header-anchor" href="#interaction-zoomrange-min" aria-label="Permalink to "interaction.zoomRange.min""></a></h4><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>0.5</code></li></ul><p>地图初始化后，支持的最小缩放倍数</p><h4 id="interaction-zoomrange-max" tabindex="-1">interaction.zoomRange.max <a class="header-anchor" href="#interaction-zoomrange-max" aria-label="Permalink to "interaction.zoomRange.max""></a></h4><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>8</code></li></ul><p>地图初始化后，支持的最大缩放倍数</p><h3 id="interaction-fitminscale" tabindex="-1">interaction.fitMinScale <a class="header-anchor" href="#interaction-fitminscale" aria-label="Permalink to "interaction.fitMinScale""></a></h3><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>1</code></li></ul><p>自适应缩放时的最小比例。限制地图缩小的最小程度。</p><h3 id="interaction-fitmaxscale" tabindex="-1">interaction.fitMaxScale <a class="header-anchor" href="#interaction-fitmaxscale" aria-label="Permalink to "interaction.fitMaxScale""></a></h3><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>4</code></li></ul><p>自适应缩放时的最大比例。限制地图放大的最大程度。</p><div class="tip custom-block"><p class="custom-block-title">TIP</p><p>关于自适应缩放的完整说明，包括触发时机、计算逻辑和常见问题，请参阅 <a href="/guide/advanced-usage.html#自适应缩放">自适应缩放</a>。</p></div><h3 id="interaction-enable" tabindex="-1">interaction.enable <a class="header-anchor" href="#interaction-enable" aria-label="Permalink to "interaction.enable""></a></h3><ul><li><strong>类型</strong>: <code>boolean</code></li><li><strong>默认值</strong>: <code>true</code></li></ul><p>是否开启地图交互总控。设置为 <code>false</code> 时，将完全从底层禁用地图的缩放、平移和点击等交互事件监听，极大减少交互带来的性能开销。</p><h3 id="interaction-enabledoubletapzoom" tabindex="-1">interaction.enableDoubleTapZoom <a class="header-anchor" href="#interaction-enabledoubletapzoom" aria-label="Permalink to "interaction.enableDoubleTapZoom""></a></h3><ul><li><strong>类型</strong>: <code>boolean</code></li><li><strong>默认值</strong>: <code>true</code></li></ul><p>是否启用双击缩放功能</p><h3 id="interaction-enablerobotclick" tabindex="-1">interaction.enableRobotClick <a class="header-anchor" href="#interaction-enablerobotclick" aria-label="Permalink to "interaction.enableRobotClick""></a></h3><ul><li><strong>类型</strong>: <code>boolean</code></li><li><strong>默认值</strong>: <code>false</code></li></ul><p>是否启用扫地机器人的点击交互功能。</p><h3 id="interaction-enablechargingstationclick" tabindex="-1">interaction.enableChargingStationClick <a class="header-anchor" href="#interaction-enablechargingstationclick" aria-label="Permalink to "interaction.enableChargingStationClick""></a></h3><ul><li><strong>类型</strong>: <code>boolean</code></li><li><strong>默认值</strong>: <code>false</code></li></ul><p>是否启用充电桩的点击交互功能。</p><h2 id="map" tabindex="-1">map <a class="header-anchor" href="#map" aria-label="Permalink to "map""></a></h2><p>地图配置。</p><h3 id="map-autopaddinghorizontalpercent" tabindex="-1">map.autoPaddingHorizontalPercent <a class="header-anchor" href="#map-autopaddinghorizontalpercent" aria-label="Permalink to "map.autoPaddingHorizontalPercent""></a></h3><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>0.05</code></li></ul><p>地图自适应时水平方向保留的最小边距比例（相对于视口宽度）。地图完成自适应后，左右边距不小于该比例值。</p><h3 id="map-autopaddingverticalpercent" tabindex="-1">map.autoPaddingVerticalPercent <a class="header-anchor" href="#map-autopaddingverticalpercent" aria-label="Permalink to "map.autoPaddingVerticalPercent""></a></h3><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>0.05</code></li></ul><p>地图自适应时垂直方向保留的最小边距比例（相对于视口高度）。地图完成自适应后，上下边距不小于该比例值。</p><div class="tip custom-block"><p class="custom-block-title">TIP</p><p>这两个配置用于计算自适应缩放时的初始缩放比例。关于自适应缩放的完整说明，请参阅 <a href="/guide/advanced-usage.html#自适应缩放">自适应缩放</a>。</p></div><h3 id="map-obstaclecolor" tabindex="-1">map.obstacleColor <a class="header-anchor" href="#map-obstaclecolor" aria-label="Permalink to "map.obstacleColor""></a></h3><ul><li><strong>类型</strong>: <code>ColorSource</code></li><li><strong>默认值</strong>: <code>'#999999'</code></li></ul><p>障碍点显示颜色。</p><h3 id="map-freecolor" tabindex="-1">map.freeColor <a class="header-anchor" href="#map-freecolor" aria-label="Permalink to "map.freeColor""></a></h3><ul><li><strong>类型</strong>: <code>ColorSource</code></li><li><strong>默认值</strong>: <code>'#ebebeb'</code></li></ul><p>自由区域点显示颜色。(仅结构化地图可用)</p><h3 id="map-autofitoffset" tabindex="-1">map.autoFitOffset <a class="header-anchor" href="#map-autofitoffset" aria-label="Permalink to "map.autoFitOffset""></a></h3><ul><li><strong>类型</strong>: <code>{ x: number; y: number }</code></li><li><strong>默认值</strong>: <code>{ x: 0, y: 0 }</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>地图自适应时的偏移量。</p><p>用于在地图自适应居中显示时，手动指定一个偏移值（例如为了避开底部的 Footer 组件或顶部的 Header 组件），使地图在视觉上保持在显示区域的中心。</p><h3 id="map-adjacencythreshold" tabindex="-1">map.adjacencyThreshold <a class="header-anchor" href="#map-adjacencythreshold" aria-label="Permalink to "map.adjacencyThreshold""></a></h3><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>3</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>房间相邻判定阈值。</p><p>用于判断两个房间是否相邻的算法。两个房间的边界点距离小于等于此阈值时，认为它们相邻。</p><h3 id="map-originchangeautofitthreshold" tabindex="-1">map.originChangeAutoFitThreshold <a class="header-anchor" href="#map-originchangeautofitthreshold" aria-label="Permalink to "map.originChangeAutoFitThreshold""></a></h3><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>2</code></li></ul><p>地图原点变化自适应阈值。当地图 origin 的 x 或 y 变化超过此值时，将触发自适应缩放。</p><div class="tip custom-block"><p class="custom-block-title">TIP</p><p>这是触发自适应缩放的条件之一。关于自适应缩放的完整说明，请参阅 <a href="/guide/advanced-usage.html#自适应缩放">自适应缩放</a>。</p></div><h3 id="map-sizechangeautofitthreshold" tabindex="-1">map.sizeChangeAutoFitThreshold <a class="header-anchor" href="#map-sizechangeautofitthreshold" aria-label="Permalink to "map.sizeChangeAutoFitThreshold""></a></h3><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>10</code></li></ul><p>地图尺寸变化自适应阈值。当地图宽度或高度变化超过此值时，将触发自适应缩放。</p><div class="tip custom-block"><p class="custom-block-title">TIP</p><p>这是触发自适应缩放的条件之一。关于自适应缩放的完整说明，请参阅 <a href="/guide/advanced-usage.html#自适应缩放">自适应缩放</a>。</p></div><h2 id="heatmap" tabindex="-1">heatmap <a class="header-anchor" href="#heatmap" aria-label="Permalink to "heatmap""></a></h2><p>热力图配置，控制信号强度热力图的渲染效果。</p><h3 id="heatmap-cellsize" tabindex="-1">heatmap.cellSize <a class="header-anchor" href="#heatmap-cellsize" aria-label="Permalink to "heatmap.cellSize""></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="heatmap-maxdistance" tabindex="-1">heatmap.maxDistance <a class="header-anchor" href="#heatmap-maxdistance" aria-label="Permalink to "heatmap.maxDistance""></a></h3><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><h3 id="heatmap-smoothiterations" tabindex="-1">heatmap.smoothIterations <a class="header-anchor" href="#heatmap-smoothiterations" aria-label="Permalink to "heatmap.smoothIterations""></a></h3><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>10</code></li></ul><p>热力图平滑迭代次数。</p><h3 id="heatmap-heatmapalpha" tabindex="-1">heatmap.heatmapAlpha <a class="header-anchor" href="#heatmap-heatmapalpha" aria-label="Permalink to "heatmap.heatmapAlpha""></a></h3><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>0.8</code></li></ul><p>热力图透明度 (0-1)。</p><h3 id="heatmap-usegradient" tabindex="-1">heatmap.useGradient <a class="header-anchor" href="#heatmap-usegradient" aria-label="Permalink to "heatmap.useGradient""></a></h3><ul><li><strong>类型</strong>: <code>boolean</code></li><li><strong>默认值</strong>: <code>true</code></li></ul><p>是否启用颜色渐变。关闭后会使用统一色阶渲染。</p><h3 id="heatmap-colorgradients" tabindex="-1">heatmap.colorGradients <a class="header-anchor" href="#heatmap-colorgradients" aria-label="Permalink to "heatmap.colorGradients""></a></h3><ul><li><strong>类型</strong>: <code>[ColorSource, ColorSource, ColorSource, ColorSource, ColorSource, ColorSource, ColorSource, ColorSource]</code></li><li><strong>默认值</strong>: <code>['#FF3B30', '#FF7A00', '#FFA100', '#FFD700', '#99DD70', '#2EC070', '#40E0D0', '#88D0E9']</code></li></ul><p>热力图颜色渐变配置，从高强度到低强度。</p><h2 id="room" tabindex="-1">room <a class="header-anchor" href="#room" aria-label="Permalink to "room""></a></h2><p>房间配置，控制房间的颜色、名称、属性显示等。</p><h3 id="room-colors" tabindex="-1">room.colors <a class="header-anchor" href="#room-colors" aria-label="Permalink to "room.colors""></a></h3><p>房间颜色配置对象。</p><div class="tip custom-block"><p class="custom-block-title">智能配色</p><p>SDK 使用<strong>智能配色算法</strong>，自动确保相邻房间颜色不同。</p><ul><li><strong>建议至少提供 4 种颜色</strong>（基于<a href="https://zh.wikipedia.org/wiki/%E5%9B%9B%E8%89%B2%E5%AE%9A%E7%90%86" target="_blank" rel="noreferrer">四色定理</a>，4种颜色足以满足平面地图需求）</li><li>所有数组类型的颜色配置（<code>active</code>、<code>inactive</code>、<code>name</code>、<code>propertyTheme</code> 等）<strong>建议长度一致</strong></li><li>如果有复杂的相邻房间情况，可以尝试增加更多的颜色，以确保相邻房间颜色不同</li></ul><p>关于智能配色算法的完整说明、配色策略和实际案例，请参阅 <a href="/guide/advanced-usage.html#房间智能配色">房间智能配色</a>。</p></div><h3 id="room-colors-sortby" tabindex="-1">room.colors.sortBy <a class="header-anchor" href="#room-colors-sortby" aria-label="Permalink to "room.colors.sortBy""></a></h3><ul><li><strong>类型</strong>: <code>'index' | 'area'</code></li><li><strong>默认值</strong>: <code>'index'</code></li></ul><p>房间颜色排序方式。</p><ul><li><code>index</code>：按房间ID排序，保持颜色分配稳定。</li><li><code>area</code>：按房间面积排序，大房间将优先分配索引靠前的颜色。</li></ul><div class="warning custom-block"><p class="custom-block-title">WARNING</p><p>使用 <code>area</code> 可能会导致机器导航过程中颜色的突然变化(房间大小变化引起)，建议谨慎使用。</p></div><h3 id="room-colors-strategy" tabindex="-1">room.colors.strategy <a class="header-anchor" href="#room-colors-strategy" aria-label="Permalink to "room.colors.strategy""></a></h3><ul><li><strong>类型</strong>: <code>'priority' | 'balanced'</code></li><li><strong>默认值</strong>: <code>'priority'</code></li></ul><p>房间颜色分配策略。</p><ul><li><code>priority</code>：靠前优先，索引靠前的颜色将被优先使用。</li><li><code>balanced</code>：均匀分配，颜色将被尽可能均匀地使用。</li></ul><h4 id="room-colors-active" tabindex="-1">room.colors.active <a class="header-anchor" href="#room-colors-active" aria-label="Permalink to "room.colors.active""></a></h4><ul><li><strong>类型</strong>: <code>string[]</code></li><li><strong>默认值</strong>: <code>['#a8c8f5', '#9de5c7', '#d4b9f7', '#ffd399']</code></li></ul><p>房间激活状态的颜色数组。</p><div class="tip custom-block"><p class="custom-block-title">TIP</p><ul><li><strong>当 <code>enableRoomSelection: true</code> 时</strong>：代表“被选中”房间的填充色。</li><li><strong>当 <code>enableRoomSelection: false</code> 时</strong>：若未定义 <code>room.colors.normal</code>，默认使用此配置。</li></ul></div><h4 id="room-colors-inactive" tabindex="-1">room.colors.inactive <a class="header-anchor" href="#room-colors-inactive" aria-label="Permalink to "room.colors.inactive""></a></h4><ul><li><strong>类型</strong>: <code>string[]</code></li><li><strong>默认值</strong>: <code>['#d6e7fc', '#d1f4e5', '#ece0fb', '#fff0d9']</code></li></ul><p>房间非激活状态的颜色数组。</p><div class="tip custom-block"><p class="custom-block-title">TIP</p><p>仅在 <code>enableRoomSelection: true</code> 且房间“未被选中”时生效。</p></div><p>颜色索引与 <code>active</code> 对应，建议长度保持一致。</p><h4 id="room-colors-normal" tabindex="-1">room.colors.normal <a class="header-anchor" href="#room-colors-normal" aria-label="Permalink to "room.colors.normal""></a></h4><ul><li><strong>类型</strong>: <code>string[]</code></li><li><strong>默认值</strong>: <code>undefined</code></li></ul><p>房间在普通展示模式下的填充颜色数组。</p><div class="tip custom-block"><p class="custom-block-title">TIP</p><p>仅在 <code>enableRoomSelection: false</code> 时生效。若未定义，默认使用 <code>room.colors.active</code> 的配置。</p></div><h4 id="room-colors-name" tabindex="-1">room.colors.name <a class="header-anchor" href="#room-colors-name" aria-label="Permalink to "room.colors.name""></a></h4><ul><li><strong>类型</strong>: <code>string[]</code></li><li><strong>默认值</strong>: <code>['#2563b8', '#26966b', '#7c3fb8', '#d97706']</code></li></ul><p>房间名称标签的颜色数组。</p><div class="tip custom-block"><p class="custom-block-title">TIP</p><ul><li><strong>当 <code>enableRoomSelection: true</code> 时</strong>：代表“被选中”房间的文字颜色。</li><li><strong>当 <code>enableRoomSelection: false</code> 时</strong>：若未定义 <code>room.colors.nameNormal</code>，默认使用此配置。</li></ul></div><p>颜色索引与 <code>active</code> 对应，建议长度保持一致。</p><h4 id="room-colors-nameinactive" tabindex="-1">room.colors.nameInactive <a class="header-anchor" href="#room-colors-nameinactive" aria-label="Permalink to "room.colors.nameInactive""></a></h4><ul><li><strong>类型</strong>: <code>string[]</code></li><li><strong>默认值</strong>: <code>undefined</code></li></ul><p>房间名称标签在非激活状态下的颜色数组。</p><div class="tip custom-block"><p class="custom-block-title">TIP</p><p>仅在 <code>enableRoomSelection: true</code> 且房间“未被选中”时生效。</p></div><p>如果不配置，则默认使用 <code>room.colors.name</code>。</p><h4 id="room-colors-namenormal" tabindex="-1">room.colors.nameNormal <a class="header-anchor" href="#room-colors-namenormal" aria-label="Permalink to "room.colors.nameNormal""></a></h4><ul><li><strong>类型</strong>: <code>string[]</code></li><li><strong>默认值</strong>: <code>undefined</code></li></ul><p>房间名称标签在普通展示模式下的颜色数组。</p><div class="tip custom-block"><p class="custom-block-title">TIP</p><p>仅在 <code>enableRoomSelection: false</code> 时生效。若未定义，默认使用 <code>room.colors.name</code> 的配置。</p></div><h4 id="room-colors-propertytheme" tabindex="-1">room.colors.propertyTheme <a class="header-anchor" href="#room-colors-propertytheme" aria-label="Permalink to "room.colors.propertyTheme""></a></h4><ul><li><strong>类型</strong>: <code>string[]</code></li><li><strong>默认值</strong>: <code>['#2563b8', '#26966b', '#7c3fb8', '#d97706']</code></li></ul><p>房间属性图标主题颜色数组。</p><div class="tip custom-block"><p class="custom-block-title">TIP</p><ul><li><strong>当 <code>enableRoomSelection: true</code> 时</strong>：代表“被选中”房间的图标颜色。</li><li><strong>当 <code>enableRoomSelection: false</code> 时</strong>：若未定义 <code>room.colors.propertyThemeNormal</code>，默认使用此配置。</li></ul></div><p>颜色索引与 <code>active</code> 对应，建议长度保持一致。</p><h4 id="room-colors-propertythemeinactive" tabindex="-1">room.colors.propertyThemeInactive <a class="header-anchor" href="#room-colors-propertythemeinactive" aria-label="Permalink to "room.colors.propertyThemeInactive""></a></h4><ul><li><strong>类型</strong>: <code>string[]</code></li><li><strong>默认值</strong>: <code>undefined</code></li></ul><p>房间属性图标在非激活状态下的颜色数组。</p><div class="tip custom-block"><p class="custom-block-title">TIP</p><p>仅在 <code>enableRoomSelection: true</code> 且房间“未被选中”时生效。</p></div><p>如果不配置，则默认使用 <code>room.colors.propertyTheme</code>。</p><h4 id="room-colors-propertythemenormal" tabindex="-1">room.colors.propertyThemeNormal <a class="header-anchor" href="#room-colors-propertythemenormal" aria-label="Permalink to "room.colors.propertyThemeNormal""></a></h4><ul><li><strong>类型</strong>: <code>string[]</code></li><li><strong>默认值</strong>: <code>undefined</code></li></ul><p>房间属性图标在普通展示模式下的主题颜色数组。</p><div class="tip custom-block"><p class="custom-block-title">TIP</p><p>仅在 <code>enableRoomSelection: false</code> 时生效。若未定义，默认使用 <code>room.colors.propertyTheme</code> 的配置。</p></div><h4 id="room-colors-selectionindicatorbackground" tabindex="-1">room.colors.selectionIndicatorBackground <a class="header-anchor" href="#room-colors-selectionindicatorbackground" aria-label="Permalink to "room.colors.selectionIndicatorBackground""></a></h4><ul><li><strong>类型</strong>: <code>string[]</code></li><li><strong>默认值</strong>: <code>['#2563b8', '#26966b', '#7c3fb8', '#d97706']</code></li></ul><p>选择指示器背景颜色数组。</p><p>颜色索引与 <code>active</code> 对应，建议长度保持一致。</p><h4 id="room-colors-selectionindicatoricon" tabindex="-1">room.colors.selectionIndicatorIcon <a class="header-anchor" href="#room-colors-selectionindicatoricon" aria-label="Permalink to "room.colors.selectionIndicatorIcon""></a></h4><ul><li><strong>类型</strong>: <code>string[]</code></li><li><strong>默认值</strong>: <code>['#ffffff', '#ffffff', '#ffffff', '#ffffff']</code></li></ul><p>选择指示器图标颜色数组。</p><p>颜色索引与 <code>active</code> 对应，建议长度保持一致。</p><h4 id="room-colors-no-room-data" tabindex="-1">room.colors.NO_ROOM_DATA <a class="header-anchor" href="#room-colors-no-room-data" aria-label="Permalink to "room.colors.NO_ROOM_DATA""></a></h4><ul><li><strong>类型</strong>: <code>string</code></li><li><strong>默认值</strong>: <code>'#ebebeb'</code></li></ul><p>无房间数据区域的颜色 (点阵协议专用)。</p><h4 id="room-colors-room-gap" tabindex="-1">room.colors.ROOM_GAP <a class="header-anchor" href="#room-colors-room-gap" aria-label="Permalink to "room.colors.ROOM_GAP""></a></h4><ul><li><strong>类型</strong>: <code>string</code></li><li><strong>默认值</strong>: <code>'#ebebeb'</code></li></ul><p>房间间隙的颜色 (点阵协议专用)。</p><h4 id="room-colors-obstacle-room" tabindex="-1">room.colors.OBSTACLE_ROOM <a class="header-anchor" href="#room-colors-obstacle-room" aria-label="Permalink to "room.colors.OBSTACLE_ROOM""></a></h4><ul><li><strong>类型</strong>: <code>string</code></li><li><strong>默认值</strong>: <code>'#ebebeb'</code></li></ul><p>障碍物房间的颜色 (点阵协议专用)。</p><h4 id="room-colors-unknown-room" tabindex="-1">room.colors.UNKNOWN_ROOM <a class="header-anchor" href="#room-colors-unknown-room" aria-label="Permalink to "room.colors.UNKNOWN_ROOM""></a></h4><ul><li><strong>类型</strong>: <code>string</code></li><li><strong>默认值</strong>: <code>'#ebebeb'</code></li></ul><p>未知房间的颜色。对于结构化协议代表 <code>roomId >= 255</code> 的房间颜色。</p><h4 id="room-colors-version0-room" tabindex="-1">room.colors.VERSION0_ROOM <a class="header-anchor" href="#room-colors-version0-room" aria-label="Permalink to "room.colors.VERSION0_ROOM""></a></h4><ul><li><strong>类型</strong>: <code>string</code></li><li><strong>默认值</strong>: <code>''</code></li></ul><p>点阵地图协议版本0的房间颜色 (点阵协议专用)。</p><div class="tip custom-block"><p class="custom-block-title">版本兼容说明</p><p>此配置项用于控制地图协议版本0（未支持分区的协议版本）中房间的颜色。在之前的版本中，版本0的房间和无房间数据区域都使用 <code>NO_ROOM_DATA</code> 颜色。现已将版本0的房间单独拆分为 <code>VERSION0_ROOM</code>。</p><p>默认值为空字符串，此时将自动使用 <code>NO_ROOM_DATA</code> 的颜色，以保持向后兼容。如需区分显示，可配置为不同的颜色值。</p></div><h3 id="room-namelabel" tabindex="-1">room.nameLabel <a class="header-anchor" href="#room-namelabel" aria-label="Permalink to "room.nameLabel""></a></h3><p>房间名称标签配置。</p><h4 id="room-namelabel-fontsize" tabindex="-1">room.nameLabel.fontSize <a class="header-anchor" href="#room-namelabel-fontsize" aria-label="Permalink to "room.nameLabel.fontSize""></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="room-namelabel-fontfamily" tabindex="-1">room.nameLabel.fontFamily <a class="header-anchor" href="#room-namelabel-fontfamily" aria-label="Permalink to "room.nameLabel.fontFamily""></a></h4><ul><li><strong>类型</strong>: <code>string</code></li><li><strong>默认值</strong>: <code>'system-ui, -apple-system, sans-serif'</code></li></ul><p>房间名称字体名称。</p><h4 id="room-namelabel-fontweight" tabindex="-1">room.nameLabel.fontWeight <a class="header-anchor" href="#room-namelabel-fontweight" aria-label="Permalink to "room.nameLabel.fontWeight""></a></h4><ul><li><strong>类型</strong>: <code>TextStyleFontWeight</code></li><li><strong>默认值</strong>: <code>'500'</code></li></ul><p>房间名称字体粗细。</p><h3 id="room-type" tabindex="-1">room.type <a class="header-anchor" href="#room-type" aria-label="Permalink to "room.type""></a></h3><p>房间类型图标配置。</p><h4 id="room-type-assets" tabindex="-1">room.type.assets <a class="header-anchor" href="#room-type-assets" aria-label="Permalink to "room.type.assets""></a></h4><ul><li><strong>类型</strong>: <code>string[]</code></li><li><strong>默认值</strong>: <code>[内置资源, ...]</code></li></ul><p>房间类型图标资源数组。</p><p>数组索引对应 <code>RoomProperty.type</code> 值，即 <code>assets[type]</code> 显示该索引对应的图标。</p><p><strong>内置默认资源映射表：</strong></p><p>以下是内置默认图标与 <code>type</code> 值的对应关系：</p><table tabindex="0"><thead><tr><th style="text-align:left;">ID (索引)</th><th style="text-align:left;">房间类型</th></tr></thead><tbody><tr><td style="text-align:left;">0</td><td style="text-align:left;">通用/房间</td></tr><tr><td style="text-align:left;">1</td><td style="text-align:left;">客厅</td></tr><tr><td style="text-align:left;">2</td><td style="text-align:left;">餐厅</td></tr><tr><td style="text-align:left;">3</td><td style="text-align:left;">主卧</td></tr><tr><td style="text-align:left;">4</td><td style="text-align:left;">次卧/卧室</td></tr><tr><td style="text-align:left;">5</td><td style="text-align:left;">书房</td></tr><tr><td style="text-align:left;">6</td><td style="text-align:left;">厨房</td></tr><tr><td style="text-align:left;">7</td><td style="text-align:left;">卫生间</td></tr><tr><td style="text-align:left;">8</td><td style="text-align:left;">洗衣房</td></tr><tr><td style="text-align:left;">9</td><td style="text-align:left;">休息室</td></tr><tr><td style="text-align:left;">10</td><td style="text-align:left;">储物间</td></tr><tr><td style="text-align:left;">11</td><td style="text-align:left;">儿童房</td></tr><tr><td style="text-align:left;">12</td><td style="text-align:left;">阳光房</td></tr><tr><td style="text-align:left;">13</td><td style="text-align:left;">走廊</td></tr><tr><td style="text-align:left;">14</td><td style="text-align:left;">阳台</td></tr><tr><td style="text-align:left;">15</td><td style="text-align:left;">健身房</td></tr><tr><td style="text-align:left;">16</td><td style="text-align:left;">玄关</td></tr></tbody></table><p>当使用内置默认资源时，索引与房间类型的对应关系详见<a href="/guide/advanced-usage.html#房间类型图标">房间类型图标</a>。如果开发者通过此配置项自定义了数组，则映射关系完全取决于自定义数组的顺序。</p><div class="tip custom-block"><p class="custom-block-title">TIP</p><p>如果某个索引对应的资源为空字符串（<code>''</code>），则该类型的房间将不会显示任何图标。例如，通过设置 <code>assets[0] = ''</code> 可以隐藏 type 为 0 的房间图标。</p></div><h4 id="room-type-iconsize" tabindex="-1">room.type.iconSize <a class="header-anchor" href="#room-type-iconsize" aria-label="Permalink to "room.type.iconSize""></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="room-type-gap" tabindex="-1">room.type.gap <a class="header-anchor" href="#room-type-gap" aria-label="Permalink to "room.type.gap""></a></h4><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>4</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>图标与房间名称文字之间的间距。</p><h4 id="room-type-position" tabindex="-1">room.type.position <a class="header-anchor" href="#room-type-position" aria-label="Permalink to "room.type.position""></a></h4><ul><li><strong>类型</strong>: <code>'left' | 'right'</code></li><li><strong>默认值</strong>: <code>'left'</code></li></ul><p>图标相对于房间名称文字的显示位置。</p><h4 id="room-type-container" tabindex="-1">room.type.container <a class="header-anchor" href="#room-type-container" aria-label="Permalink to "room.type.container""></a></h4><p>房间类型图标背景容器配置。</p><h5 id="room-type-container-visible" tabindex="-1">room.type.container.visible <a class="header-anchor" href="#room-type-container-visible" aria-label="Permalink to "room.type.container.visible""></a></h5><ul><li><strong>类型</strong>: <code>boolean</code></li><li><strong>默认值</strong>: <code>true</code></li></ul><p>是否显示背景容器。</p><div class="tip custom-block"><p class="custom-block-title">TIP</p><ul><li><strong>颜色逻辑</strong>： <ul><li>当开启背景容器（<code>container.visible: true</code>）时，背景将填充为房间名称颜色（<code>room.colors.name</code>），图标将自动设置为白色（<code>tint: #ffffff</code>）。</li><li>当禁用背景容器（<code>container.visible: false</code>）时，图标将直接使用房间名称颜色（<code>room.colors.name</code>）。</li></ul></li><li><strong>最佳实践</strong>：为了实现自动换色效果，建议使用单色（通常为黑色或白色）的 SVG 资源。如果使用彩色 PNG 资源，建议将 <code>container.visible</code> 设为 <code>false</code> 以保持原色。</li></ul></div><h5 id="room-type-container-size" tabindex="-1">room.type.container.size <a class="header-anchor" href="#room-type-container-size" aria-label="Permalink to "room.type.container.size""></a></h5><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><h5 id="room-type-container-borderradius" tabindex="-1">room.type.container.borderRadius <a class="header-anchor" href="#room-type-container-borderradius" aria-label="Permalink to "room.type.container.borderRadius""></a></h5><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="room-property" tabindex="-1">room.property <a class="header-anchor" href="#room-property" aria-label="Permalink to "room.property""></a></h3><p>房间属性配置。</p><h4 id="room-property-displayorders" tabindex="-1">room.property.displayOrders <a class="header-anchor" href="#room-property-displayorders" aria-label="Permalink to "room.property.displayOrders""></a></h4><ul><li><strong>类型</strong>: <code>('cleanMode' | 'suction' | 'cistern' | 'cleanTimes' | string)[]</code></li><li><strong>默认值</strong>: <code>['cleanMode', 'suction', 'cistern', 'cleanTimes']</code></li></ul><p>房间属性显示顺序。</p><p>你也可以传入自定义的字段名，比如 <code>['cleanMode', 'suction', 'cistern', 'cleanTimes', 'customProperty1']</code>。</p><div class="tip custom-block"><p class="custom-block-title">TIP</p><p>如果要隐藏某个房间属性，比如 <code>cleanTimes</code>，那么清扫次数图标将不会显示。</p></div><h4 id="room-property-customassets" tabindex="-1">room.property.customAssets <a class="header-anchor" href="#room-property-customassets" aria-label="Permalink to "room.property.customAssets""></a></h4><ul><li><strong>类型</strong>: <code>Record<string, string[]></code></li><li><strong>默认值</strong>: <code>undefined</code></li></ul><p>自定义属性图标资源配置，</p><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:#24292E;--shiki-dark:#E1E4E8;">{</span></span>
|
|
169
|
+
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">}</span></span></code></pre></div><p><strong>fit 模式说明：</strong></p><ul><li><code>fill</code>：拉伸填充整个视口</li><li><code>contain</code>：完整显示图片，保持宽高比，可能有留白</li><li><code>cover</code>（默认）：覆盖整个视口，保持宽高比，可能裁剪</li><li><code>none</code>：原始尺寸显示</li></ul><h3 id="global-backgroundalpha" tabindex="-1">global.backgroundAlpha <a class="header-anchor" href="#global-backgroundalpha" aria-label="Permalink to "global.backgroundAlpha""></a></h3><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>1</code></li></ul><p>地图容器背景透明度。</p><div class="warning custom-block"><p class="custom-block-title">注意</p><p>该配置仅对<strong>纯色背景</strong> (<code>backgroundColor</code>) 和<strong>图片背景</strong> (<code>backgroundImage</code>) 生效。</p><p>对于<strong>渐变背景</strong> (<code>backgroundGradient</code>)，请直接在 <code>colorStops</code> 中使用 <code>rgba</code> 颜色值（如 <code>'rgba(255, 255, 255, 0.5)'</code>）来控制透明度。</p></div><h3 id="global-performancemode" tabindex="-1">global.performanceMode <a class="header-anchor" href="#global-performancemode" aria-label="Permalink to "global.performanceMode""></a></h3><ul><li><strong>类型</strong>: <code>boolean</code></li><li><strong>默认值</strong>: <code>false</code></li></ul><p>是否开启高性能模式。开启后，SDK 会优化渲染性能（如强制关闭抗锯齿、共享时钟等），建议在多地图展示等对性能要求较高的场景下开启。</p><h3 id="global-resolution" tabindex="-1">global.resolution <a class="header-anchor" href="#global-resolution" aria-label="Permalink to "global.resolution""></a></h3><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>window.devicePixelRatio</code></li></ul><p>渲染分辨率倍率。通常不需要手动设置，SDK 会自动获取设备的像素密度。在性能极度受限的场景下，可以手动将其设为 <code>1</code> 或 <code>1.5</code> 来降低 GPU 渲染压力。</p><h3 id="global-enablelogger" tabindex="-1">global.enableLogger <a class="header-anchor" href="#global-enablelogger" aria-label="Permalink to "global.enableLogger""></a></h3><ul><li><strong>类型</strong>: <code>boolean</code></li><li><strong>默认值</strong>: <code>import.meta.env.DEV</code></li></ul><p>是否启用日志输出的旧配置项。当设置为 <code>true</code> 时，SDK 会输出内部日志（<code>Logger.log</code>、<code>Logger.warn</code>、<code>Logger.error</code>、<code>Logger.debug</code>、<code>Logger.success</code>）；当设置为 <code>false</code> 时，所有日志都不会输出。</p><div class="tip custom-block"><p class="custom-block-title">TIP</p><p>默认值会跟随构建环境：开发环境通常为 <code>true</code>，生产环境通常为 <code>false</code>。 建议仅在排查问题时开启此选项。</p><p>对于新接入，优先使用 <code>logger.enabled</code>。<code>global.enableLogger</code> 仅作为控制控制台日志的兼容兜底，不再负责 App 日志转发。</p></div><h3 id="global-rendererpreference" tabindex="-1">global.rendererPreference <a class="header-anchor" href="#global-rendererpreference" aria-label="Permalink to "global.rendererPreference""></a></h3><ul><li><strong>类型</strong>: <code>'webgpu' | 'webgl'</code></li><li><strong>默认值</strong>: <code>'webgl'</code></li></ul><p>渲染器偏好，设置 PIXI.js 优先使用的渲染后端。</p><p>默认值使用 <code>webgl</code>，优先选择更稳定、兼容性更高的渲染路径。如果你需要验证 <code>webgpu</code> 的表现，可以显式传入 <code>global.rendererPreference: 'webgpu'</code>。SDK 在 初始化阶段遇到 <code>webgpu</code> 启动失败时，会自动回退到 <code>webgl</code>，并输出对应告警。</p><h2 id="logger" tabindex="-1">logger <a class="header-anchor" href="#logger" aria-label="Permalink to "logger""></a></h2><p><code>logger</code> 配置用于控制 SDK 的控制台日志和可选的宿主日志转发。这一组配置不会强依赖任何业务日志库；只有当宿主层实现了 <code>onLogger</code> 回调时，日志才会被转发到 App 层。</p><h3 id="logger-enabled" tabindex="-1">logger.enabled <a class="header-anchor" href="#logger-enabled" aria-label="Permalink to "logger.enabled""></a></h3><p><code>logger.enabled</code> 控制 SDK 在 webview 控制台中的日志输出。</p><ul><li><strong>类型</strong>: <code>boolean</code></li><li><strong>默认值</strong>: <code>import.meta.env.DEV</code></li></ul><p>当设置为 <code>true</code> 时，SDK 会输出内部日志到控制台；当设置为 <code>false</code> 时，控制台日志关闭。这个字段优先级高于 <code>global.enableLogger</code>。</p><h3 id="logger-hostsinkenabled" tabindex="-1">logger.hostSinkEnabled <a class="header-anchor" href="#logger-hostsinkenabled" aria-label="Permalink to "logger.hostSinkEnabled""></a></h3><p><code>logger.hostSinkEnabled</code> 控制是否尝试把结构化日志转发给宿主层。</p><ul><li><strong>类型</strong>: <code>boolean</code></li><li><strong>默认值</strong>: <code>false</code></li></ul><p>当设置为 <code>true</code> 时，SDK 会在满足 <code>hostLevels</code> 过滤条件后，把日志 payload 转发给宿主层的 <code>onLogger</code> 回调。如果宿主层没有实现 <code>onLogger</code>，SDK 会静默跳过，不会报错。</p><h3 id="logger-hostlevels" tabindex="-1">logger.hostLevels <a class="header-anchor" href="#logger-hostlevels" aria-label="Permalink to "logger.hostLevels""></a></h3><p><code>logger.hostLevels</code> 控制哪些日志级别会被转发到宿主层。</p><ul><li><strong>类型</strong>: <code>Array<'warn' | 'error' | 'info' | 'debug'></code></li><li><strong>默认值</strong>: <code>['warn', 'error']</code></li></ul><p>默认只转发 <code>warn</code> 和 <code>error</code>。如果你需要在诊断阶段同时采集 <code>info</code> 或 <code>debug</code>，可以显式把这些级别加入数组中。</p><p>渲染链路的额外诊断日志，例如 renderer 初始化信息、地图清空告警，以及 WebGL context 丢失或恢复事件，会使用 <code>debug</code>、<code>warn</code> 或 <code>error</code> 级别输出。 如果你要排查“地图突然消失但没有恢复”这类问题，建议在临时诊断窗口里把 <code>debug</code> 加入 <code>hostLevels</code>。</p><h3 id="logger-tag" tabindex="-1">logger.tag <a class="header-anchor" href="#logger-tag" aria-label="Permalink to "logger.tag""></a></h3><p><code>logger.tag</code> 用于标识日志来源，方便宿主层在 App 日志里检索和过滤。</p><ul><li><strong>类型</strong>: <code>string</code></li><li><strong>默认值</strong>: <code>'ray-robot-map-sdk'</code></li></ul><p>业务侧可以直接使用这个字段作为日志前缀，也可以组合自己的 App tag 一起输出。</p><h2 id="interaction" tabindex="-1">interaction <a class="header-anchor" href="#interaction" aria-label="Permalink to "interaction""></a></h2><p>交互配置，控制地图的缩放和手势操作。</p><h3 id="interaction-zoomrange" tabindex="-1">interaction.zoomRange <a class="header-anchor" href="#interaction-zoomrange" aria-label="Permalink to "interaction.zoomRange""></a></h3><p>缩放范围配置。</p><h4 id="interaction-zoomrange-min" tabindex="-1">interaction.zoomRange.min <a class="header-anchor" href="#interaction-zoomrange-min" aria-label="Permalink to "interaction.zoomRange.min""></a></h4><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>0.5</code></li></ul><p>地图初始化后，支持的最小缩放倍数</p><h4 id="interaction-zoomrange-max" tabindex="-1">interaction.zoomRange.max <a class="header-anchor" href="#interaction-zoomrange-max" aria-label="Permalink to "interaction.zoomRange.max""></a></h4><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>8</code></li></ul><p>地图初始化后，支持的最大缩放倍数</p><h3 id="interaction-fitminscale" tabindex="-1">interaction.fitMinScale <a class="header-anchor" href="#interaction-fitminscale" aria-label="Permalink to "interaction.fitMinScale""></a></h3><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>1</code></li></ul><p>自适应缩放时的最小比例。限制地图缩小的最小程度。</p><h3 id="interaction-fitmaxscale" tabindex="-1">interaction.fitMaxScale <a class="header-anchor" href="#interaction-fitmaxscale" aria-label="Permalink to "interaction.fitMaxScale""></a></h3><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>4</code></li></ul><p>自适应缩放时的最大比例。限制地图放大的最大程度。</p><div class="tip custom-block"><p class="custom-block-title">TIP</p><p>关于自适应缩放的完整说明，包括触发时机、计算逻辑和常见问题，请参阅 <a href="/guide/advanced-usage.html#自适应缩放">自适应缩放</a>。</p></div><h3 id="interaction-enable" tabindex="-1">interaction.enable <a class="header-anchor" href="#interaction-enable" aria-label="Permalink to "interaction.enable""></a></h3><ul><li><strong>类型</strong>: <code>boolean</code></li><li><strong>默认值</strong>: <code>true</code></li></ul><p>是否开启地图交互总控。设置为 <code>false</code> 时，将完全从底层禁用地图的缩放、平移和点击等交互事件监听，极大减少交互带来的性能开销。</p><h3 id="interaction-enabledoubletapzoom" tabindex="-1">interaction.enableDoubleTapZoom <a class="header-anchor" href="#interaction-enabledoubletapzoom" aria-label="Permalink to "interaction.enableDoubleTapZoom""></a></h3><ul><li><strong>类型</strong>: <code>boolean</code></li><li><strong>默认值</strong>: <code>true</code></li></ul><p>是否启用双击缩放功能</p><h3 id="interaction-enablerobotclick" tabindex="-1">interaction.enableRobotClick <a class="header-anchor" href="#interaction-enablerobotclick" aria-label="Permalink to "interaction.enableRobotClick""></a></h3><ul><li><strong>类型</strong>: <code>boolean</code></li><li><strong>默认值</strong>: <code>false</code></li></ul><p>是否启用扫地机器人的点击交互功能。</p><h3 id="interaction-enablechargingstationclick" tabindex="-1">interaction.enableChargingStationClick <a class="header-anchor" href="#interaction-enablechargingstationclick" aria-label="Permalink to "interaction.enableChargingStationClick""></a></h3><ul><li><strong>类型</strong>: <code>boolean</code></li><li><strong>默认值</strong>: <code>false</code></li></ul><p>是否启用充电桩的点击交互功能。</p><h2 id="map" tabindex="-1">map <a class="header-anchor" href="#map" aria-label="Permalink to "map""></a></h2><p>地图配置。</p><h3 id="map-autopaddinghorizontalpercent" tabindex="-1">map.autoPaddingHorizontalPercent <a class="header-anchor" href="#map-autopaddinghorizontalpercent" aria-label="Permalink to "map.autoPaddingHorizontalPercent""></a></h3><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>0.05</code></li></ul><p>地图自适应时水平方向保留的最小边距比例（相对于视口宽度）。地图完成自适应后，左右边距不小于该比例值。</p><h3 id="map-autopaddingverticalpercent" tabindex="-1">map.autoPaddingVerticalPercent <a class="header-anchor" href="#map-autopaddingverticalpercent" aria-label="Permalink to "map.autoPaddingVerticalPercent""></a></h3><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>0.05</code></li></ul><p>地图自适应时垂直方向保留的最小边距比例（相对于视口高度）。地图完成自适应后，上下边距不小于该比例值。</p><div class="tip custom-block"><p class="custom-block-title">TIP</p><p>这两个配置用于计算自适应缩放时的初始缩放比例。关于自适应缩放的完整说明，请参阅 <a href="/guide/advanced-usage.html#自适应缩放">自适应缩放</a>。</p></div><h3 id="map-obstaclecolor" tabindex="-1">map.obstacleColor <a class="header-anchor" href="#map-obstaclecolor" aria-label="Permalink to "map.obstacleColor""></a></h3><ul><li><strong>类型</strong>: <code>ColorSource</code></li><li><strong>默认值</strong>: <code>'#999999'</code></li></ul><p>障碍点显示颜色。</p><h3 id="map-freecolor" tabindex="-1">map.freeColor <a class="header-anchor" href="#map-freecolor" aria-label="Permalink to "map.freeColor""></a></h3><ul><li><strong>类型</strong>: <code>ColorSource</code></li><li><strong>默认值</strong>: <code>'#ebebeb'</code></li></ul><p>自由区域点显示颜色。(仅结构化地图可用)</p><h3 id="map-autofitoffset" tabindex="-1">map.autoFitOffset <a class="header-anchor" href="#map-autofitoffset" aria-label="Permalink to "map.autoFitOffset""></a></h3><ul><li><strong>类型</strong>: <code>{ x: number; y: number }</code></li><li><strong>默认值</strong>: <code>{ x: 0, y: 0 }</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>地图自适应时的偏移量。</p><p>用于在地图自适应居中显示时，手动指定一个偏移值（例如为了避开底部的 Footer 组件或顶部的 Header 组件），使地图在视觉上保持在显示区域的中心。</p><h3 id="map-adjacencythreshold" tabindex="-1">map.adjacencyThreshold <a class="header-anchor" href="#map-adjacencythreshold" aria-label="Permalink to "map.adjacencyThreshold""></a></h3><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>3</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>房间相邻判定阈值。</p><p>用于判断两个房间是否相邻的算法。两个房间的边界点距离小于等于此阈值时，认为它们相邻。</p><h3 id="map-originchangeautofitthreshold" tabindex="-1">map.originChangeAutoFitThreshold <a class="header-anchor" href="#map-originchangeautofitthreshold" aria-label="Permalink to "map.originChangeAutoFitThreshold""></a></h3><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>2</code></li></ul><p>地图原点变化自适应阈值。当地图 origin 的 x 或 y 变化超过此值时，将触发自适应缩放。</p><div class="tip custom-block"><p class="custom-block-title">TIP</p><p>这是触发自适应缩放的条件之一。关于自适应缩放的完整说明，请参阅 <a href="/guide/advanced-usage.html#自适应缩放">自适应缩放</a>。</p></div><h3 id="map-sizechangeautofitthreshold" tabindex="-1">map.sizeChangeAutoFitThreshold <a class="header-anchor" href="#map-sizechangeautofitthreshold" aria-label="Permalink to "map.sizeChangeAutoFitThreshold""></a></h3><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>10</code></li></ul><p>地图尺寸变化自适应阈值。当地图宽度或高度变化超过此值时，将触发自适应缩放。</p><div class="tip custom-block"><p class="custom-block-title">TIP</p><p>这是触发自适应缩放的条件之一。关于自适应缩放的完整说明，请参阅 <a href="/guide/advanced-usage.html#自适应缩放">自适应缩放</a>。</p></div><h2 id="heatmap" tabindex="-1">heatmap <a class="header-anchor" href="#heatmap" aria-label="Permalink to "heatmap""></a></h2><p>热力图配置，控制信号强度热力图的渲染效果。</p><h3 id="heatmap-cellsize" tabindex="-1">heatmap.cellSize <a class="header-anchor" href="#heatmap-cellsize" aria-label="Permalink to "heatmap.cellSize""></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="heatmap-maxdistance" tabindex="-1">heatmap.maxDistance <a class="header-anchor" href="#heatmap-maxdistance" aria-label="Permalink to "heatmap.maxDistance""></a></h3><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><h3 id="heatmap-smoothiterations" tabindex="-1">heatmap.smoothIterations <a class="header-anchor" href="#heatmap-smoothiterations" aria-label="Permalink to "heatmap.smoothIterations""></a></h3><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>10</code></li></ul><p>热力图平滑迭代次数。</p><h3 id="heatmap-heatmapalpha" tabindex="-1">heatmap.heatmapAlpha <a class="header-anchor" href="#heatmap-heatmapalpha" aria-label="Permalink to "heatmap.heatmapAlpha""></a></h3><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>0.8</code></li></ul><p>热力图透明度 (0-1)。</p><h3 id="heatmap-usegradient" tabindex="-1">heatmap.useGradient <a class="header-anchor" href="#heatmap-usegradient" aria-label="Permalink to "heatmap.useGradient""></a></h3><ul><li><strong>类型</strong>: <code>boolean</code></li><li><strong>默认值</strong>: <code>true</code></li></ul><p>是否启用颜色渐变。关闭后会使用统一色阶渲染。</p><h3 id="heatmap-colorgradients" tabindex="-1">heatmap.colorGradients <a class="header-anchor" href="#heatmap-colorgradients" aria-label="Permalink to "heatmap.colorGradients""></a></h3><ul><li><strong>类型</strong>: <code>[ColorSource, ColorSource, ColorSource, ColorSource, ColorSource, ColorSource, ColorSource, ColorSource]</code></li><li><strong>默认值</strong>: <code>['#FF3B30', '#FF7A00', '#FFA100', '#FFD700', '#99DD70', '#2EC070', '#40E0D0', '#88D0E9']</code></li></ul><p>热力图颜色渐变配置，从高强度到低强度。</p><h2 id="room" tabindex="-1">room <a class="header-anchor" href="#room" aria-label="Permalink to "room""></a></h2><p>房间配置，控制房间的颜色、名称、属性显示等。</p><h3 id="room-colors" tabindex="-1">room.colors <a class="header-anchor" href="#room-colors" aria-label="Permalink to "room.colors""></a></h3><p>房间颜色配置对象。</p><div class="tip custom-block"><p class="custom-block-title">智能配色</p><p>SDK 使用<strong>智能配色算法</strong>，自动确保相邻房间颜色不同。</p><ul><li><strong>建议至少提供 4 种颜色</strong>（基于<a href="https://zh.wikipedia.org/wiki/%E5%9B%9B%E8%89%B2%E5%AE%9A%E7%90%86" target="_blank" rel="noreferrer">四色定理</a>，4种颜色足以满足平面地图需求）</li><li>所有数组类型的颜色配置（<code>active</code>、<code>inactive</code>、<code>name</code>、<code>propertyTheme</code> 等）<strong>建议长度一致</strong></li><li>如果有复杂的相邻房间情况，可以尝试增加更多的颜色，以确保相邻房间颜色不同</li></ul><p>关于智能配色算法的完整说明、配色策略和实际案例，请参阅 <a href="/guide/advanced-usage.html#房间智能配色">房间智能配色</a>。</p></div><h3 id="room-colors-sortby" tabindex="-1">room.colors.sortBy <a class="header-anchor" href="#room-colors-sortby" aria-label="Permalink to "room.colors.sortBy""></a></h3><ul><li><strong>类型</strong>: <code>'index' | 'area'</code></li><li><strong>默认值</strong>: <code>'index'</code></li></ul><p>房间颜色排序方式。</p><ul><li><code>index</code>：按房间ID排序，保持颜色分配稳定。</li><li><code>area</code>：按房间面积排序，大房间将优先分配索引靠前的颜色。</li></ul><div class="warning custom-block"><p class="custom-block-title">WARNING</p><p>使用 <code>area</code> 可能会导致机器导航过程中颜色的突然变化(房间大小变化引起)，建议谨慎使用。</p></div><h3 id="room-colors-strategy" tabindex="-1">room.colors.strategy <a class="header-anchor" href="#room-colors-strategy" aria-label="Permalink to "room.colors.strategy""></a></h3><ul><li><strong>类型</strong>: <code>'priority' | 'balanced'</code></li><li><strong>默认值</strong>: <code>'priority'</code></li></ul><p>房间颜色分配策略。</p><ul><li><code>priority</code>：靠前优先，索引靠前的颜色将被优先使用。</li><li><code>balanced</code>：均匀分配，颜色将被尽可能均匀地使用。</li></ul><h4 id="room-colors-active" tabindex="-1">room.colors.active <a class="header-anchor" href="#room-colors-active" aria-label="Permalink to "room.colors.active""></a></h4><ul><li><strong>类型</strong>: <code>string[]</code></li><li><strong>默认值</strong>: <code>['#a8c8f5', '#9de5c7', '#d4b9f7', '#ffd399']</code></li></ul><p>房间激活状态的颜色数组。</p><div class="tip custom-block"><p class="custom-block-title">TIP</p><ul><li><strong>当 <code>enableRoomSelection: true</code> 时</strong>：代表“被选中”房间的填充色。</li><li><strong>当 <code>enableRoomSelection: false</code> 时</strong>：若未定义 <code>room.colors.normal</code>，默认使用此配置。</li></ul></div><h4 id="room-colors-inactive" tabindex="-1">room.colors.inactive <a class="header-anchor" href="#room-colors-inactive" aria-label="Permalink to "room.colors.inactive""></a></h4><ul><li><strong>类型</strong>: <code>string[]</code></li><li><strong>默认值</strong>: <code>['#d6e7fc', '#d1f4e5', '#ece0fb', '#fff0d9']</code></li></ul><p>房间非激活状态的颜色数组。</p><div class="tip custom-block"><p class="custom-block-title">TIP</p><p>仅在 <code>enableRoomSelection: true</code> 且房间“未被选中”时生效。</p></div><p>颜色索引与 <code>active</code> 对应，建议长度保持一致。</p><h4 id="room-colors-normal" tabindex="-1">room.colors.normal <a class="header-anchor" href="#room-colors-normal" aria-label="Permalink to "room.colors.normal""></a></h4><ul><li><strong>类型</strong>: <code>string[]</code></li><li><strong>默认值</strong>: <code>undefined</code></li></ul><p>房间在普通展示模式下的填充颜色数组。</p><div class="tip custom-block"><p class="custom-block-title">TIP</p><p>仅在 <code>enableRoomSelection: false</code> 时生效。若未定义，默认使用 <code>room.colors.active</code> 的配置。</p></div><h4 id="room-colors-name" tabindex="-1">room.colors.name <a class="header-anchor" href="#room-colors-name" aria-label="Permalink to "room.colors.name""></a></h4><ul><li><strong>类型</strong>: <code>string[]</code></li><li><strong>默认值</strong>: <code>['#2563b8', '#26966b', '#7c3fb8', '#d97706']</code></li></ul><p>房间名称标签的颜色数组。</p><div class="tip custom-block"><p class="custom-block-title">TIP</p><ul><li><strong>当 <code>enableRoomSelection: true</code> 时</strong>：代表“被选中”房间的文字颜色。</li><li><strong>当 <code>enableRoomSelection: false</code> 时</strong>：若未定义 <code>room.colors.nameNormal</code>，默认使用此配置。</li></ul></div><p>颜色索引与 <code>active</code> 对应，建议长度保持一致。</p><h4 id="room-colors-nameinactive" tabindex="-1">room.colors.nameInactive <a class="header-anchor" href="#room-colors-nameinactive" aria-label="Permalink to "room.colors.nameInactive""></a></h4><ul><li><strong>类型</strong>: <code>string[]</code></li><li><strong>默认值</strong>: <code>undefined</code></li></ul><p>房间名称标签在非激活状态下的颜色数组。</p><div class="tip custom-block"><p class="custom-block-title">TIP</p><p>仅在 <code>enableRoomSelection: true</code> 且房间“未被选中”时生效。</p></div><p>如果不配置，则默认使用 <code>room.colors.name</code>。</p><h4 id="room-colors-namenormal" tabindex="-1">room.colors.nameNormal <a class="header-anchor" href="#room-colors-namenormal" aria-label="Permalink to "room.colors.nameNormal""></a></h4><ul><li><strong>类型</strong>: <code>string[]</code></li><li><strong>默认值</strong>: <code>undefined</code></li></ul><p>房间名称标签在普通展示模式下的颜色数组。</p><div class="tip custom-block"><p class="custom-block-title">TIP</p><p>仅在 <code>enableRoomSelection: false</code> 时生效。若未定义，默认使用 <code>room.colors.name</code> 的配置。</p></div><h4 id="room-colors-propertytheme" tabindex="-1">room.colors.propertyTheme <a class="header-anchor" href="#room-colors-propertytheme" aria-label="Permalink to "room.colors.propertyTheme""></a></h4><ul><li><strong>类型</strong>: <code>string[]</code></li><li><strong>默认值</strong>: <code>['#2563b8', '#26966b', '#7c3fb8', '#d97706']</code></li></ul><p>房间属性图标主题颜色数组。</p><div class="tip custom-block"><p class="custom-block-title">TIP</p><ul><li><strong>当 <code>enableRoomSelection: true</code> 时</strong>：代表“被选中”房间的图标颜色。</li><li><strong>当 <code>enableRoomSelection: false</code> 时</strong>：若未定义 <code>room.colors.propertyThemeNormal</code>，默认使用此配置。</li></ul></div><p>颜色索引与 <code>active</code> 对应，建议长度保持一致。</p><h4 id="room-colors-propertythemeinactive" tabindex="-1">room.colors.propertyThemeInactive <a class="header-anchor" href="#room-colors-propertythemeinactive" aria-label="Permalink to "room.colors.propertyThemeInactive""></a></h4><ul><li><strong>类型</strong>: <code>string[]</code></li><li><strong>默认值</strong>: <code>undefined</code></li></ul><p>房间属性图标在非激活状态下的颜色数组。</p><div class="tip custom-block"><p class="custom-block-title">TIP</p><p>仅在 <code>enableRoomSelection: true</code> 且房间“未被选中”时生效。</p></div><p>如果不配置，则默认使用 <code>room.colors.propertyTheme</code>。</p><h4 id="room-colors-propertythemenormal" tabindex="-1">room.colors.propertyThemeNormal <a class="header-anchor" href="#room-colors-propertythemenormal" aria-label="Permalink to "room.colors.propertyThemeNormal""></a></h4><ul><li><strong>类型</strong>: <code>string[]</code></li><li><strong>默认值</strong>: <code>undefined</code></li></ul><p>房间属性图标在普通展示模式下的主题颜色数组。</p><div class="tip custom-block"><p class="custom-block-title">TIP</p><p>仅在 <code>enableRoomSelection: false</code> 时生效。若未定义，默认使用 <code>room.colors.propertyTheme</code> 的配置。</p></div><h4 id="room-colors-selectionindicatorbackground" tabindex="-1">room.colors.selectionIndicatorBackground <a class="header-anchor" href="#room-colors-selectionindicatorbackground" aria-label="Permalink to "room.colors.selectionIndicatorBackground""></a></h4><ul><li><strong>类型</strong>: <code>string[]</code></li><li><strong>默认值</strong>: <code>['#2563b8', '#26966b', '#7c3fb8', '#d97706']</code></li></ul><p>选择指示器背景颜色数组。</p><p>颜色索引与 <code>active</code> 对应，建议长度保持一致。</p><h4 id="room-colors-selectionindicatoricon" tabindex="-1">room.colors.selectionIndicatorIcon <a class="header-anchor" href="#room-colors-selectionindicatoricon" aria-label="Permalink to "room.colors.selectionIndicatorIcon""></a></h4><ul><li><strong>类型</strong>: <code>string[]</code></li><li><strong>默认值</strong>: <code>['#ffffff', '#ffffff', '#ffffff', '#ffffff']</code></li></ul><p>选择指示器图标颜色数组。</p><p>颜色索引与 <code>active</code> 对应，建议长度保持一致。</p><h4 id="room-colors-no-room-data" tabindex="-1">room.colors.NO_ROOM_DATA <a class="header-anchor" href="#room-colors-no-room-data" aria-label="Permalink to "room.colors.NO_ROOM_DATA""></a></h4><ul><li><strong>类型</strong>: <code>string</code></li><li><strong>默认值</strong>: <code>'#ebebeb'</code></li></ul><p>无房间数据区域的颜色 (点阵协议专用)。</p><h4 id="room-colors-room-gap" tabindex="-1">room.colors.ROOM_GAP <a class="header-anchor" href="#room-colors-room-gap" aria-label="Permalink to "room.colors.ROOM_GAP""></a></h4><ul><li><strong>类型</strong>: <code>string</code></li><li><strong>默认值</strong>: <code>'#ebebeb'</code></li></ul><p>房间间隙的颜色 (点阵协议专用)。</p><h4 id="room-colors-obstacle-room" tabindex="-1">room.colors.OBSTACLE_ROOM <a class="header-anchor" href="#room-colors-obstacle-room" aria-label="Permalink to "room.colors.OBSTACLE_ROOM""></a></h4><ul><li><strong>类型</strong>: <code>string</code></li><li><strong>默认值</strong>: <code>'#ebebeb'</code></li></ul><p>障碍物房间的颜色 (点阵协议专用)。</p><h4 id="room-colors-unknown-room" tabindex="-1">room.colors.UNKNOWN_ROOM <a class="header-anchor" href="#room-colors-unknown-room" aria-label="Permalink to "room.colors.UNKNOWN_ROOM""></a></h4><ul><li><strong>类型</strong>: <code>string</code></li><li><strong>默认值</strong>: <code>'#ebebeb'</code></li></ul><p>未知房间的颜色。对于结构化协议代表 <code>roomId >= 255</code> 的房间颜色。</p><h4 id="room-colors-version0-room" tabindex="-1">room.colors.VERSION0_ROOM <a class="header-anchor" href="#room-colors-version0-room" aria-label="Permalink to "room.colors.VERSION0_ROOM""></a></h4><ul><li><strong>类型</strong>: <code>string</code></li><li><strong>默认值</strong>: <code>''</code></li></ul><p>点阵地图协议版本0的房间颜色 (点阵协议专用)。</p><div class="tip custom-block"><p class="custom-block-title">版本兼容说明</p><p>此配置项用于控制地图协议版本0（未支持分区的协议版本）中房间的颜色。在之前的版本中，版本0的房间和无房间数据区域都使用 <code>NO_ROOM_DATA</code> 颜色。现已将版本0的房间单独拆分为 <code>VERSION0_ROOM</code>。</p><p>默认值为空字符串，此时将自动使用 <code>NO_ROOM_DATA</code> 的颜色，以保持向后兼容。如需区分显示，可配置为不同的颜色值。</p></div><h3 id="room-namelabel" tabindex="-1">room.nameLabel <a class="header-anchor" href="#room-namelabel" aria-label="Permalink to "room.nameLabel""></a></h3><p>房间名称标签配置。</p><h4 id="room-namelabel-fontsize" tabindex="-1">room.nameLabel.fontSize <a class="header-anchor" href="#room-namelabel-fontsize" aria-label="Permalink to "room.nameLabel.fontSize""></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="room-namelabel-fontfamily" tabindex="-1">room.nameLabel.fontFamily <a class="header-anchor" href="#room-namelabel-fontfamily" aria-label="Permalink to "room.nameLabel.fontFamily""></a></h4><ul><li><strong>类型</strong>: <code>string</code></li><li><strong>默认值</strong>: <code>'system-ui, -apple-system, sans-serif'</code></li></ul><p>房间名称字体名称。</p><h4 id="room-namelabel-fontweight" tabindex="-1">room.nameLabel.fontWeight <a class="header-anchor" href="#room-namelabel-fontweight" aria-label="Permalink to "room.nameLabel.fontWeight""></a></h4><ul><li><strong>类型</strong>: <code>TextStyleFontWeight</code></li><li><strong>默认值</strong>: <code>'500'</code></li></ul><p>房间名称字体粗细。</p><h3 id="room-type" tabindex="-1">room.type <a class="header-anchor" href="#room-type" aria-label="Permalink to "room.type""></a></h3><p>房间类型图标配置。</p><h4 id="room-type-assets" tabindex="-1">room.type.assets <a class="header-anchor" href="#room-type-assets" aria-label="Permalink to "room.type.assets""></a></h4><ul><li><strong>类型</strong>: <code>string[]</code></li><li><strong>默认值</strong>: <code>[内置资源, ...]</code></li></ul><p>房间类型图标资源数组。</p><p>数组索引对应 <code>RoomProperty.type</code> 值，即 <code>assets[type]</code> 显示该索引对应的图标。</p><p><strong>内置默认资源映射表：</strong></p><p>以下是内置默认图标与 <code>type</code> 值的对应关系：</p><table tabindex="0"><thead><tr><th style="text-align:left;">ID (索引)</th><th style="text-align:left;">房间类型</th></tr></thead><tbody><tr><td style="text-align:left;">0</td><td style="text-align:left;">通用/房间</td></tr><tr><td style="text-align:left;">1</td><td style="text-align:left;">客厅</td></tr><tr><td style="text-align:left;">2</td><td style="text-align:left;">餐厅</td></tr><tr><td style="text-align:left;">3</td><td style="text-align:left;">主卧</td></tr><tr><td style="text-align:left;">4</td><td style="text-align:left;">次卧/卧室</td></tr><tr><td style="text-align:left;">5</td><td style="text-align:left;">书房</td></tr><tr><td style="text-align:left;">6</td><td style="text-align:left;">厨房</td></tr><tr><td style="text-align:left;">7</td><td style="text-align:left;">卫生间</td></tr><tr><td style="text-align:left;">8</td><td style="text-align:left;">洗衣房</td></tr><tr><td style="text-align:left;">9</td><td style="text-align:left;">休息室</td></tr><tr><td style="text-align:left;">10</td><td style="text-align:left;">储物间</td></tr><tr><td style="text-align:left;">11</td><td style="text-align:left;">儿童房</td></tr><tr><td style="text-align:left;">12</td><td style="text-align:left;">阳光房</td></tr><tr><td style="text-align:left;">13</td><td style="text-align:left;">走廊</td></tr><tr><td style="text-align:left;">14</td><td style="text-align:left;">阳台</td></tr><tr><td style="text-align:left;">15</td><td style="text-align:left;">健身房</td></tr><tr><td style="text-align:left;">16</td><td style="text-align:left;">玄关</td></tr></tbody></table><p>当使用内置默认资源时，索引与房间类型的对应关系详见<a href="/guide/advanced-usage.html#房间类型图标">房间类型图标</a>。如果开发者通过此配置项自定义了数组，则映射关系完全取决于自定义数组的顺序。</p><div class="tip custom-block"><p class="custom-block-title">TIP</p><p>如果某个索引对应的资源为空字符串（<code>''</code>），则该类型的房间将不会显示任何图标。例如，通过设置 <code>assets[0] = ''</code> 可以隐藏 type 为 0 的房间图标。</p></div><h4 id="room-type-iconsize" tabindex="-1">room.type.iconSize <a class="header-anchor" href="#room-type-iconsize" aria-label="Permalink to "room.type.iconSize""></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="room-type-gap" tabindex="-1">room.type.gap <a class="header-anchor" href="#room-type-gap" aria-label="Permalink to "room.type.gap""></a></h4><ul><li><strong>类型</strong>: <code>number</code></li><li><strong>默认值</strong>: <code>4</code></li><li><strong>单位</strong>: <code>px</code></li></ul><p>图标与房间名称文字之间的间距。</p><h4 id="room-type-position" tabindex="-1">room.type.position <a class="header-anchor" href="#room-type-position" aria-label="Permalink to "room.type.position""></a></h4><ul><li><strong>类型</strong>: <code>'left' | 'right'</code></li><li><strong>默认值</strong>: <code>'left'</code></li></ul><p>图标相对于房间名称文字的显示位置。</p><h4 id="room-type-container" tabindex="-1">room.type.container <a class="header-anchor" href="#room-type-container" aria-label="Permalink to "room.type.container""></a></h4><p>房间类型图标背景容器配置。</p><h5 id="room-type-container-visible" tabindex="-1">room.type.container.visible <a class="header-anchor" href="#room-type-container-visible" aria-label="Permalink to "room.type.container.visible""></a></h5><ul><li><strong>类型</strong>: <code>boolean</code></li><li><strong>默认值</strong>: <code>true</code></li></ul><p>是否显示背景容器。</p><div class="tip custom-block"><p class="custom-block-title">TIP</p><ul><li><strong>颜色逻辑</strong>： <ul><li>当开启背景容器（<code>container.visible: true</code>）时，背景将填充为房间名称颜色（<code>room.colors.name</code>），图标将自动设置为白色（<code>tint: #ffffff</code>）。</li><li>当禁用背景容器（<code>container.visible: false</code>）时，图标将直接使用房间名称颜色（<code>room.colors.name</code>）。</li></ul></li><li><strong>最佳实践</strong>：为了实现自动换色效果，建议使用单色（通常为黑色或白色）的 SVG 资源。如果使用彩色 PNG 资源，建议将 <code>container.visible</code> 设为 <code>false</code> 以保持原色。</li></ul></div><h5 id="room-type-container-size" tabindex="-1">room.type.container.size <a class="header-anchor" href="#room-type-container-size" aria-label="Permalink to "room.type.container.size""></a></h5><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><h5 id="room-type-container-borderradius" tabindex="-1">room.type.container.borderRadius <a class="header-anchor" href="#room-type-container-borderradius" aria-label="Permalink to "room.type.container.borderRadius""></a></h5><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="room-property" tabindex="-1">room.property <a class="header-anchor" href="#room-property" aria-label="Permalink to "room.property""></a></h3><p>房间属性配置。</p><h4 id="room-property-displayorders" tabindex="-1">room.property.displayOrders <a class="header-anchor" href="#room-property-displayorders" aria-label="Permalink to "room.property.displayOrders""></a></h4><ul><li><strong>类型</strong>: <code>('cleanMode' | 'suction' | 'cistern' | 'cleanTimes' | string)[]</code></li><li><strong>默认值</strong>: <code>['cleanMode', 'suction', 'cistern', 'cleanTimes']</code></li></ul><p>房间属性显示顺序。</p><p>你也可以传入自定义的字段名，比如 <code>['cleanMode', 'suction', 'cistern', 'cleanTimes', 'customProperty1']</code>。</p><div class="tip custom-block"><p class="custom-block-title">TIP</p><p>如果要隐藏某个房间属性，比如 <code>cleanTimes</code>，那么清扫次数图标将不会显示。</p></div><h4 id="room-property-customassets" tabindex="-1">room.property.customAssets <a class="header-anchor" href="#room-property-customassets" aria-label="Permalink to "room.property.customAssets""></a></h4><ul><li><strong>类型</strong>: <code>Record<string, string[]></code></li><li><strong>默认值</strong>: <code>undefined</code></li></ul><p>自定义属性图标资源配置，</p><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:#24292E;--shiki-dark:#E1E4E8;">{</span></span>
|
|
170
170
|
<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> room</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: {</span></span>
|
|
171
171
|
<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> property</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: {</span></span>
|
|
172
172
|
<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> displayOrders</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: [</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">'cleanMode'</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">'suction'</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">'customProperty1'</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">'cistern'</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">'cleanTimes'</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">'customProperty2'</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">],</span></span>
|
|
@@ -207,7 +207,7 @@ import{_ as e,c as i,o as a,aq as t}from"./chunks/framework.CBLqO2Q1.js";const g
|
|
|
207
207
|
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> ],</span></span>
|
|
208
208
|
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> },</span></span>
|
|
209
209
|
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> },</span></span>
|
|
210
|
-
<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>
|
|
210
|
+
<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-deleteiconwrapperfillcolor" tabindex="-1">controls.carpet.deleteIconWrapperFillColor <a class="header-anchor" href="#controls-carpet-deleteiconwrapperfillcolor" aria-label="Permalink to "controls.carpet.deleteIconWrapperFillColor""></a></h4><ul><li><strong>类型</strong>: <code>ColorSource | undefined</code></li><li><strong>默认值</strong>: <code>'#ff4444'</code></li></ul><p>地毯删除按钮的图标容器填充颜色。未设置时回退到 <code>controls.carpet.iconWrapperFillColor</code>。</p><h4 id="controls-carpet-rotatemode" tabindex="-1">controls.carpet.rotateMode <a class="header-anchor" href="#controls-carpet-rotatemode" aria-label="Permalink to "controls.carpet.rotateMode""></a></h4><ul><li><strong>类型</strong>: <code>'step' | 'free'</code></li><li><strong>默认值</strong>: <code>'step'</code></li></ul><p>地毯旋转按钮交互模式。<code>step</code> 表示点击后顺时针旋转 90 度，<code>free</code> 表示按住拖动连续旋转。</p><h4 id="controls-carpet-scalemode" tabindex="-1">controls.carpet.scaleMode <a class="header-anchor" href="#controls-carpet-scalemode" aria-label="Permalink to "controls.carpet.scaleMode""></a></h4><ul><li><strong>类型</strong>: <code>'free' | 'ratioLocked'</code></li><li><strong>默认值</strong>: <code>'ratioLocked'</code></li></ul><p>地毯右下角缩放按钮交互模式。<code>ratioLocked</code> 表示等比缩放，同时显示横向和纵向辅助缩放按钮；<code>free</code> 表示宽高独立缩放，并隐藏辅助缩放按钮。</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>
|
|
211
211
|
<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>
|
|
212
212
|
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> customZoneTypes: {</span></span>
|
|
213
213
|
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> petCleanZone: {</span></span>
|
|
@@ -236,4 +236,4 @@ import{_ as e,c as i,o as a,aq as t}from"./chunks/framework.CBLqO2Q1.js";const g
|
|
|
236
236
|
<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>
|
|
237
237
|
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> },</span></span>
|
|
238
238
|
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> },</span></span>
|
|
239
|
-
<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>`,
|
|
239
|
+
<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>`,1348)])])}const k=e(s,[["render",l]]);export{g as __pageData,k as default};
|