signalr_client 是一个用于在 Flutter 应用中实现与 SignalR 服务器进行实时通信的插件。SignalR 是一个由微软开发的实时通信库，它支持多种传输协议（如 WebSocket、Server-Sent Events 和长轮询），并能够自动选择最佳传输方式。

以下是如何在 Flutter 项目中使用 signalr_client 插件的步骤：

1. 添加依赖

首先，在 pubspec.yaml 文件中添加 signalr_client 依赖：

dependencies:
  flutter:
    sdk: flutter
  signalr_client: ^1.0.0

然后运行 flutter pub get 来获取依赖。

2. 导入包

在需要使用 SignalR 的 Dart 文件中导入 signalr_client 包：

import 'package:signalr_client/signalr_client.dart';

3. 创建 SignalR 连接

接下来，你可以创建一个 SignalR 连接并连接到服务器。以下是一个简单的示例：

void connectToSignalR() async {
  // 创建 HubConnectionBuilder
  final hubConnection = HubConnectionBuilder()
      .withUrl('https://your-signalr-server-url/hub')
      .build();

  // 监听连接状态变化
  hubConnection.onclose((error) {
    print('Connection closed: $error');
  });

  // 连接到服务器
  await hubConnection.start();

  // 监听服务器发送的消息
  hubConnection.on('ReceiveMessage', (List<dynamic>? arguments) {
    if (arguments != null && arguments.isNotEmpty) {
      print('Received message: ${arguments[0]}');
    }
  });

  // 发送消息到服务器
  hubConnection.invoke('SendMessage', args: ['Hello, SignalR!']);
}

4. 处理连接状态

你可以通过 onclose 方法来处理连接关闭的情况，并在需要时重新连接。

5. 发送和接收消息

使用 hubConnection.invoke 方法可以向服务器发送消息，而使用 hubConnection.on 方法可以监听服务器发送的消息。

6. 断开连接

当你不再需要连接时，可以调用 hubConnection.stop() 来断开连接：

void disconnectFromSignalR() async {
  await hubConnection.stop();
}

7. 处理错误

你可以通过 hubConnection.onclose 方法来处理连接关闭时的错误，并在需要时进行重连或其他操作。

8. 完整示例

以下是一个完整的示例，展示了如何连接、发送和接收消息，以及处理连接关闭：

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

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

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: SignalRExample(),
    );
  }
}

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

class _SignalRExampleState extends State<SignalRExample> {
  late HubConnection hubConnection;

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

  void connectToSignalR() async {
    hubConnection = HubConnectionBuilder()
        .withUrl('https://your-signalr-server-url/hub')
        .build();

    hubConnection.onclose((error) {
      print('Connection closed: $error');
      // 可以在这里实现重连逻辑
    });

    await hubConnection.start();

    hubConnection.on('ReceiveMessage', (List<dynamic>? arguments) {
      if (arguments != null && arguments.isNotEmpty) {
        print('Received message: ${arguments[0]}');
      }
    });

    hubConnection.invoke('SendMessage', args: ['Hello, SignalR!']);
  }

  void disconnectFromSignalR() async {
    await hubConnection.stop();
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('SignalR Example'),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: <Widget>[
            ElevatedButton(
              onPressed: disconnectFromSignalR,
              child: Text('Disconnect'),
            ),
          ],
        ),
      ),
    );
  }

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