灯光
此集成允许您跟踪和控制各种灯泡。请阅读特定灯硬件的集成文档以了解如何启用它。
构建模块集成
这个 灯光 是一个构建模块集成，无法直接添加到你的 Home Assistant 中，但可以被其他集成使用和提供。
构建模块集成不同于典型的与设备或服务连接的集成。相反，其他将设备或服务集成到 Home Assistant 中的集成使用这个 灯光 构建模块来提供实体、服务和其他你可以在自动化或仪表板中使用的功能。
如果你的某个集成具有这个构建模块，这个页面记录了 灯光 构建模块所提供的功能。
灯光实体的状态和属性
灯光 entities实体表示 Home Assistant 中的传感器、执行器或功能。实体用于监控物理属性或控制其他实体。实体通常是设备或服务的一部分。 [Learn more] 可以有以下 states状态保存实体的感兴趣信息，例如灯是开还是关。每个实体只有一个状态，并且状态一次只保存一个值。但是，实体可以存储与该状态相关的属性，例如亮度、颜色或测量单位。 [Learn more]：on 或 off。可用属性的列表取决于 device设备是表示包含实体的物理或逻辑单元的模型。。请参考您的灯的集成文档。
三个灯具的不同状态：`on`、`off`或`unavailable`。
默认开启值
要设置灯光打开时的默认颜色、亮度和渐变值，请创建一个自定义 light_profiles.csv，该文件通常位于您找到 configuration.yamlconfiguration.yaml 文件是 Home Assistant 的主要配置文件。它列出了要加载的集成及其特定配置。在某些情况下，需要直接在 configuration.yaml 文件中手动编辑配置。大多数集成可以在 UI 中配置。 [Learn more] 的默认配置文件夹中。
light_profiles.csv 必须有一个标题。标题的格式是：
id,x,y,brightness,transition
字段 transition 是可选的，可以省略。
每个灯的实体标识符应添加 .default 后缀以定义默认值，例如，对于 light.ceiling_2，profile 字段为 light.ceiling_2.default。要为所有灯定义一个默认值，可以使用标识符 group.all_lights.default。个别设置将始终优先于 all_lights 默认设置。
如果灯光实体处于 on 状态，默认配置亮度将仅在通过动作数据属性 profile 调用时应用，像任何其他命名配置一样。渐变属性将应用于所有 light.turn_on、light.toggle 和 light.turn_off 操作，除非在动作数据中另有说明。
操作 light.turn_on
打开一个灯或多个灯，使用 groups。
大多数灯不支持所有属性。您可以检查特定灯的集成文档以获取提示，但通常情况下，您需要尝试一下，看看什么有效。
| 数据属性 | 可选 | 描述 |
|---|---|---|
entity_id |
否 | 指向灯的 entity_id 的字符串或字符串列表。要目标所有灯，请将 entity_id 设置为 all。 |
transition |
是 | 表示灯光应花费多长时间（以秒为单位）过渡到新状态的数字。 |
profile |
是 | 包含内置配置之一的名称的字符串（放松、激励、集中、阅读）或当前工作目录中 light_profiles.csv 中定义的任何自定义配置。灯光配置定义了一个 xy 颜色、亮度和渐变值（如果不需要渐变，则设置为 0 或完全省略该列）。如果提供了配置并设置了亮度，则配置的亮度将被覆盖。 |
hs_color |
是 | 包含两个浮点数的列表，表示您希望灯光呈现的颜色的色调和饱和度。色调范围是 0-360，饱和度范围是 0-100。 |
xy_color |
是 | 包含两个浮点数的列表，表示您希望灯光呈现的 xy 颜色。两个用逗号分隔的浮点数，表示 xy 中的颜色。 |
rgb_color |
是 | 包含三个 0 到 255 之间的整数的列表，表示您希望灯光呈现的 RGB 颜色。三个用逗号分隔的整数，表示 RGB 中的颜色，位于方括号内。 |
rgbw_color |
是 | 包含四个 0 到 255 之间的整数的列表，表示您希望灯光呈现的 RGBW 颜色。四个用逗号分隔的整数，表示 RGBW（红色、绿色、蓝色、白色）中的颜色，位于方括号内。此属性将被不支持 RGBW 颜色的灯光忽略。 |
rgbww_color |
是 | 包含五个 0 到 255 之间的整数的列表，表示您希望灯光呈现的 RGBWW 颜色。五个用逗号分隔的整数，表示 RGBWW（红色、绿色、蓝色、冷白、暖白）中的颜色，位于方括号内。此属性将被不支持 RGBWW 颜色的灯光忽略。 |
color_temp_kelvin |
是 | 表示您希望灯光呈现的色温的开尔文整数。 |
kelvin |
是 | （已弃用）请改用 color_temp_kelvin。 |
color_temp |
是 | （已弃用）或者，您可以以米红色（Mireds）指定色温。 |
color_name |
是 | 可读的颜色名称字符串，例如 blue 或 goldenrod。支持所有 CSS3 颜色名称 |
brightness |
是 | 整数在 0 与 255 之间，表示灯光的亮度，其中 0 意味着灯光关闭，1 是最小亮度，255 是灯光支持的最大亮度。 |
brightness_pct |
是 | 或者，您可以以百分比（0 到 100 之间的数字）指定亮度，其中 0 意味着灯光关闭，1 是最小亮度，100 是灯光支持的最大亮度。 |
brightness_step |
是 | 按指定量更改亮度。应在 -255..255 之间。 |
brightness_step_pct |
是 | 按百分比更改亮度。应在 -100..100 之间。 |
white |
是 | 通过将此设置为 True 将灯光设置为白光模式。请注意，white 没有对应的状态属性，因此 color_mode 状态属性将设置为 white。 |
flash |
是 | 告诉灯光闪烁，可以是值 short 或 long。 |
effect |
是 | 应用效果，如 colorloop 或 random。 |
要将属性应用于实体，您需要在配置中添加 data:。请参见下面的示例
# 示例 configuration.yaml 条目
automation:
- alias: "当检测到运动时打开灯光"
triggers:
- trigger: state
entity_id: binary_sensor.motion_1
to: "on"
actions:
- action: light.turn_on
target:
entity_id: light.living_room
data:
brightness: 255
kelvin: 2700
# Ledlist 早上打开，红色
- alias: "楼梯早上打开"
triggers:
- trigger: time
at: '05:00'
actions:
- action: light.turn_on
target:
entity_id: light.ledliststair
data:
brightness: 130
rgb_color: [255,0,0]
如果未发送数据，且存在默认配置，则将应用默认配置。
操作 light.turn_off
关闭一个或多个灯。
| 数据属性 | 可选 | 描述 |
|---|---|---|
entity_id |
否 | 指向灯的 entity_id 的字符串或字符串列表。要目标所有灯，请将 entity_id 设置为 all。 |
transition |
是 | 表示灯光应花费多长时间（以秒为单位）过渡到新状态的整数。 |
flash |
是 | 告诉灯光闪烁，可以是值 short 或 long。 |
操作 light.toggle
切换一个或多个灯的状态。接受与 light.turn_on 操作相同的参数。
注意: 如果对一组灯使用 light.toggle，它将切换每盏灯的单独状态。如果您希望灯光作为单一灯光处理，请使用 灯光组。