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

2026-02-05 04:22:11作者：盛欣凯Ernestine

米家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