RoomKit API
Introduction
The TUIRoomKit API is a multi-person meeting component with an Including UI Interface. By using the TUIRoomKit API, you can quickly implement a meeting-like scenario through a simple interface. For more detailed integration steps, see: Integration.
This document will provide a detailed introduction to the classes and related interfaces you may use in Flutter TUIRoomKit. By referring to this document, you can gain a more comprehensive understanding of how to use Flutter TUIRoomKit.
ConferenceMainPage
Conference Main Page
Parameter | Type | Description |
conferenceId | String | Conference ID required for creating or joining a conference |
isCreateConference | bool | Whether it is for creating a conference (true for creating, false for joining) |
conferenceParams | Parameters related to creating or joining a conference | |
conferenceObserver | Conference status change callback listener |
Note:
When you use ConferenceSession to create or join a conference, you do not need to pass any of the parameters here.
ConferenceSession
When you expect to navigate to the conference page after successfully creating/joining a conference, you can use the
ConferenceSession
class to perform related operations.Parameter | Type | Description |
isMuteMicrophone | bool | Whether to mute the microphone (default is false) |
isOpenCamera | bool | Whether to turn on the camera (default is false) |
isSoundOnSpeaker | bool | Whether to use speakers (default is true) |
name | String | Conference name (default is your conference ID, it is invalid when joining the conference) |
enableMicrophoneForAllUser | bool | Whether to enable microphone permission for all members (default is true, invalid when joining a conference) |
enableCameraForAllUser | bool | Whether to enable camera permissions for all members (default is true, invalid when joining a conference) |
enableMessageForAllUser | bool | Whether to enable the speaking permission of all members (default is true, invalid when joining a conference) |
enableSeatControl | bool | Whether to enable speaking mode on stage (default is false, invalid when joining a conference) |
onActionSuccess | VoidCallback | Callback for successful creation/joining of a conference. You can navigate to the meeting page in this callback. |
onActionError | Callback for failed creation/joining of a conference. |
newInstance
Create a new ConferenceSession object.
factory ConferenceSession.newInstance(String id)
Parameter | Type | Description |
id | String | Conference ID required for creating or joining a conference |
quickStart
Quickly create conference interfaces.
Future<void> quickStart()
join
Join the conference interface.
Future<void> join()
Note:
Before calling the quick conference creation or joining conference interface, you need to complete all the parameters of the ConferenceSession that you need to set. For details, please refer to Pre-conference Control.
When navigating directly to ConferenceMainPage and passing in relevant parameters to create/join a conference, there is no need to use
ConferenceSession
.ConferenceParams
Parameter | Type | Description |
isMuteMicrophone | bool | Whether to mute the microphone (default is false) |
isOpenCamera | bool | Whether to turn on the camera (default is false) |
isSoundOnSpeaker | bool | Whether to use speakers (default is true) |
name | String | Conference name (default is your conference ID, it is invalid when joining the conference) |
enableMicrophoneForAllUser | bool | Whether to enable microphone permission for all members (default is true, invalid when joining a conference) |
enableCameraForAllUser | bool | Whether to enable camera permissions for all members (default is true, invalid when joining a conference) |
enableMessageForAllUser | bool | Whether to enable the speaking permission of all members (default is true, invalid when joining a conference) |
enableSeatControl | bool | Whether to enable speaking mode on stage (default is false, invalid when joining a conference) |
onActionSuccess | VoidCallback | Callback for successful creation/joining of a conference. You can navigate to the meeting page in this callback. |
onActionError | Callback for failed creation/joining of a conference. |
ConferenceObserver
onConferenceStarted
Conference start event.
Function(String conferenceId, ConferenceError error) onConferenceStarted
Parameter | Type | Description |
conferenceId | String | Conference id |
error | Error code |
onConferenceJoined
Join the conference event.
Function(String conferenceId, ConferenceError error) onConferenceJoined
Parameter | Type | Description |
conferenceId | String | Conference Id |
error | Error code |
onConferenceFinished
Meeting end event, this callback will be triggered when the meeting is actively ended or the meeting is dismissed.
Function(String conferenceId) onConferenceFinished
Parameter | Type | Description |
conferenceId | String | Conference Id |
onConferenceExited
Exit meeting event, this callback will be triggered when actively exiting the meeting or being kicked out of the meeting.
Function(String conferenceId) onConferenceFinished
Parameter | Type | Description |
conferenceId | String | Conference Id |
ConferenceError
Error code
Enumeration | Value | Description |
success | 0 | Operation Successful |
errFailed | -1 | Temporarily Unclassified General Error |
errConferenceIdNotExist | -2100 | Room Does Not Exist When Entering, May Have Been Closed |
errConferenceIdInvalid | -2105 | Illegal Custom Room ID, Must Be Printable ASCII Characters (0x20-0x7e), Up to 48 Bytes Long |
errConferenceIdOccupied | -2106 | Room ID is Already in Use, Please Choose Another Room ID |
errConferenceNameInvalid | -2107 | Illegal Room Name, Maximum 30 Bytes, Must Be UTF-8 Encoding if Contains Chinese Characters |