Philips Hue 控制库 Phue 使用教程

Philips Hue 控制库 Phue 使用教程

phue A Python library for the Philips Hue system 项目地址: https://gitcode.com/gh_mirrors/ph/phue

1. 项目介绍

Phue 是一个开源的 Python 库，用于控制 Philips Hue 照明系统。它完全兼容 Philips Hue API 1.0 版本，支持灯光、分组、计划、场景和传感器等功能。Phue 库不依赖任何外部库，拥有简洁的结构，只有一个 phue.py 文件，既可以以过程式方式使用，也可以以面向对象的方式使用。

2. 项目快速启动

在开始之前，确保你的 Philips Hue 桥接器已经设置好并且可以连接到网络。

安装

你可以使用 pip 来安装 Phue：

pip install phue

或者，如果你更喜欢手动安装，只需将 phue.py 文件放入你的 Python 搜索路径或 site-packages 目录中。

连接到 Philips Hue 桥接器

首先，你需要创建一个 Bridge 实例并连接到你的 Philips Hue 桥接器：

from phue import Bridge

b = Bridge('ip_of_your_bridge')
b.connect()

确保将 'ip_of_your_bridge' 替换为你的 Philips Hue 桥接器的 IP 地址。

控制灯光

以下是如何使用 Phue 库控制灯光的基础示例：

# 打开/关闭灯光
b.set_light(1, 'on', True)  # 打开编号为1的灯光
b.set_light(1, 'on', False)  # 关闭编号为1的灯光

# 调整灯光亮度
b.set_light(1, 'bri', 254)  # 将编号为1的灯光亮度设置为最大
b.set_light(1, 'bri', 127)  # 将编号为1的灯光亮度设置为50%

# 使用灯光名称
b.set_light('Living Room', 'on', True)  # 打开名为 'Living Room' 的灯光

3. 应用案例和最佳实践

控制多个灯光

你可以同时控制多个灯光，只需传递一个包含灯光 ID 或名称的列表：

b.set_light([1, 2], 'on', True)  # 同时打开编号为1和2的灯光

设置过渡时间

在 Hue API 中，过渡时间以十分之一秒为单位。你可以在调用 set_light 方法时指定 transitiontime 参数：

command = {
    'transitiontime': 300,  # 30秒
    'on': True,
    'bri': 254
}
b.set_light(1, command)

创建灯光场景

你可以创建场景来保存和恢复灯光的特定状态：

# 创建一个场景
b.create_scene('MyScene', [1, 2], {'name': 'My Scene', 'transitiontime': 300})

4. 典型生态项目

目前，Phue 社区中并没有特定的“生态项目”直接与之关联。但是，Phue 可以与各种智能家居系统集成，例如通过 Home Assistant 或其他自动化工具，实现更为复杂的自动化流程和场景。开发者可以根据自己的需求，将 Phue 库集成到自己的项目中，创建自定义的智能家居解决方案。

phue A Python library for the Philips Hue system 项目地址: https://gitcode.com/gh_mirrors/ph/phue