房间管理（Flutter）

import 'package:atomic_x_core/atomicxcore.dart';

void createAndJoinRoom() async {
  // 1. 配置房间初始化参数
  // CreateRoomOptions 用于定义房间的基础属性及初始权限控制
  final options = CreateRoomOptions(
    roomName: '我的讨论会',        // 设置房间对外展示的名称
    password: '',                 // 设置房间进入密码（若无需密码则留空）
    // 2. 房间权限预设
    isAllCameraDisabled: false,      // 全员开启/禁用摄像头的初始状态
    isAllMessageDisabled: false,     // 全员开启/禁言的初始状态
    isAllMicrophoneDisabled: false,  // 全员开启/静音的初始状态
    isAllScreenShareDisabled: false, // 全员禁止/允许屏幕分享的初始状态
  );

  // 3. 创建并加入房间
  // 该方法会自动处理房间创建（如果不存在）和加入逻辑
  final result = await RoomStore.shared.createAndJoinRoom(
    roomID: widget.roomID,
    options: options,
  );

  if (result.isSuccess) {
    debugPrint('创建并加入房间成功');
  } else {
    debugPrint('创建并加入房间失败 [错误码: ${result.errorCode}]: ${result.errorMessage}');
  }
}

import 'package:atomic_x_core/atomicxcore.dart';

Future<void> joinRoom() async {
  // 调用 RoomStore 加入房间接口
  // 该操作会验证房间是否存在、用户是否被禁入以及密码是否正确
  final result = await RoomStore.shared.joinRoom(
    roomID: targetRoomID,    // 目标房间 ID
    password: roomPassword,  // 房间密码，若房间未设置密码则传空字符串或null
  );

  if (result.isSuccess) {
    print("加入房间成功");
  } else {
    print("加入房间失败 [错误码: ${result.errorCode}]: ${result.errorMessage}");
  }
}

import 'package:atomic_x_core/atomicxcore.dart';

Future<void> leaveRoom() async {
  // 1. 业务逻辑说明
  // leaveRoom 接口用于普通成员或房主主动退出房间
  // 与 endRoom 不同，房主调用 leaveRoom 只会让自己离开，房间依然存在

  // 2. 调用 RoomStore 离开房间接口
  // 该操作会停止音视频流传输，并通知服务器将当前用户移出房间
  final result = await RoomStore.shared.leaveRoom();

  if (result.code == 0) {
    print("离开房间成功");
  } else {
    print("离开房间失败 [错误码: ${result.errorCode}]: ${result.errorMessage}");
  }
}


import 'package:atomic_x_core/atomicxcore.dart';

Future<void> endRoom() async {
  
  // 1. 业务逻辑说明
  // endRoom 接口用于永久解散当前房间
  // 注意：该操作通常仅限房主（Owner）执行，解散后所有成员将被强制退出
  
  // 2. 调用 RoomStore 解散房间接口
  // 该方法会向服务器发送解散指令，并通知所有在线参与者房间已结束
  final result = await RoomStore.shared.endRoom();
  
  if (result.isSuccess) {
    debugPrint('结束房间成功');
  } else {
    debugPrint('结束房间失败 [错误码: ${result.errorCode}]: ${result.errorMessage}');
  }
}

import 'package:atomic_x_core/atomicxcore.dart';

Future<void> updateRoomInfo() async {
  // 1. 配置房间更新参数
  // UpdateRoomOptions 用于定义需要更新的房间属性
  final options = UpdateRoomOptions(
    roomName: "新的会议室名称",  // 更新房间显示名称
  );

  // 2. 设置修改标志位
  // modifyFlagList 用于指定具体要更新哪些字段
  final modifyFlagList = [
    UpdateRoomOptionsModifyFlag.roomName,  // 标记需要更新房间名称
  ];

  // 3. 调用 RoomStore 更新房间信息接口
  // 该方法会向服务器提交更新请求，并同步给所有房间成员
  final result = await RoomStore.shared.updateRoomInfo(
    roomID: "roomID",
    options: options,
    modifyFlagList: modifyFlagList,
  );

  if (result.isSuccess) {
    print("更新房间信息成功");
  } else {
    print("更新房间信息失败 [错误码: ${result.errorCode}]: ${result.errorMessage}");
  }
}


import 'package:atomic_x_core/atomicxcore.dart';

Future<void> getRoomInfo() async {
  // 1. 业务逻辑说明
  // getRoomInfo 接口用于获取指定房间的详细信息
  // 可以获取房间名称、创建者、参与者数量、权限设置等完整信息

  // 2. 调用 RoomStore 获取房间信息接口
  // 该操作会从服务器获取最新的房间状态和配置信息
  final result = await RoomStore.shared.getRoomInfo("roomID");

  if (result.code == 0) {
    print("获取房间信息成功，roomInfo: ${result.roomInfo}");
  } else {
    print("获取房间信息失败 [错误码: ${result.errorCode}]: ${result.errorMessage}");
  }
}

import 'package:atomic_x_core/atomicxcore.dart';

// RoomPage 代表房间主视图
class RoomPage extends StatefulWidget {
  const RoomPage({super.key});

  @override
  State<RoomPage> createState() => _RoomPageState();
}

class _RoomPageState extends State<RoomPage> {
  // 房间事件监听器
  late final RoomListener _roomListener;

  @override
  void initState() {
    super.initState();
    
    /// 创建监听器，设置各事件回调
    _roomListener = RoomListener(
      onRoomEnded: (roomInfo) {
        print("房间已结束: ${roomInfo.roomName}");
      },
       // ... 处理其他 RoomListener 事件 ...
    );

    /// 调用此方法添加监听器，订阅房间被动事件
    RoomStore.shared.addRoomListener(_roomListener);
  }

  @override
  void dispose() {
    // 调用此方法移除监听器，避免内存泄漏
    RoomStore.shared.removeRoomListener(_roomListener);
    super.dispose();
  }
}

ValueListenableBuilder(
  valueListenable: RoomStore.shared.state.currentRoom,
  builder: (context, currentRoom, _) {
    return Container();  // 需要监听房间信息的widget
  },
),