Home Assistant KEF 音箱低音炮 dB 设置:kef.set_sub_db 动作完全指南

原创2026-09-16 12:27:491,680 阅读
文章标签:文档教程智能家居

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 前端完成整个配置过程:

  1. 进入 Settings > Automations & scenes。
  2. 打开一个现有的自动化或脚本,或者选择 Create automation > Create new automation 新建。
  3. 若是新建自动化,需要在 When 部分添加一个触发器;脚本则不需要触发器,它们在被其他内容调用时执行。
  4. 在 Then do 部分,选择 Add action。
  5. 选择你要控制的对象:在 By target(目标,见下文"动作的目标")下选择 KEF 音箱。
  6. 从该目标对应的动作列表中,选择 KEF: Set subwoofer dB。
  7. 设置 dB value(dB 值)。
  8. 选择 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(历史遗留质量等级),使用时应以实际设备固件表现为准。

参考与延伸阅读

登录后查看全文
home-assistant.io