如何用MiService轻松掌控小米智能设备

MiService是一款功能强大的Python开源项目，专为与小米云服务交互设计，让用户能通过简单的命令行操作控制家中的小米智能设备。无论是查询设备状态、调整设备设置，还是让智能音箱播报自定义内容，MiService都能帮你轻松实现。

设备连接全流程

1️⃣ 获取项目源码并安装依赖

首先需要克隆项目并安装必要的依赖包，打开终端执行以下命令：

git clone https://gitcode.com/gh_mirrors/mi/MiService  # 克隆项目仓库
cd MiService  # 进入项目目录
pip3 install aiohttp aiofiles  # 安装所需依赖库

2️⃣ 配置小米账号信息

在使用MiService前，需要配置小米账号信息用于认证，在终端中输入：

export MI_USER=您的小米账号用户名  # 设置小米账号用户名环境变量
export MI_PASS=您的小米账号密码  # 设置小米账号密码环境变量

3️⃣ 发现并查看设备列表

配置完成后，使用以下命令查看账号下的小米设备：

python3 micli.py list  # 列出所有绑定设备

执行后会显示设备名称、设备ID（DID）和类型等信息，记录下要操作设备的ID。

设备控制基础操作指南

查询设备属性状态

要了解设备当前状态，可使用以下命令查询设备属性：

export MI_DID=您的设备ID  # 设置要操作的设备ID
python3 micli.py 2-1  # 查询设备属性，2代表服务ID（siid），1代表属性ID（piid）

设置设备属性参数

调整设备设置，例如将设备音量设为60：

python3 micli.py 2=#60  # 设置属性，格式为"服务ID=#值"

执行设备动作命令

让设备执行特定动作，如让小爱音箱播报文本：

python3 micli.py 5 您好，欢迎使用MiService！  # 执行动作，5代表动作ID，后面是参数

高级控制技巧集

查询设备完整接口规格

想了解设备所有可用属性和动作，可使用：

python3 micli.py spec  # 显示设备MIoT接口能力描述

环境变量管理技巧

建议将账号信息保存在环境配置文件中，避免每次手动输入。例如在~/.bashrc或~/.zshrc中添加：

export MI_USER=您的小米账号用户名
export MI_PASS=您的小米账号密码

添加后执行source ~/.bashrc或source ~/.zshrc使配置生效。

实用场景案例分析

案例一：定时控制智能灯开关

结合系统定时任务工具（如crontab），可实现定时控制设备。例如每天晚上7点打开智能灯：

# 编辑crontab配置
crontab -e
# 添加以下内容
0 19 * * * export MI_DID=设备ID && cd /path/to/MiService && python3 micli.py 2=#1

（注：2=#1表示将开关属性设为开启状态，具体ID需根据设备规格文档确定）

案例二：通过语音助手触发设备操作

将MiService命令集成到语音助手（如 Siri 快捷指令），实现语音控制设备。在快捷指令中配置执行shell脚本：

cd /path/to/MiService && export MI_DID=设备ID && python3 micli.py 5 我到家了，欢迎我吧

常见问题解答

Q: 执行命令时提示认证失败怎么办？

A: 首先检查小米账号密码是否正确，可重新设置环境变量。若密码正确仍失败，可能是账号开启了二次验证，需在MiService中进行相应配置。

Q: 设备列表为空如何解决？

A: 确认网络连接正常，账号已绑定设备。尝试重新登录账号，执行unset MI_USER MI_PASS后重新设置账号密码。

Q: 如何获取设备的服务ID和属性ID？

A: 执行python3 micli.py spec命令，查看设备接口规格文档，其中会详细列出各服务和属性的ID及含义。

设备兼容性列表

MiService支持大多数小米生态链设备，常见兼容设备包括：

• 小米智能音箱系列（小爱音箱Play、小爱音箱Pro等）
• 小米智能灯泡（Yeelight系列）
• 小米智能插座
• 小米空气净化器
• 小米扫地机器人
• 小米智能门锁

（注：具体设备兼容性可能因设备型号和固件版本有所差异，建议执行python3 micli.py list命令确认设备是否能被识别）