米家 API 使用指南：智能家居设备控制

米家 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) 远程调整设备参数
• 动作执行：run_action(data) 触发设备特定功能

🛠️ 实用技巧与最佳实践

命令行工具：无需编程的控制方式

米家 API 提供了便捷的命令行界面，让非技术用户也能轻松操作：

# 查看所有可用设备
mijiaAPI -l
# 获取特定设备详细信息
mijiaAPI --get_device_info yeelink.light.lamp4
# 设置设备属性
mijiaAPI set --dev_name "智能台灯" --prop_name "brightness" --value 60
# 语音控制（小爱音箱）
mijiaAPI --run "打开卧室灯光" --quiet

示例代码库：即学即用的参考资源

项目中的 demos/ 目录包含了丰富的实用示例：

• test_device_attr.py：设备属性操作演示
• test_device_func.py：功能调用示例
• test_device_wifispeaker.py：小爱音箱控制
• test_get_statistics.py：设备统计信息获取

🔧 常见问题解决方案

登录失败：优先选择二维码登录方式，确保小米账号已授权设备控制 设备发现：检查设备是否在线，网络连接是否正常 参数查询：设备属性参数可从官方产品库获取对应型号的技术规格

📚 项目资源与文档

项目提供了完整的文档支持：

• README.md：快速入门指南
• FAQ.md：常见问题解答
• CHANGELOG.md：版本更新记录

⚠️ 使用须知

• 本项目遵循开源协议，仅供学习和个人使用
• 用户需对使用过程中产生的后果自行负责
• 不得将本项目用于商业用途