接入概览（iOS）

pod install

<key>NSCameraUsageDescription</key>
<string>TUIRoomKit需要访问您的相机权限</string>
<key>NSMicrophoneUsageDescription</key>
<string>TUIRoomKit需要访问您的麦克风权限</string>

import UIKit
import AtomicXCore

// RoomMainViewController 代表房间主视图控制器
class RoomMainViewController: UIViewController {
    private let roomID: String

    // 初始化视图控制器并自动启动房间逻辑
    // - Parameter roomID: 目标房间的唯一 ID
    public init(roomID: String) {
        self.roomID = roomID
        super.init(nibName: nil, bundle: nil)
        createAndJoinRoom()
    }
    
    required init?(coder: NSCoder) {
        fatalError("init(coder:) has not been implemented")
    }
    
    // 调用此方法完成创建并加入房间的复合操作
    private func createAndJoinRoom() {
        // 1. 配置房间初始化参数
        // CreateRoomOptions 用于定义房间的基础属性及初始权限控制
        var options = CreateRoomOptions()
        options.roomName = "我的讨论会"        // 设置房间对外展示的名称
        options.password = ""                // 设置房间进入密码（若无需密码则留空）
        
        // 2. 房间权限预设：在创建之初即可控制全场权限（通常用于正式会议场景）
        options.isAllCameraDisabled = false      // 全员开启/禁用摄像头的初始状态
        options.isAllMessageDisabled = false     // 全员开启/禁言的初始状态
        options.isAllMicrophoneDisabled = false  // 全员开启/静音的初始状态
        options.isAllScreenShareDisabled = false // 全员禁止/允许屏幕分享的初始状态
        
        // 3. 创建并加入房间
        // 该方法是一个复合操作：若房间不存在则先创建，随后自动执行加入流程
        RoomStore.shared.createAndJoinRoom(roomID: roomID, options: options) { [weak self] result in
            guard let self = self else { return }
            switch result {
            case .success():
                print("创建并加入房间成功")
            case .failure(let error):
                print("创建并加入房间失败 [错误码: \\(error.code)]: \\(error.message)")
            }
        }
    }
}

import UIKit
import AtomicXCore

// RoomMainViewController 代表房间主视图控制器
class RoomMainViewController: UIViewController {
    private let roomID: String
    public init(roomID: String) {
        self.roomID = roomID
        super.init(nibName: nil, bundle: nil)
        openDevices()
    }
    
    required init?(coder: NSCoder) {
        fatalError("init(coder:) has not been implemented")
    }
    
    // 调用此方法打开设备
    private func openDevices() {
        // 1. 打开前置摄像头
        DeviceStore.shared.openLocalCamera(isFront: true, completion: nil)
        // 2. 打开麦克风
        DeviceStore.shared.openLocalMicrophone(completion: nil)
    }
}

import UIKit
import AtomicXCore

// RoomMainViewController 代表房间主视图控制器
class RoomMainViewController: UIViewController {
    private let roomID: String

    public init(roomID: String) {
        self.roomID = roomID
        super.init(nibName: nil, bundle: nil)
        endRoom()
    }
    
    required init?(coder: NSCoder) {
        fatalError("init(coder:) has not been implemented")
    }
    
    /// 调用此方法结束房间
    private func endRoom() { 
        // endRoom 接口用于永久结束当前房间。
        // 注意：通常该操作仅限房主（Owner）执行，执行后所有成员将被移出房间且音视频采集会强制停止。
        RoomStore.shared.endRoom { [weak self] result in
            guard let self = self else { return }
            switch result {
            case .success():
                print("结束房间成功")
            case .failure(let error):
                print("结束房间失败 [错误码: \\(error.code)]: \\(error.message)")
            }
        }
    }
}

import UIKit
import AtomicXCore

// RoomMainViewController 代表房间主视图控制器
class RoomMainViewController: UIViewController {
    private let roomID: String
    
    public init(roomID: String) {
        self.roomID = roomID
        super.init(nibName: nil, bundle: nil)
        joinRoom()
    }
    
    required init?(coder: NSCoder) {
        fatalError("init(coder:) has not been implemented")
    }
    
    /// 调用此方法加入一个已存在的房间
    private func joinRoom() {
        // 1. 准备加入参数
        // joinRoom 适用于加入一个已知且正在进行的房间
        let targetRoomID = self.roomID    // 目标房间 ID
        let roomPassword = ""             // 房间密码，若房间未设置密码则传空字符串或 nil
        
        // 2. 调用 RoomStore 加入房间接口
        // 该操作会验证房间是否存在、用户是否被禁入以及密码是否正确
        RoomStore.shared.joinRoom(roomID: targetRoomID, password: roomPassword) { [weak self] result in
            guard let self = self else { return }
            switch result {
            case .success():
                print("加入房间成功")
            case .failure(let error):
                print("加入房间失败 [错误码: \\(error.code)]: \\(error.message)")
            }
        }
    }
} 

import UIKit
import AtomicXCore

// RoomMainViewController 代表房间主视图控制器
class RoomMainViewController: UIViewController {
    private let roomID: String
    
    public init(roomID: String) {
        self.roomID = roomID
        super.init(nibName: nil, bundle: nil)
        leaveRoom()
    }
    
    required init?(coder: NSCoder) {
        fatalError("init(coder:) has not been implemented")
    }
    
    /// 调用此方法主动退出当前房间
    private func leaveRoom() {
        // 1. 业务逻辑说明
        // leaveRoom 接口用于普通成员或房主主动退出房间。
        // 与 endRoom 不同，房主调用 leaveRoom 只会让自己离开，房间依然存在。
        
        // 2. 调用 RoomStore 离开房间接口
        // 该操作会停止音视频流传输，并通知服务器将当前用户移出房间
        RoomStore.shared.leaveRoom { [weak self] result in
            guard let self = self else { return }
            switch result {
            case .success():
                print("退出房间成功")
            case .failure(let error):
                print("退出房间失败 [错误码: \\(error.code)]: \\(error.message)")
            }
        }
    }
}