在 Home Assistant 中通过 denonavr.set_dynamic_eq 控制 Denon AVR 接收器的 DynamicEQ 均衡器【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io导读本文围绕 Home Assistant 文档仓库中 denonavr.set_dynamic_eq 动作文档 展开完整讲解如何通过 Home Assistant 的denonavr集成对 Denon / Marantz AVR 影音接收器启用或关闭 Audyssey DynamicEQ动态均衡功能。读完本文你将掌握该动作在可视化自动化编辑器与 YAML 两种模式下的完整用法、参数语义、目标Target作用范围以及它与denonavr.get_command、denonavr.update_audyssey等关联动作的配合方式可直接落地为观影自动开启 DynamicEQ、深夜自动关闭之类的实际自动化。DynamicEQ 是什么Audyssey DynamicEQ 是 Denon AVR 接收器内置的响度校正技术当音量低于参考电平时它会对低频和高频进行补偿使小音量下依然能听到均衡的声音细节。对家庭影院用户而言这是一项开箱即用的听感优化功能。Home Assistant 的denonavr集成参见 Denon AVR Network Receivers 集成文档通过该动作denonavr.set_dynamic_eq将这一硬件设置暴露到自动化系统中Use this action to enable or disable the DynamicEQ setting on your Denon AVR receiver.也就是说你不再需要打开功放机柜、翻遥控器菜单Home Assistant 即可在任意时间点远程切换 DynamicEQ 的开与关——这正是把它接入自动化场景的价值所在。前置条件先完成 denonavr 集成配置该动作的运行对象是denonavr域下的 media_player 实体因此需要先配置好 Denon AVR Network Receivers 集成。根据集成文档需要注意支持的设备涵盖 Denon AVR-X 系列如 AVR-X1700H、X3800H、AVR-S 系列如 S760H、AVR-1700/1900 系列、Marantz SR / NR / AV 系列等其他未列出的 Denon AVR 机型也可尝试Other Denon AVR receivers (untested)。网络要求如果使用了 VLANHome Assistant 需要能访问接收器的 TCP 端口23telnet、8080HTTP 控制和60006。关键配置项配置向导中可设置host设备 IP 地址例如192.168.1.32不设置则使用自动发现。update_audyssey是否更新 Audyssey 设置部分机型可能耗时最长约 10 秒——这与set_dynamic_eq动作底层依赖的 Audyssey 状态刷新链路直接相关。use_telnet是否使用 telnet 连接接收实时状态推送注意每台接收器只允许一个 telnet 连接。zone2/zone3是否启用第二、第三区域Zone各区域会以独立 media_player 实体呈现。配置完成后接收器会以media_player.设备名的实体形式出现在 Home Assistant 中供本动作作为目标Target使用。从用户界面UI使用该动作如果你习惯可视化编辑自动化文档提供了完整的 UI 操作路径对应文档中的{% include actions/ui_header.md %}描述在可视化编辑器中按步骤选择目标、调整选项、保存无需编写 YAML进入SettingsAutomations scenes。打开一个已有的自动化或脚本或选择Create automationCreate new automation新建。若是新建自动化在When当……时部分添加一个触发条件脚本Script不需要触发器它们由其他流程调用时才运行。在Then do然后执行部分选择Add action添加动作。在By target按目标下选择要控制的 Denon AVR media_player目标的具体规则见下文动作的目标Target一节。在针对该目标列出的动作中选择Set dynamic equalizer。填写需要使用的选项。点击Save保存。UI 中的选项在可视化编辑器中该动作只有一个选项选项说明Dynamic equalizer打开即启用 DynamicEQ关闭即禁用 DynamicEQ在 YAML 中使用该动作在自动化或脚本的 YAML 中动作名称为denonavr.set_dynamic_eq。文档给出的基础示例action: denonavr.set_dynamic_eq target: entity_id: media_player.marantz data: dynamic_eq: true该示例对目标接收器media_player.marantz启用DynamicEQ。YAML 参数说明参数必填类型默认值说明dynamic_eq是booleantrue是否启用 DynamicEQ。设为true开启false关闭该动作只有dynamic_eq这一个数据字段结构非常简单target用于指定要控制的接收器实体。文档默认值为true即若想关闭 DynamicEQ必须显式传入dynamic_eq: false。一个实用的观影开启 / 深夜关闭自动化示例alias: 影院模式启用 DynamicEQ trigger: - platform: state entity_id: media_player.marantz to: playing condition: - condition: time after: 18:00 action: - action: denonavr.set_dynamic_eq target: entity_id: media_player.marantz data: dynamic_eq: true mode: singlealias: 深夜关闭 DynamicEQ trigger: - platform: time at: 23:00 action: - action: denonavr.set_dynamic_eq target: entity_id: media_player.marantz data: dynamic_eq: false mode: single动作的目标Target该动作必须指定目标。根据文档{% include actions/targets.md domainmedia_player %}的说明目标可以指向单个实体、设备、区域、楼层或标签Home Assistant 会对目标下所有匹配的media_player实体执行该动作实体Entity某个具体的media_player实体例如media_player.living_room。设备Device属于某台设备的所有media_player实体。区域Area某个房间/区域内的所有media_player实体。楼层Floor某个楼层上的所有media_player实体。标签Label带有某标签的所有media_player实体。同一个动作还可以混合使用多种目标类型例如同时添加一个具体实体和一个区域让动作一次作用于两者。这意味着一台具备多区域Main Zone / Zone 2 / Zone 3的 Denon AVR其各区域实体可通过目标选择分别控制。与关联动作的配合该文档的 front matter 声明了两个关联动作related_actionsdenonavr.get_command通过接收器基于文本的 HTTP 网络接口发送任意命令如/goform/formiPhoneAppDirect.xml?VSMONI2切换 HDMI 输出或/goform/formiPhoneAppDirect.xml?RCKSK0410370发送 IR 遥控码切换静音用于覆盖没有独立 Home Assistant 动作的功能。denonavr.update_audyssey更新接收器上的 Audyssey 设置该动作没有额外参数且部分机型更新耗时可能长达约 10 秒。它们的配合逻辑是set_dynamic_eq负责开/关 DynamicEQupdate_audyssey负责让接收器重新应用整体 Audyssey 设置例如在跑完 Audyssey 校准后同步而get_command则作为兜底可以发送功放协议中未被 Home Assistant 封装的任意底层命令。三者同属denonavr域目标语义一致可以出现在同一条自动化中串联使用。试一下在不写 YAML 的情况下验证如果你想先验证该动作在你的接收器上的实际效果文档提供了Try it yourself路径进入SettingsToolsActions搜索denonavr.set_dynamic_eq在目标中选择你的接收器实体将dynamic_eq设为true或false点击Perform action即可实时观察功放行为无需编写任何 YAML。故障排查要点确认实体域该动作只能作用于denonavr域下的media_player实体若目标实体来自其他媒体播放器集成动作不会生效。Audyssey 刷新耗时若启用了集成配置中的update_audyssey部分机型应用 Audyssey 相关设置可能耗时约 10 秒自动化中对后续动作做适当的延迟等待会更稳妥。telnet 单连接限制若开启了use_telnet实时推送接收器只允许一个 telnet 连接其他 telnet 客户端可能被拒绝进而影响状态同步。从状态确认结果可以到SettingsToolsStates查看该media_player实体的相关属性确认 DynamicEQ 状态是否按预期切换。社区求助如果仍然无法解决可在 Home Assistant 社区论坛community.home-assistant.io发帖时附上你调用的动作与预期现象便于他人快速定位。小结denonavr.set_dynamic_eq是 Home Assistant 暴露 Denon / Marantz AVR 功放 Audyssey DynamicEQ 开关的专用动作参数极少仅dynamic_eq一个布尔字段却能把功放设置与场景自动化直接打通。无论是通过可视化编辑器一步步配置还是在 YAML 中直接书写只要目标实体指向正确的denonavrmedia_player即可实现基于时间、基于播放状态或基于场景的 DynamicEQ 智能切换配合denonavr.update_audyssey与denonavr.get_command还能覆盖更完整的 Audyssey 调音链路。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考