pyharmony 使用教程
1、项目介绍
pyharmony 是一个用于连接和控制 Logitech Harmony Link 或 Ultimate Hub 的 Python 库。它是 bkanuka/pyharmony 的一个分支,旨在:
- 使其可以通过 pip/setup.py 安装
- 统一其他分支中的改进
- 针对 Harmony Link/Hub 的差异进行配置
- 改进项目布局
- 更好的错误处理
- 集成到 Home Assistant (https://home-assistant.io)
2、项目快速启动
安装
首先,通过 pip 安装 pyharmony:
pip install pyharmony
基本使用
以下是一个简单的示例,展示如何连接到 Harmony Hub 并发送一个命令:
from pyharmony import HarmonyClient
# 连接到 Harmony Hub
client = HarmonyClient('192.168.1.100')
# 获取设备信息
devices = client.get_devices()
# 发送命令
client.send_command(device_id=devices[0]['id'], command='PowerOn')
# 断开连接
client.disconnect()
3、应用案例和最佳实践
集成到 Home Assistant
pyharmony 可以集成到 Home Assistant 中,实现自动化控制。以下是一个简单的配置示例:
remote:
- platform: harmony
name: LivingRoomHarmony
host: 192.168.1.100
activity: WatchTV
自动化脚本
你可以编写自动化脚本来控制 Harmony Hub,例如在特定时间自动开启电视:
import schedule
import time
from pyharmony import HarmonyClient
def turn_on_tv():
client = HarmonyClient('192.168.1.100')
devices = client.get_devices()
client.send_command(device_id=devices[0]['id'], command='PowerOn')
client.disconnect()
schedule.every().day.at("20:00").do(turn_on_tv)
while True:
schedule.run_pending()
time.sleep(1)
4、典型生态项目
Home Assistant
Home Assistant 是一个开源的家庭自动化平台,可以集成 pyharmony 实现对 Harmony Hub 的控制。
OpenHAB
OpenHAB 是一个通用的开源家庭自动化系统,也可以通过插件集成 pyharmony。
通过这些生态项目,你可以构建一个完整的家庭自动化系统,实现对 Harmony Hub 的全面控制。