米家 API 使用指南:智能家居设备控制
米家 API 是一个功能强大的 Python 工具库,让开发者和普通用户都能轻松控制小米智能设备。通过封装复杂的网络通信协议,您只需几行代码即可实现设备远程操控、状态监测和场景自动化,打造专属的智能家居体验。
🌟 米家 API 的核心优势
简单易用:无需深入了解底层技术细节,初学者也能快速上手
功能全面:支持设备发现、属性设置、动作执行等核心操作
兼容性强:适配米家生态链中的各类智能设备
扩展灵活:提供丰富的 API 接口,满足个性化开发需求
介绍米家 API 这一 Python 工具库的使用方法。通过安装库并扫码登录,开发者可远程控制小米智能设备,实现状态监测与场景自动化。内容涵盖设备发现、属性设置、动作执行及命令行操作,提供详细代码示例与最佳实践,帮助用户快速构建智能家居系统。
米家 API 是一个功能强大的 Python 工具库,让开发者和普通用户都能轻松控制小米智能设备。通过封装复杂的网络通信协议,您只需几行代码即可实现设备远程操控、状态监测和场景自动化,打造专属的智能家居体验。
简单易用:无需深入了解底层技术细节,初学者也能快速上手
功能全面:支持设备发现、属性设置、动作执行等核心操作
兼容性强:适配米家生态链中的各类智能设备
扩展灵活:提供丰富的 API 接口,满足个性化开发需求
推荐方式:通过 PyPI 安装
pip install mijiaAPI
备选方案:从源码构建
git clone https://gitcode.com/gh_mirrors/mi/mijia-api
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:版本更新记录米家 API 为您打开了智能家居控制的大门,无论您是技术爱好者还是普通用户,都能通过这个强大的工具实现个性化的设备管理。

微信公众号「极客日志」,在微信中扫描左侧二维码关注。展示文案:极客日志 zeeklog
解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具,curl 转代码在线工具,online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online
将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML 转 Markdown 互为补充。 在线工具,Markdown 转 HTML在线工具,online
将 HTML 片段转为 GitHub Flavored Markdown,支持标题、列表、链接、代码块与表格等;浏览器内处理,可链接预填。 在线工具,HTML 转 Markdown在线工具,online
通过删除不必要的空白来缩小和压缩JSON。 在线工具,JSON 压缩在线工具,online