chatroom_manager 是一个用于管理 Flutter 聊天室的插件，它可以帮助开发者轻松地实现聊天室的基本功能，如创建聊天室、加入聊天室、发送消息、接收消息等。以下是如何使用 chatroom_manager 插件的基本步骤：

1. 添加依赖

首先，你需要在 pubspec.yaml 文件中添加 chatroom_manager 插件的依赖：

dependencies:
  flutter:
    sdk: flutter
  chatroom_manager: ^1.0.0  # 请使用最新版本

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

2. 初始化插件

在你的 Flutter 应用中初始化 chatroom_manager 插件。通常，你可以在 main.dart 文件中进行初始化：

import 'package:chatroom_manager/chatroom_manager.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  
  // 初始化 ChatroomManager
  await ChatroomManager.initialize(
    apiKey: 'YOUR_API_KEY',  // 替换为你的 API 密钥
    serverUrl: 'YOUR_SERVER_URL',  // 替换为你的服务器地址
  );

  runApp(MyApp());
}

3. 创建聊天室

你可以使用 ChatroomManager 来创建一个新的聊天室：

import 'package:chatroom_manager/chatroom_manager.dart';

Future<void> createChatroom() async {
  try {
    Chatroom chatroom = await ChatroomManager.createChatroom(
      name: 'My Chatroom',
      description: 'This is a sample chatroom',
    );
    print('Chatroom created: ${chatroom.id}');
  } catch (e) {
    print('Failed to create chatroom: $e');
  }
}

4. 加入聊天室

用户可以通过聊天室的 ID 加入聊天室：

import 'package:chatroom_manager/chatroom_manager.dart';

Future<void> joinChatroom(String chatroomId) async {
  try {
    await ChatroomManager.joinChatroom(chatroomId);
    print('Joined chatroom: $chatroomId');
  } catch (e) {
    print('Failed to join chatroom: $e');
  }
}

5. 发送消息

在聊天室中发送消息：

import 'package:chatroom_manager/chatroom_manager.dart';

Future<void> sendMessage(String chatroomId, String message) async {
  try {
    await ChatroomManager.sendMessage(chatroomId, message);
    print('Message sent: $message');
  } catch (e) {
    print('Failed to send message: $e');
  }
}

6. 接收消息

你可以通过监听消息流来接收聊天室中的消息：

import 'package:chatroom_manager/chatroom_manager.dart';

StreamSubscription<ChatMessage>? _messageSubscription;

void listenToMessages(String chatroomId) {
  _messageSubscription = ChatroomManager.getMessageStream(chatroomId).listen((message) {
    print('New message: ${message.content}');
  });
}

[@override](/user/override)
void dispose() {
  _messageSubscription?.cancel();
  super.dispose();
}

7. 离开聊天室

用户可以通过以下代码离开聊天室：

import 'package:chatroom_manager/chatroom_manager.dart';

Future<void> leaveChatroom(String chatroomId) async {
  try {
    await ChatroomManager.leaveChatroom(chatroomId);
    print('Left chatroom: $chatroomId');
  } catch (e) {
    print('Failed to leave chatroom: $e');
  }
}

8. 删除聊天室

只有聊天室的创建者可以删除聊天室：

import 'package:chatroom_manager/chatroom_manager.dart';

Future<void> deleteChatroom(String chatroomId) async {
  try {
    await ChatroomManager.deleteChatroom(chatroomId);
    print('Chatroom deleted: $chatroomId');
  } catch (e) {
    print('Failed to delete chatroom: $e');
  }
}

9. 处理错误

在使用 chatroom_manager 时，可能会遇到各种错误，如网络错误、权限错误等。你可以通过 try-catch 块来捕获并处理这些错误。

10. 示例应用

以下是一个简单的示例应用，展示了如何使用 chatroom_manager 插件：

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

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await ChatroomManager.initialize(
    apiKey: 'YOUR_API_KEY',
    serverUrl: 'YOUR_SERVER_URL',
  );
  runApp(ChatroomApp());
}

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

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

class _ChatroomScreenState extends State<ChatroomScreen> {
  String _chatroomId = '';

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Chatroom Manager'),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            ElevatedButton(
              onPressed: () async {
                Chatroom chatroom = await ChatroomManager.createChatroom(
                  name: 'My Chatroom',
                  description: 'This is a sample chatroom',
                );
                setState(() {
                  _chatroomId = chatroom.id;
                });
              },
              child: Text('Create Chatroom'),
            ),
            ElevatedButton(
              onPressed: () async {
                await ChatroomManager.joinChatroom(_chatroomId);
              },
              child: Text('Join Chatroom'),
            ),
            ElevatedButton(
              onPressed: () async {
                await ChatroomManager.sendMessage(_chatroomId, 'Hello, World!');
              },
              child: Text('Send Message'),
            ),
          ],
        ),
      ),
    );
  }
}