房间管理（Android）

import android.util.Log
import io.trtc.tuikit.atomicxcore.api.CompletionHandler
import io.trtc.tuikit.atomicxcore.api.room.CreateRoomOptions
import io.trtc.tuikit.atomicxcore.api.room.RoomStore

private val roomID = "test_room_001"

fun createAndJoinRoom() {
    // 1. 配置房间创建参数
    // CreateRoomOptions 定义房间的基础属性和初始权限设置
    val options = CreateRoomOptions(
        roomName = "团队会议室",           // 房间显示名称
        password = "",                     // 房间密码（可选）
        // 2. 设置房间初始权限控制
        isAllCameraDisabled = false,       // 是否禁用所有成员摄像头
        isAllMessageDisabled = false,      // 是否禁言所有成员
        isAllMicrophoneDisabled = false,   // 是否静音所有成员
        isAllScreenShareDisabled = false   // 是否禁止所有成员屏幕分享
    )

    // 3. 调用 RoomStore 创建并加入房间接口
    // 该方法会自动处理房间创建（如果不存在）和加入逻辑
    RoomStore.shared().createAndJoinRoom(roomID, options, object : CompletionHandler {
        override fun onSuccess() {
            Log.d("Room", "成功创建并加入房间")
        }

        override fun onFailure(code: Int, desc: String) {
            Log.e("Room", "创建并加入房间失败 [错误码: $code]: $desc")
        }
    })
}

import android.util.Log
import io.trtc.tuikit.atomicxcore.api.room.RoomStore
import io.trtc.tuikit.atomicxcore.api.CompletionHandler

private val roomID = "test_room_001"

fun joinRoom() {
    // 1. 准备加入房间参数
    // joinRoom 适用于加入一个已知且正在进行的房间
    val roomPassword = "" // 房间密码，若房间未设置密码则传空字符串或 null

    // 2. 调用 RoomStore 加入房间接口
    // 该操作会验证房间是否存在、用户是否被禁入以及密码是否正确
    RoomStore.shared().joinRoom(roomID, roomPassword, object : CompletionHandler {
        override fun onSuccess() {
            Log.d("Room", "加入房间成功")
        }

        override fun onFailure(code: Int, desc: String) {
            Log.e("Room", "加入房间失败 [错误码: $code]: $desc")
        }
    })
}

import android.util.Log
import io.trtc.tuikit.atomicxcore.api.room.RoomStore
import io.trtc.tuikit.atomicxcore.api.CompletionHandler

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

    // 2. 调用 RoomStore 离开房间接口
    // 该操作会停止音视频流传输，并通知服务器将当前用户移出房间
    RoomStore.shared().leaveRoom(object : CompletionHandler {
        override fun onSuccess() {
            Log.d("Room", "离开房间成功")
        }

        override fun onFailure(code: Int, desc: String) {
            Log.e("Room", "离开房间失败 [错误码: $code]: $desc")
        }
    })
}

import android.util.Log
import io.trtc.tuikit.atomicxcore.api.CompletionHandler
import io.trtc.tuikit.atomicxcore.api.room.RoomStore

fun endRoom() {
    // 1. 业务逻辑说明
    // endRoom 接口用于永久解散当前房间
    // 注意：该操作通常仅限房主（Owner）执行，解散后所有成员将被强制退出

    // 2. 调用 RoomStore 解散房间接口
    // 该方法会向服务器发送解散指令，并通知所有在线参与者房间已结束
    RoomStore.shared().endRoom(object : CompletionHandler {
        override fun onSuccess() {
            Log.d("Room", "解散房间成功")
        }

        override fun onFailure(code: Int, desc: String) {
            Log.e("Room", "解散房间失败 [错误码: $code]: $desc")
        }
    })
}

import android.util.Log
import io.trtc.tuikit.atomicxcore.api.room.RoomStore
import io.trtc.tuikit.atomicxcore.api.room.UpdateRoomOptions
import io.trtc.tuikit.atomicxcore.api.CompletionHandler

private val roomID = "test_room_001"

