如何轻松控制米家智能设备？米家API终极使用指南 🚀
【免费下载链接】mijia-api 米家API 
项目地址: https://gitcode.com/gh_mirrors/mi/mijia-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开源许可证。
⚠️ 免责声明
- 本项目仅供学习交流使用，不得用于商业用途
- 用户使用本项目所产生的任何后果，需自行承担风险
- 开发者不对使用本项目产生的任何直接或间接损失负责
通过米家API，你可以轻松打造个性化的智能家居控制方案。无论是简单的设备控制还是复杂的自动化场景，米家API都能满足你的需求。立即开始探索，解锁米家智能设备的无限可能吧！ 智能家居，尽在掌握！ 💡
【免费下载链接】mijia-api 米家API 项目地址: https://gitcode.com/gh_mirrors/mi/mijia-api
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
