Flutter即时通讯插件nim_conversationkit的使用

Flutter即时通讯插件nim_conversationkit的使用

kit.nim_conversationkit

提供会话列表业务层实现。

声明依赖项

如需添加 ConversationKit 的依赖项，您必须将 pub 库添加到项目中。

在应用或模块的 pubspec.yaml 文件中添加所需工件的依赖项：

dependencies:
  nim_conversationkit: ^1.0.0

接下来，让我们看看如何在您的 Flutter 项目中使用 nim_conversationkit 插件。我们将创建一个简单的示例来展示如何获取并显示会话列表。

创建一个新的 Flutter 项目

首先，确保你已经安装了 Flutter SDK 并配置好了开发环境。然后创建一个新的 Flutter 项目：

flutter create conversation_kit_example
cd conversation_kit_example

在项目的 pubspec.yaml 文件中添加 nim_conversationkit 依赖：

dependencies:
  flutter:
    sdk: flutter
  nim_conversationkit: ^1.0.0

保存文件后，运行以下命令以获取依赖项：

flutter pub get

初始化nim_conversationkit

在您的主应用程序文件（例如 main.dart）中初始化 nim_conversationkit。

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

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

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(title: Text('nim_conversationkit 示例')),
        body: ConversationListScreen(),
      ),
    );
  }
}

创建会话列表屏幕

现在我们来创建一个 ConversationListScreen，它将从 nim_conversationkit 获取会话列表并显示它们。

class ConversationListScreen extends StatefulWidget {
  @override
  _ConversationListScreenState createState() => _ConversationListScreenState();
}

class _ConversationListScreenState extends State<ConversationListScreen> {
  List<NIMSession> sessions = [];

  @override
  void initState() {
    super.initState();
    // 初始化nim_conversationkit
    NIMConversationKit.instance().init();

    // 获取会话列表
    NIMConversationKit.instance().fetchSessions().then((result) {
      setState(() {
        sessions = result;
      });
    }).catchError((error) {
      print("获取会话列表失败: $error");
    });
  }

  @override
  Widget build(BuildContext context) {
    return ListView.builder(
      itemCount: sessions.length,
      itemBuilder: (context, index) {
        final session = sessions[index];
        return ListTile(
          title: Text(session.title),
          subtitle: Text(session.lastMessage?.content ?? ""),
          trailing: Text(session.unreadCount.toString()),
        );
      },
    );
  }
}

上述代码做了以下几件事：

1. 初始化 nim_conversationkit。
2. 调用 fetchSessions() 方法获取会话列表。
3. 将获取到的会话列表存储在 _ConversationListScreenState 类中的 sessions 变量里，并更新 UI 显示。

运行示例

最后，运行你的 Flutter 应用程序，你应该能够看到会话列表被成功加载并显示出来。

flutter run