Valetudo机器人能力全解析：从基础控制到高级功能

Valetudo机器人能力全解析：从基础控制到高级功能

Valetudo Cloud replacement for vacuum robots enabling local-only operation 项目地址: https://gitcode.com/gh_mirrors/va/Valetudo

前言

Valetudo作为一款开源的机器人控制平台，其核心设计理念是通过"能力(Capabilities)"系统来统一管理不同品牌、型号机器人的功能差异。本文将全面解析Valetudo支持的各种机器人能力，帮助用户更好地理解和使用这些功能。

能力系统设计理念

Valetudo采用能力抽象层来屏蔽不同厂商设备的实现差异。这种设计使得：

1. 开发者可以专注于功能实现而非设备兼容性
2. 用户界面保持一致性，不受底层设备影响
3. 新设备只需实现对应能力接口即可获得完整支持

基础控制能力

基本控制能力(BasicControlCapability)

这是所有支持Valetudo的机器人必须具备的基础能力，包含四个核心操作：

• 启动清洁：开始执行清洁任务
• 暂停：临时中断当前任务
• 停止：终止当前任务（部分设备可能用暂停代替）
• 回充：返回充电座

清洁控制相关能力

吸力控制(FanSpeedControlCapability)

允许调节机器人吸力强度，通常提供多个预设档位（如静音、标准、强力等）。

地毯模式控制(CarpetModeControlCapability)

当机器人检测到地毯时自动提升吸力，此功能可在此开启或关闭。

地毯传感器模式(CarpetSensorModeControlCapability)

配备超声波等传感器的机器人可提供更智能的地毯处理方式：

• 忽略地毯直接通过
• 避开地毯区域
• 抬起拖布模块（针对扫拖一体机型）

地图与导航能力

地图分段(MapSegmentationCapability)

将地图划分为逻辑区域（通常称为"房间"），支持：

• 按区域清洁
• 区域合并与分割(MapSegmentEditCapability)
• 区域重命名(MapSegmentRenameCapability)

区域清洁(ZoneCleaningCapability)

允许用户在地图上划定特定区域进行定点清洁。

定位导航(GoToLocationCapability)

指挥机器人移动到地图指定位置，常用于：

• 前往垃圾桶位置
• 移动到特定房间

碰撞避免调节(CollisionAvoidantNavigationControlCapability)

在"彻底清洁"和"减少碰撞"之间进行平衡设置。

基站相关能力

自动集尘控制(AutoEmptyDockAutoEmptyControlCapability)

设置机器人完成任务后是否自动清空尘盒。

手动集尘触发(AutoEmptyDockManualTriggerCapability)

随时手动清空尘盒。

拖布清洁(MopDockCleanManualTriggerCapability)

拖布烘干(MopDockDryManualTriggerCapability)

控制扫拖一体机型的拖布清洁和烘干功能。

高级功能

操作模式选择(OperationModeControlCapability)

切换工作模式：

• 仅扫地
• 仅拖地
• 扫拖同时

水量控制(WaterUsageControlCapability)

调节拖地时的出水量。

勿扰模式(DoNotDisturbCapability)

设置免打扰时段，期间：

• 暂停低电量续扫
• 降低LED亮度
• 减少提示音

障碍物避免(ObstacleAvoidanceControlCapability)

启用/禁用AI障碍物检测功能。

宠物排泄物检测(PetObstacleAvoidanceControlCapability)

专门针对宠物排泄物的检测功能，可关闭以减少误报。

实用工具

定位发声(LocateCapability)

让机器人播放声音方便寻找。

手动遥控(ManualControlCapability)

像遥控车一样手动控制机器人移动。

语音包管理(VoicePackManagementCapability)

更换机器人语音提示包。

音量控制(SpeakerVolumeControlCapability)

调节机器人提示音量。

统计与维护

耗材监控(ConsumableMonitoringCapability)

查看并重置滤网、边刷等耗材的使用状态。

当前统计(CurrentStatisticsCapability)

显示本次清洁的数据：

• 清洁面积
• 运行时间

历史统计(TotalStatisticsCapability)

累计清洁数据（可能因恢复出厂设置而清零）。

特殊功能

特性配置(QuirksCapability)

针对特定机型/固版的专属设置项，作为标准能力的补充。

Wi-Fi配置(WifiConfigurationCapability)

查看和修改机器人的Wi-Fi连接设置。

结语

通过Valetudo的能力系统，用户可以获得统一的设备控制体验，同时又能充分利用各机型特有的高级功能。理解这些能力将帮助您更好地配置和使用您的清洁机器人。

建议用户根据自己设备的实际支持情况，合理搭配使用这些功能，以获得最佳的清洁体验。

Valetudo Cloud replacement for vacuum robots enabling local-only operation 项目地址: https://gitcode.com/gh_mirrors/va/Valetudo