Home Assistant 中 Xiaomi Home 智能插线板电价设置：xiaomi_miio.switch_set_power_price 动作实战指南

Home Assistant 中 Xiaomi Home 智能插线板电价设置xiaomi_miio.switch_set_power_price 动作实战指南【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io本文面向使用 Home Assistant当前仓库为 home-assistant.io 用户文档接入 Xiaomi 智能插线板的用户完整讲解xiaomi_miio.switch_set_power_price动作Action的作用、UI 图形化配置、YAML 自动化写法、参数约束与底层原理。读完本文你将能够在自动化与脚本中为小米插线板写入电价并理解插线板如何利用该电价计算用电成本同时掌握与之配套的xiaomi_miio.switch_set_power_mode动作的使用方法。动作是什么把电价存进插线板Switch set power price设置功率价格动作的功能是将一条电价数据存储到 Xiaomi 智能插线板上插线板利用该值在本地计算用电成本energy cost。该动作由xiaomi_miio集成即 Xiaomi Home 集成提供动作域名为xiaomi_miio完整动作名为xiaomi_miio.switch_set_power_price。相关文档位于 source/_actions/xiaomi_miio.switch_set_power_price.markdown。需要特别说明的是该动作仅对支持电价功能的插线板有效。根据集成文档 source/_integrations/xiaomi_miio.markdown 中 Xiaomi Smart Power Strip 一节受支持的插线板型号为qmi.powerstrip.v1zimi.powerstrip.v2其功能清单中明确列出Power Price0...999这一可设置项同时支持 Power Modegreen / normal仅 Power Strip V1。也就是说电价范围在 0 到 999 之间写入时需保证数值落在此区间内。在 UI 中通过自动化或脚本设置电价从用户界面Settings 界面配置该动作的步骤如下进入Settings Automations scenes设置 自动化与场景。打开一个现有的自动化或脚本或者选择Create automation Create new automation创建自动化 创建新自动化新建一个。如果是新建自动化需要在When当…时部分添加一个触发器。脚本script不需要触发器它们在被其他对象调用时运行。在Then do则执行部分选择Add action添加动作。在搜索框中搜索并选择Xiaomi Home: Switch set power price。输入电价数值。点击Save保存。UI 中的选项选项说明是否必填Entity ID要操作的 Xiaomi 插线板。留空则作用于所有插线板否Price要存储到插线板上的电价是需要注意该动作不支持 targets目标选择器。在 UI 中必须使用Entity ID字段来指定要操作的具体插线板实体如果该字段留空动作会应用到所有插线板实体上。在 YAML 中调用动作如果直接在 YAML 中编写自动化或脚本该动作以xiaomi_miio.switch_set_power_price引用。基础示例如下action: xiaomi_miio.switch_set_power_price data: entity_id: switch.power_strip price: 0.25该示例将电价0.25存储到实体switch.power_strip上。YAML 参数说明参数说明是否必填类型entity_id要操作的 Xiaomi 插线板。省略时作用于所有插线板否字符串或字符串列表string / listprice要存储到插线板上的电价是浮点数float结合集成文档中 Power Price 的取值说明0...999price的合理取值范围为0到999之间的浮点数例如0.25、0.52、0.9等。从字段类型看entity_id既可以传单个实体 ID也可以传一个实体 ID 列表便于批量写入电价。关键使用要点price 字段名在 Good to know 一节中文档特别强调电价数据是通过price字段发送给设备的。因此在 YAML 中调用本动作时务必使用price作为字段名如上例所示不要误写成其他名称例如power_price之类的变体否则参数不会被识别。配套动作切换插线板功率模式与电价动作直接相关的还有一个动作Switch set power modexiaomi_miio.switch_set_power_mode两个动作在文档 frontmatter 中互相引用见 source/_actions/xiaomi_miio.switch_set_power_mode.markdown。它用于设置插线板的功率模式且仅对支持功率模式的插线板有效按集成文档即 Power Strip V1。YAML 调用示例action: xiaomi_miio.switch_set_power_mode data: entity_id: switch.power_strip mode: greenmode字段必填类型为字符串可选值为green节能模式或normal普通模式。两者的分工可理解为switch_set_power_mode决定插线板以何种模式运行而switch_set_power_price决定插线板在计算电费时使用什么单价。结合使用即可实现低谷电价时段切换节能模式、并按当地电价核算成本这类节能自动化场景。前置条件先接入 Xiaomi 插线板在调用本动作之前需要先将 Xiaomi 插线板通过Xiaomi Home集成接入 Home Assistant。参考集成文档 source/_integrations/xiaomi_miio.markdown集成支持通过 Home Assistant UI 的配置流config flow完成接入推荐在配置时提供 Xiaomi 账号凭据以自动连接设备并正确选择账号所在的服务器区域cn、de、i2、ru、sg、us六台服务器。设备必须先在 Mi Home米家App 中完成绑定而不是使用厂商专属 App。插线板接入后会暴露switch平台实体如switch.power_strip并带有 Temperature温度、Current电流、Load power负载功率、Wifi LED、Mode模式仅 V1等属性供自动化读取与联动。接入成功后即可按上文步骤在自动化、脚本中调用xiaomi_miio.switch_set_power_price写入电价。手动测试立即验证动作效果如果不确定配置是否正确可以使用 Home Assistant 自带的动作调试入口验证进入Settings Tools Actions设置 工具 动作搜索xiaomi_miio.switch_set_power_price填写字段后点击Perform action执行动作即可在不编写任何 YAML 的情况下直接在真实实体上观察动作执行结果。这是排查电价未生效实体未找到等问题的最快途径。注意事项与限制动作作用于插线板实体entity_id省略时作用于所有已接入的 Xiaomi 插线板操作前请确认影响范围避免意外覆盖其他插线板的电价。电价取值范围为 0 到 999依据集成文档的 Power Price 功能说明超出该范围的值可能被设备拒绝或产生不可预期的行为。电价功能仅对插线板型号qmi.powerstrip.v1与zimi.powerstrip.v2有效普通插座如chuangmi.plug.*系列不具备电价计算能力调用本动作不会产生实际效果。本动作与xiaomi_miio.switch_set_power_mode均为该集成为插线板扩展的动作完整动作列表可参见集成文档中的 Actions 一节。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考