革新性小米设备控制工具：MiService高效操控指南

MiService是一款基于Python的开源项目，核心价值在于让用户通过简单命令行操作实现对小米智能设备的全面控制。无论是查询设备状态、调整参数设置，还是执行自定义指令，都能通过简洁的命令快速完成，为小米生态用户提供高效便捷的设备管理体验。

设备连接全流程：3步完成环境配置

1. 获取项目源码

首先克隆项目仓库到本地环境：

git clone https://gitcode.com/gh_mirrors/mi/MiService
cd MiService

2. 安装依赖组件

通过pip安装必要的Python依赖库：

pip3 install aiohttp aiofiles

3. 配置账号信息

设置小米账号环境变量进行身份验证：

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

设备管理核心操作：从发现到控制

设备发现命令

使用以下命令列出账号下所有智能设备：

python3 micli.py list

执行后将显示设备名称、设备ID（DID）和设备类型等关键信息，记录目标设备的DID用于后续操作。

设备状态查询

通过服务ID（siid）和属性ID（piid）组合查询设备状态：

export MI_DID=您的设备ID
python3 micli.py 2-1

其中数字组合"2-1"代表查询特定设备属性，具体ID可通过设备规格文档获取。

设备参数设置

以调整设备音量为例，使用等号语法设置属性值：

python3 micli.py 2=#60

此命令将设备音量设置为60，实际效果取决于设备支持的调节范围。

高级功能解锁技巧：探索设备潜力

设备接口规格查询

通过spec命令获取设备完整能力描述：

python3 micli.py spec

该命令输出设备支持的所有服务、属性和动作列表，帮助发现隐藏功能。

自定义动作执行

以控制小爱音箱播报为例，使用动作ID加文本参数实现语音播报：

python3 micli.py 5 欢迎使用MiService智能控制

数字"5"代表动作ID，后续文本为播报内容，具体ID需参考设备接口文档。

实战案例分析：场景化设备控制

智能家居联动场景

通过编写简单脚本实现多设备联动，例如当温湿度传感器检测到室内温度超过26℃时，自动开启空调并设置为24℃。核心实现依赖设备交互模块中的设备控制接口，结合定时任务调度实现自动化控制。

批量设备管理方案

对于拥有多台小米设备的用户，可通过设备名称快速切换控制目标，避免反复设置MI_DID环境变量：

python3 micli.py --name "客厅小爱音箱" 5 现在是下午3点

使用--name参数直接指定设备名称，简化多设备管理流程。

使用技巧与注意事项

环境变量持久化

建议将账号信息添加到~/.bashrc或~/.zshrc文件中，避免每次终端重启后重新设置：

echo 'export MI_USER=您的账号' >> ~/.bashrc
echo 'export MI_PASS=您的密码' >> ~/.bashrc
source ~/.bashrc

错误排查要点

• 连接失败时检查网络状态和账号密码正确性
• 设备无响应时确认设备处于在线状态
• 命令执行错误可添加-v参数查看详细调试信息

MiService通过简洁的命令行接口，将复杂的小米设备控制逻辑封装为易于使用的指令集，无论是智能家居爱好者还是开发者，都能快速掌握并实现个性化的设备控制方案。通过探索设备接口规格和组合不同指令，还能实现更复杂的自动化场景，让小米智能设备发挥更大价值。