Flutter插件atmotuber的介绍与使用

atmotuber

atmotuber 是一个用于直接通过BLE连接处理Atmotube蓝牙API的Flutter包。它使数据在你的应用中易于使用。

Flutter插件atmotuber使用方法

要使用该包，请按以下步骤操作：

添加依赖

在你的 pubspec.yaml 文件中添加依赖：

dependencies:
  flutter:
    sdk: flutter
  atmotuber:

iOS 配置

在 ios/Runner/Info.plist 中添加以下内容：

<key>NSBluetoothAlwaysUsageDescription</key>
<string>需要BLE权限</string>
<key>NSBluetoothPeripheralUsageDescription</key>
<string>需要BLE权限</string>

Android 配置

在 android/app/src/main/AndroidManifest.xml 中添加以下权限：

<uses-permission android:name="android.permission.BLUETOOTH" />
<uses-permission android:name="android.permission.BLUETOOTH_ADMIN" />

连接到Atmotube Pro

// 初始化
Atmotuber atm = Atmotuber();

// 连接
await atm.searchAtmotube();

获取实时数据

// 实时数据回调函数
await atm.wrapper(callback: (streams) {
  dataGot.value = streams;
});

获取历史数据

// 历史数据回调函数
await atm.hist_wrapper(callback: (streams) {
  history.value = streams;
});

断开连接

// 断开连接
await atm.dropConnection();

完整示例代码

// ignore_for_file: unnecessary_const

import 'package:atmotuber/atmotuber.dart';
import 'package:flutter/material.dart';
import 'dart:async';

void main() {
  return runApp(
    const MaterialApp(home: HomePage(), debugShowCheckedModeBanner: false),
  );
}

class HomePage extends StatefulWidget {
  const HomePage({Key? key}) : super(key: key);

  [@override](/user/override)
  HomePageState createState() => HomePageState();
}

class HomePageState extends State<HomePage> {
  Atmotuber atm2 = Atmotuber();
  List<String> names = ['日期时间', '状态', 'BME280', 'PM', 'VOC'];
  ValueNotifier<AtmotubeData> dataGot = ValueNotifier(const AtmotubeData());
  ValueNotifier<AtmotubeData> history = ValueNotifier(const AtmotubeData());
  late String _status;

  Future<void> connectDevice() async {
    await atm2.searchAtmotube();
  }

  Future<void> dataTaker() async {
    await atm2.wrapper(callback: (streams) {
      dataGot.value = streams;
    });
  }

  Future<void> dataHist() async {
    await atm2.hist_wrapper(callback: (histStreams) {
      history.value = histStreams;
    });
  }

  [@override](/user/override)
  void initState() {
    _status = '断开';
    super.initState();
  }

  void showsnack(SnackBar snackBar) {
    ScaffoldMessenger.of(context).showSnackBar(snackBar);
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      backgroundColor: Colors.white,
      body: SingleChildScrollView(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            Center(
              child: ElevatedButton(
                child: const Text(
                  '连接ATMOTUBE',
                  style: TextStyle(fontSize: 20.0),
                ),
                onPressed: () async {
                  await connectDevice();
                  _status = atm2.getDeviceState();
                  if (_status == 'connected') {
                    const snackBar = SnackBar(
                      content: Text('已连接！'),
                      backgroundColor: Colors.green,
                    );
                    showsnack(snackBar);
                  } else if (_status == 'disconnected') {
                    const snackBar = SnackBar(
                      content: Text('未连接！'),
                      backgroundColor: Colors.red,
                    );
                    showsnack(snackBar);
                  }
                },
              ),
            ),
            Center(
              child: ElevatedButton(
                child: const Text(
                  '断开ATMOTUBE',
                  style: TextStyle(fontSize: 20.0),
                ),
                onPressed: () async {
                  await atm2.dropConnection();
                  _status = atm2.getDeviceState();
                  if (_status == 'disconnected') {
                    const snackBar = SnackBar(
                      content: Text('已断开连接！'),
                      backgroundColor: Colors.red,
                    );
                    showsnack(snackBar);
                  }
                },
              ),
            ),
            Center(
              child: ElevatedButton(
                onPressed: (() async {
                  await dataTaker();
                }),
                child: const Text(
                  '获取数据',
                  style: TextStyle(fontSize: 20.0),
                ),
              ),
            ),
            Center(
              child: ElevatedButton(
                onPressed: (() async {
                  await dataHist();
                }),
                child: const Text(
                  '获取历史数据',
                  style: TextStyle(fontSize: 20.0),
                ),
              ),
            ),
            Center(
              child: ElevatedButton(
                onPressed: (() async {
                  await atm2.cancelStreamHistory();
                }),
                child: const Text(
                  '取消流',
                  style: TextStyle(fontSize: 20.0),
                ),
              ),
            ),
            const SizedBox(height: 30),
            const SizedBox(
              height: 30,
              width: 360,
              child: Align(
                alignment: Alignment.centerLeft,
                child: Text('实时数据',
                    style: TextStyle(fontSize: 30, fontWeight: FontWeight.w400)),
              ),
            ),
            Center(
              child: ValueListenableBuilder(
                valueListenable: history,
                builder: (context, AtmotubeData data, child) {
                  List list = [
                    data.datetime,
                    data.status,
                    data.bme280,
                    data.pm,
                    data.voc
                  ];
                  return Column(
                    mainAxisAlignment: MainAxisAlignment.center,
                    children: [
                      ListView.builder(
                        scrollDirection: Axis.vertical,
                        shrinkWrap: true,
                        itemCount: list.length,
                        itemBuilder: (BuildContext context, int index) {
                          return Column(
                            children: [
                              ListTile(
                                title: Text(names[index]),
                                subtitle: Text(list[index].toString()),
                              ),
                              const Divider(height: 2.0)
                            ],
                          );
                        },
                      )
                    ],
                  );
                },
              ),
            )
          ],
        ),
      ),
    );
  }
}