fun updateRoomInfo() {
    // 1. 配置房间更新参数
    // UpdateRoomOptions 用于定义需要更新的房间属性
    val options = UpdateRoomOptions(
        roomName = "新的会议室名称"     // 更新房间显示名称
    )

    // 2. 设置修改标志位
    // modifyFlagList 用于指定具体要更新哪些字段，支持组合多个标志
    val modifyFlagList = listOf(UpdateRoomOptions.ModifyFlag.ROOM_NAME)

    // 3. 调用 RoomStore 更新房间信息接口
    // 该方法会向服务器提交更新请求，并同步给所有房间成员
    RoomStore.shared().updateRoomInfo(roomID, options, modifyFlagList, object : CompletionHandler {
        override fun onSuccess() {
            Log.d("Room", "更新房间信息成功")
        }

        override fun onFailure(code: Int, desc: String) {
            Log.e("Room", "更新房间信息失败 [错误码: $code]: $desc")
        }
    })
}

import io.trtc.tuikit.atomicxcore.api.room.UpdateRoomOptions

private fun update() {
    // 1. 配置房间更新参数
    // UpdateRoomOptions 用于定义需要更新的房间属性
    val options = UpdateRoomOptions()
    options.password = "123456"  // 更新房间的房间密码

    // 2. 设置修改标志位
    // ModifyFlag 用于指定具体要更新哪些字段
    val modifyFlag = mutableListOf<UpdateRoomOptions.ModifyFlag>()
    modifyFlag.add(UpdateRoomOptions.ModifyFlag.PASSWORD) // 添加更新密码标记位
}

import android.util.Log
import io.trtc.tuikit.atomicxcore.api.room.RoomStore
import io.trtc.tuikit.atomicxcore.api.room.RoomInfo
import io.trtc.tuikit.atomicxcore.api.room.GetRoomInfoCompletionHandler

private val roomID = "test_room_001"

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

    // 2. 调用 RoomStore 获取房间信息接口
    // 该操作会从服务器获取最新的房间状态和配置信息
    RoomStore.shared().getRoomInfo(roomID, object : GetRoomInfoCompletionHandler {
        override fun onSuccess(roomInfo: RoomInfo) {
            Log.d("Room", "获取房间信息成功，roomInfo: $roomInfo")
        }

        override fun onFailure(code: Int, desc: String) {
            Log.e("Room", "获取房间信息失败 [错误码: $code]: $desc")
        }
    })
}

import android.content.Context
import android.util.AttributeSet
import android.util.Log
import android.widget.FrameLayout
import io.trtc.tuikit.atomicxcore.api.room.RoomInfo
import io.trtc.tuikit.atomicxcore.api.room.RoomListener
import io.trtc.tuikit.atomicxcore.api.room.RoomStore

class RoomMainView @JvmOverloads constructor(
    context: Context,
    attrs: AttributeSet? = null,
    defStyleAttr: Int = 0
) : FrameLayout(context, attrs, defStyleAttr) {

    // 房间事件监听器
    private val roomListener = object : RoomListener() {
        override fun onRoomEnded(roomInfo: RoomInfo) {
            Log.d("Room", "当前所在房间已结束")
            // 建议操作：关闭当前页面，返回上一级
        }
    }

    override fun onAttachedToWindow() {
        super.onAttachedToWindow()
        // 添加房间事件监听器
        RoomStore.shared().addRoomListener(roomListener)
    }

    override fun onDetachedFromWindow() {
        super.onDetachedFromWindow()
        // 移除监听器，防止内存泄漏
        RoomStore.shared().removeRoomListener(roomListener)
    }
}

import android.util.Log
import io.trtc.tuikit.atomicxcore.api.room.RoomStore
import kotlinx.coroutines.CoroutineScope
import kotlinx.coroutines.Dispatchers
import kotlinx.coroutines.launch

// 订阅当前所在房间信息变化
private fun subscribeCurrentRoomState() {
    CoroutineScope(Dispatchers.Main).launch {
        RoomStore.shared().state.currentRoom.collect { roomInfo ->
            Log.d("Room", "房间信息更新 新的房间信息: $roomInfo")
        }
    }
}