Flutter即时通讯插件netease_corekit_im的使用

netease_corekit_im 是网易云信提供的一个 Flutter 插件，用于在 Flutter 应用中集成即时通讯（IM）功能。它提供了丰富的 API，支持消息发送、接收、会话管理、群组管理等功能。

以下是使用 netease_corekit_im 插件的基本步骤和示例代码：

1. 添加依赖

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

dependencies:
  flutter:
    sdk: flutter
  netease_corekit_im: ^latest_version

然后运行 flutter pub get 来安装依赖。

2. 初始化 SDK

在使用 IM 功能之前，需要先初始化 SDK。通常在 main.dart 中进行初始化：

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

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  
  // 初始化 IM SDK
  await NIMCoreKit.init(
    appKey: 'your_app_key',
  );
  
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter IM Demo',
      home: HomeScreen(),
    );
  }
}

3. 登录 IM 服务器

使用 login 方法登录 IM 服务器：

void loginIM(String account, String token) async {
  try {
    await NIMCoreKit.login(
      account: account,
      token: token,
    );
    print('登录成功');
  } catch (e) {
    print('登录失败: $e');
  }
}

4. 发送消息

使用 sendMessage 方法发送消息：

void sendTextMessage(String sessionId, String text) async {
  try {
    await NIMCoreKit.sendMessage(
      sessionId: sessionId,
      messageType: NIMessageType.text,
      text: text,
    );
    print('消息发送成功');
  } catch (e) {
    print('消息发送失败: $e');
  }
}

5. 接收消息

通过监听 NIMCoreKit.onMessageReceived 来接收消息：

void listenForMessages() {
  NIMCoreKit.onMessageReceived.listen((message) {
    print('收到消息: ${message.text}');
  });
}

6. 管理会话

获取会话列表：

void getSessions() async {
  try {
    List<NIMSession> sessions = await NIMCoreKit.getSessions();
    sessions.forEach((session) {
      print('会话ID: ${session.sessionId}');
    });
  } catch (e) {
    print('获取会话列表失败: $e');
  }
}

7. 退出登录

使用 logout 方法退出登录：

void logoutIM() async {
  try {
    await NIMCoreKit.logout();
    print('退出登录成功');
  } catch (e) {
    print('退出登录失败: $e');
  }
}

8. 其他功能

netease_corekit_im 还支持群组管理、好友管理、消息撤回、已读回执等功能，具体可以参考官方文档。

9. 处理生命周期

在 Flutter 中，建议在 WidgetsBindingObserver 中处理应用的生命周期，以确保 IM SDK 的正确运行：

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

class _HomeScreenState extends State<HomeScreen> with WidgetsBindingObserver {
  [@override](/user/override)
  void initState() {
    super.initState();
    WidgetsBinding.instance.addObserver(this);
  }

  [@override](/user/override)
  void dispose() {
    WidgetsBinding.instance.removeObserver(this);
    super.dispose();
  }

  [@override](/user/override)
  void didChangeAppLifecycleState(AppLifecycleState state) {
    super.didChangeAppLifecycleState(state);
    if (state == AppLifecycleState.paused) {
      // 应用进入后台
      NIMCoreKit.enterBackground();
    } else if (state == AppLifecycleState.resumed) {
      // 应用回到前台
      NIMCoreKit.enterForeground();
    }
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Flutter IM Demo'),
      ),
      body: Center(
        child: Text('即时通讯示例'),
      ),
    );
  }
}