简介
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。 |