必威是什么必威是什么

模板灯

这模板平台创建结合集成的灯光，并提供了为每个灯的亮度，关闭和亮度命令运行脚本或调用服务的能力。

要在安装中启用模板灯，请添加以下内容configuration.yaml文件：

＃示例Configuration.yaml条目光：-平台：模板灯：theatre_lights：友好名称：“剧院灯”Level_Template：“{{{state_attr（'sensor.theater_brightness'，'lux'）| int}}””value_template：“{{{state_attr（'sensor.theater_brightness'，'lux'）| int>0}}””温度_template：“{{states（'input_number.temperature_input'）|int}}”color_template：“（{{states（'input_number.h_input'）|int}}，{{states（'input_number.s_input'）|int}}））forvest_list_template：“{{{state_attr（'light.led_strip'，'forvest_list'）}}””打开：服务：script.theater_lights_on关掉：服务：script.theater_lights_offset_level：服务：script.theater_lights_level数据：亮度：“{{{亮度}}””set_temperature：服务：input_number.set_value数据：价值：“{{{color_temp}}””ENTITY_ID：input_number.temperature_inputset_white_value：服务：input_number.set_value数据：价值：“{{{white_value}}””ENTITY_ID：input_number.white_value_inputset_color：-服务：input_number.set_value数据：价值：“{{{H}}””ENTITY_ID：input_number.h_input-服务：input_number.set_value数据：价值：“{{{s}}””ENTITY_ID：input_number.s_input-服务：light.turn_ondata_template：ENTITY_ID：-Light.LED_STRIP过渡：“{{{过渡|漂浮}}””HS_COLOR：-“{{{HS [0]}}””-“{{{HS [1]}}””set_effect：-服务：light.turn_ondata_template：ENTITY_ID：-Light.LED_STRIP影响：“{{{影响}}””supports_transition_template：“{{{真的}}””

配置变量

寻找您的配置文件？
灯 地图 必需的

灯的清单。
友好名称 细绳 （（可选的）

在前端使用的名称。
唯一身份 细绳 （（可选的）

独特地识别此光的ID。将其设置为唯一值，以通过UI自定义。
value_template 模板 （（可选的，默认：乐观）

定义一个模板以获取光的状态。
Level_Template 模板 （（可选的，默认：乐观）

定义一个模板以获得光的亮度。
温度_template 模板 （（可选的，默认：乐观）

定义一个模板以获取光的色温。
white_value_template 模板 （（可选的，默认：乐观）

定义一个模板以获取光的白色值。
color_template 模板 （（可选的，默认：乐观）

定义一个模板以获取光的颜色。必须渲染元组（色调，饱和）
supports_transition_template 模板 （（可选的，默认：false）

定义一个模板，如果光支持过渡。应返回布尔值（true/false）。如果此值为真的在打开或关闭呼叫中的过渡参数将作为命名参数传递过渡到任何一个脚本。
forvest_list_template 模板 （（包括的，默认：乐观）

定义一个模板以获取支持效果的列表。必须渲染清单
forvest_template 模板 （（包括的，默认：乐观）

定义一个模板以获取光的效果。
min_mireds_template 模板 （（可选的，默认：乐观）

定义一个模板以获取光线的最小值。
max_mireds_template 模板 （（可选的，默认：乐观）

定义一个模板以获取光的最大介绍值。
icon_template 模板 （（可选的）

定义图标或图片的模板，例如，显示不同状态的不同图标。
availability_template 模板 （（可选的，默认：正确）

定义一个模板以获取可用的实体状态。如果模板无法渲染或返回真的，，，，“ 1”，，，，“真的”，，，，“是的”，，，，“上”，，，，“使能够”，或一个非零的数字，实体将是可用的。如果模板返回任何其他值，则实体将为不可用。如果未配置，实体将始终是可用的。请注意，字符串比较不敏感；“真的”和“是的”被允许。
打开 行动 必需的

定义一个灯打开时运行的动作。
关掉 行动 必需的

定义关闭灯时运行的动作。
set_level 行动 （（可选的）

定义在给出亮度命令时运行的动作。只有在打开呼叫只有亮度，并且可选地过渡。
set_temperature 行动 （（可选的）

定义在给出灯光命令时运行的动作。
set_white_value 行动 （（可选的）

定义在给出灯时运行的动作。
set_color 行动 （（可选的）

定义在给出颜色命令时运行的动作。
set_effect 行动 （（包括的）

定义在给出效果命令时运行的动作。

模板和动作变量

基于州的模板实体具有特殊模板变量这个在他们的模板和动作中可用。这这个可变辅助工具自我引用模板和动作中实体的状态和属性。

考虑因素

如果您使用的是需要额外时间加载的平台的状态，则模板灯可能会得到未知启动期间的状态。这会导致日志文件中的错误消息，直到该平台完成加载为止。如果您使用is_state（）在模板中功能，您可以避免这种情况。例如，您将替换{{states.switch.source.state =='on'}}以这种等效的返回真的/错误的并且永远不会给出未知的结果：{{is_state（'switch.source'，'on''）}}}过渡没有自己的脚本，而是将其作为命名参数传递过渡到打开，，，，关掉，，，，亮度，，，，color_temp，，，，影响，，，，HS_COLOR或者white_value脚本。亮度将作为命名参数传递亮度到一个打开，，，，color_temp，，，，影响，，，，HS_COLOR或者white_value脚本如果相应的参数也在呼叫中。在这种情况下，亮度脚本（set_level）不会被调用。如果只传递亮度light.turn_on服务电话set_level脚本称为。

例子

在本节中，您将找到一些现实生活中的示例。

剧院音量控制

此示例显示了实际上是家庭影院卷的灯光。该组件使您可以灵活地提供您想要发送的任何内容作为有效载荷给消费者，包括您可能需要进行的任何比例转换；这媒体播放器组件需要从0.0至1.0。

光：-平台：模板灯：theatre_volume：友好名称：“接收者体积”value_template：>  -{％如果IS_STATE（'Media_player.receiver'，'on'）％}{％如果state_attr（'Media_player.receiver'，'is_volume_muted'）％}离开{％ 别的 ％}上{％ 万一 ％}{％ 别的 ％}离开{％ 万一 ％}打开：服务：Media_player.volume_mute目标：ENTITY_ID：Media_player.Receiver数据：IS_VOLUME_MMETED：错误的关掉：服务：Media_player.volume_mute目标：ENTITY_ID：Media_player.Receiver数据：IS_VOLUME_MMETED：真的set_level：服务：Media_player.volume_set目标：ENTITY_ID：Media_player.Receiver数据：volume_level：“{{{（亮度/255*100）| int/100}}””Level_Template：>  -{％如果IS_STATE（'Media_player.receiver'，'on'）％}{{（state_attr（'Media_player.receiver'，'volume_level'）| float * 255）| int}}}}{％ 别的 ％}0{％ 万一 ％}

更改图标

此示例显示了如何根据光态更改图标。

光：-平台：模板灯：theatre_volume：友好名称：“接收者体积”value_template：>  -{％如果IS_STATE（'Media_player.receiver'，'on'）％}{％如果state_attr（'Media_player.receiver'，'is_volume_muted'）％}离开{％ 别的 ％}上{％ 万一 ％}{％ 别的 ％}离开{％ 万一 ％}icon_template：>  -{％如果IS_STATE（'Media_player.receiver'，'on'）％}{％如果state_attr（'Media_player.receiver'，'is_volume_muted'）％}MDI：灯泡{％ 别的 ％}MDI：灯泡{％ 万一 ％}{％ 别的 ％}MDI：灯泡{％ 万一 ％}打开：服务：Media_player.volume_mute目标：ENTITY_ID：Media_player.Receiver数据：IS_VOLUME_MMETED：错误的关掉：服务：Media_player.volume_mute目标：ENTITY_ID：Media_player.Receiver数据：IS_VOLUME_MMETED：真的

更改实体图片

此示例显示了如何根据光状态更改实体图片。

光：-平台：模板灯：theatre_volume：友好名称：“接收者体积”value_template：>  -{％如果IS_STATE（'Media_player.receiver'，'on'）％}{％如果state_attr（'Media_player.receiver'，'is_volume_muted'）％}离开{％ 别的 ％}上{％ 万一 ％}{％ 别的 ％}离开{％ 万一 ％}icon_template：>  -{％如果IS_STATE（'Media_player.receiver'，'on'）％}{％如果state_attr（'Media_player.receiver'，'is_volume_muted'）％}/local/lightbulb-off.png{％ 别的 ％}/local/lightbulb-on.png{％ 万一 ％}{％ 别的 ％}/local/lightbulb-off.png{％ 万一 ％}打开：服务：Media_player.volume_mute目标：ENTITY_ID：Media_player.Receiver数据：IS_VOLUME_MMETED：错误的关掉：服务：Media_player.volume_mute目标：ENTITY_ID：Media_player.Receiver数据：IS_VOLUME_MMETED：真的