Flutter音频播放插件topwisemp35p的使用

简介

topwisemp35p 是一个用于干扰 Topwise MP35P 便携式设备的插件。

开始使用

如何开始

此插件暴露了两个 API：

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

<application
    android:name="com.a5starcompany.topwisemp35p.PaylonyApp">
</application>

并在 <application> 标签内添加以下服务：

<service
    android:name="com.a5starcompany.topwisemp35p.emvreader.card.CardMoniterService"
    android:enabled="true" />

使用步骤

1. 初始化插件

首先需要初始化插件。这应该只执行一次。

import 'package:topwisemp35p/topwisemp35p.dart';

class _MyAppState extends State<MyApp> {
  final _topwisemp35pPlugin = Topwisemp35p();

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

2. 初始化支付

创建一个 Transaction 对象并传递给 initializePayment 函数。

Future<void> initPayment() async {
  _topwisemp35pPlugin.initialize("2000");
}

3. 监听卡状态

监听卡事件以了解卡的状态，并根据状态执行相应的操作。

_topwisemp35pPlugin.stateStream.listen((values) async {
  print("卡状态: $values");

  // 根据状态处理逻辑
  switch (values["state"]) {
    case "Loading":
      showDialog(
        context: context,
        builder: (builder) => AlertDialog(
          title: Text("加载中"),
        ),
      );
      return;

    case "CardData":
      // 处理卡数据
      return;

    case "CardReadTimeOut":
      return;

    case "CallBackError":
      return;

    case "CallBackCanceled":
      return;

    case "CallBackTransResult":
      return;

    case "CardDetected":
      // 跳转到输入 PIN 页面
      var result = await Navigator.push(
        context,
        MaterialPageRoute(builder: (context) => Carpin(amount: "200")),
      );

      if (result != null) {
        _topwisemp35pPlugin.enterpin(result);
      }
      return;
  }
});

4. 自定义卡 PIN 布局

将用户输入的 PIN 发送回 SDK，等待响应。

_topwisemp35pPlugin.enterpin(result);

5. 提现收据打印

创建一个 Print 对象并传递给 startprinting 函数。

var args = Print(
  marchantname: "VERDANT MICROFINANCE BANK",
  datetime: "27 Jan 2023,06:55AM",
  terminalid: "2LUX4199",
  merchantid: "2LUXAA00000001",
  transactiontype: "CARD WITHDRAWAL",
  copytype: "Merchant",
  rrn: "561409897476",
  stan: "904165",
  pan: "539983******1954",
  expiry: "2303",
  transactionstatus: "DECLINED",
  responsecode: "55",
  message: "Incorrect PIN",
  appversion: "1.5.3",
  amount: "200",
  bottommessage: "Buy Airtime and Pay Electricity bills here anytime! AnyDAY!",
);

_topwisePlugin.startprinting(args).then((value) {
  print(value);
});

6. 转账收据打印

类似提现收据打印，只需修改部分字段。

var args = Print(
  marchantname: "VERDANT MICROFINANCE BANK",
  datetime: "27 Jan 2023,06:55AM",
  terminalid: "2LUX4199",
  merchantid: "2LUXAA00000001",
  transactiontype: "TRANSFER",
  accountname: "ODEJINMI TOLUWALOPE ABRAHAM",
  copytype: "Merchant",
  stan: "904165",
  accountnumber: "3076302098",
  bank: "First Bank",
  transactionstatus: "DECLINED",
  responsecode: "55",
  message: "Incorrect PIN",
  appversion: "1.5.3",
  amount: "200",
  bottommessage: "Buy Airtime and Pay Electricity bills here anytime! AnyDAY!",
);

_topwisePlugin.startprinting(args).then((value) {
  print(value);
});

7. 自定义打印布局

在设计自定义打印 UI 时，请注意以下几点：

1. 一行不能超过两个 Widget。
2. SDK 只支持有限的 Widget，包括：Column, Row, Container, Expanded, Text, Image, Divider。
3. 如果需要打印列表，请避免使用 ListView，可以使用 for 循环。
4. 如果使用了上述列表之外的 Widget，SDK 将将其视为空白。

示例代码

以下是完整的示例代码：

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

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

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

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

class _MyAppState extends State<MyApp> {
  final _topwisemp35pPlugin = Topwisemp35p();

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

  Future<void> _initPayment() async {
    await _topwisemp35pPlugin.initialize("2000");
    _listenToCardState();
  }

  void _listenToCardState() {
    _topwisemp35pPlugin.stateStream.listen((values) async {
      print("卡状态: $values");

      switch (values["state"]) {
        case "Loading":
          showDialog(
            context: context,
            builder: (builder) => AlertDialog(
              title: Text("加载中"),
            ),
          );
          return;

        case "CardDetected":
          var result = await Navigator.push(
            context,
            MaterialPageRoute(builder: (context) => Carpin(amount: "200")),
          );

          if (result != null) {
            _topwisemp35pPlugin.enterpin(result);
          }
          return;
      }
    });
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      debugShowCheckedModeBanner: false,
      title: 'Topwise MP35P Demo',
      theme: ThemeData(
        primaryColor: Colors.green,
        visualDensity: VisualDensity.adaptivePlatformDensity,
      ),
      home: Scaffold(
        appBar: AppBar(
          title: Text('Topwise MP35P 示例'),
        ),
        body: Center(
          child: Text('初始化完成！'),
        ),
      ),
    );
  }
}