實體
該整合幾乎暴露了所有可用的設定和從官方應用逆向工程得出的狀態。實體會為每個特定設備動態生成；如果設備缺少某個硬體功能或屬性，對應的實體將不會被添加到 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 升降功能的裝置 |
房間選擇實體 地圖支援
房間選擇實體是從已儲存地圖動態生成的，用於編輯每個房間的自定義清掃設置。
有關自訂清潔功能的更多資訊
選擇地圖的實體 地圖支援
地圖選擇實體用於與已保存的地圖互動。
有關地圖實體的更多資訊
攝影機 地圖支援
只有在使用雲端連接時，攝像頭實體才可用，並用於呈現實時地圖和已保存的地圖。