尧图网站建设 
Home Assistant 中 Home Connect 集成 change_setting 动作远程修改家电设置的完整指南【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io本文围绕 Home Assistant 的 Home Connect 集成中的home_connect.change_setting动作讲解如何通过自动化或脚本远程修改博世Bosch、西门子Siemens等支持 Home Connect 标准的家电设置例如开启儿童锁、切换设备模式等。你将掌握该动作的 UI 操作步骤、YAML 完整参数device_id、key、value及其取值规则并理解底层 Home Connect 云端 API 的实现约束最终能够独立编写出可落地的自动化配置。动作概览什么是 change_settinghome_connect.change_setting是 Home Connect 集成 提供的核心动作之一用于在 Home Connect 家电上修改一项设置setting。典型用法包括打开或关闭Child Lock儿童锁将设备切换到不同的运行模式修改设备上通过 Home Connect API 暴露的其他可写设置项。其核心设计思路是三要素模型选择家电device_id→ 指定设置项key→ 给定目标值value。设置项通过 Home Connect 的键名key唯一标识例如儿童锁的键为BSH.Common.Setting.ChildLock。值的类型由该设置项决定可以是文本text、整数integer或布尔开关true/false。值得注意的是该动作与另外两个配套动作共同构成 Home Connect 的完整控制面三者常配合使用相关动作见 related_actions 渲染逻辑home_connect.set_program_and_options启动或选择程序或为活动/已选程序设置选项home_connect.start_selected_program启动已在设备上选定的程序home_connect.change_setting本文主题修改设备的持久化设置。在 UI 中调用该动作从自动化或脚本界面调用该动作的操作路径为见关联文档进入Settings Automations scenes打开现有自动化或脚本或选择Create automation Create new automation若新建自动化需在When部分添加触发器脚本无需触发器由其他场景调用时运行在Then do部分选择Add action从动作列表中搜索并选择Change setting选择要修改的家电输入设置的键key和目标值value选择Save。UI 中提供的选项字段如下UI 字段说明Device要修改的 Home Connect 家电Key要修改设置的键例如BSH.Common.Setting.ChildLockValue要为该设置设置的值具体可接受值取决于设置项本身YAML 完整配置与参数说明在 YAML 中该动作名为home_connect.change_setting。一个开启儿童锁的基础示例action: home_connect.change_setting data: device_id: a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6 key: BSH.Common.Setting.ChildLock value: true三个参数均为必填项完整定义如下参数是否必填类型说明device_id是string要修改家电的设备 IDkey是string要修改设置的键例如BSH.Common.Setting.ChildLockvalue是string要为该设置设置的值。可接受值取决于设置项可以是文本、数字或布尔值true/false参数取值规则详解device_id在自动化中直接填写目标设备的实体或设备 ID。实际操作中更推荐通过device_id定位它是 Home Assistant 内部每个设备唯一分配的标识示例中的a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6为占位符需替换为你的实际设备 ID。key采用 Home Connect 云 API 的标准键命名空间形如BSH.Common.Setting.ChildLock。键名结构遵循 供应商域 设备域 Setting 具体名称 的约定其中BSH.Common.Setting.*为跨设备通用的公共设置Cooking.Common.Setting.*、LaundryCare.*、Dishcare.*、ConsumerProducts.*等前缀则对应烤箱、洗衣机、洗碗机、咖啡机等具体品类。value必须与设置项期望的类型严格匹配开关型设置如 Child Lock使用布尔值true/false文本型设置传入字符串数值型设置传入整数。实战案例离家时自动锁定烤箱控制文档中给出了一个完整的自动化示例当全家离开家时自动开启烤箱的儿童锁防止离家期间控制面板被误操作。触发器Everyone leaves home全家离开家动作Change settingKeyBSH.Common.Setting.ChildLockValuetrue对应的完整 YAMLalias: Lock the oven controls when away triggers: - trigger: state entity_id: zone.home to: 0 actions: - action: home_connect.change_setting data: device_id: a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6 key: BSH.Common.Setting.ChildLock value: true该示例展示了trigger: state状态触发与动作调用的组合当zone.home的人数归零时触发将烤箱儿童锁置为true。与配套动作的协同设置、程序与启动change_setting只负责改设置不负责跑程序。完整的远程控制链路通常需要三步配合用home_connect.set_program_and_options选择/启动程序并设置程序选项例如dishcare_dishwasher_program_eco_50搭配dishcare_dishwasher_option_silence_on_demand: true见 set_program_and_options 文档用home_connect.start_selected_program启动已选定的程序并可附带启动专属的定时选项如b_s_h_common_option_start_in_relative、b_s_h_common_option_finish_in_relative以秒计9000表示 2 小时 30 分钟见 start_selected_program 文档用home_connect.change_setting调整设备的持久化设置如儿童锁、运行模式。一个典型的谷电场景自动化可把三者串起来电价低于阈值且洗碗机门关闭时先设置静音 Eco 程序再指定两小时后完成同时保持儿童锁开启。参考 集成文档中的自动化示例可看到set_program_and_options与条件判断时间窗口 22:00–06:00的组合写法。好用的要点与已知限制Good to know根据关联文档与集成文档使用该动作必须注意以下事实约束可修改的设置项取决于具体家电。Home Connect API 与 Home Connect App 并不完全一致App 中可用的某些设置可能无法通过 Home Assistant 生效值的类型必须与设置项匹配。开关型用true/false其他设置期望文本或整数传错类型会导致调用失败设备在线状态决定可用性。部分家电在关机时不报告数据相关实体在开机前不会出现重载集成或重启 Home Assistant 可刷新程序列表集成仅支持单一配置条目因为 Home Connect API 不允许唯一标识同一账户下的多个条目该集成基于 Home Connect 官方云 API通过 Server-Sent Events 实时接收家电推送配置条目加载或流式连接出错后会重新拉取全部数据见集成文档Data updates小节。在 Home Assistant 中配置 Home Connect 集成的前置条件若要使用change_setting动作首先需完成集成本身配置见集成文档Prerequisites小节在 Home Connect 开发者门户注册开发者账户并填写用于测试的默认 Home Connect 用户账户邮箱须全部小写否则 OAuth 认证失败注册应用OAuth 流程选择Authorization Code Grant FlowRedirect URI 填写https://my.home-assistant.io/redirect/oauth记录 Client ID 与 Client Secret在 Home Assistant 中通过Application Credentials创建凭据并完成 OAuth 授权注意开发者门户的配置变更约 15 分钟后生效且完成配置后需退出开发者账户否则会因unauthorized_client错误导致认证失败。若未启用 My Home Assistant可使用HOME_ASSISTANT_URL/auth/external/callback作为回调地址见集成文档。故障排查指引当动作无法生效时优先按以下顺序排查依据集成文档 Troubleshooting 小节确认家电在线关机设备不会上报数据先开机并重载集成检查 OAuth 凭据若配置时报Error while obtaining access token.删除 Application credentials 后重新添加集成核对键名与值类型确认key在设备诊断文件diagnostics中存在且value类型与设置项匹配若程序/设置键缺失可在 aiohomeconnect 项目提交 issue 补充检查家电云端连接在 Home Connect App 的Network设置中确认家电与云端的连接状态为绿色。总结home_connect.change_setting是 Home Connect 集成中面向设备设置的通用动作通过device_idkeyvalue三参数即可远程修改家电设置是构建离家锁控模式切换等自动化场景的基础构件。使用时请牢记设置项的键名采用 Home Connect 命名空间、值类型必须匹配、可用设置因设备而异、家电需保持在线。配合set_program_and_options与start_selected_program两个动作即可在 Home Assistant 中完成从选程序、设选项、启动程序到修改设置的完整远程控制闭环。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Home Assistant 中 Home Connect 集成 change_setting 动作：远程修改家电设置的完整指南
Home Assistant 中 Home Connect 集成 change_setting 动作远程修改家电设置的完整指南【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io本文围绕 Home Assistant 的 Home Connect 集成中的home_connect.change_setting动作讲解如何通过自动化或脚本远程修改博世Bosch、西门子Siemens等支持 Home Connect 标准的家电设置例如开启儿童锁、切换设备模式等。你将掌握该动作的 UI 操作步骤、YAML 完整参数device_id、key、value及其取值规则并理解底层 Home Connect 云端 API 的实现约束最终能够独立编写出可落地的自动化配置。动作概览什么是 change_settinghome_connect.change_setting是 Home Connect 集成 提供的核心动作之一用于在 Home Connect 家电上修改一项设置setting。典型用法包括打开或关闭Child Lock儿童锁将设备切换到不同的运行模式修改设备上通过 Home Connect API 暴露的其他可写设置项。其核心设计思路是三要素模型选择家电device_id→ 指定设置项key→ 给定目标值value。设置项通过 Home Connect 的键名key唯一标识例如儿童锁的键为BSH.Common.Setting.ChildLock。值的类型由该设置项决定可以是文本text、整数integer或布尔开关true/false。值得注意的是该动作与另外两个配套动作共同构成 Home Connect 的完整控制面三者常配合使用相关动作见 related_actions 渲染逻辑home_connect.set_program_and_options启动或选择程序或为活动/已选程序设置选项home_connect.start_selected_program启动已在设备上选定的程序home_connect.change_setting本文主题修改设备的持久化设置。在 UI 中调用该动作从自动化或脚本界面调用该动作的操作路径为见关联文档进入Settings Automations scenes打开现有自动化或脚本或选择Create automation Create new automation若新建自动化需在When部分添加触发器脚本无需触发器由其他场景调用时运行在Then do部分选择Add action从动作列表中搜索并选择Change setting选择要修改的家电输入设置的键key和目标值value选择Save。UI 中提供的选项字段如下UI 字段说明Device要修改的 Home Connect 家电Key要修改设置的键例如BSH.Common.Setting.ChildLockValue要为该设置设置的值具体可接受值取决于设置项本身YAML 完整配置与参数说明在 YAML 中该动作名为home_connect.change_setting。一个开启儿童锁的基础示例action: home_connect.change_setting data: device_id: a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6 key: BSH.Common.Setting.ChildLock value: true三个参数均为必填项完整定义如下参数是否必填类型说明device_id是string要修改家电的设备 IDkey是string要修改设置的键例如BSH.Common.Setting.ChildLockvalue是string要为该设置设置的值。可接受值取决于设置项可以是文本、数字或布尔值true/false参数取值规则详解device_id在自动化中直接填写目标设备的实体或设备 ID。实际操作中更推荐通过device_id定位它是 Home Assistant 内部每个设备唯一分配的标识示例中的a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6为占位符需替换为你的实际设备 ID。key采用 Home Connect 云 API 的标准键命名空间形如BSH.Common.Setting.ChildLock。键名结构遵循 供应商域 设备域 Setting 具体名称 的约定其中BSH.Common.Setting.*为跨设备通用的公共设置Cooking.Common.Setting.*、LaundryCare.*、Dishcare.*、ConsumerProducts.*等前缀则对应烤箱、洗衣机、洗碗机、咖啡机等具体品类。value必须与设置项期望的类型严格匹配开关型设置如 Child Lock使用布尔值true/false文本型设置传入字符串数值型设置传入整数。实战案例离家时自动锁定烤箱控制文档中给出了一个完整的自动化示例当全家离开家时自动开启烤箱的儿童锁防止离家期间控制面板被误操作。触发器Everyone leaves home全家离开家动作Change settingKeyBSH.Common.Setting.ChildLockValuetrue对应的完整 YAMLalias: Lock the oven controls when away triggers: - trigger: state entity_id: zone.home to: 0 actions: - action: home_connect.change_setting data: device_id: a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6 key: BSH.Common.Setting.ChildLock value: true该示例展示了trigger: state状态触发与动作调用的组合当zone.home的人数归零时触发将烤箱儿童锁置为true。与配套动作的协同设置、程序与启动change_setting只负责改设置不负责跑程序。完整的远程控制链路通常需要三步配合用home_connect.set_program_and_options选择/启动程序并设置程序选项例如dishcare_dishwasher_program_eco_50搭配dishcare_dishwasher_option_silence_on_demand: true见 set_program_and_options 文档用home_connect.start_selected_program启动已选定的程序并可附带启动专属的定时选项如b_s_h_common_option_start_in_relative、b_s_h_common_option_finish_in_relative以秒计9000表示 2 小时 30 分钟见 start_selected_program 文档用home_connect.change_setting调整设备的持久化设置如儿童锁、运行模式。一个典型的谷电场景自动化可把三者串起来电价低于阈值且洗碗机门关闭时先设置静音 Eco 程序再指定两小时后完成同时保持儿童锁开启。参考 集成文档中的自动化示例可看到set_program_and_options与条件判断时间窗口 22:00–06:00的组合写法。好用的要点与已知限制Good to know根据关联文档与集成文档使用该动作必须注意以下事实约束可修改的设置项取决于具体家电。Home Connect API 与 Home Connect App 并不完全一致App 中可用的某些设置可能无法通过 Home Assistant 生效值的类型必须与设置项匹配。开关型用true/false其他设置期望文本或整数传错类型会导致调用失败设备在线状态决定可用性。部分家电在关机时不报告数据相关实体在开机前不会出现重载集成或重启 Home Assistant 可刷新程序列表集成仅支持单一配置条目因为 Home Connect API 不允许唯一标识同一账户下的多个条目该集成基于 Home Connect 官方云 API通过 Server-Sent Events 实时接收家电推送配置条目加载或流式连接出错后会重新拉取全部数据见集成文档Data updates小节。在 Home Assistant 中配置 Home Connect 集成的前置条件若要使用change_setting动作首先需完成集成本身配置见集成文档Prerequisites小节在 Home Connect 开发者门户注册开发者账户并填写用于测试的默认 Home Connect 用户账户邮箱须全部小写否则 OAuth 认证失败注册应用OAuth 流程选择Authorization Code Grant FlowRedirect URI 填写https://my.home-assistant.io/redirect/oauth记录 Client ID 与 Client Secret在 Home Assistant 中通过Application Credentials创建凭据并完成 OAuth 授权注意开发者门户的配置变更约 15 分钟后生效且完成配置后需退出开发者账户否则会因unauthorized_client错误导致认证失败。若未启用 My Home Assistant可使用HOME_ASSISTANT_URL/auth/external/callback作为回调地址见集成文档。故障排查指引当动作无法生效时优先按以下顺序排查依据集成文档 Troubleshooting 小节确认家电在线关机设备不会上报数据先开机并重载集成检查 OAuth 凭据若配置时报Error while obtaining access token.删除 Application credentials 后重新添加集成核对键名与值类型确认key在设备诊断文件diagnostics中存在且value类型与设置项匹配若程序/设置键缺失可在 aiohomeconnect 项目提交 issue 补充检查家电云端连接在 Home Connect App 的Network设置中确认家电与云端的连接状态为绿色。总结home_connect.change_setting是 Home Connect 集成中面向设备设置的通用动作通过device_idkeyvalue三参数即可远程修改家电设置是构建离家锁控模式切换等自动化场景的基础构件。使用时请牢记设置项的键名采用 Home Connect 命名空间、值类型必须匹配、可用设置因设备而异、家电需保持在线。配合set_program_and_options与start_selected_program两个动作即可在 Home Assistant 中完成从选程序、设选项、启动程序到修改设置的完整远程控制闭环。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考