Flutter智能家居控制插件miio的使用

Flutter智能家居控制插件miio的使用

Dart实现的MiIO局域网协议。

该协议是一个基于UDP（端口54321）的加密二进制协议，用于配置和控制小米生态系统的智能家庭设备。

CLI

该包包含一个基于miio构建的简单CLI程序。

安装

• 从Pub全局激活：

pub global activate miio

• 从GitHub Action下载预构建的二进制文件：

示例

# 发送发现数据包到广播IP。
miio discover --ip 192.168.1.255

# 向设备发送数据包。
miio send --ip 192.168.1.100 --token ffffffffffffffffffffffffffffffff --payload '{"id": 1, "method": "miIO.info", "params": []}'

# 或者使用设备API。
# 传统方式：
miio device --ip 192.168.1.100 --token ffffffffffffffffffffffffffffffff props -p power
miio device --ip 192.168.1.100 --token ffffffffffffffffffffffffffffffff call -m set_power -p on
# MIoT规范：
miio device --ip 192.168.1.100 --token ffffffffffffffffffffffffffffffff property -s 2 -p 1
miio device --ip 192.168.1.100 --token ffffffffffffffffffffffffffffffff property -s 2 -p 1 -v true

协议

 0                   1                   2                   3
 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| Magic Number = 0x2131         | Packet Length (incl. header)  |
|-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-|
| Unknown                                                       |
|-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-|
| Device ID ("did")                                             |
|-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-|
| Stamp                                                         |
|-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-|
| MD5 Checksum                                                  |
| ... or Device Token in response to the "Hello" packet         |
|-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-|
| Optional variable-sized payload (encrypted)                   |
|...............................................................|


Packet Length: 16位无符号整数
    整个数据包的长度（包括头部），单位为字节。

Unknown: 32位
    这个值始终为0。
    在“Hello”数据包中为0xFFFFFFFF。

Device ID: 32位
    唯一编号。可能来源于MAC地址。
    在“Hello”数据包中为0xFFFFFFFF。

Stamp: 32位无符号整数
    持续增加的计数器。
    自设备启动以来的秒数。

MD5校验和：
    包括MD5字段本身在内的整个数据包计算得到的校验和，
    必须用令牌初始化。

    在“Hello”数据包中，
    此字段包含128位的0xFF。

    在对第一个“Hello”数据包的响应中，
    此字段包含128位的设备令牌。

可选的可变大小有效载荷：
    使用AES-128-CBC（PKCS#7填充）加密的有效载荷。

        密钥 = MD5(令牌)
        初始化向量 = MD5(密钥 + 令牌)

Flutter示例代码

以下是一个完整的Flutter示例代码，展示如何使用miio插件来控制智能设备。

首先，确保在pubspec.yaml文件中添加miio依赖项：

dependencies:
  flutter:
    sdk: flutter
  miio: ^版本号

然后，在你的Flutter应用中使用miio插件进行设备控制：

import 'package:flutter/material.dart';
import 'package:miio/miio.dart';

void main() => runApp(MyApp());

class MyApp extends StatefulWidget {
  [@override](/user/override)
  _MyAppState createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  String _info = '未连接';

  [@override](/user/override)
  void initState() {
    super.initState();
    connectToDevice();
  }

  Future<void> connectToDevice() async {
    try {
      // 初始化MiIO客户端
      final client = MiioClient(
        ip: '192.168.1.100',
        token: 'ffffffffffffffffffffffffffffffff',
      );

      // 获取设备信息
      final info = await client.sendCommand('miIO.info', []);
      setState(() {
        _info = '$info';
      });

      // 控制设备开关
      await client.sendCommand('set_power', ['on']);
    } catch (e) {
      setState(() {
        _info = '错误: $e';
      });
    }
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('MiIO设备控制'),
        ),
        body: Center(
          child: Text(_info),
        ),
      ),
    );
  }
}