企业官网建设流程全解析

Home Assistant 中 Magic Home 灯光音乐模式：flux_led.set_music_mode动作完全指南

【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io

flux_led.set_music_mode是 Home Assistant 的 Magic Home（flux_led）集成提供的灯光动作之一，它开启 Magic Home 灯光的音乐模式，让灯光随环境声音实时跳动。本指南完整覆盖该动作的适用设备型号、UI 操作步骤、全部配置项（含取值范围与默认值）、YAML 写法以及一个可直接落地的自动化示例，并结合本仓库的集成文档说明底层设备支持情况，帮助你在自动化与脚本中安全、准确地控制带麦克风的 LED 灯。

动作概览：让灯光随音乐跳动

音乐模式是 Magic Home 灯光的一项内置功能：灯光自带麦克风，通过拾取环境声音来决定光效的节奏与强度。flux_led.set_music_mode动作的作用就是把这一模式打开，并允许你精细调节：

• 麦克风灵敏度（决定灯光对声音的响应程度）；
• 亮度（效果的整体亮度）；
• 前景色与背景色（效果使用的颜色）；
• 部分型号还可设置二维像素的灯屏模式（Light screen）与特效编号。

支持的设备型号

并非所有 Magic Home 灯都支持音乐模式。根据 flux_led 集成的设备型号文档，音乐模式依赖设备内置麦克风，本动作明确支持以下三种带麦克风的控制器：

从集成文档的完整型号表可以看出，0xA4/0xA6/0xA7 等 Addressable 控制器虽然同样带麦克风，但本文档确认set_music_mode支持的是 0x08、0xA2、0xA3 三类。使用前请确认你的设备型号属于上述三者之一，否则动作可能无效。若不确定型号，可查看实体属性或参考集成文档的 Supported models 一节。

从用户界面（UI）使用该动作

如果你习惯通过可视化界面构建自动化与脚本，Home Assistant 会逐步引导你完成设置，无需编写 YAML：

1. 进入设置（Settings） > 自动化与场景（Automations & scenes）；
2. 打开一个现有的自动化或脚本，或者选择创建自动化（Create automation） > 创建新自动化（Create new automation）；
3. 如果是新建自动化，在When（何时）部分添加触发器；脚本不需要触发器，脚本由其他对象调用时才会执行；
4. 在Then do（然后执行）部分选择添加动作（Add action）；
5. 在搜索框中搜索并选择Magic Home: Set music mode；
6. 在目标（Targets）下选择要应用音乐模式的灯；
7. 设置你想要修改的选项；
8. 选择保存（Save）。

UI 中的选项

动作的目标（Targets）

该动作必须指定目标。目标是动作的作用对象，可以指向单个实体、设备、区域、楼层或标签，Home Assistant 会针对目标背后每一个匹配的light实体执行动作：

• 实体（Entity）：一个具体的light实体，例如light.living_room；
• 设备（Device）：属于某设备的全部light实体；
• 区域（Area）：某个房间或区域内的全部light实体；
• 楼层（Floor）：某个楼层上的全部light实体；
• 标签（Label）：共享同一标签的全部light实体。

你还可以在同一个动作中混合不同类型的多个目标，例如同时添加一个具体实体和一个区域，让动作同时作用于两者。

在 YAML 中使用该动作

如果你直接编写 YAML，或想确切了解 Home Assistant 在底层做了什么，这一节给出技术参考：字段名称、类型与必填性。YAML 中该动作的名称为flux_led.set_music_mode，基础示例如下：

action: flux_led.set_music_mode target: entity_id: light.addressable_v3_8e2f7f data: sensitivity: 100 brightness: 100 effect: 2 foreground_color: [255, 0, 0] background_color: [0, 255, 0]

YAML 选项参考

注意：foreground_color与background_color均为 RGB 列表形式，如[255, 0, 0]表示红色、[0, 255, 0]表示绿色。light_screen仅在 Addressable（0xA2/0xA3）型号上有效，RGB with MIC（0x08）型号不支持该字段与背景色。

动手试试

准备好测试了吗？打开设置（Settings） > 工具（Tools） > 动作（Actions）（即开发者工具的服务页面），搜索flux_led.set_music_mode，填写字段并点击执行动作（Perform action），无需写一行 YAML 即可在真实实体上看到效果。

更多示例：聚会场景触发音乐模式

下面是该动作在自动化中的一个真实使用场景。当聚会场景被激活时，以适中的灵敏度和亮度开启音乐模式，而不是满功率运行——这样灯光能跟随音乐律动，又不会整晚处于最大功耗状态。

• 触发器（Trigger）：场景激活（scene.party）
• 动作（Action）：Magic Home: Set music mode

automation: alias: "Enable music mode at moderate power when party scene activates" triggers: - trigger: state entity_id: scene.party actions: - action: flux_led.set_music_mode target: entity_id: light.addressable_v3_living_room data: sensitivity: 60 brightness: 50 effect: 2 light_screen: false foreground_color: [0, 100, 255] background_color: [0, 0, 0]

该示例中，sensitivity设为 60、brightness设为 50，属于中等水平；背景色设为[0, 0, 0]（黑色），让前景色成为视觉主体。复制该示例后只需调整entity_id与颜色数值即可适配你的设备。

相关动作

音乐模式在 Magic Home 生态中与以下两个动作协同工作：

• Set custom effect：通过你提供的颜色列表循环播放自定义特效，可控制颜色、速度与过渡方式（渐变、跳跃或频闪），适合在音乐模式之外打造自己的灯光效果；
• Set zones：为 Addressable v3 灯带的每个区段分配颜色，可将一条灯带拆分为不同颜色的区域。

排错提示

如果动作未按预期生效，可按以下顺序排查：

• 确认设备型号：仅在 0x08（RGB with MIC）、0xA2（Addressable v2）、0xA3（Addressable v3）上支持，其余型号请参考 flux_led 集成文档 确认能力；
• 确认实体已配置：目标必须是flux_led集成下正确配置的light实体；
• 区分 Addressable 特有选项：light_screen与background_color仅对 Addressable 型号生效，在 RGB with MIC 型号上应省略；
• 数值越界：sensitivity、brightness需在 1～100 之间，effect需落在对应型号允许的区间（Addressable：1～16；RGB with MIC：0～3）；
• 单独测试：在工具 > 动作页面直接执行该动作，观察灯光反应，可快速区分是动作参数问题还是自动化触发问题。

若仍无法解决，可携带动作名称、目标实体与预期结果到 Home Assistant 社区求助（Discord、社区论坛或 /r/homeassistant），或直接向 AI 助手用自然语言描述需求，让其帮你分析动作参数。

【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io