jawilson/harmony-api

Harmony API

Harmony API是一个简单的服务器，允许通过HTTP或MQTT查询和控制多个本地Harmony Home Hub及其设备。

通过HTTP，你可以通过几乎任何其他项目的简单HTTP请求来开启/关闭活动、检查Hub状态，以及向单个设备发送命令。通过MQTT，你可以轻松监控设备状态，设置Hub的当前活动或向每个设备发送特定命令，这使得它非常容易集成到现有的智能家居设置中。

核心功能

• 控制多个Harmony Hub
• 列出活动
• 获取当前状态（包括是否所有设备关闭或当前活动是什么）
• 关闭所有设备
• 启动特定活动
• 列出设备
• 列出设备命令
• 为每个设备执行离散命令

使用场景

• 智能家居自动化系统集成，实现设备统一控制
• 通过HTTP接口远程管理家庭设备状态
• 利用MQTT协议实时监控和控制Harmony Hub及其设备

配置说明

Harmony API会自动发现你的Hub。你可以选择添加MQTT broker的主机以连接到它。配置文件示例：

json
{
  "mqtt_host": "mqtt://192.168.1.106",
  "mqtt_options": {
      "port": 1883,
      "username": "someuser",
      "password": "somepassword",
      "rejectUnauthorized": false
  },
  "topic_namespace": "home/harmony"
}

mqtt_options是可选的，允许的主机和选项值请参考https://github.com/mqttjs/MQTT.js#connect%E9%A1%B9%E7%9B%AE%E3%80%82

Docker部署示例

调整以下命令中的/path/to/your/config指向你存储配置的文件夹，然后运行：

bash
docker run --name="harmony-api" -v /path/to/your/config:/config \
    -p 8282:8282 -d jawilson/harmony-api

这将启动Harmony API并从Docker主机的8282端口提供Web界面。Hub发现需要主机网络（--net=host），但你也可以在config.json中指定Harmony Hub：

json
  "hubs": [
    {
      "name": "客厅",
      "ip": "192.168.1.111"
    },
    {
      "name": "卧室",
      "ip": "192.168.1.112"
    }
  ]