如何轻松控制米家智能设备？米家API终极使用指南 🚀

米家API是一款强大的Python工具，让你无需复杂编程即可轻松控制小米智能设备。通过封装米家设备的网络通信协议，开发者和普通用户都能快速实现设备远程控制、状态读取等功能，打造个性化智能家居体验。

🌟 为什么选择米家API？

✅ 核心优势一览

• 简单易用：无需深入了解底层协议，几行代码即可实现设备控制
• 功能全面：支持设备状态查询、属性设置、场景执行等核心功能
• 灵活扩展：丰富的API接口支持自定义开发，满足个性化需求
• 多设备支持：兼容米家生态多种设备，包括灯具、传感器、音箱等

📱 支持的设备类型

米家API已支持多种主流智能设备，包括但不限于：

• 照明设备（台灯、吸顶灯等）
• 环境传感器（温湿度传感器、人体传感器等）
• 智能音箱（小爱音箱系列）
• 空调伴侣
• 更多设备持续更新中...

🚀 快速开始：3步上手米家API

1️⃣ 安装米家API（超简单！）

方法一：通过PyPI安装（推荐）

pip install mijiaAPI

方法二：从源码安装

git clone https://gitcode.com/gh_mirrors/mi/mijia-api
cd mijia-api
pip install .

方法三：使用Poetry（适合开发者）

poetry install

2️⃣ 首次登录：获取控制权限

米家API提供两种登录方式，推荐使用二维码登录：

from mijiaAPI import mijiaLogin

# 二维码登录（推荐）
login_data = mijiaLogin.QRlogin()

# 账号密码登录（可能需要验证码）
# login_data = mijiaLogin.login("你的小米账号", "你的密码")

登录成功后，你将获得控制设备所需的userId、ssecurity、deviceId和serviceToken等信息。

3️⃣ 控制你的第一个设备

以控制米家台灯为例，只需几行代码：

from mijiaAPI import mijiaAPI, mijiaDevice

# 初始化API
api = mijiaAPI(login_data)

# 控制台灯
lamp = mijiaDevice(api, dev_name='台灯')
lamp.on = True               # 打开台灯
lamp.brightness = 80         # 设置亮度为80%
lamp.color_temperature = 4000 # 设置色温为4000K

💻 实用功能详解

🔧 核心API功能

米家API提供丰富的接口，满足各种控制需求：

设备与场景管理

• get_devices_list()：获取所有设备列表
• get_homes_list()：获取家庭及房间信息
• get_scenes_list(home_id)：获取场景列表
• run_scene(scene_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 80

# 使用小爱音箱执行命令
mijiaAPI --run "打开客厅灯" --quiet

📁 示例代码：快速参考

项目的demos文件夹提供了丰富的示例代码，帮助你快速上手：

• test_devices_light.py：控制照明设备示例
• test_devices_sensor.py：读取传感器数据示例
• test_devices_wifispeaker.py：控制小爱音箱示例
• test_get_statistics.py：获取设备统计信息（如耗电量）

🛠️ 常见问题与解决方案

❓ 登录失败怎么办？

• 优先使用二维码登录方式
• 确保小米账号已开启设备控制权限
• 检查网络连接，确保能正常访问小米服务器

⚙️ 如何查找设备属性参数？

设备属性（siid, piid, aiid）可从米家产品库查询，只需访问：https://home.miot-spec.com/spec/{model}（将{model}替换为设备型号）

📱 支持哪些编程语言？

米家API核心使用Python开发，同时提供API接口，可通过其他语言调用。

🙏 致谢与开源许可

本项目基于janzlan/mijia-api开发，采用GPL-3.0开源许可证。

⚠️ 免责声明

• 本项目仅供学习交流使用，不得用于商业用途
• 用户使用本项目所产生的任何后果，需自行承担风险
• 开发者不对使用本项目产生的任何直接或间接损失负责

---

通过米家API，你可以轻松打造个性化的智能家居控制方案。无论是简单的设备控制还是复杂的自动化场景，米家API都能满足你的需求。立即开始探索，解锁米家智能设备的无限可能吧！ 智能家居，尽在掌握！ 💡