Home Assistant 中 Xiaomi Miio 扫地机遥控移动动作vacuum_remote_control_move完整实战指南【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io本篇技术指南基于 home-assistant.io 仓库的官方动作文档 xiaomi_miio.vacuum_remote_control_move.markdown系统讲解如何在 Home Assistant 中通过xiaomi_miio.vacuum_remote_control_move动作遥控操纵小米扫地机器人包括前置的遥控模式开启、速度/转向/时长的参数语义与取值范围、UI 与 YAML 两种配置方式以及与 start / stop / move_step 等配套动作组成的完整遥控生命周期。读完本文你将掌握在自动化与脚本中编写可靠、可控的小米扫地机遥控指令的完整能力。动作概述它是做什么的xiaomi_miio.vacuum_remote_control_move是 Xiaomi Homexiaomi_miio集成专为小米扫地机器人提供的遥控移动动作。它的作用是在扫地机已经处于遥控模式时向其发送一次移动指令指定本次移动的速度velocity、转向rotation与持续时间duration。该动作属于xiaomi_miio集成在通用vacuum集成动作start、pause、stop、return_to_base、locate、set_fan_speed、send_command等之外额外提供的 Xiaomi 专属动作之一。根据集成文档 xiaomi_miio.markdown 的说明xiaomi_miio的 vacuum 平台还支持xiaomi_clean_zone、xiaomi_clean_segment、xiaomi_goto以及整套remote_control_*系列动作遥控移动正是其中一员。关键前提必须先进入遥控模式与普通的清扫指令不同遥控移动不是独立执行的动作。要使用vacuum_remote_control_move必须先通过 Vacuum remote control start 动作让扫地机进入遥控模式移动结束后再通过 Vacuum remote control stop 动作退出遥控模式。三者配合构成一次完整的遥控操控流程start让扫地机进入遥控模式停止当前清扫等待遥控指令move以指定速度、转向和时长执行一段移动可多次调用实现连续操控stop退出遥控模式恢复正常状态。如果你的场景只是单次移动一下然后停下则无需手动管理 start/stop可直接使用 Vacuum remote control move step 动作它会自动完成进入遥控模式 → 执行一次移动 → 停止的完整流程。方式一通过 UI自动化与脚本在 Home Assistant 的 UI 中配置该动作适用于不熟悉 YAML 的用户也是可视化自动化编辑器中推荐的方式。官方文档给出的步骤如下进入Settings设置Automations scenes自动化与场景打开一个已有的自动化或脚本也可以选择Create automation创建自动化Create new automation创建新自动化如果是新建自动化在When当…时部分添加触发条件脚本无需触发器它们在被其他内容调用时才运行在Then do然后执行部分选择Add action添加动作选择要控制的设备在By target按目标下详见下文动作的目标Targets选择要遥控的小米扫地机器人从该目标对应的动作列表中选择Vacuum remote control move扫地机遥控移动设置Velocity速度、Rotation转向和Duration持续时间三个参数点击Save保存。UI 中的参数选项UI 字段含义取值范围Velocity移动速度介于 -0.29 与 0.29 之间负值表示向后移动Rotation移动转向介于 -179 与 179 度之间Duration移动持续时间以毫秒为单位指定扫地机移动多久方式二通过 YAML自动化、脚本与开发者工具在 YAML 中该动作的名称写作xiaomi_miio.vacuum_remote_control_move。官方文档提供的基础示例如下action: xiaomi_miio.vacuum_remote_control_move target: entity_id: vacuum.xiaomi_vacuum data: velocity: 0.2 rotation: 0 duration: 1500这个示例会让vacuum.xiaomi_vacuum以 0.2 的速度向前移动 1.5 秒1500 毫秒。rotation: 0表示不转向、直线前进。YAML 参数详解根据官方文档的 options_yaml 定义三个参数均为可选required: false参数类型必填说明velocityfloat浮点数否移动速度取值范围 -0.29 ~ 0.29负值让扫地机后退rotationinteger整数否移动转向取值范围 -179 ~ 179 度durationinteger整数否移动持续时间单位为毫秒参数语义与实战要点velocity速度控制移动快慢。正值前进、负值后退。文档明确标注取值范围为-0.29 ~ 0.29超出该范围的取值不受官方文档支持。后退操控常用于倒车微调位置例如配合转向实现原地掉头后倒回。rotation转向控制运动方向单位为度范围-179 ~ 179。正值与负值分别对应顺时针/逆时针旋转方向以实际设备表现为准0表示直线移动。可用它实现原地转向velocity: 0 非零rotation、弧线前进速度与转向同时非零等轨迹。duration持续时间以毫秒为单位。示例中的1500即 1.5 秒。由于该动作只执行一段移动连续操控时需要多次调用并自行编排每次的时长。一个典型的转向后前进脚本示例结合 start/move/stop 的完整流程alias: Xiaomi vacuum remote control demo sequence: - action: xiaomi_miio.vacuum_remote_control_start target: entity_id: vacuum.xiaomi_vacuum - action: xiaomi_miio.vacuum_remote_control_move target: entity_id: vacuum.xiaomi_vacuum data: velocity: 0 rotation: 90 duration: 800 - action: xiaomi_miio.vacuum_remote_control_move target: entity_id: vacuum.xiaomi_vacuum data: velocity: 0.2 rotation: 0 duration: 2000 - action: xiaomi_miio.vacuum_remote_control_stop target: entity_id: vacuum.xiaomi_vacuum这个脚本让扫地机先原地转向 90 度约 0.8 秒再以 0.2 速度直线前进 2 秒最后退出遥控模式。其中每段移动的位移与角度取决于实际设备的机械参数需要在实际设备上标定调整。动作的目标Targets与大多数 Home Assistant 动作一样vacuum_remote_control_move必须指定目标target。目标就是动作作用的对象根据 targets.md 说明你可以将动作指向单个实体、设备、区域、楼层或标签Home Assistant 会对其背后的每一个匹配的vacuum实体执行该动作实体Entity某一个具体的vacuum实体例如vacuum.living_room设备Device属于某台设备的所有vacuum实体区域Area某个房间/区域内的所有vacuum实体楼层Floor某个楼层上的所有vacuum实体标签Label共享某个标签的所有vacuum实体。你还可以在一次动作中混用不同类型的目标例如同时指定一个具体实体和一个区域让动作同时作用于两者。与配套动作的对比move vs. move step遥控系列共包含四个动作理解它们的差异有助于选择正确的组合动作是否自动进入遥控模式是否自动退出遥控模式适用场景vacuum_remote_control_start是仅进入否遥控会话的起点vacuum_remote_control_move否否遥控会话中的连续移动指令vacuum_remote_control_stop否是仅退出遥控会话的终点vacuum_remote_control_move_step是是单次移动即结束如 move_step 文档 所述move step会让扫地机进入遥控模式、执行一次移动、然后停止你无需单独管理 start 和 stop而move则需要你自行先调用 start、再调用 stop。需要说明的是move_step 与 move 拥有完全相同的三个参数velocity、rotation、duration及相同的取值范围。如果你的目标是长按摇杆式连续操控例如配合手柄、摇杆 UI 或按键宏用start → 多次 move → stop如果只是按一下动一下用move step更简洁。集成前提与注意事项xiaomi_miio.vacuum_remote_control_move依赖 Xiaomi Home 集成的 vacuum 平台使用前需确认以下前提详见 xiaomi_miio.markdown 的 Prerequisites 与 Troubleshooting 部分扫地机需通过Mi Home 应用完成绑定而非厂商专用应用例如 Roborock 应用集成建议在配置时提供 Xiaomi Home 账号凭据以自动连接设备并需指定与 Mi Home App 中一致的服务器区域cn、de、i2、ru、sg、us六个服务器之一若设备位于不同子网/VLANUDP 包的源地址可能导致设备无法发现或通信异常需要参考集成的跨子网排查说明部分连接异常如间歇性超时与设备内部软件挂起、看门狗重启有关阻断设备网络访问是已知的诱发因素。如果动作调用后扫地机没有按预期移动建议按以下顺序排查确认设备已处于遥控模式先调用 start、确认velocity/rotation取值在文档范围内、确认目标实体 ID 正确、查看 Home Assistant 日志中该动作的报错信息。总结xiaomi_miio.vacuum_remote_control_move是 Home Assistant 中操控小米扫地机器人的核心遥控动作配合 start/stop 可实现对扫地机速度、转向与时长的精细化手动控制配合 move step 可实现一键式单步移动。三个参数velocity-0.29~0.29、rotation-179~179、duration毫秒语义清晰既可在 UI 中可视化配置也可在 YAML 中直接编写适用于自动化脚本、手动遥控面板以及各种自定义操控场景。相关动作的完整官方文档可在仓库的 source/_actions 目录下查阅xiaomi_miio.vacuum_remote_control_start.markdown、xiaomi_miio.vacuum_remote_control_stop.markdown、xiaomi_miio.vacuum_remote_control_move_step.markdown集成层面的设备支持范围与故障排查细节参见 source/_integrations/xiaomi_miio.markdown。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考