Home Assistant 使用 xiaomi_miio.switch_set_power_mode 设置小米插线板电源模式【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io导读xiaomi_miio.switch_set_power_mode是 Home Assistant 中 xiaomi_miio 集成 提供的动作action用于在支持的米家 Wi-Fi 插线板上设置电源模式Power Mode即在节能的green绿色/节能模式与默认的normal普通模式之间切换。本篇文章完整讲解该动作的适用设备、UI 配置步骤、YAML 写法、参数说明与底层实现依据读完即可在自动化与脚本中直接使用。一、动作概述与适用设备该动作用于设置小米插线板的电源模式。需要注意的是它只对支持电源模式的插线板生效。根据 xiaomi_miio 集成文档 的说明小米智能插线板Xiaomi Smart Power Strip支持的型号为qmi.powerstrip.v1与zimi.powerstrip.v2其中Power Modegreen / normal仅在 Power Strip V1 上可用qmi.powerstrip.v1插线板的能力包括电源开/关、Wi-Fi LED 开/关、Power Price0...999、Power Modegreen、normal以及温度、电流、负载功率、Wi-Fi LED、Mode 等属性其中 Mode 属性同样仅 Power Strip V1 支持。也就是说如果你使用的插线板型号不支持电源模式例如 Power Strip V2调用该动作不会产生预期效果。在配置前请先确认设备型号。该动作与另一个动作 xiaomi_miio.switch_set_power_price设置插线板上存储的电价用于计算能耗成本配套使用二者均针对支持的小米插线板在集成文档的 Actions 小节 中被一并列出集成会为插线板提供切换 Wi-Fi LED、设置电源模式与设置电价的多个动作。二、在 UI 中使用该动作如果你倾向于用可视化方式构建自动化和脚本Home Assistant 会逐步引导你完成配置选择目标实体、微调选项并保存全程无需 YAML 知识。在自动化或脚本中设置电源模式的步骤如下进入Settings设置Automations scenes自动化与场景打开一个现有的自动化或脚本或者选择Create automation创建自动化Create new automation创建新自动化如果正在创建新自动化在When何时部分添加一个触发条件脚本则不需要触发器它们在被其他东西调用时运行在Then do然后执行部分选择Add action添加动作在搜索框中搜索并选择Xiaomi Home: Switch set power mode选择要设置的Mode模式选择Save保存。该动作不支持 targets目标实体批量指定。在 UI 中使用Entity ID字段来选择要对哪台小米插线板执行操作如果留空则动作会应用到所有此类插线板。UI 选项一览选项说明是否必填Entity ID要操作的小米插线板实体。留空则影响所有此类插线板否Mode要设置的电源模式可选green或normal是三、在 YAML 中使用该动作如果你直接使用 YAML 编写自动化或者想精确了解 Home Assistant 在底层做了什么可以参考以下技术参考。它列出了你在 YAML 中使用的字段名、字段类型以及哪些是必填的。在 YAML 中该动作的标识为xiaomi_miio.switch_set_power_mode。一个基本示例action: xiaomi_miio.switch_set_power_mode data: entity_id: switch.power_strip mode: green上面的示例将switch.power_strip设置为green绿色/节能电源模式。YAML 选项一览字段说明是否必填类型entity_id要操作的小米插线板实体。省略则影响所有此类插线板否string 或 list字符串列表mode要设置的电源模式可选green或normal是string两个关键点entity_id类型为[string, list]意味着可以传入单个实体 ID也可以传入一组实体 ID 的列表省略时动作作用于全部适用的插线板。mode为必填字段取值只能是green或normal两者之一且为字符串类型。在自动化中完整使用示例将上面的动作嵌入一个真实的自动化中例如在晚上 23 点将插线板切换到节能模式alias: Power strip green mode at night triggers: - trigger: time at: 23:00:00 actions: - action: xiaomi_miio.switch_set_power_mode data: entity_id: switch.power_strip mode: green四、立即试运行Developer Tools 中的 Actions如果你还没有想好把它放进哪个自动化可以先到Settings设置Tools工具Actions动作中手动测试搜索xiaomi_miio.switch_set_power_mode填写字段然后选择Perform action执行动作。你可以直接在真实实体上观察动作效果而无需编写任何 YAML。五、底层实现依据仓库源码印证以上配置与能力说明均可在当前仓库中找到对应的实现与文档依据动作文档source/_actions/xiaomi_miio.switch_set_power_mode.markdown 是该动作的权威使用说明定义了 UI 与 YAML 两套参数规范集成文档source/_integrations/xiaomi_miio.markdown 明确了插线板支持的型号qmi.powerstrip.v1、zimi.powerstrip.v2、Power Mode 仅在 Power Strip V1 上可用以及动作所属的 Actions 小节配套动作xiaomi_miio.switch_set_power_price 用于在插线板上存储电价price字段float 类型插线板会据此计算能耗成本与本动作配合使用效果最佳动作系列source/_actions/目录下还包含 xiaomi_miio.switch_set_wifi_led_on.markdown、xiaomi_miio.switch_set_wifi_led_off.markdown 等同类动作共同构成小米插线板的完整控制能力。可以推断该动作在实现上会向插线板设备下发电源模式的设置指令并同步更新实体属性中的mode属性集成文档中注明该属性仅 Power Strip V1 提供。如果你在调用后发现实体属性未变化请先核对设备型号是否为qmi.powerstrip.v1。六、常见问题与排查思路动作没有效果确认插线板型号是否支持电源模式。只有qmi.powerstrip.v1Power Strip V1支持green/normal两种模式V2 型号不具备此能力。mode参数报错该字段必填且只能填写green或normal注意大小写与引号。找不到动作确认已正确配置并加载 xiaomi_miio 集成且当前实体为受支持的插线板实体。想同时设置电价配合 xiaomi_miio.switch_set_power_price 使用在 YAML 中使用price字段传入浮点型电价。如果仍然无法解决可以在 Home Assistant 社区Discord、官方论坛或 /r/homeassistant中说明你调用的动作、期望结果与实际现象以便快速获得帮助。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考