Flutter集成Knot.x API插件knotapi_flutter的使用

在本文中，我们将介绍如何在Flutter应用中集成Knot.x API插件knotapi_flutter。通过该插件，您可以轻松地调用Knot.x API的功能。

准备工作

首先，在您的pubspec.yaml文件中添加knotapi_flutter依赖：

dependencies:
  flutter:
    sdk: flutter
  knotapi_flutter: ^版本号

然后运行以下命令以安装依赖：

flutter pub get

初始化和配置

接下来，我们将在应用中初始化并配置knotapi_flutter插件。以下是完整的示例代码：

示例代码

import 'dart:async';

import 'package:flutter/material.dart';
import 'package:knotapi_flutter/events.dart';
import 'package:knotapi_flutter/knotapi_configuration.dart';
import 'package:knotapi_flutter/knotapi_flutter.dart';

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

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

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

class _MyAppState extends State<MyApp> {
  final _knotapiFlutterPlugin = KnotapiFlutter();
  StreamSubscription<KnotEvent>? _streamEvent;
  StreamSubscription<KnotSuccess>? _streamSuccess;
  StreamSubscription<KnotError>? _streamError;
  StreamSubscription<KnotExit>? _streamExit;

  // 成功回调函数
  void _onSuccess(KnotSuccess event) {
    String type = event.type;
    String merchant = event.merchant;
    print("eventName: _onSuccess, type: $type, merchant: $merchant");
  }

  // 错误回调函数
  void _onError(KnotError event) {
    String type = event.type;
    String message = event.message;
    print("eventName: _onError, type: $type, message: $message");
  }

  // 事件回调函数
  void _onEvent(KnotEvent event) {
    String type = event.type;
    String name = event.event;
    String taskId = event.taskId;
    bool sendCard = event.sendCard;
    print("eventName: _onEvent, type: $type, event: $name, taskId: $taskId, sendCard: $sendCard");
  }

  // 退出回调函数
  void _onExit(KnotExit event) {
    String type = event.type;
    print("eventName: _onExit, type: $type");
  }

  [@override](/user/override)
  void initState() {
    super.initState();
    
    // 监听错误事件
    _streamError = KnotapiFlutter.onError.listen(_onError);

    // 监听事件
    _streamEvent = KnotapiFlutter.onEvent.listen(_onEvent);

    // 监听退出事件
    _streamExit = KnotapiFlutter.onExit.listen(_onExit);

    // 监听成功事件
    _streamSuccess = KnotapiFlutter.onSuccess.listen(_onSuccess);
  }

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

    // 取消监听
    _streamSuccess?.cancel();
    _streamExit?.cancel();
    _streamEvent?.cancel();
    _streamError?.cancel();
  }

  // 打开卡片选择器
  void onOpenCardOnFileSwitcher() {
    _knotapiFlutterPlugin.openCardOnFileSwitcher(KnotConfiguration(
      sessionId: "695ce724-7f61-40f1-a410-cb0c0fcf9b7f",
      clientId: "3f4acb6b-a8c9-47bc-820c-b0eaf24ee771",
      environment: "sandbox",
      useCategories: false,
    ));
  }

  // 打开订阅管理器
  void onOpenSubscriptionManager() {
    _knotapiFlutterPlugin.openSubscriptionManager(KnotConfiguration(
      sessionId: "da2493c2-8514-4804-a3e5-b8726394f019",
      clientId: "3f4acb6b-a8c9-47bc-820c-b0eaf24ee771",
      environment: "sandbox",
      useCategories: false,
    ));
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      theme: ThemeData(
          primaryColor: Colors.black,
          appBarTheme: const AppBarTheme(color: Colors.black),
          buttonTheme: const ButtonThemeData(buttonColor: Colors.black),
          colorScheme: const ColorScheme(
              background: Colors.white,
              brightness: Brightness.light,
              primary: Colors.black,
              onPrimary: Colors.white,
              secondary: Colors.white,
              onSecondary: Colors.white,
              error: Colors.redAccent,
              onError: Colors.redAccent,
              onBackground: Colors.black,
              surface: Colors.white,
              onSurface: Colors.black)),
      home: Scaffold(
        appBar: AppBar(
          title: const Text('KnotAPI Plugin 示例应用'),
        ),
        body: Center(
          child: Column(
            mainAxisAlignment: MainAxisAlignment.center,
            children: [
              ElevatedButton(
                onPressed: onOpenCardOnFileSwitcher,
                child: const Text('打开卡片选择器'),
              ),
              ElevatedButton(
                onPressed: onOpenSubscriptionManager,
                child: const Text('打开订阅管理器'),
              ),
            ],
          ),
        ),
      ),
    );
  }
}