如何用MiService实现智能家居自动化：从入门到精通

2026-04-07 11:19:10作者：丁柯新Fawn

项目地址：https://gitcode.com/gh_mirrors/mi/MiService

你是否曾想过用代码控制家中的小米智能设备？是否希望通过编程实现灯光自动调节、设备状态监控等个性化场景？MiService作为一款强大的Python库，正是为解决这些需求而生。本文将带你深入探索如何利用这个工具实现小米设备控制，掌握智能家居API的使用方法，从基础操作到高级应用，全面解锁智能家居自动化的无限可能。

为什么需要智能家居自动化工具？

在智能家居日益普及的今天，你是否遇到过这些场景：下班回家希望灯光自动亮起，离家时所有设备自动关闭，或者根据环境变化自动调节空调温度？传统的手动控制不仅繁琐，也无法实现复杂的联动逻辑。MiService通过编程接口将小米设备的控制能力开放给开发者，让你可以根据个人需求定制自动化规则，打造真正智能的生活空间。

MiService能为你解决什么问题？

MiService是一个基于Python的开源项目，它像一座桥梁🔧，连接了你的代码与小米智能家居设备。通过简洁的API设计，你可以轻松实现设备发现、状态查询、远程控制等核心功能。无论是想构建个人智能家居系统，还是开发商业级智能应用，MiService都能提供稳定可靠的技术支持。

核心功能一览

设备统一管理：通过一个接口控制多种类型的小米智能设备
异步操作支持：高效处理多设备并发控制，响应迅速
完整认证体系：安全处理小米账号登录和权限验证
丰富命令集：支持设备属性查询、设置和动作调用

快速上手：环境搭建与基础配置

如何快速将MiService集成到你的开发环境中？只需完成以下几个简单步骤：

安装依赖包

打开终端，执行以下命令安装必要的Python库：
```
pip3 install aiohttp aiofiles miservice
```

配置环境变量

在使用MiService前，需要设置小米账号信息：

export MI_USER="你的小米账号"
export MI_PASS="你的小米密码"

获取项目代码

克隆项目仓库到本地：

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

完成以上步骤后，你就拥有了控制小米智能家居的开发环境。

设备发现实战：如何找到并识别你的智能设备

不知道家里有哪些设备可以控制？MiService提供了简单的设备发现功能，让你一目了然。

列出所有设备

在项目目录下执行以下命令：

python micli.py list

这个命令会返回你账号下所有智能设备的关键信息，包括：

设备名称（如"客厅灯"）
设备类型（如"xiaomi.wifispeaker.lx04"）
设备ID（DID）
通信Token

理解设备标识

每个设备都有唯一的设备ID（DID），这是控制设备的关键标识。例如，当你看到类似"2-1"这样的标识时，"2"代表设备ID，"1"代表该设备的某个属性。

属性控制技巧：掌握设备状态查询与设置

控制智能设备的核心在于对其属性的操作。MiService提供了直观的命令方式来查询和修改设备属性。

查询设备属性

要查询设备的特定属性，使用以下命令格式：

python micli.py 设备ID-属性ID

例如，查询ID为2的设备的属性1：

python micli.py 2-1

设置设备属性

修改设备属性的命令格式如下：

python micli.py 设备ID=#属性值

例如，将ID为2的设备属性设置为60：

python micli.py 2=#60

设备接口文档查询

想知道某个设备支持哪些属性和操作？可以查询设备的接口规范：

python micli.py spec 设备类型

例如，查询小爱音箱的接口文档：

python micli.py spec xiaomi.wifispeaker.lx04

代码实战：构建你的第一个智能家居控制程序

了解了基础命令后，让我们通过Python代码实现一个简单的自动化场景：根据环境光照度自动调节灯光亮度。

from miservice import MiAccount, MiIOService
import asyncio

async def auto_adjust_light():
    # 1. 初始化账户
    # 创建MiAccount实例，传入会话对象、用户名、密码和token存储路径
    account = MiAccount(None, "你的小米账号", "你的小米密码", ".mi.token")
    
    # 2. 登录并获取认证
    # 使用"xiaomiio"服务类型登录
    await account.login("xiaomiio")
    
    # 3. 创建设备服务实例
    service = MiIOService(account)
    
    # 4. 获取光照传感器数据（假设传感器设备ID为3，光照属性ID为1）
    light_level = await service.get_property(3, "3-1")
    print(f"当前光照度: {light_level}")
    
    # 5. 根据光照度调节灯光（假设灯光设备ID为2，亮度属性ID为1）
    if light_level < 50:  # 如果光照度低于50
        await service.set_property(2, "2-1", 80)  # 设置亮度为80%
        print("灯光已调亮")
    else:
        await service.set_property(2, "2-1", 30)  # 否则设置为30%
        print("灯光已调暗")

# 运行异步函数
asyncio.run(auto_adjust_light())

这段代码展示了MiService的核心使用流程：账户认证→设备连接→数据获取→设备控制。你可以根据自己的设备ID和属性ID进行修改，实现个性化的自动化控制。

高级应用：批量控制与并发操作

当你需要同时控制多个设备时，MiService的异步特性可以发挥巨大优势。下面是一个批量控制设备的示例：

import asyncio
from miservice import MiAccount, MiIOService

async def control_multiple_devices(account):
    # 创建设备服务实例
    service = MiIOService(account)
    
    # 定义要控制的设备和命令
    devices = [
        {"id": 2, "property": "2-1", "value": 100},  # 灯光设为最亮
        {"id": 4, "property": "4-2", "value": 26},   # 空调设为26度
        {"id": 5, "property": "5-3", "value": "on"}  # 加湿器开启
    ]
    
    # 创建任务列表
    tasks = []
    for device in devices:
        # 为每个设备创建一个设置属性的任务
        task = service.set_property(
            device["id"], 
            device["property"], 
            device["value"]
        )
        tasks.append(task)
    
    # 并发执行所有任务
    results = await asyncio.gather(*tasks)
    
    # 处理结果
    for i, result in enumerate(results):
        if result:
            print(f"设备 {devices[i]['id']} 控制成功")
        else:
            print(f"设备 {devices[i]['id']} 控制失败")

# 主函数
async def main():
    account = MiAccount(None, "你的小米账号", "你的小米密码", ".mi.token")
    await account.login("xiaomiio")
    await control_multiple_devices(account)

asyncio.run(main())