pyharmony 使用教程

pyharmony 使用教程

pyharmonyPython library for connecting to and controlling the Logitech Harmony Link项目地址:https://gitcode.com/gh_mirrors/py/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 的全面控制。

pyharmonyPython library for connecting to and controlling the Logitech Harmony Link项目地址:https://gitcode.com/gh_mirrors/py/pyharmony