Home Assistant KEF 动作详解:使用 kef.set_wall_db 精确设置墙壁模式分贝值
Home Assistant KEF 动作详解:使用 kef.set_wall_db 精确设置墙壁模式分贝值
导读
kef.set_wall_db 是 Home Assistant KEF 集成提供的一个媒体播放器动作,用于以分贝(dB)为单位设置 KEF 音箱的墙壁模式(wall mode)滑块,与 KEF Control 官方 App 中的滑块完全对应。阅读本文后,你将掌握在可视化编辑器与 YAML 两种方式下配置该动作的完整方法、db_value 参数的取值范围与类型约束,以及它与其他 KEF DSP 动作(kef.set_mode、kef.set_desk_db、kef.update_dsp)的协同用法。
动作概览:kef.set_wall_db 是什么
kef.set_wall_db 属于 kef 领域(domain),目标实体类型为 media_player。根据 动作文档 的定义,该动作用于设置 KEF 音箱的墙壁模式滑块值,单位是分贝(dB),作用效果与 KEF Control App 中同名滑块一致,适用于将音箱靠墙摆放后补偿低频反射的声学校准场景。
该动作是 KEF 集成 DSP(数字信号处理)设置体系中的一员,与此配套的还有:
- kef.set_mode:开关 DSP 总开关下的细分模式(Desk mode、Wall mode、Phase correction、High pass、Subwoofer polarity、Bass extension)
- kef.set_desk_db:设置桌面模式的 dB 滑块
- kef.update_dsp:手动刷新全部 DSP 设置
前置条件:完成 KEF 集成配置
使用该动作前,需要在 Home Assistant 中完成 KEF 音箱的集成配置。根据 KEF 集成文档,在 configuration.yaml 中通过 media_player 平台添加:
# Example configuration.yaml entry
media_player:
- platform: kef
host: IP_ADDRESS
type: LS50
核心配置参数说明:
| 参数 | 说明 | 必填 | 默认值 |
|---|---|---|---|
host |
设备 IP 地址,例如 192.168.1.32 |
是 | — |
type |
音箱型号,LS50 或 LSX |
是 | — |
name |
设备显示名称 | 否 | KEF |
port |
设备通信端口 | 否 | 50001 |
maximum_volume |
允许的最大音量,0 到 1 之间 | 否 | 0.5 |
volume_step |
音量增减步长 | 否 | 0.05 |
inverse_speaker_mode |
交换左右声道(L/R 与 R/L) | 否 | false |
standby_time |
自动待机时间,20 或 60 分钟,留空则永不待机 |
否 | — |
supports_on |
是否支持网络唤醒开机(序列号低于 LS50W13074K24L/R2G 的旧款 LS50 Wireless 不支持,需设为 false) |
否 | true |
配置完成后需重启 Home Assistant 使配置生效(参考 配置文档 中的重启说明)。集成支持 KEF LS50 Wireless 与 KEF LSX 两款音箱。
在 UI 中通过可视化编辑器设置墙壁分贝值
根据 动作文档 中 "Using this action from the user interface" 的操作指引,如果你偏好图形化构建自动化与脚本,Home Assistant 会逐步引导完成配置,全程无需编写 YAML。具体步骤:
- 进入 Settings > Automations & scenes。
- 打开现有自动化或脚本,或选择 Create automation > Create new automation。
- 如果是新建自动化,需在 When 部分添加触发器;脚本无需触发器,脚本在被其他对象调用时运行。
- 在 Then do 部分选择 Add action。
- 选择要控制的设备:在 By target(目标选择,详见下文"目标(Targets)"一节)下选中 KEF 音箱。
- 在该目标可用的动作列表中选择 KEF: Set wall dB。
- 设置 dB value 数值。
- 选择 Save 保存。
UI 中的选项
| 选项 | 说明 |
|---|---|
| dB value | 滑块数值,单位为分贝,范围 -6 到 0,步进 0.5 |
在 YAML 中使用 kef.set_wall_db
如果你直接在 YAML 中工作,或者想精确掌握 Home Assistant 底层字段,可使用如下语法。动作在 YAML 中以其动作名 kef.set_wall_db 引用,基本示例如下(来自 动作文档):
action: kef.set_wall_db
target:
entity_id: media_player.kef_ls50
data:
db_value: -3
YAML 参数详解
| 参数 | 说明 | 必填 | 类型 |
|---|---|---|---|
db_value |
滑块数值,单位为分贝,范围 -6 到 0,步进 0.5 | 是 | float(浮点数) |
注意以下几点实战细节:
db_value为必填项,类型为浮点数,例如-3、-1.5、0都是合法取值;取值必须落在-6到0的闭区间内,并按0.5步进。- 参数写在
data映射下,目标通过target指定。 - 一个动作只能作用于一个目标实体集,如需同时调整多台音箱,可借助下文"目标"一节中的区域、楼层或标签等批量目标方式。
目标(Targets):动作的作用对象
根据 targets.md 的说明,该动作必须指定目标,目标是动作的作用对象。可以将动作指向单个实体、设备、区域、楼层或标签,Home Assistant 会对目标背后匹配的每个 media_player 实体执行动作:
- 实体(Entity):一个具体的
media_player实体,例如media_player.living_room。 - 设备(Device):属于某台设备的所有
media_player实体。 - 区域(Area):某个房间或区域内的所有
media_player实体。 - 楼层(Floor):某一楼层上的所有
media_player实体。 - 标签(Label):共享同一标签的所有
media_player实体。
在同一动作中还可以混合不同类型的目标,例如同时添加一个具体实体和一个区域,让动作同时作用于两者。
快速试用手动测试
如果只是想验证动作效果而不想立即创建自动化,可打开 Settings > Tools > Actions(开发者工具中的动作面板),搜索 kef.set_wall_db,填写字段并选择 Perform action(执行动作),即可在真实实体上立即看到效果,无需编写任何 YAML(参考 try_it.md)。
与 DSP 设置体系的协同:mode、desk dB 与手动刷新
墙壁分贝值是 KEF 音箱 DSP 设置的一部分。正如 KEF 集成文档 所述,与 KEF Control App 一致,可以在 Home Assistant 中修改音箱的数字信号处理(DSP)设置;音箱的 DSP 设置每小时自动更新一次,并且每次 DSP 动作执行后也会更新。若想立即获取最新数值,可手动调用 kef.update_dsp。
与 kef.set_wall_db 搭配使用的常见动作组合:
- kef.set_mode(文档):集中开关各类 DSP 模式。YAML 示例如下,未填写的选项保持音箱上的当前值不变:
action: kef.set_mode
target:
entity_id: media_player.kef_ls50
data:
desk_mode: true
bass_extension: Standard
其中 wall_mode 为布尔值(默认 false),用于开启或关闭墙壁模式;sub_polarity 可选 - 或 +;bass_extension 可选 Less、Standard、Extra。
-
kef.set_desk_db(文档):设置桌面模式的 dB 滑块,参数结构与
kef.set_wall_db完全一致(db_value,范围 -6 到 0,步进 0.5)。 -
kef.set_low_hz / kef.set_high_hz:分别设置低通(40–250 Hz,步进 5)与高通(50–120 Hz,步进 5)频率滑块,用于配合分频点调整。
典型自动化场景:将音箱靠墙摆放后,可先通过 kef.set_mode 开启 wall_mode,再调用 kef.set_wall_db 将 db_value 设为 -3 dB 补偿低频反射,最后执行 kef.update_dsp 立即刷新状态。
常见问题排查
- 动作列表中找不到 "KEF: Set wall dB":请确认 KEF 集成已正确配置且 Home Assistant 已重启,音箱型号与固件需被支持(LS50 Wireless、LSX)。
- 执行后没有效果:确认目标实体确实是
media_player类型的 KEF 实体,且db_value位于 -6 到 0 区间内、符合 0.5 步进。 - DSP 数值显示滞后:音箱 DSP 设置默认每小时自动刷新,也可手动调用 kef.update_dsp 立即获取最新值。
相关动作速查
- kef.set_mode:设置音箱的 DSP 工作模式(含 wall mode 开关)。
- kef.set_desk_db:设置桌面模式滑块分贝值。
- kef.update_dsp:手动刷新音箱全部 DSP 设置。