Flutter集成Nimmsta SDK插件nimmsta_sdk_wrapper的使用

Nimmsta SDK

一个用于Nimmsta SDK的Flutter包装器。

目前仅支持Android平台，因为Nimmsta只提供了针对该平台的SDK。

使用方法

在pubspec.yaml文件中添加以下依赖：

dependencies:
  nimmsta_sdk: <version>

将以下值添加到您的local.properties文件中：

nimmsta.username=<username>
nimmsta.password=<password>

用户名和密码由Nimmsta提供（https://nimmsta.com/）。

在AndroidManifest.xml中添加以下内容：

<application
    ...
    android:theme="@style/NormalTheme">
    <activity
        ...
        <meta-data
            android:name="io.flutter.embedding.android.NormalTheme"
            android:resource="@style/NormalTheme"
            />
        ...
</application>

在/res/values/styles.xml中添加以下样式：

<?xml version="1.0" encoding="utf-8"?>
<resources>
    ...
    <style name="NormalTheme" parent="Theme.AppCompat.Light.DarkActionBar">
        <item name="android:windowBackground">?android:colorBackground</item>
    </style>
</resources>

在应用级别的build.gradle中添加以下配置：

android {
    ...
    packagingOptions {
        exclude 'META-INF/*.kotlin_module'
        exclude 'META-INF/DEPENDENCIES'
        exclude 'META-INF/INDEX.LIST'
        exclude 'META-INF/io.netty.versions.properties'
    }
}

dependencies {
    ...
    implementation "androidx.appcompat:appcompat:1.2.0" /* 临时依赖，用于使Nimmsta SDK正常工作 */
}

将需要加载的布局文件放在/res/raw目录下。

示例代码

以下是一个完整的示例代码，展示了如何使用nimmsta_sdk_wrapper插件。

示例代码

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

import 'package:nimmsta_sdk_wrapper/nimmsta_sdk_wrapper.dart';
import 'package:nimmsta_sdk_wrapper/models/scan_picking_mode.dart' as Picking;
import 'package:nimmsta_sdk_wrapper/models/scan_trigger_mode.dart' as Trigger;

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

class MyApp extends StatefulWidget {
  [@override](/user/override)
  _MyAppState createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  String? _barcode = "Unknown";
  String _connectionFlag = "disconnected";

  late NimmstaSdk nimmstaSdk;

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

  // 初始化Nimmsta SDK
  Future<void> initNimmsta() async {
    nimmstaSdk = NimmstaSdk(
      didConnectAndInitCallback: (deviceAddress) async {
        // 设备连接并初始化回调
        await nimmstaSdk.setLayout("test_layout", {
          "title": "设备状态",
          "subtitle": "didConnectAndInitCallback",
        });
        await nimmstaSdk.pushSettings(true, true,
            Trigger.ScanTriggerMode.Button, Picking.ScanPickingMode.DISABLED);
        setState(() {
          _connectionFlag = "didConnectAndInitCallback";
        });
      },
      didDisconnectCallback: () {
        // 设备断开连接回调
        setState(() {
          _connectionFlag = "disconnected";
        });
      },
      didTouchCallback: (dynamic arguments) {
        // 屏幕触摸回调
        debugPrint(
            "NIMMSTA SDK: didTouchCallback with coordinates ${arguments.toString()}");
      },
      didClickButtonCallback: (dynamic action) {
        // 按钮点击回调
        debugPrint("NIMMSTA SDK: didClickButtonCallback with action $action");
      },
      didScanBarcodeCallback: (dynamic barcode) {
        // 条形码扫描回调
        setState(() {
          _barcode = barcode;
        });
      },
      didReconnectAndInitCallback: (deviceAddress) async {
        // 设备重新连接并初始化回调
        await nimmstaSdk.setLayout("test_layout", {
          "title": "设备状态",
          "subtitle": "didReconnectAndInitCallback",
        });
        await nimmstaSdk.pushSettings(true, true,
            Trigger.ScanTriggerMode.Button, Picking.ScanPickingMode.DISABLED);
        setState(() {
          _connectionFlag = "didReconnectAndInitCallback";
        });
      },
      connectedWithDeviceAddress: (deviceAddress) async {
        // 连接到设备地址回调
        await nimmstaSdk.setLayout("test_layout", {
          "title": "设备状态",
          "subtitle": "connectedWithDeviceAddress",
        });
        await nimmstaSdk.pushSettings(true, true,
            Trigger.ScanTriggerMode.Button, Picking.ScanPickingMode.DISABLED);
        setState(() {
          _connectionFlag = "connectedWithDeviceAddress";
        });
      },
    );
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('插件示例应用'),
        ),
        body: Center(
          child: Column(
            children: [
              Text('连接状态: $_connectionFlag\n'),
              TextButton(
                onPressed: () async {
                  // 连接Nimmsta设备
                  await nimmstaSdk.connect();
                },
                child: Text('连接Nimmsta设备'),
              ),
              Text('扫描的条形码: $_barcode\n'),
              TextButton(
                onPressed: () async {
                  // 更改布局
                  await nimmstaSdk.setLayout("test_layout", {
                    "title": "这是一个标题！",
                    "subtitle": "这是子标题",
                  });
                },
                child: Text('更改布局'),
              ),
              TextButton(
                onPressed: () async {
                  // 触发LED闪烁
                  await nimmstaSdk.triggerLEDBurst(2, 500, 250, Colors.green);
                },
                child: Text('触发LED'),
              ),
              TextButton(
                onPressed: () async {
                  // 触发蜂鸣器
                  await nimmstaSdk.triggerBeeperBurst(1, 100, 50, 100);
                },
                child: Text('触发蜂鸣器'),
              ),
              TextButton(
                onPressed: () async {
                  // 触发振动
                  await nimmstaSdk.triggerVibrationBurst(2, 1000, 500, 100);
                },
                child: Text('触发振动'),
              ),
            ],
          ),
        ),
      ),
    );
  }
}