2025.3.4
首页 ▸ Integrations ▸

KEF

kef integration集成将 Home Assistant 与您的设备、服务等连接和集成。 [Learn more] 允许您通过 Home Assistant 控制 KEF LS50 Wireless 和 KEF LSX 扬声器。

支持的设备：

  • KEF LS50 Wireless
  • KEF LSX

配置

要将 KEF 扬声器添加到您的安装中，请将以下内容添加到您的 configuration.yamlconfiguration.yaml 文件是 Home Assistant 的主要配置文件。它列出了要加载的集成及其特定配置。在某些情况下，需要直接在 configuration.yaml 文件中手动编辑配置。大多数集成可以在 UI 中配置。 [Learn more] 文件中。 在更改了configuration.yamlconfiguration.yaml 文件是 Home Assistant 的主要配置文件。它列出了要加载的集成及其特定配置。在某些情况下，需要直接在 configuration.yaml 文件中手动编辑配置。大多数集成可以在 UI 中配置。 [Learn more] 文件后，重启 Home Assistant 以应用更改。 该集成现在显示在集成页面的 设置 > 设备与服务 下。其实体在集成卡片上以及实体标签上列出。

# 示例 configuration.yaml 条目
media_player:
 - platform: kef
   host: IP_ADDRESS
   type: LS50

Configuration Variables

Looking for your configuration file?
host string Required

设备的 IP 地址。例如：192.168.1.32

type string Required

扬声器类型，可以是 LS50 或 LSX。

name string (Optional, default: KEF)

设备的名称

port integer (Optional, default: 50001)

设备的端口

maximum_volume float (Optional, default: 0.5)

允许的最大音量。0到1之间的数字。

volume_step float (Optional, default: 0.05)

增加音量时的音量步长。

inverse_speaker_mode boolean (Optional, default: false)

切换通道从 L/R 到 R/L。

standby_time integer (Optional)

扬声器在 20 或 60 分钟后自动进入待机模式。留空可使扬声器永不进入待机模式。

supports_on boolean (Optional, default: true)

序列号低于 LS50W13074K24L/R2G 的 LS50 Wireless 不支持通过网络打开扬声器。如果您有旧型号，请将其设置为 false。

高级 - 配置示例 

# 示例 configuration.yaml 条目
media_player:
 - platform: kef
   host: IP_ADDRESS
   type: LS50
   name: 我的 KEF 扬声器
   maximum_volume: 0.6
   volume_step: 0.05

操作

就像在 KEF Control 应用中一样，我们可以更改数字信号处理（DSP）设置。

扬声器当前的 DSP 设置会在每小时和每次操作后自动更新。 要手动更新设置，请使用 kef.update_dsp。

操作 kef.update_dsp

更新所有 DSP 设置。

数据属性 可选 描述
entity_id 否 KEF 扬声器的 entity_id.

操作 kef.set_mode

设置扬声器的模式。当省略可选属性时，设置将保持不变。

数据属性 可选 描述
entity_id 否 KEF 扬声器的 entity_id.
desk_mode 是 “桌面模式” (true 或 false)
wall_mode 是 “墙壁模式” (true 或 false)
phase_correction 是 “相位修正” (true 或 false)
high_pass 是 “高通模式” (true 或 false)
sub_polarity 是 “低音极性” (- 或 +)
bass_extension 是 “低音扩展” 选择器 (Less, Standard, 或 Extra)

操作 kef.set_desk_db

设置扬声器的 “桌面模式” 滑块值（单位：dB）。

数据属性 可选 描述
entity_id 否 KEF 扬声器的 entity_id.
db_value 否 滑块值（-6 到 0，步长为 0.5）

操作 kef.set_wall_db

设置扬声器的 “墙壁模式” 滑块值（单位：dB）。

数据属性 可选 描述
entity_id 否 KEF 扬声器的 entity_id.
db_value 否 滑块值（-6 到 0，步长为 0.5）

操作 kef.set_treble_db

设置扬声器的 “高音修剪” 滑块值（单位：dB）。

数据属性 可选 描述
entity_id 否 KEF 扬声器的 entity_id.
db_value 否 滑块值（-2 到 2，步长为 0.5）

操作 kef.set_high_hz

设置扬声器的 “高通模式” 滑块值（单位：Hz）。

数据属性 可选 描述
entity_id 否 KEF 扬声器的 entity_id.
hz_value 否 滑块值（50 到 120，步长为 5）

操作 kef.set_low_hz

设置扬声器的 “低通频率” 滑块值（单位：Hz）。

数据属性 可选 描述
entity_id 否 KEF 扬声器的 entity_id.
hz_value 否 滑块值（40 到 250，步长为 5）

操作 kef.set_sub_db

设置扬声器的 “低音增益” 滑块值（单位：dB）。

数据属性 可选 描述
entity_id 否 KEF 扬声器的 entity_id.
db_value 否 滑块值（-10 到 10，步长为 1）

注意事项

  • LS50 Wireless 在 2019 年 11 月 19 日的最新固件测试中：p6.3001902221.105039422 以及较旧的固件：p6.2101809171.105039422
  • LSX Wireless 在 2019 年 10 月 10 日的最新固件 v4.1 测试中：p20.4101909240.105243

相关主题