Flutter Mikrotik MNDP协议通信插件mikrotik_mndp的使用

Flutter Mikrotik MNDP协议通信插件mikrotik_mndp的使用

简介

这是用于通过MikroTik邻居发现协议（MNDP）发现网络设备的Flutter插件。

使用方法

要使用此插件，在`pubspec.yaml`文件中添加`mikrotik_mndp`作为依赖项。

该插件负责向网络上的MikroTik设备发送广播/多播请求。这些设备接收到请求后会响应其信息。然后插件解码响应并以流的形式发送一个`MndpMessage`对象。

`MndpMessage`对象包含以下字段：

| 字段               | 描述                         | 示例                       |
|--------------------|----------------------------|--------------------------|
| `type`             | 消息类型                     | 0                        |
| `ttl`              | 消息存活时间                 | 0                        |
| `sequence`         | 消息序列号                   | 7                        |
| `mac_address`      | 设备的MAC地址                | 48:8F:5A:AD:7E:E9        |
| `identity`         | 设备的身份                   | MikroTik                 |
| `version`          | 设备的软件版本               | 6.45.9 (长期支持版)       |
| `platform`         | 硬件平台                     | MikroTik                 |
| `uptime`           | 自上次重启以来的时间（秒）   | 201                      |
| `software_id`      | 软件标识符                   | H5ZN-JERX                |
| `board_name`       | 硬件型号名称                 | RB931-2nD                |
| `unpack`           | 消息解包状态                 | 0                        |
| `interface_name`   | 网络接口名称                 | bridgeLocal/ether2       |
| `unicast_ipv4_address` | 设备的单播IPv4地址        | 192.168.1.125            |

该插件还会根据设备名称搜索其附加信息（图像、商业名称、在MikroTik页面上的描述链接）。

### 示例

<img src="https://raw.githubusercontent.com/Eitol/mikrotik_mndp/main/doc/img.jpg" alt="App Example Screenshot">

```dart
import 'package:flutter/material.dart';
import 'package:mikrotik_mndp/decoder.dart';
import 'package:mikrotik_mndp/product_info_provider.dart';
import 'package:url_launcher/url_launcher.dart';
import 'message.dart';
import 'listener.dart';

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

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  [@override](/user/override)
  Widget build(BuildContext context) {
    return const MaterialApp(
      title: 'Mikrotik MNDP Demo',
      home: MyHomePage(title: 'Mikrotik MNDP Demo'),
    );
  }
}

class MyHomePage extends StatefulWidget {
  final String title;

  const MyHomePage({super.key, required this.title});

  [@override](/user/override)
  State<MyHomePage> createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  final List<MndpMessage> _messages = [];

  [@override](/user/override)
  Widget build(BuildContext context) {
    var productProvider = MikrotikProductInfoProviderImpl();
    var decoder = MndpMessageDecoderImpl(productProvider);
    MNDPListener mndpListener = MNDPListener(decoder);
    return Scaffold(
      appBar: AppBar(
        backgroundColor: Theme.of(context).colorScheme.inversePrimary,
        title: Text(widget.title),
      ),
      body: SingleChildScrollView(
        child: Column(      
          children: [
            StreamBuilder(
                stream: mndpListener.listen(),
                builder: (BuildContext context,
                    AsyncSnapshot<MndpMessage> snapshot) {
                  if (snapshot.hasData && snapshot.data != null) {
                    var found = false;
                    for (var i = 0; i < _messages.length; i++) {
                      if (_messages[i].macAddress ==
                          snapshot.data!.macAddress) {
                        _messages[i] = snapshot.data!;
                        found = true;
                        break;
                      }
                    }
                    if (!found) {
                      _messages.add(snapshot.data!);
                    }
                    return Column(
                      children: _messages
                          .map((message) => MndpMessageWidget(message: message))
                          .toList(),
                    );
                  }
                  return const Text('Awaiting MNDP messages...');
                }),
          ],
        ),
      ),
    );
  }
}

class MndpMessageWidget extends StatelessWidget {
  final MndpMessage message;

  const MndpMessageWidget({Key? key, required this.message}) : super(key: key);

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Card(
      elevation: 4.0,
      child: Padding(
        padding: const EdgeInsets.all(8.0),
        child: Column(
          mainAxisSize: MainAxisSize.min,
          children: [
            Visibility(
              visible: message.productInfo?.imageUrl != null,
              child: SizedBox(
                height: 200,
                child: Image.network(message.productInfo!.imageUrl),
              ),
            ),
            ListTile(
              title: Text(message.boardName ?? '未知'),
              subtitle: Text('MAC: ${message.macAddress ?? 'N/A'}'),
            ),
            _infoRow('商业名称', message.productInfo?.name ?? 'N/A'),
            _infoRow('板卡名称', message.boardName),
            _infoRow('MAC 地址', message.macAddress),
            _infoRow('身份', message.identity),
            _infoRow('IPv4 地址', message.unicastIpv4Address),
            _infoRow('IPv6 地址', message.unicastIpv6Address),
            _infoRow('版本', message.version),
            _infoRow('平台', message.platform),
            _infoRow('运行时间', _formatDuration(message.uptime)),
            _infoRow('软件ID', message.softwareId),
            InkWell(
              onTap: () async {
                var url = message.productInfo?.productUrl ?? '';
                var uri = Uri.parse(url);
                if (await canLaunchUrl(uri)) {
                  await launchUrl(uri, mode: LaunchMode.externalApplication);
                }
              },
              child: const Text(
                "页面链接",
                style: TextStyle(
                    color: Colors.blue, decoration: TextDecoration.underline),
              ),
            ),       
          ],
        ),
      ),
    );
  }

  Widget _infoRow(String label, String? value) {
    return Padding(
      padding: const EdgeInsets.symmetric(vertical: 4.0),
      child: Row(
        mainAxisAlignment: MainAxisAlignment.spaceBetween,
        children: [
          Text(label, style: const TextStyle(fontWeight: FontWeight.bold)),
          Text(value ?? 'N/A'),
        ],
      ),
    );
  }

  String _formatDuration(Duration? duration) {
    return duration != null
        ? '${duration.inHours}小时 ${duration.inMinutes % 60}分钟'
        : 'N/A';
  }
}