Flutter连接管理插件quiltt_connector的使用

Quiltt Flutter SDK 提供了一个方便的方式来管理和维护设备连接。你可以通过以下步骤来安装和使用该插件。

使用

首先，在你的 pubspec.yaml 文件中添加 quiltt_connector 作为依赖项。

dependencies:
  quiltt_connector: ^最新版本号

然后在你的 Dart 文件中导入必要的库：

import 'package:quiltt_connector/quiltt_connector.dart';
import 'package:quiltt_connector/configuration.dart';

接下来，我们来看一个完整的示例，展示如何使用 quiltt_connector 插件进行连接和重新连接操作。

连接

class ExampleState extends State<Example> {
  void connect() {
    // 配置连接信息
    QuilttConnectorConfiguration config = QuilttConnectorConfiguration(
      connectorId: "<CONNECTOR_ID>", // 替换为你的连接ID
      oauthRedirectUrl: "<YOUR_HTTPS_APP_LINK>", // 替换为你的重定向URL
    );

    // 初始化QuilttConnector对象
    QuilttConnector quilttConnector = QuilttConnector();

    // 可选：进行身份验证
    quilttConnector.authenticate("<TOKEN>"); // 如果需要身份验证，请替换<TOKEN>

    // 进行连接操作
    quilttConnector.connect(
      context,
      config,
      // 可选：事件处理器函数
      onEvent: (event) {
        debugPrint("onEvent: ${event.eventMetadata}");
      },
      onExit: (event) {
        debugPrint("onExit: ${event.eventMetadata}");
      },
      onExitSuccess: (event) {
        debugPrint("onExitSuccess: ${event.eventMetadata}");
        _setConnectionId(event.eventMetadata.connectionId!);
      },
      onExitAbort: (event) {
        debugPrint("onExitAbort: ${event.eventMetadata}");
      },
      onExitError: (event) {
        debugPrint("onExitError: ${event.eventMetadata}");
      },
    );
  }
}

重新连接

class ExampleState extends State<Example> {
  void reconnect() {
    // 配置连接信息
    QuilttConnectorConfiguration config = QuilttConnectorConfiguration(
      connectorId: "<CONNECTOR_ID>", // 替换为你的连接ID
      connectionId: "<CONNECTION_ID>", // 替换为现有的连接ID
      oauthRedirectUrl: "<YOUR_HTTPS_APP_LINK>", // 替换为你的重定向URL
    );

    // 初始化QuilttConnector对象
    QuilttConnector quilttConnector = QuilttConnector();

    // 可选：进行身份验证
    quilttConnector.authenticate("<TOKEN>"); // 如果需要身份验证，请替换<TOKEN>

    // 进行重新连接操作
    quilttConnector.reconnect(
      context,
      config,
      // 可选：事件处理器函数
      onEvent: (event) {
        debugPrint("onEvent: ${event.eventMetadata}");
      },
      onExit: (event) {
        debugPrint("onExit: ${event.eventMetadata}");
      },
      onExitSuccess: (event) {
        debugPrint("onExitSuccess: ${event.eventMetadata}");
        _setConnectionId(event.eventMetadata.connectionId!);
      },
      onExitAbort: (event) {
        debugPrint("onExitAbort: ${event.eventMetadata}");
      },
      onExitError: (event) {
        debugPrint("onExitError: ${event.eventMetadata}");
      },
    );
  }
}

完整示例

下面是一个完整的示例，展示了如何在 Flutter 应用程序中使用 quiltt_connector 插件。

import 'package:flutter/material.dart';
import 'package:quiltt_connector/quiltt_connector.dart';
import 'package:quiltt_connector/configuration.dart';

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

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: Text('Quiltt Connector Demo'),
        ),
        body: Center(
          child: ElevatedButton(
            onPressed: () {
              // 调用连接方法
              connect();
            },
            child: Text('Connect'),
          ),
        ),
      ),
    );
  }

  void connect() {
    // 配置连接信息
    QuilttConnectorConfiguration config = QuilttConnectorConfiguration(
      connectorId: "<CONNECTOR_ID>", // 替换为你的连接ID
      oauthRedirectUrl: "<YOUR_HTTPS_APP_LINK>", // 替换为你的重定向URL
    );

    // 初始化QuilttConnector对象
    QuilttConnector quilttConnector = QuilttConnector();

    // 可选：进行身份验证
    quilttConnector.authenticate("<TOKEN>"); // 如果需要身份验证，请替换<TOKEN>

    // 进行连接操作
    quilttConnector.connect(
      // 当前上下文
      context,
      config,
      // 可选：事件处理器函数
      onEvent: (event) {
        debugPrint("onEvent: ${event.eventMetadata}");
      },
      onExit: (event) {
        debugPrint("onExit: ${event.eventMetadata}");
      },
      onExitSuccess: (event) {
        debugPrint("onExitSuccess: ${event.eventMetadata}");
        _setConnectionId(event.eventMetadata.connectionId!);
      },
      onExitAbort: (event) {
        debugPrint("onExitAbort: ${event.eventMetadata}");
      },
      onExitError: (event) {
        debugPrint("onExitError: ${event.eventMetadata}");
      },
    );
  }
}