米家 API 使用指南：智能家居设备控制
米家 API 是一个功能强大的 Python 工具库，让开发者和普通用户都能轻松控制小米智能设备。通过封装复杂的网络通信协议，您只需几行代码即可实现设备远程操控、状态监测和场景自动化，打造专属的智能家居体验。
🌟 米家 API 的核心优势
简单易用：无需深入了解底层技术细节，初学者也能快速上手 功能全面：支持设备发现、属性设置、动作执行等核心操作 兼容性强：适配米家生态链中的各类智能设备 扩展灵活：提供丰富的 API 接口，满足个性化开发需求
🚀 快速上手
第一步：安装米家 API
推荐方式：通过 PyPI 安装
pip install mijiaAPI
备选方案：从源码构建
git clone <repository_url>
cd mijia-api
pip install .
第二步：获取设备控制权限
使用二维码登录方式，简单安全：
from mijiaAPI import mijiaLogin
# 扫码登录，轻松获取控制权
login_data = mijiaLogin.QRlogin()
第三步：开始控制智能设备
以控制米家智能台灯为例：
from mijiaAPI import mijiaAPI, mijiaDevice
# 初始化 API 连接
api = mijiaAPI(login_data)
# 创建设备实例
lamp = mijiaDevice(api, dev_name='台灯')
# 控制操作
lamp.on = True
lamp.brightness = 75
lamp.color_temperature = 4500
💡 核心功能深度解析
设备管理与发现
- 获取设备列表：
get_devices_list()一键发现所有联网设备 - 家庭信息查询：
get_homes_list()查看家庭和房间结构 - 场景管理：
get_scenes_list(home_id)获取自动化场景
设备属性操作
- 状态读取：
get_devices_prop(data)实时获取设备状态 - 属性设置：
set_devices_prop(data)远程调整设备参数 - 动作执行： 触发设备特定功能
