Flutter房间管理UI插件roomkit_flutter_ui的使用

roomkit_flutter_ui 是一个用于构建房间管理界面的 Flutter 插件。它提供了一套预定义的 UI 组件，帮助开发者快速实现房间管理功能，如创建房间、加入房间、显示房间列表等。

安装

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

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

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

基本使用

1. 导入包

import 'package:roomkit_flutter_ui/roomkit_flutter_ui.dart';

2. 创建房间

RoomKitFlutterUI.createRoom(
  roomName: 'My Room',
  onRoomCreated: (roomId) {
    print('Room created with ID: $roomId');
  },
  onError: (error) {
    print('Error creating room: $error');
  },
);

3. 加入房间

RoomKitFlutterUI.joinRoom(
  roomId: '12345',
  onJoined: () {
    print('Successfully joined the room');
  },
  onError: (error) {
    print('Error joining room: $error');
  },
);

4. 显示房间列表

RoomKitFlutterUI.showRoomList(
  onRoomSelected: (roomId) {
    print('Selected room ID: $roomId');
  },
  onError: (error) {
    print('Error fetching room list: $error');
  },
);

自定义 UI

roomkit_flutter_ui 也允许你自定义 UI 组件的外观和行为。你可以通过传递自定义的 ThemeData 或 Widget 来实现。

自定义主题

RoomKitFlutterUI.setTheme(
  theme: ThemeData(
    primaryColor: Colors.blue,
    accentColor: Colors.green,
  ),
);

自定义房间列表项

RoomKitFlutterUI.setRoomListItemBuilder(
  builder: (context, room) {
    return ListTile(
      title: Text(room.name),
      subtitle: Text('ID: ${room.id}'),
      onTap: () {
        // Handle room selection
      },
    );
  },
);

高级功能

roomkit_flutter_ui 还提供了一些高级功能，如房间权限管理、房间成员管理、消息发送等。你可以通过查阅官方文档来了解更多细节。

示例

以下是一个完整的示例，展示了如何使用 roomkit_flutter_ui 创建和加入房间：

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

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

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: Text('RoomKit Flutter UI Example'),
        ),
        body: Center(
          child: Column(
            mainAxisAlignment: MainAxisAlignment.center,
            children: [
              ElevatedButton(
                onPressed: () {
                  RoomKitFlutterUI.createRoom(
                    roomName: 'My Room',
                    onRoomCreated: (roomId) {
                      print('Room created with ID: $roomId');
                    },
                    onError: (error) {
                      print('Error creating room: $error');
                    },
                  );
                },
                child: Text('Create Room'),
              ),
              SizedBox(height: 20),
              ElevatedButton(
                onPressed: () {
                  RoomKitFlutterUI.joinRoom(
                    roomId: '12345',
                    onJoined: () {
                      print('Successfully joined the room');
                    },
                    onError: (error) {
                      print('Error joining room: $error');
                    },
                  );
                },
                child: Text('Join Room'),
              ),
            ],
          ),
        ),
      ),
    );
  }
}