Flutter物联网通信插件flutter_thingspeak的使用

Flutter物联网通信插件flutter_thingspeak的使用

Flutter ThingSpeak 是一个Dart包，提供了与ThingSpeak频道交互的客户端。它涵盖了ThingSpeak API的所有功能，使用户能够更新频道信息、获取和分析数据流，并查询公共频道。该插件兼容托管在 api.thingspeak.com 的ThingSpeak服务器以及自托管的开源服务器。

开始使用

要使用此插件，你需要在项目的 pubspec.yaml 文件中添加 flutter_thingspeak 作为依赖项：

dependencies:
  flutter_thingspeak: ^1.1.0

然后运行以下命令以获取依赖项：

dart pub get

使用示例

以下是一个简单的示例代码，展示了如何初始化 FlutterThingspeakClient 并从ThingSpeak通道获取所有数据：

import 'package:flutter_thingspeak/flutter_thingspeak.dart';

void main() async {
  final flutterThingspeak = FlutterThingspeakClient(channelID: '12397');

  // 初始化客户端
  flutterThingspeak.initialize();

  // 获取ThingSpeak通道的数据
  final result = await flutterThingspeak.getAllData();
  print(result);
}

查询参数

这些是可选的查询参数，可以在请求ThingSpeak API时包含在 [options] 参数中。它们允许你根据特定标准自定义响应。

• results: 要检索的条目数。最大数量为8000。
• days: 包含在响应中的天数。默认为1。
• minutes: 包含在响应中的分钟数。默认为1440。
• start: 开始日期，格式为 YYYY-MM-DD%20HH:NN:SS。
• end: 结束日期，格式为 YYYY-MM-DD%20HH:NN:SS。
• timezone: 此请求的时间区域标识符。
• offset: 结果显示的时间区域偏移量。使用 timezone 参数可以获得更高的准确性。
• status: 通过设置 "status=true" 包含状态更新。
• metadata: 通过设置 "metadata=true" 包含频道元数据。
• location: 通过设置 "location=true" 包含纬度、经度和海拔。
• min: 包含在响应中的最小值。
• max: 包含在响应中的最大值。
• round: 四舍五入到小数点后几位。
• timescale: 每个时间窗口获取第一个值，有效值为 10, 15, 20, 30, 60, 240, 720, 1440, "daily"。
• sum: 每个时间窗口获取总和，有效值同上。
• average: 每个时间窗口获取平均值，有效值同上。
• median: 每个时间窗口获取中位数，有效值同上。

完整示例

下面是一个更详细的示例，展示了如何从ThingSpeak通道获取温度数据并将其显示在一个图表中：

import 'package:flutter/material.dart';
import 'package:flutter_thingspeak/flutter_thingspeak.dart';
import 'package:syncfusion_flutter_charts/charts.dart';
import './channel_model.dart';

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

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

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      theme: ThemeData(
        colorScheme: ColorScheme.fromSeed(seedColor: Colors.deepPurple),
        useMaterial3: true,
      ),
      home: const MyHomePage(title: 'Flutter Thingspeak demo'),
    );
  }
}

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

  final String title;

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

class _MyHomePageState extends State<MyHomePage> {
  final flutterThingspeak = FlutterThingspeakClient(
      channelID: '12397', options: {'results': '5', 'timescale': '5'});
  Channel? channel;
  List<Feed> feeds = [];

  Future<void> getTemperatureData() async {
    flutterThingspeak.initialize();
    try {
      // 获取通道的温度数据
      final result = await flutterThingspeak.getFieldData('4');

      channel = Channel.fromJson(result);
      feeds = (result['feeds'] as List<dynamic>)
          .map((feed) => Feed.fromJson(feed))
          .toList();
    } catch (e) {}
  }

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

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        backgroundColor: Theme.of(context).colorScheme.inversePrimary,
        title: Text(widget.title),
      ),
      body: SafeArea(
        child: FutureBuilder(
          future: getTemperatureData(),
          builder: (context, snapshot) {
            if (snapshot.connectionState == ConnectionState.done) {
              if (snapshot.hasError) {
                // 显示加载数据时的错误信息
                return Center(
                  child: Text('Error loading data: ${snapshot.error}'),
                );
              }

              if (channel != null) {
                return Column(
                  children: [
                    Container(
                      margin: const EdgeInsets.all(10),
                      decoration: BoxDecoration(
                        border: Border.all(color: Colors.black45, width: .5),
                        borderRadius: const BorderRadius.all(Radius.circular(5)),
                      ),
                      child: ListBody(
                        children: [
                          ListTile(
                            title: const Text("Channel ID"),
                            subtitle: Text(channel!.id.toString()),
                          ),
                          ListTile(
                            title: const Text("Channel Name"),
                            subtitle: Text(channel!.name),
                          ),
                          ListTile(
                            title: const Text("Channel Description"),
                            subtitle: Text(channel!.description),
                          ),
                          ListTile(
                            title: const Text("Location"),
                            subtitle: Text(
                                "${channel!.latitude.toString()},${channel!.longitude}"),
                          )
                        ],
                      ),
                    ),
                    SfCartesianChart(
                        primaryXAxis: const CategoryAxis(),
                        // 图表标题
                        title: const ChartTitle(text: 'Temperature Data Chart'),
                        // 启用图例
                        legend: const Legend(isVisible: true),
                        // 启用工具提示
                        tooltipBehavior: TooltipBehavior(enable: true),
                        series: <CartesianSeries<Feed, String>>[
                          LineSeries<Feed, String>(
                              dataSource: feeds,
                              xValueMapper: (Feed feed, _) => feed.createdAt.minute.toString(),
                              yValueMapper: (Feed feed, _) => feed.field4,
                              name: 'Temperature',
                              // 启用数据标签
                              dataLabelSettings: const DataLabelSettings(isVisible: true))
                        ]),
                  ],
                );
              } else {
                // 显示数据不可用的消息
                return const Center(
                  child: Text('No data available.'),
                );
              }
            } else {
              // 显示加载指示器
              return const Center(
                child: CircularProgressIndicator(),
              );
            }
          },
        ),
      ),
    );
  }
}