Integration Overview (iOS)

pod install

<key>NSCameraUsageDescription</key>
<string>TUIRoomKit requires access to your camera</string>
<key>NSMicrophoneUsageDescription</key>
<string>TUIRoomKit requires access to your microphone</string>

import UIKit
import AtomicXCore

// RoomMainViewController represents the main room view controller
class RoomMainViewController: UIViewController {
    private var roomID = "webinar_123456"

    // Automatically create and join the room on initialization
    public init() {
        super.init(nibName: nil, bundle: nil)
        createAndJoinRoom(roomID: roomID, roomType: .webinar)
    }

    required init?(coder: NSCoder) {
        fatalError("init(coder:) has not been implemented")
    }

    private func createAndJoinRoom(roomID: String, roomType: RoomType) {
        // 1. Configure room parameters
        var options = CreateRoomOptions()
        options.roomName = "My Webinar"        // Display name for the room
        options.password = ""                  // Room entry password (leave empty if not needed)

        // 2. Set initial room permissions
        options.isAllCameraDisabled = false
        options.isAllMessageDisabled = false
        options.isAllMicrophoneDisabled = false
        options.isAllScreenShareDisabled = false

        // 3. Create and join the room
        RoomStore.shared.createAndJoinRoom(roomID: roomID, roomType: roomType, options: options) { [weak self] result in
            guard let self = self else { return }
            switch result {
            case .success():
                print("Successfully created and joined webinar room")
            case .failure(let error):
                print("Failed to create and join webinar room [Error Code: \(error.code)]: \(error.message)")
            }
        }
    }
}

import UIKit
import AtomicXCore

// RoomMainViewController represents the main room view controller
class RoomMainViewController: UIViewController {
    private let roomID: String
    private static let kAppGroup = "group.com.RPLiveStreamRelease"

    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. Enable front camera
        DeviceStore.shared.openLocalCamera(isFront: true, completion: nil)
        // 2. Enable microphone
        DeviceStore.shared.openLocalMicrophone(completion: nil)
        // 3. Start screen sharing (camera must be off for screen sharing)
        // DeviceStore.shared.startScreenShare(appGroup: Self.kAppGroup)
    }
}

import UIKit
import AtomicXCore

// RoomMainViewController represents the main room view controller
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 permanently terminates the room.
        // Only the host (Owner) can perform this operation. All members are removed and audio/video is forcibly stopped.
        RoomStore.shared.endRoom { [weak self] result in
            guard let self = self else { return }
            switch result {
            case .success():
                print("Room ended successfully")
            case .failure(let error):
                print("Failed to end room [Error Code: \(error.code)]: \(error.message)")
            }
        }
    }
}

import UIKit
import AtomicXCore

// RoomMainViewController represents the main room view controller
class RoomMainViewController: UIViewController {
    private let roomID = "webinar_123456"

    public init() {
        super.init(nibName: nil, bundle: nil)
        joinRoom(roomID: roomID, roomType: .webinar)
    }

    required init?(coder: NSCoder) {
        fatalError("init(coder:) has not been implemented")
    }

    private func joinRoom(roomID: String, roomType: RoomType) {
        // 1. Prepare join parameters
        let targetRoomID = roomID    // Room ID to join
        let roomPassword = ""        // Room password; pass empty string or nil if not set

        // 2. Call RoomStore joinRoom API
        // Checks room existence, user ban, and password correctness
        RoomStore.shared.joinRoom(roomID: targetRoomID, roomType: roomType, password: roomPassword) { [weak self] result in
            guard let self = self else { return }
            switch result {
            case .success():
                print("Joined room successfully")
            case .failure(let error):
                print("Failed to join room [Error Code: \(error.code)]: \(error.message)")
            }
        }
    }
}

import UIKit
import AtomicXCore

// RoomMainViewController represents the main room view controller
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() {
        // leaveRoom is for regular members or hosts to exit the room.
        // If the host leaves, only they exit; the room remains active.
        // Stops audio/video streaming and notifies the server to remove the user
        RoomStore.shared.leaveRoom { [weak self] result in
            guard let self = self else { return }
            switch result {
            case .success():
                print("Left room successfully")
            case .failure(let error):
                print("Failed to leave room [Error Code: \(error.code)]: \(error.message)")
            }
        }
    }
}