实体
该集成暴露了几乎所有可用的设置和状态，这些都是从官方应用中反向工程得到的。每个特定设备都会动态生成实体；如果某个设备缺少特定硬件功能或属性，则不会将相应的实体添加到 Home Assistant。
大多数实体，包括主要的吸尘器实体，都配有动态图标，以反映其当前状态。如果需要，可以在实体设置中覆盖这些图标。此外，大多数传感器实体和所有选择实体在 raw_value、map_id 或 segment_id 属性下返回其原始整数值，这简化了它们在自动化和服务中的使用。
对所有实体应用动态刷新率，该刷新率由其预期变化频率和当前设备状态决定。Home Assistant 仅在通过监听器检测到属性更新时才会获知变化，其功能类似于本地推送方式。
状态同步延迟
实体可能需要一些时间才能反映在官方应用中直接进行的更改。当使用本地或米家连接方式时，这种延迟是预期内的，因为它们依赖于周期性的数据轮询，而不是其他连接方式使用的即时云推送通知。
某些实体具有与其他实体状态相关的自定义可用性规则，这些规则反映了从官方应用提取的逻辑。例如，当水箱或拖布未安装时，tight_mopping 开关将变为不可用。通过云连接的实体也可以用于访问存储在特定地图数据中的设置，而不是设备本身，例如 map_rotation。
实体可用性和固件限制
某些实体在固件版本较旧的设备上可能不可用，例如 customized_cleaning 和 cleaning_mode。此外，某些实体默认被禁用，其他实体可以直接通过吸尘器实体的属性访问。
所有生成的实体遵循标准命名规范：
[domain].[vacuum name]_[entity name] （例如， switch.l10s_gen2_resume_cleaning)
开关
| 名称 | 描述 | 备注 |
|---|---|---|
resume_cleaning | 启用/禁用继续清洁功能 | 吸尘器实体在清洁继续充电前返回其状态为 paused |
carpet_boost | 启用/禁用地毯增强功能 | |
carpet_recognition | 启用/禁用识别功能 | 适用于带超声波传感器的吸尘器 |
obstacle_avoidance | 启用/禁用3D障碍物规避 | 适用于带有激光线的吸尘器 |
customized_cleaning | 启用/禁用自定义房间清洁 | 适用于固件高于1056的设备 |
child_lock | 启用/禁用儿童锁 | |
tight_mopping | 启用/禁用紧凑拖地模式 | 适用于固件高于1056且在未安装水箱或拖布时不可用的设备 |
dnd | 启用/禁用免打扰模式 | |
multi_floor_map | 启用/禁用多楼层地图 | 适用于可存储多张地图的吸尘器 |
auto_dust_collecting | 启用/禁用完成清洁自动集尘 | 适用于带自动倒灰站的吸尘器 |
self_clean | 启用/禁用自动自清洁功能 | 适用于带自清洗底座的吸尘器 |
self_clean_by_zone | 在清洁特定区域后自动清洁拖布垫 | 适用于具有按区域自清洁功能的设备 |
auto_drying | 启用/禁用清洁完成后拖布的自动干燥 | 适用于带自清洗底座的吸尘器 |
water_electrolysis | 启用/禁用水电解功能 | 适用于具有水电解功能的吸尘器 |
auto_water_refilling | 启用/禁用自清洁底座的外部进水 | 适用于具有自清洁底座和外部进水的吸尘器 |
auto_mount_mop | 启用/禁用根据所选清洁模式自动装配和拆卸拖布垫 | 适用于具有自动拖布装配功能的吸尘器 |
carpet_avoidance | 拖布垫附着时避免清洁地毯 | 适用于具有拖布提升功能的吸尘器 |
auto_add_detergent | 使用清洁剂盒清洁拖布垫 | 适用于具有自清洁底座和清洁剂盒的吸尘器 |
auto_charging | 自动返回充电底座进行充电 | 适用于具有自动充电功能的设备 |
map_saving | VSLAM设备的地图保存模式设置 | 适用于没有激光雷达导航的吸尘器 |
ai_obstacle_detection | 启用/禁用 AI 障碍物检测 | 适用于 S10 和 L10s 型号 |
ai_obstacle_image_upload | 启用/禁用上传障碍物图片到云端 | 适用于带前置摄像头的设备 |
ai_obstacle_picture | 启用/禁用障碍物图片显示 | 适用于带前置摄像头的设备 |
ai_pet_detection | 启用/禁用 AI 宠物检测 | 适用于带前置摄像头的设备 |
ai_human_detection | 启用/禁用 AI 人类检测 | 适用于 S10 和 S10 Pro |
ai_furniture_detection | 启用/禁用 AI 家具检测 | 适用于带前置摄像头的设备 |
ai_fluid_detection | 启用/禁用 AI 液体检测 | 适用于带前置摄像头的设备 |
fill_light | 打开后，在光线较暗的环境中会自动补光，以提高避障能力和视频清晰度 | 适用于带前置摄像头和前置灯的设备 |
collision_avoidance | 打开后，与墙壁、家具和障碍物碰撞减少，但清洁效率和覆盖范围略有下降 | 适用于具备此功能的设备 |
stain_avoidance | 打开后，当识别到污渍时，会避开该区域不进行清洁 | 在具有 AI 液体检测功能的设备上可用 |
intelligent_recognition | 启用/禁用多楼层地图启用时的自动地图切换 | 在具有 WiFi 地图功能的设备上可用 |
cleaning_sequence | 启用/禁用自定义房间清扫顺序 | 在具有地图功能时可用（这是动态创建的实体，并不直接关联任何设置。关闭时，当前清扫顺序将被删除并重新生成默认顺序，重新开启时可从记忆中恢复之前的顺序） |
voice_assistant | 启用/禁用吸尘器内置语音助手 | 在具有语音助手功能的设备上可用 |
fuzzy_obstacle_detection | 允许吸尘器检测并避开模糊或不明显的障碍物 | 在具有 AI 模糊障碍物检测的设备上可用 |
ai_pet_avoidance | 使用 AI 摄像头识别并主动避开清扫中的宠物 | 在具有宠物侦测功能的设备上可用 |
pet_picture | 自动捕捉清扫过程中遇到的宠物照片 | 在具有宠物侦测功能的设备上可用 |
pet_focused_detection | 优先检测宠物及与宠物相关的物品 | 适用于具有宠物家具功能的设备 |
floor_direction_cleaning | 沿地板板条方向清洁以防刮伤 | 适用于具有地板方向清洁功能的设备 |
pet_focused_cleaning | 检测到宠物时调整清洁策略 | 在具有宠物侦测功能的设备上可用 |
smart_charging | 计算完成清洁所需的精确电量并继续清洁 | 适用于具有自动充电功能的设备 |
human_follow | 允许吸尘器通过摄像头跟随人 | 适用于具有拖布摆动和摄像头直播功能的设备 |
max_suction_power | 启用最大吸力模式进行深度清洁 | 适用于具有最大吸力功能的设备 |
smart_drying | 根据环境湿度自动调整干燥时间 | 适用于具有智能干燥功能的设备 |
hot_washing | 使用热水在基站清洗拖布 | 适用于具有热水清洗但无智能拖布清洗功能的设备 |
uv_sterilization | 为拖布或水箱启用紫外线消毒 | 适用于具有紫外线消毒功能的设备 |
camera_light_brightness_auto | 自动调节内置摄像头补光灯的亮度 | 适用于具有摄像头直播和补光功能的设备 |
off_peak_charging | 仅在电费低峰时段安排吸尘器充电 | 适用于具有低峰充电功能的设备 |
mopping_under_furnitures | 伸展拖布以彻底清洁低矮家具下方 | 适用于具有拖布摆动增强功能的设备 |
gap_cleaning_extension | 将拖布伸入狭小缝隙和边缘 | 适用于具有拖布摆动增强功能的设备 |
intensive_carpet_cleaning | 提高吸力并针对地毯调整清洁模式 | 适用于具有强化地毯清洁功能的设备 |
large_particles_boost | 检测到大颗粒垃圾时暂时提升吸力 | 适用于具有大颗粒增强功能的设备 |
ultra_clean_mode | 对整个区域进行高强度清洁 | 适用于具有超净模式但没有智能拖布清洗功能的设备 |
streaming_voice_prompt | 在摄像头直播时启用语音提示 | 适用于具有摄像头直播功能的设备 |
clean_carpets_first | 在清扫硬地之前优先清理铺有地毯的区域 | 适用于具有“先清理地毯”功能的设备 |
silent_drying | 在拖布干燥过程中减少噪音 | 适用于具有“静音干燥”功能的设备 |
hair_compression | 自动压缩尘盒中的收集毛发以节省空间 | 适用于具有“毛发压缩”功能的设备 |
side_brush_carpet_rotate | 在过渡到地毯时调整侧扫刷的旋转行为 | 适用于具有“侧刷地毯旋转”功能的设备 |
side_reach | 伸展侧扫刷以更好地清扫边缘 | 适用于具有“侧边延伸”功能的设备 |
smart_mop_washing | 根据拖布脏污程度动态调整拖布清洗时间 | 适用于具有“智能拖布清洗”功能的设备 |
dnd_disable_resume_cleaning | 在勿扰模式期间防止吸尘器恢复暂停的清洁任务 | 适用于具有勿扰功能的设备 |
dnd_disable_auto_empty | 在勿扰模式期间防止基站自动清空尘盒 | 适用于具有勿扰功能的设备 |
dnd_reduce_volume | 在免打扰时间降低吸尘器的语音提示音量 | 适用于具有勿扰功能的设备 |
auto_change_mop | 根据清洁需求自动弹出和安装不同的拖布 | 适用于具有自动更换拖布功能的设备 |
lift_chassis_on_carpet | 提起吸尘器的主机以更好地应对高绒地毯 | 适用于具有地毯自动抬升功能的设备 |
close_roller_cover_on_carpet | 关闭主滚刷盖以防止其在地毯上卡住 | 适用于具有滚刷盖功能的设备 |
dust_bag_drying | 使用热风干燥基座内的灰尘袋 | 适用于具有手动灰尘袋干燥功能的设备 |
ring_light_always_on | 保持吸尘器的指示环灯常亮 | 适用于具有指示环常亮功能的设备 |
active_suspension_crossing | 使用主动悬挂提高吸尘器以越过高门槛或障碍物 | 适用于具有主动悬挂功能的设备 |
dynamic_obstacle_cleaning | 动态调整清洁路径以绕过新检测到的障碍物 | 适用于具有动态障碍清洁功能的设备 |
pressurized_cleaning | 对拖布垫施加向下压力以更好去除污渍 | 适用于具有加压清洁功能的设备 |
lds_state | 切换LDS（激光测距传感器）模块的抬起状态 | 适用于具有自动LDS抬起功能的设备 |
mop_washing_with_detergent | 清洗拖布垫时自动将清洁剂混入水中 | 适用于具有自动加清洁剂和拖布使用清洁剂功能的设备 |
mop_extend | 延伸拖布垫以更好覆盖边缘 | 适用于具有拖布延展功能的设备 |
mopping_with_detergent | 自动向水箱中添加清洁剂以进行拖地 | 适用于具有拖布使用清洁剂功能的设备 |
obstacle_crossing | 协调轮子和悬挂以跨越难以清理的障碍物 | 适用于具有障碍物跨越功能的设备 |
传感器
| 名称 | 描述 | 备注 |
|---|---|---|
cleaning_time | 上一次/当前清洁任务的清洁时长 | 快速地图绘制期间不可用 |
mapping_time | 当前快速地图绘制任务的地图绘制时长 | 仅在机器人快速映射时可用 |
cleaned_area | 上一次/当前清洁任务的清洁区域 | 快速地图绘制期间不可用 |
state | 机器人的状态 | 该实体暴露了 Home Assistant 中本身不具备的机器人状态，例如 charging_completed |
status | 机器人的状态 | |
relocation_status | 机器人的重新定位状态 | |
task_status | 机器人的任务状态 | |
water_tank | 机器人的水箱状态 | 可用于带水箱的吸尘器 |
mop_pad | 机器人的水拖布垫状态 | 适用于带自清洗底座的吸尘器 |
dust_collection | 吸尘器集尘能力状态 | 适用于带自动倒灰站的吸尘器 |
auto_empty_status | 自动清空底座状态 | 适用于带自动倒灰站的吸尘器 |
self_wash_base_status | 自清洁底座状态 | 适用于带自清洗底座的吸尘器 |
error | 机器人的故障代码说明 | 错误报告 |
charging_status | 机器人的充电状态 | |
battery_level | 机器人的电池电量 | |
first_cleaning_date | 首次清扫日期 | |
total_cleaning_time | 总清洁时长 | |
cleaning_count | 总清洁次数 | |
total_cleaned_area | 累计清扫面积 | |
stream_status | 实时摄像头视频流的当前状态（例如，空闲、正在直播） | 适用于具有摄像头直播功能的设备 |
drainage_status | 底座水排系统的当前状态 | 可用于带水检测功能的设备 |
low_water_warning | 指示底座的清水箱是否水量不足 | 可用于带自清洗底座的设备 |
task_type | 当前正在执行的任务类型（例如，清洁、回充、洗涤） | 适用于具有任务类型功能的设备 |
firmware_version | 吸尘器上安装的当前固件版本 | |
cleaning_progress | 当前清洁任务的完成百分比 | 适用于具有清洁进度功能的设备 |
drying_progress | 当前拖布干燥周期的完成百分比 | 可用于带自清洗底座的设备 |
dust_bag_drying_status | 尘袋干燥过程的当前状态（例如，干燥、空闲） | 可用于带手动或自动集尘袋干燥功能的设备 |
clean_water_tank_status | 基座中清水箱的当前状态和水位 | 可用于带自清洗底座的设备 |
dirty_water_tank_status | 基座中污水箱的当前状态和水位 | 可用于带自清洗底座的设备 |
dust_bag_status | 集尘袋的当前状态（例如，存在、已满、缺失） | 适用于具有自动倒空功能的设备 |
detergent_status | 基座中洗涤剂盒的当前状态 | 可用于带自清洗底座的设备 |
hot_water_status | 拖布洗涤用热水器的当前温度或状态 | 适用于具有热洗功能的设备 |
station_drainage_status | 自动接水排水系统的当前状态 | 可用于具有排水功能的设备 |
耗材传感器实体
耗材传感器实体会动态生成，用于报告各种设备部件和配件的剩余寿命或剩余时间。
关于耗材实体的更多信息
地图传感器实体 地图支持
地图传感器实体从已保存的地图动态生成，用于报告与地图相关的状态。
关于地图实体的更多信息
二进制传感器
| 名称 | 描述 | 备注 |
|---|---|---|
charging_state | 指示吸尘器当前是否在基座充电 | |
roller_cover_status | 指示主滚刷盖是否正确安装或关闭 | 适用于具有滚刷盖功能的设备 |
lds_status | 指示LDS（激光距离传感器）模块是否处于抬起位置 | 适用于具有自动LDS抬起功能的设备 |
数量
| 名称 | 描述 | 备注 |
|---|---|---|
volume | 音量级别 | |
mop_cleaning_remainder | 清洗拖布提醒 | |
camera_light_brightness | 相机补光灯的目标亮度级别 | 适用于具有摄像头直播和补光功能的设备 |
self_clean_area | 清洁指定面积（平方米）后返回清洗拖把 | 可用于具有自清洗基座但没有拖布清洁频率功能的设备 |
self_clean_time | 指定清洁时间（以分钟为单位），在返回洗拖把之前 | 适用于具有自清洁频率但没有拖把清洁频率功能的设备 |
wetness_level | 拖把垫在拖地过程中的目标湿度 | 适用于具有湿度等级功能的设备 |
drying_time | 指定拖把垫干燥时间（以小时为单位） | 适用于具有自洗底座和拖把清洁频率或长时间干燥功能的设备 |
auto_empty_area | 指定清洁面积，以便返回清空尘盒 | 适用于具有自动清空区域和模式功能的设备 |
时间
| 名称 | 描述 | 备注 |
|---|---|---|
dnd_start | 勿扰开始 | 禁用勿扰时不可用 |
dnd_end | 勿扰结束 | 禁用勿扰时不可用 |
off_peak_charging_start | 非高峰电价充电开始时间 | 适用于具有低峰充电功能的设备 |
off_peak_charging_end | 非高峰电价充电结束时间 | 适用于具有低峰充电功能的设备 |
按键
| 名称 | 描述 | 备注 |
|---|---|---|
start_auto_empty | 开始自动清空 | 适用于带自动倒灰站的吸尘器 |
clear_warning | 清除告警 | 没有清理警告时不可用 |
self_clean | 手动开始/暂停拖把清洗 | 适用于带自洗底座的吸尘器，不可清洗时不可用 |
manual_drying | 手动开始/停止拖把干燥 | 适用于带自清洗底座的吸尘器，当无法干燥时不可用 |
manual_dust_bag_drying | 手动触发或停止集尘袋干燥过程 | 可用于带手动或自动集尘袋干燥功能的设备 |
water_tank_draining | 触发底座站排放其内部水管 | 可用于具有排水功能的设备 |
base_station_self_repair | 触发底座站的自检和维修程序 | 可用于带自清洗底座的设备 |
start_recleaning | 命令吸尘器从头开始重新启动上一次清洁任务 | 适用于具有自动重新清洁和地图功能的设备 |
empty_water_tank | 命令吸尘器完全清空其机载水箱 | 适用于具有水箱排放功能的设备 |
base_station_cleaning | 触发底座站的洗板自清洁程序 | 适用于具有底座清洁功能的设备 |
reload_shortcuts | 从吸尘器重新加载已保存的清洁快捷方式 | 适用于具有快捷方式功能的设备 |
shortcut_{1-33} | 执行特定的已保存清洁快捷方式 | 适用于具有快捷方式功能的设备 |
消耗品按钮实体
消耗品按钮实体用于在更换或清洁设备部件和配件后重置其剩余寿命。
关于耗材实体的更多信息
地图按钮实体 地图支持
地图按钮实体用于触发地图功能或与已保存的地图进行交互。
关于地图实体的更多信息
选择
| 名称 | 描述 | 备注 |
|---|---|---|
suction_level | 吸尘器的吸力等级 | 如果启用了自定义清扫且当前任务不是区域清扫或定点清扫，则不可用 |
water_volume | 吸尘器的水量 | 适用于带水箱的吸尘器。如果启用了自定义清扫且当前任务不是区域清扫或定点清扫，则不可用 |
mop_pad_humidity | 拖地垫的湿度等级 | 适用于带自清洁底座的吸尘器。如果启用了自定义清扫且当前任务不是区域清扫或定点清扫，则不可用 |
cleaning_mode | 吸尘器的清扫模式（扫地、拖地、扫拖一体） | 清扫过程中不可用。 （选项对于没有可升降拖地垫的吸尘器动态生成） |
carpet_sensitivity | 地毯增强功能的地毯敏感度 | 当地毯增强被禁用时不可用 |
auto_empty_frequency | 自动清空频率 | 当自动集尘被禁用或不可用时不可用 |
self_clean_area | 在返回清洁拖布前选择清洁区域 | 适用于带自清洗底座的吸尘器 |
mop_wash_level | 拖把清洁用水量 | 适用于具有自清洁底座和外部进水的吸尘器 |
drying_time | 拖把干燥时间（分钟） | 适用于带自清洗底座的吸尘器 |
mopping_type | 深度清洁或日常清洁的拖地类型 | 适用于具有 AI 液体和污渍检测功能的吸尘器 |
wider_corner_coverage | 倒退进入角落以用拖布清洁的频率 | 适用于没有拖布摆动和拖布清洁频率功能的设备 |
mop_pad_swing | 摆动吸尘器后部以用拖布清洁边缘的频率 | 适用于具有拖布摆动但没有拖布延伸功能的设备 |
voice_assistant_language | 吸尘器内置语音助手使用的语言 | 在具有语音助手功能的设备上可用 |
auto_empty_mode | 用于确定何时自动清空尘盒的逻辑 | 适用于具有自动清空模式功能的设备 |
cleangenius | 启用房间清洁和拖地设置的自动智能 | 适用于具有 CleanGenius 功能的设备 |
auto_rewashing | 根据污垢程度决定拖布是否需要二次清洗的逻辑 | 可用于具有自动重新清洗功能的设备 |
auto_recleaning | 决定严重脏污区域是否需要第二次清洁的逻辑 | 可用于具有自动重新清洁功能的设备 |
cleaning_route | 清洁过程中使用的导航模式（例如，标准、深度、快速） | 可用于具有清洁路线功能的设备 |
custom_mopping_route | 开启拖地功能时特定使用的导航模式 | 可用于具有自定义拖地路线功能的设备 |
self_clean_frequency | 触发返回拖布清洗的条件（区域、时间或房间） | 可用于具有自清洁频率功能的设备 |
mop_clean_frequency | 基于所选自清洁频率模式的具体频率值 | 可用于具有自洗底座和拖布清洁频率功能的设备 |
mop_extend_frequency | 基于所选拖布延长模式的具体频率值 | 适用于具有拖布延展功能的设备 |
cleangenius_mode | CleanGenius 自动清洁模式的强度等级 | 可在具有CleanGenius模式功能的设备上使用 |
washing_mode | 底座擦地机清洗周期的强度 | 适用于具有“智能拖布清洗”功能的设备 |
water_temperature | 用于清洗拖把垫的水的目标温度 | 可在具有水温功能的设备上使用 |
mop_pressure | 施加到拖把垫上的下压力度 | 在具有拖把压力功能的设备上可用 |
mop_temperature | 清洁过程中拖把垫的目标温度 | 在具有拖把温度功能的设备上可用 |
low_lying_area_frequency | 专门清洁低矮家具下方的频率 | 可在具有低位区域频率功能的设备上使用 |
scraper_frequency | 使用刮刀工具的频率（如适用） | 可在具有刮刀频率功能的设备上使用 |
battery_charge_level | 在恢复清洁任务前充电至的目标电量百分比 | |
auto_lds_coverage | 在狭小空间中抬起LDS传感器的覆盖设置 | 适用于具有自动LDS抬起功能的设备 |
为房间选择实体 地图支持
房间选择实体是从已保存地图动态生成的，用于编辑每个房间的自定义清洁设置。
有关定制清洁功能的更多信息
选择地图实体 地图支持
地图选择实体用于与已保存的地图进行交互。
关于地图实体的更多信息
摄像头 地图支持
只有在使用云连接时，摄像头实体才可用，并用于渲染实时地图和已保存的地图。