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

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

MiIO

** 这是一个来自原始dartlang miio包的复制品，仅为了使其符合dart 3.x版本。**

Dart实现用于MiIO LAN协议。

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

CLI

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

安装

1. 从Pub激活：

pub global activate miio

1. 从GitHub Actions下载预构建的二进制文件

示例

# 发送到广播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 bits unsigned int
    Length in bytes of the whole packet, including header(0x20 bytes).

Unknown: 32 bits
    This value is always 0.
    0xFFFFFFFF in "Hello" packet.

Device ID: 32 bits
    Unique number. Possibly derived from the MAC address.
    0xFFFFFFFF in "Hello" packet.

Stamp: 32 bit unsigned int
    Continously increasing counter.
    Number of seconds since device startup.

MD5 Checksum:
    Calculated for the whole packet including the MD5 field itself,
    which must be initialized with token.

    In "Hello" packet,
    this field contains the 128-bit 0xFF.

    In the response to the first "Hello" packet,
    this field contains the 128-bit device token.

Optional variable-sized payload:
    Payload encrypted with AES-128-CBC (PKCS#7 padding).

        Key = MD5(Token)
        IV  = MD5(Key + Token)

Flutter示例代码

以下是一个完整的Flutter应用示例，展示如何使用miio_new插件来控制智能家居设备。

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

dependencies:
  flutter:
    sdk: flutter
  miio_new:
    git:
      url: https://github.com/your-repo/miio_new.git

接下来，在你的Flutter应用中导入并使用miio_new插件：

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

void main() {
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: Text('MiIO控制示例'),
        ),
        body: Center(
          child: ElevatedButton(
            onPressed: () async {
              // 初始化MiIO客户端
              final client = MiioClient(
                ipAddress: '192.168.1.100',
                token: 'ffffffffffffffffffffffffffffffff',
              );

              try {
                // 获取设备信息
                final info = await client.getInfo();
                print('设备信息: $info');

                // 控制设备开关
                await client.setPower(true);
                print('设备已开启');
              } catch (e) {
                print('发生错误: $e');
              }
            },
            child: Text('控制设备'),
          ),
        ),
      ),
    );
  }
}