Flutter标签管理插件wiatag_kit的使用

wiatag_kit 是一个基于Gurtam开发的原生SDK的插件，可以帮助你将应用转换为WiaTag设备。你可以通过这个插件与WiaTag设备进行通信。

有关WiaTag的更多信息，请访问：

• WiaTag官网
• WiaTag Kit Android
• WiaTag Kit iOS

开始使用

首先，你需要定义服务器的主机和端口。这个服务器可以是Wialon Hosting、Wialon Local或Flespi。在这个示例中，我们将使用Wialon Hosting。

例如，这是我们的WiaTag单元在Wialon中的配置：

接下来，设置服务器的过程如下：

import 'package:wiatag_kit/wiatag_kit.dart';

WiaTagKit plugin = WiaTagKit();

WiatagServer server = WiatagServer(
  host: 'nl.gpsgsm.org',
  port: 20963,
  unitId: 'wiatag_flutter',
  password: '', 
  hasCommands: true,
  commandListener: const Duration(seconds: 30),
);

plugin.setServer(server); // Future<bool?> setServer(WiatagServer server)

发送消息

你可以通过以下方式发送一条消息：

WiatagMessage message = WiatagMessage(
  latitude: 10,
  longitude: 10,
  // ... 查看WiatagMessage类以获取更多选项
);

plugin.sendMessage(message); // Future<bool?> sendMessage(WiatagMessage message)

发送SOS

你可以通过以下方式发送SOS：

plugin.sendSOS(); // Future<bool?> sendSOS()

// 或者，你可以添加一条消息到SOS
WiatagMessage message = WiatagMessage(
  latitude: 10,
  longitude: 10,
  // ... 查看WiatagMessage类以获取更多选项
);
plugin.sendSOS(message); // Future<bool?> sendSOS([WiatagMessage? message])

发送文本消息

你可以通过以下方式发送一条文本消息：

plugin.sendText('Hello, World!'); // Future<bool?> sendText(String text)

// 或者，你可以添加一条消息到文本
WiatagMessage message = WiatagMessage(
  latitude: 10,
  longitude: 10,
  // ... 查看WiatagMessage类以获取更多选项
);
plugin.sendText('Hello, World!', message); // Future<bool?> sendText(String text, [WiatagMessage? message])

如何监听命令？

你可以通过以下方式添加监听器来接收命令：

plugin.addListener((WiatagCommand command) {
  // 对命令执行某些操作
});

完整示例

以下是完整的示例代码，展示了如何使用wiatag_kit插件：

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

void main() {
  WidgetsFlutterBinding.ensureInitialized();
  runApp(const MyApp());
}

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

  [@override](/user/override)
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  final _plugin = WiatagKit();

  WiatagServer get server => const WiatagServer(
        host: "nl.gpsgsm.org",
        port: 20963,
        unitId: "wiatag_flutter",
        password: "",
        commandListener: Duration(seconds: 5),
      );

  WiatagMessage get message => const WiatagMessage(
        latitude: 10,
        longitude: 10,
      );

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

    _plugin.setServer(server);
    _plugin.addListener((command) {
      debugPrint("Command received: $command");
    });
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('插件示例应用'),
        ),
        body: Column(
          children: [
            const Text("设置WiatagServer"),
            ElevatedButton(
              onPressed: () async {
                await _plugin.setServer(server);
              },
              child: const Text("设置WiatagServer"),
            ),
            const SizedBox(height: 16),
            const Text("获取WiatagServer"),
            ElevatedButton(
              onPressed: () async {
                final result = await _plugin.getServer();
                debugPrint("WiatagServer: $result");
              },
              child: const Text("获取WiatagServer"),
            ),
            const SizedBox(height: 16),
            const Text("发送SOS"),
            ElevatedButton(
              onPressed: () async {
                await _plugin.sendSos();
              },
              child: const Text("发送SOS"),
            ),
            const SizedBox(height: 16),
            const Text("发送带有信息的SOS"),
            ElevatedButton(
              onPressed: () async {
                await _plugin.sendSos(message.copyWith(
                  extra: {"last.will": "HELP ME!"},
                ));
              },
              child: const Text("发送带有信息的SOS"),
            ),
            const SizedBox(height: 16),
            const Text("发送文本"),
            ElevatedButton(
              onPressed: () async {
                await _plugin.sendText("Hello, World!");
              },
              child: const Text("发送文本"),
            ),
            const SizedBox(height: 16),
            const Text("发送带有信息的文本"),
            ElevatedButton(
              onPressed: () async {
                await _plugin.sendText("Hello, World!", message);
              },
              child: const Text("发送带有信息的文本"),
            ),
            const SizedBox(height: 16),
            const Text("发送WiatagMessage"),
            ElevatedButton(
              onPressed: () async {
                await _plugin.sendMessage(message);
              },
              child: const Text("发送WiatagMessage"),
            ),
          ],
        ),
      ),
    );
  }
}