node-red-contrib-knx-ultimate/nodes/locales/zh-CN/knxUltimateHueButton.html

Control your KNX and KNX Secure intallation via Node-Red! A bunch of KNX nodes, with integrated Philips HUE control and ETS group address importer. Easy to use and highly configurable.

<script type="text/markdown" data-help-name="knxUltimateHueButton">
🌐 语言: [EN](https://github.com/Supergiovane/node-red-contrib-knx-ultimate/wiki/HUE+Button) | [IT](https://github.com/Supergiovane/node-red-contrib-knx-ultimate/wiki/it-HUE+Button) | [DE](https://github.com/Supergiovane/node-red-contrib-knx-ultimate/wiki/de-HUE+Button) | [简体中文](https://github.com/Supergiovane/node-red-contrib-knx-ultimate/wiki/zh-CN-HUE+Button)

<!-- NAV START -->
导航: [首页](https://github.com/Supergiovane/node-red-contrib-knx-ultimate/wiki/zh-CN-Home)
概览: [Changelog](https://github.com/Supergiovane/node-red-contrib-knx-ultimate/blob/master/CHANGELOG.md) • [常见问题](https://github.com/Supergiovane/node-red-contrib-knx-ultimate/wiki/zh-CN-FAQ-Troubleshoot) • [安全](https://github.com/Supergiovane/node-red-contrib-knx-ultimate/wiki/zh-CN-SECURITY) • [文档：语言栏](https://github.com/Supergiovane/node-red-contrib-knx-ultimate/wiki/zh-CN-Docs-Language-Bar)
KNX 设备: [网关](https://github.com/Supergiovane/node-red-contrib-knx-ultimate/wiki/zh-CN-Gateway-configuration) • [设备](https://github.com/Supergiovane/node-red-contrib-knx-ultimate/wiki/zh-CN-KNX+Node+Configuration) • [节点保护](https://github.com/Supergiovane/node-red-contrib-knx-ultimate/wiki/zh-CN-Protections)
其他 KNX 节点: [场景控制器](https://github.com/Supergiovane/node-red-contrib-knx-ultimate/wiki/zh-CN-SceneController-Configuration) • [看门狗](https://github.com/Supergiovane/node-red-contrib-knx-ultimate/wiki/zh-CN-WatchDog-Configuration) • [日志节点](https://github.com/Supergiovane/node-red-contrib-knx-ultimate/wiki/zh-CN-Logger-Configuration) • [全局上下文](https://github.com/Supergiovane/node-red-contrib-knx-ultimate/wiki/zh-CN-GlobalVariable) • [告警器](https://github.com/Supergiovane/node-red-contrib-knx-ultimate/wiki/zh-CN-Alerter-Configuration) • [负载控制](https://github.com/Supergiovane/node-red-contrib-knx-ultimate/wiki/zh-CN-LoadControl-Configuration) • [查看器](https://github.com/Supergiovane/node-red-contrib-knx-ultimate/wiki/zh-CN-knxUltimateViewer) • [自动响应](https://github.com/Supergiovane/node-red-contrib-knx-ultimate/wiki/zh-CN-KNXAutoResponder) • [HA 翻译器](https://github.com/Supergiovane/node-red-contrib-knx-ultimate/wiki/zh-CN-HATranslator)
HUE: [Bridge](https://github.com/Supergiovane/node-red-contrib-knx-ultimate/wiki/zh-CN-HUE+Bridge+configuration) • [灯](https://github.com/Supergiovane/node-red-contrib-knx-ultimate/wiki/zh-CN-HUE+Light) • [电池](https://github.com/Supergiovane/node-red-contrib-knx-ultimate/wiki/zh-CN-HUE+Battery) • [按钮](https://github.com/Supergiovane/node-red-contrib-knx-ultimate/wiki/zh-CN-HUE+Button) • [接触](https://github.com/Supergiovane/node-red-contrib-knx-ultimate/wiki/zh-CN-HUE+Contact+sensor) • [设备软件更新](https://github.com/Supergiovane/node-red-contrib-knx-ultimate/wiki/zh-CN-HUE+Device+software+update) • [光照传感器](https://github.com/Supergiovane/node-red-contrib-knx-ultimate/wiki/zh-CN-HUE+Light+sensor) • [运动](https://github.com/Supergiovane/node-red-contrib-knx-ultimate/wiki/zh-CN-HUE+Motion) • [场景](https://github.com/Supergiovane/node-red-contrib-knx-ultimate/wiki/zh-CN-HUE+Scene) • [Tap Dial](https://github.com/Supergiovane/node-red-contrib-knx-ultimate/wiki/zh-CN-HUE+Tapdial) • [温度](https://github.com/Supergiovane/node-red-contrib-knx-ultimate/wiki/zh-CN-HUE+Temperature+sensor) • [Zigbee 连接](https://github.com/Supergiovane/node-red-contrib-knx-ultimate/wiki/zh-CN-HUE+Zigbee+connectivity)
示例: [日志](https://github.com/Supergiovane/node-red-contrib-knx-ultimate/wiki/zh-CN-Logger-Sample) • [Switch Light](https://github.com/Supergiovane/node-red-contrib-knx-ultimate/wiki/-Sample---Switch-light) • [Dimming](https://github.com/Supergiovane/node-red-contrib-knx-ultimate/wiki/-Sample---Dimming) • [RGB color](https://github.com/Supergiovane/node-red-contrib-knx-ultimate/wiki/-Sample---RGB-Color) • [RGBW color + White](https://github.com/Supergiovane/node-red-contrib-knx-ultimate/wiki/-Sample---RGBW-Color-plus-White) • [Command a scene actuator](https://github.com/Supergiovane/node-red-contrib-knx-ultimate/wiki/-Sample---Control-a-scene-actuator) • [Datapoint 213.x 4x Setpoint](https://github.com/Supergiovane/node-red-contrib-knx-ultimate/wiki/-Sample---DPT213) • [Datapoint 222.x 3x Setpoint](https://github.com/Supergiovane/node-red-contrib-knx-ultimate/wiki/-Sample---DPT222) • [Datapoint 237.x DALI diags](https://github.com/Supergiovane/node-red-contrib-knx-ultimate/wiki/-Sample---DPT237) • [Datapoint 2.x 1 bit proprity](https://github.com/Supergiovane/node-red-contrib-knx-ultimate/wiki/-Sample---DPT2) • [Datapoint 22.x RCHH Status](https://github.com/Supergiovane/node-red-contrib-knx-ultimate/wiki/-Sample---DPT22) • [Datetime to BUS](https://github.com/Supergiovane/node-red-contrib-knx-ultimate/wiki/-Sample---DateTime-to-BUS) • [Read Status](https://github.com/Supergiovane/node-red-contrib-knx-ultimate/wiki/-Sample---Read-value-from-Device) • [Virtual Device](https://github.com/Supergiovane/node-red-contrib-knx-ultimate/wiki/-Sample---Virtual-Device) • [Subtype decoded](https://github.com/Supergiovane/node-red-contrib-knx-ultimate/wiki/-Sample---Subtype) • [Alexa](https://github.com/Supergiovane/node-red-contrib-knx-ultimate/wiki/-Sample---Alexa) • [Apple Homekit](https://github.com/Supergiovane/node-red-contrib-knx-ultimate/wiki/-Sample---Apple-Homekit) • [Google Home](https://github.com/Supergiovane/node-red-contrib-knx-ultimate/wiki/-Sample---Google-Assistant) • [Switch on/off POE port of Unifi switch](https://github.com/Supergiovane/node-red-contrib-knx-ultimate/wiki/-Sample---UnifiPOE) • [Set configuration by msg](https://github.com/Supergiovane/node-red-contrib-knx-ultimate/wiki/-Sample-setConfig) • [Scene Controller node](https://github.com/Supergiovane/node-red-contrib-knx-ultimate/wiki/Sample-Scene-Node) • [WatchDog node](https://github.com/Supergiovane/node-red-contrib-knx-ultimate/wiki/-Sample---WatchDog) • [Global Context node](https://github.com/Supergiovane/node-red-contrib-knx-ultimate/wiki/SampleGlobalContextNode) • [Alerter node](https://github.com/Supergiovane/node-red-contrib-knx-ultimate/wiki/SampleAlerter) • [Load control node](https://github.com/Supergiovane/node-red-contrib-knx-ultimate/wiki/SampleLoadControl) • [Viewer node](https://github.com/Supergiovane/node-red-contrib-knx-ultimate/wiki/knxUltimateViewer) • [MySQL, InfluxDB, MQTT Sample](https://github.com/Supergiovane/node-red-contrib-knx-ultimate/wiki/Sample-KNX2MQTT-KNX2MySQL-KNX2InfluxDB)
Contribute to Wiki: [Link](https://github.com/Supergiovane/node-red-contrib-knx-ultimate/wiki/zh-CN-Manage-Wiki)
<!-- NAV END -->

---

<p>Hue Button 节点利用 <code>button.button_report.event</code> 将 Hue 按钮事件映射到 KNX，并在流程输出中提供相同的事件。</p>

在 GA 输入框（名称或组地址）中键入即可关联 KNX GA；输入时会显示匹配的设备。

**常规**
|属性|说明|
|--|--|
| KNX 网关 | 选择要使用的 KNX 网关 |
| HUE Bridge | 选择要使用的 HUE Bridge |
| Hue 按钮 | 要使用的 Hue 按钮（输入时自动补全） |

**开关**
|属性|说明|
|--|--|
| 开关 | 由 <code>short\_release</code>（短按释放）触发的 GA。 |
| 状态 GA | 启用"每次事件切换数值”时的可选反馈 GA，用于保持内部状态同步。 |

**调光**
|属性|说明|
|--|--|
| 调光 | <code>long\_press</code>/<code>repeat</code> 事件期间用于调光的 GA（通常为 DPT 3.007）。 |

**行为**
|属性|说明|
|--|--|
| 每次事件切换数值 | 启用后自动在 <code>true/false</code> 与调光方向之间切换。 |
| 开关负载 | 禁用切换时发送到 KNX/流程的固定负载。 |
| 调光负载 | 禁用切换时发送到 KNX/流程的固定调光方向。 |

### 输出

1. 标准输出
   : `msg.payload` 为布尔值或调光对象；`msg.event` 为 Hue 事件字符串（例如 `short_release`, `repeat`）。

### 详细信息

`msg.event` 对应 `button.button_report.event`，原始 Hue 事件包含在 `msg.rawEvent` 中。使用可选的状态 GA 可以让内部切换状态与墙壁开关等外部设备保持一致。
</script>