接入概览（Flutter）

dependencies:   
    atomic_x_core: 最新版本

flutter pub get

import 'package:atomic_x_core/atomicxcore.dart';

var loginResult = await LoginStore.shared.login(
    sdkAppID: 'SDKAPPID',    // 替换为您的 SDKAPPID
    userID: 'userID',        // 替换为您的 UserID
    userSig: 'userSig',      // 替换为您的 UserSig
);

if (loginResult.isSuccess) {
  // login success
} else {
  // login error
}

import 'package:atomic_x_core/atomicxcore.dart';

// RoomMainPage 代表房间主视图
class RoomMainPage extends StatefulWidget {
  final String roomID;
  const RoomMainPage({super.key, required this.roomID});

  @override
  State<RoomMainPage> createState() => _RoomMainPageState();
}

class _RoomMainPageState extends State<RoomMainPage> {
  @override
  void initState() {
    super.initState();
    createAndJoinRoom();
  }

  // 调用此方法完成创建并加入房间的复合操作
  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}');
    }
  }

  @override
  Widget build(BuildContext context) {
    return Container(); // 房间视图内容
  }
}

import 'package:atomic_x_core/atomicxcore.dart';

/// 打开设备
/// 注意：Android 平台需要在开启前先申请摄像头和麦克风权限
/// 可选择使用permission_handler库申请权限
void _openDevices() {
  // 1. 打开前置摄像头
  DeviceStore.shared.openLocalCamera(true);
  // 2. 打开麦克风
  DeviceStore.shared.openLocalMicrophone();
}

import 'package:atomic_x_core/atomicxcore.dart';

/// 调用此方法结束房间
Future<void> endRoom() async {
  // endRoom 接口用于永久结束当前房间。
  // 注意：通常该操作仅限房主（Owner）执行，执行后所有成员将被移出房间且音视频采集会强制停止。
  final result = await RoomStore.shared.endRoom();
  
  if (result.isSuccess) {
    debugPrint('结束房间成功');
  } else {
    debugPrint('结束房间失败 [错误码: ${result.errorCode}]: ${result.errorMessage}');
  }
}

import 'package:atomic_x_core/atomicxcore.dart';

final _controllers = <String, RoomParticipantController>{};
final _participantStore = RoomParticipantStore.create(roomID);

Widget build(BuildContext context) {
  // 使用 ValueListenableBuilder 订阅房间参与者列表状态
  return ValueListenableBuilder<List<RoomParticipant>>(
    valueListenable: _participantStore.state.participantList,
    builder: (context, participants, _) {
      return GridView.builder(
        gridDelegate: const SliverGridDelegateWithFixedCrossAxisCount(crossAxisCount: 2),
        itemCount: participants.length,
        itemBuilder: (_, index) => _buildParticipantView(participants[index]),
      );
    },
  );
}

Widget _buildParticipantView(RoomParticipant participant) {
  // 初始化 RoomParticipantController 实例
  final controller = _controllers.putIfAbsent(
    participant.userID,
    () => RoomParticipantController.create(
      streamType: VideoStreamType.camera,
      participant: participant,
    ),
  )..updateParticipant(participant)
   ..setActive(true);  // 可见时设置活跃状态为 true，不可见时设为 false

  // 初始化 Widget 并添加到房间界面中
  return RoomParticipantWidget(controller: controller);
}