飞利浦 Hue
飞利浦 Hue 集成允许您控制和监控连接到您的 Hue 桥的灯光和传感器。
目前在 Home Assistant 中支持以下设备类型：
- 灯光
- 动作传感器（包括温度和光照传感器）
- Hue 遥控器/开关（作为自动化的设备触发器，当电池供电时也会暴露为电池传感器）
配置
要将 飞利浦 Hue hub 添加到您的 Home Assistant 实例中，请使用此 My 按钮：
飞利浦 Hue 可以被 Home Assistant 自动发现。如果发现了实例， 它将显示为 已发现。您可以立即进行设置。
如果没有自动发现，请不要担心！您可以设置一个 手动集成条目：
-
浏览到您的 Home Assistant 实例。
-
转到
设置 > 设备与服务。 -
在右下角，选择
Add Integration 按钮。 -
从列表中选择 飞利浦 Hue。
-
按照屏幕上的说明完成设置。
Hue 区域和房间的灯光
Hue 的概念基于区域和房间。虽然底层的 Hue 灯光直接暴露给 Home Assistant，但与 Hue 生态系统的“分组灯光”进行交互也可能很有用，例如同时打开/关闭 Hue 组中的所有灯光。
Home Assistant 会自动为每个 Hue 区域/房间创建灯光，但默认情况下将其禁用。 如果您希望使用这些“分组灯光”，可以在 设置 –> 集成 –> Hue –> 实体 中启用它们。
场景
在 Hue 的概念中，您可以为房间和区域内的灯光创建（动态）场景。您可以从 iOS 和 Android 上的（官方）Hue 应用创建、编辑和删除 Hue 场景。每个区域/房间可以分配自己的场景，并且有丰富的预设场景库以适应特定的氛围。这些 Hue 场景会自动导入到 Home Assistant 中，并作为“场景实体”提供。在 Home Assistant 中创建或编辑 Hue 场景不受支持。
建议使用 Hue 场景来同时控制多个灯光，以获得流畅的体验。如果您单独控制多个灯光和/或使用 Home Assistant 场景，每个灯光命令将逐个发送到每个灯光，这并不会带来很好的用户体验，而使用 Hue 场景会以优化的方式一次性向所有灯光发送命令，从而获得流畅的体验。
动作 hue.activate_scene
为了在 Hue 场景上获得更多控制，我们实现了一种次要的、更高级的动作来激活 Hue 场景并同时设置一些属性，如动态模式和/或亮度。
| 数据属性 | 必须 | 描述 |
|---|---|---|
entity_id |
是 | 您要激活的 Hue 场景实体的实体 ID。 |
transition |
否 | 将设备带到场景中定义状态所需的过渡时间（以秒为单位）。 |
dynamic |
否 | 为场景启用（true）或禁用（false）动态模式。 |
speed |
否 | 设置此场景的动态调色板速度。 |
brightness |
否 | 为此场景设置亮度。 |
例如，如果您想开始/停止动态模式，可以使用此动作。
Hue 遥控器和开关
Hue 遥控器例如调光开关是无状态设备，这意味着它们没有像 Home Assistant 中普通实体那样的开关状态。相反，此类设备在按下按钮时会发出事件 hue_event。您可以使用事件 Home Assistant 中的开发者工具 测试接收到的事件并订阅 hue_event。一旦您知道事件数据的格式，您可以用它来创建自动化。
在写作时，Hue API 有一个限制，即每个设备每秒只能发送一个事件。这意味着按钮事件的速率限制为每秒 1 个。这已告知 Signify，希望会尽快修复。
对遗留（V1）Hue 桥的支持
飞利浦/Signify 发布了他们的新版本的 Hue 桥（方形），他们的遗留/V1 桥（圆形）现在已停止支持。Home Assistant 将继续支持 V1 Hue 桥，只要在技术上可行，尽管有一些限制：
- V1 桥不会自动创建场景实体。要从 Home Assistant 激活 V1 桥上的 Hue 场景，我们提供通过名称激活 Hue 场景的动作。
- V1 桥上的设备/实体状态更新不会立即收到，而是按间隔轮询。
- V1 桥的 Hue 房间不会自动创建灯光实体，您可以选择在集成选项中为房间创建实体。
对于 V1 Hue 桥，您可以使用 脚本 选项卡创建脚本。
- 选择 添加新脚本 > 添加动作 > 飞利浦 Hue: 激活场景
- 然后在 组 字段中选择适当的房间名称，在 场景 字段中选择存储在您的 Hue 桥上的场景名称。