Home Assistant KEF 音箱低音炮 dB 设置:kef.set_sub_db 动作完全指南
Home Assistant KEF 音箱低音炮 dB 设置:kef.set_sub_db 动作完全指南
导读
本文聚焦 Home Assistant 中 KEF 集成提供的 kef.set_sub_db 动作,讲解如何通过自动化、脚本或 YAML 精确调整 KEF 音箱的低音炮(subwoofer)增益滑块(单位为分贝 dB)。读完本文,你将掌握该动作的 UI 操作路径、YAML 参数规范、取值范围与类型约束,以及它与 KEF 数字信号处理(DSP)动作体系的配合方式,从而在家庭影音自动化中实现对 KEF LS50 Wireless / LSX 音箱低频输出的精细控制。
动作概述:与 KEF Control App 一致的滑块控制
kef.set_sub_db 用于设置 KEF 音箱的低音炮增益滑块,单位为分贝(dB)。这个滑块与你手机上的 KEF Control App 中看到的是同一个滑块,Home Assistant 通过该动作直接对音箱下发等效控制指令。
从 KEF 集成文档 可知,该集成面向 KEF LS50 Wireless 和 KEF LSX 两类音箱,集成类型为 media_player,采用本地轮询(Local Polling)方式与设备通信。因此使用 kef.set_sub_db 之前,你需要先在 configuration.yaml 中完成 KEF 音箱的基本配置,例如:
# Example configuration.yaml entry
media_player:
- platform: kef
host: IP_ADDRESS
type: LS50
配置完成后,Home Assistant 中会生成形如 media_player.kef_ls50 的实体,该实体即动作的目标(target)。
在 UI 中通过自动化或脚本设置低音炮 dB
如果你的操作习惯偏向可视化界面,可以在 Home Assistant 前端完成整个配置过程:
- 进入 Settings > Automations & scenes。
- 打开一个现有的自动化或脚本,或者选择 Create automation > Create new automation 新建。
- 若是新建自动化,需要在 When 部分添加一个触发器;脚本则不需要触发器,它们在被其他内容调用时执行。
- 在 Then do 部分,选择 Add action。
- 选择你要控制的对象:在 By target(目标,见下文"动作的目标")下选择 KEF 音箱。
- 从该目标对应的动作列表中,选择 KEF: Set subwoofer dB。
- 设置 dB value(dB 值)。
- 选择 Save 保存。
UI 中的选项
| 选项 | 说明 |
|---|---|
| dB value | 滑块数值,单位为分贝,范围在 -10 到 10 之间。 |
在 YAML 中使用该动作
如果你直接编写 YAML,或者想确切了解 Home Assistant 在底层执行了什么,可以参考以下技术参考。YAML 中引用该动作的名称为 kef.set_sub_db。基础示例如下:
action: kef.set_sub_db
target:
entity_id: media_player.kef_ls50
data:
db_value: 0
YAML 选项
| 字段 | 说明 | 必填 | 类型 |
|---|---|---|---|
| db_value | 滑块数值,单位为分贝,范围在 -10 到 10 之间。 | 是 | float |
值得注意的是,db_value 是必填字段且类型为 float。这意味着即使你只想做微调(例如从 0 dB 调整到 -3 dB),也必须显式传入该值;Home Assistant 会将该值直接作用于音箱的低音炮增益滑块。
动作的目标(Targets)
kef.set_sub_db 要求一个目标(target),目标是动作的作用对象。你可以将动作指向单个实体、设备、区域、楼层或标签,Home Assistant 会对该目标背后的每一个匹配的 media_player 实体执行此动作:
- 实体:一个具体的 media_player 实体,例如
media_player.living_room。 - 设备:属于某个设备的全部 media_player 实体。
- 区域:某个房间或区域内的全部 media_player 实体。
- 楼层:某一楼层上的全部 media_player 实体。
- 标签:共享某个标签的全部 media_player 实体。
你还可以在同一个动作中混用不同类型的目标,例如同时指定一个具体实体和一个区域,让动作对两者同时生效。这在多房间场景(例如客厅与书房各有一套 KEF LSX)下尤其有用——一条自动化即可同时调整多台音箱的低音炮电平。
结合 KEF DSP 动作体系使用
kef.set_sub_db 并非孤立动作,它属于 KEF 集成的数字信号处理(DSP)动作家族。在该动作文档的 related_actions 中,明确关联了以下相邻动作:
- kef.set_mode:设置 DSP 模式(Desk mode、Wall mode、Phase correction、High pass、Subwoofer polarity、Bass extension 等),未设置的选项保持音箱当前值不变。
- kef.set_treble_db:设置高音(treble)修整滑块,范围为 -2 到 2 dB,步进 0.5。
从 KEF 集成文档 可以确认:与 KEF Control App 一样,你可以通过 Home Assistant 更改音箱的 DSP 设置,音箱的 DSP 设置会每小时自动更新一次,并且在每次 DSP 动作之后更新。因此,当你调用 kef.set_sub_db 后,音箱会立即应用新的低音炮增益值。
如果你希望手动立即刷新全部 DSP 设置(而不等待每小时自动同步),可以使用 kef.update_dsp 动作:
action: kef.update_dsp
target:
entity_id: media_player.kef_ls50
该动作没有额外参数,仅需指定目标。
典型使用场景
将 kef.set_sub_db 放入自动化或脚本,可以实现诸如以下场景:
- 夜间模式:晚间自动化触发时,将低音炮增益调低(例如 -6 dB),避免低频干扰家人休息;早晨再恢复 0 dB。
- 观影模式:播放电影时自动提升低音炮输出(例如 +4 dB),搭配
kef.set_treble_db同步微调高音,实现一键音效切换。 - 多设备同步:利用目标中的"区域"或"标签"能力,一条脚本同时调节多个房间内 KEF 音箱的低音炮电平。
alias: "Evening: reduce subwoofer"
triggers:
- trigger: time
at: "22:00:00"
actions:
- action: kef.set_sub_db
target:
entity_id: media_player.kef_ls50
data:
db_value: -6
参数约束与注意事项
db_value的取值范围为 -10 到 10(单位 dB),超出该范围的数值在音箱端不受支持,应避免使用。- 该动作属于 media_player 域动作,仅在已配置 KEF 集成且音箱在线时可正常执行。
- 音箱的 DSP 状态每小时自动同步一次,因此即便动作执行后音箱端出现状态回读延迟,最终也会通过自动更新与 Home Assistant 保持一致;如需立即同步,可追加调用
kef.update_dsp。 - KEF 集成文档标注的
ha_quality_scale为 legacy(历史遗留质量等级),使用时应以实际设备固件表现为准。
参考与延伸阅读
- 动作定义与参数:
source/_actions/kef.set_sub_db.markdown - KEF 集成配置指南(host/type/name/port/maximum_volume 等参数):source/_integrations/kef.markdown
- 关联动作:kef.set_mode、kef.set_treble_db、kef.update_dsp