简介
TUIRoomKit API 是多人会议组件的含 UI 接口。使用 TUIRoomKit 的相关 API,您可以通过简单接口快速实现一个类会议场景。详细的接入步骤请参见:快速接入(TUIRoomKit)。
本文档将详细介绍 Flutter TUIRoomKit 中您可能使用到的类以及相关接口,通过查阅本文档,您可以对 Flutter TUIRoomKit 的使用有一个更为详细的了解。
ConferenceMainPage
会议主界面。

| 字段 | 类型 | 描述 | 
| conferenceId | String | 需要创建/加入的会议 ID | 
| isCreateConference | Bool | 是否为创建会议: true:为创建会议 false:为加入会议 | 
| conferenceParams | 创建/加入会议的相关参数 | |
| conferenceObserver | 会议状态变化回调监听 | 
说明:
当您使用
ConferenceSession创建或加入会议时,这里的参数均可不传。ConferenceSession
当您期望在创建/加入会议成功后再拉起会议界面,您可以使用
ConferenceSession类进行相关操作。| 字段 | 类型 | 描述 | 
| isMuteMicrophone | Bool | 是否静音麦克风(默认为 false) | 
| isOpenCamera | Bool | 是否开启摄像头(默认为 false) | 
| isSoundOnSpeaker | Bool | 是否使用扬声器(默认为 true) | 
| name | String | 会议名称(默认为您的会议 ID,加入会议时传入无效) | 
| enableMicrophoneForAllUser | Bool | 是否开启全员的麦克风权限(默认为 true,加入会议时传入无效) | 
| enableCameraForAllUser | Bool | 是否开启全员的摄像头权限(默认为 true,加入会议时传入无效) | 
| enableMessageForAllUser | Bool | 是否开启全员的发言权限(默认为 true,加入会议时传入无效) | 
| enableSeatControl | Bool | 是否开启上台发言模式(默认为 false,加入会议时传入无效) | 
| onActionSuccess | VoidCallback | 创建/加入会议成功的回调,您可以在这个回调中导航至会议页面 | 
| onActionError | 创建/加入会议失败的回调 | 
newInstance
创建一个新的ConferenceSession对象。
factory ConferenceSession.newInstance(String id)
| 参数 | 类型 | 描述 | 
| id | String | 需要创建/加入的会议 ID | 
quickStart
快速创建会议接口。
Future<void> quickStart()
join
加入会议接口。
Future<void> join()
注意:
1. 在调用快速创建会议或加入会议接口之前,您需要完成所有您需要设置的ConferenceSession的参数,详情可以参考 会前控制。
2. 直接导航至ConferenceMainPage并传入相关参数以 创建/加入会议 时,无需使用ConferenceSession。
ConferenceParams
| 字段 | 类型 | 描述 | 
| isMuteMicrophone | Bool | 是否静音麦克风(默认为 false) | 
| isOpenCamera | Bool | 是否开启摄像头(默认为 false) | 
| isSoundOnSpeaker | Bool | 是否使用扬声器(默认为 true) | 
| name | String | 会议名称(默认为您的会议 ID,加入会议时传入无效) | 
| enableMicrophoneForAllUser | Bool | 是否开启全员的麦克风权限(默认为 true,加入会议时传入无效) | 
| enableCameraForAllUser | Bool | 是否开启全员的摄像头权限(默认为 true,加入会议时传入无效) | 
| enableMessageForAllUser | Bool | 是否开启全员的发言权限(默认为 true,加入会议时传入无效) | 
| enableSeatControl | Bool | 是否开启上台发言模式(默认为 false,加入会议时传入无效) | 
ConferenceObserver
onConferenceStarted
会议开始事件。
Function(String conferenceId, ConferenceError error) onConferenceStarted
| 参数 | 类型 | 描述 | 
| conferenceId | String | 会议 ID | 
| error | 错误码 | 
onConferenceJoined
加入会议事件。
Function(String conferenceId, ConferenceError error) onConferenceJoined
| 参数 | 类型 | 描述 | 
| conferenceId | String | 会议 ID | 
| error | 错误码 | 
onConferenceFinished
会议结束事件,当主动结束会议或会议被解散时会触发该回调。
Function(String conferenceId) onConferenceFinished
| 参数 | 类型 | 描述 | 
| conferenceId | String | 会议 ID | 
onConferenceExited
退出会议事件,当主动退出会议或被踢出会议时会触发该回调。
Function(String conferenceId) onConferenceFinished
| 参数 | 类型 | 描述 | 
| conferenceId | String | 会议 ID | 
ConferenceError
错误码
| 枚举 | 取值 | 描述 | 
| success | 0 | 操作成功 | 
| errFailed | -1 | 暂未归类的通用错误 | 
| errConferenceIdNotExist | -2100 | 进房时房间不存在,或许已被解散 | 
| errConferenceIdInvalid | -2105 | 创建房间 ID 非法,自定义 ID 必须为可打印 ASCII 字符(0x20-0x7e),最长48个字节 | 
| errConferenceIdOccupied | -2106 | 房间 ID 已被使用,请选择别的房间 ID | 
| errConferenceNameInvalid | -2107 | 房间名称非法,名称最长30字节,如果包含中文,字符编码必须是 UTF-8。 |