이 페이지는 현재 영어로만 제공되며 한국어 버전은 곧 제공될 예정입니다. 기다려 주셔서 감사드립니다.

인터페이스 개요

Overview
TUIRoomEngine (rtc_room_engine) is a component designed for scenarios involving corporate meetings, webinars, online education, etc., supporting multi-person audio and video conversations. It offers room management, multi-person TRTC interactions, member management, screen sharing, and other meeting control features, and supports various video qualities including standard definition, high definition, and ultra-high definition. By integrating this component, you can add multi-person audio and video conversation features to your application.
Integration method:
In your project's pubspec.yaml, add the following code to integrate TUIRoomEngine:
dependencies:   
    rtc_room_engine: latest version
Run the following command to install the component:
flutter pub get
TUIRoomEngine API List
TUIRoomEngine API is the Audio/Video call Component's No UI Interface, you can use this set of API to customize packaging according to your business needs.
TUIRoomEngine
TUIRoomEngine Core Methods
API
Description
﻿createInstance﻿
Create TUIRoomEngine Instance
﻿destroyInstance﻿
Destroy TUIRoomEngine Instance
﻿login﻿
Login interface, you need to initialize user information before entering the room and perform a series of operations.
﻿logout﻿
Logout interface, there will be actively leave room operation, destroy resources
﻿setSelfInfo﻿
Set local user name and avatar
﻿setLoginUserInfo﻿
Set login user information
﻿getSelfInfo﻿
Get local user basic information
﻿addObserver﻿
Set event callback
﻿removeObserver﻿
Remove event callback
Room Related Active Interface
API
Description
﻿createRoom﻿
Create room
﻿destroyRoom﻿
Close the room
﻿enterRoom﻿
Entered room
﻿exitRoom﻿
Leave room
﻿connectOtherRoom﻿
Connect to other room
﻿disconnectOtherRoom﻿
Disconnect from other room
﻿fetchRoomInfo﻿
Get room data
﻿updateRoomNameByAdmin﻿
Update room name
﻿updateRoomSpeechModeByAdmin﻿
Set room management mode (only administrator or group owner can call)
Local User View Rendering, Video Management
API
Description
﻿setLocalVideoView﻿
Set the view control for local user video rendering
﻿openLocalCamera﻿
Open local camera
﻿closeLocalCamera﻿
Close local camera
﻿updateVideoQuality﻿
Update local video codec quality settings
﻿updateVideoQualityEx﻿
Set the encoding parameters of video encoder
﻿setVideoResolutionMode﻿
Set the  resolution mode of video encoder
﻿enableGravitySensor﻿
Enable the gravity sensor
﻿startPushLocalVideo﻿
Start pushing local video
﻿stopPushLocalVideo﻿
Stop pushing local video
﻿startScreenSharing﻿
Start screen sharing
﻿stopScreenSharing﻿
Stop screen sharing
Local User Audio Management
API
Description
﻿openLocalMicrophone﻿
Open local microphone
﻿closeLocalMicrophone﻿
Close local microphone
﻿updateAudioQuality﻿
Update local audio codec quality settings
﻿muteLocalAudio﻿
Mute local audio
﻿unMuteLocalAudio﻿
UnMute local audio
Remote User View Rendering, Video Management
API
Description
﻿setRemoteVideoView﻿
Set the view control for remote user video rendering
﻿startPlayRemoteVideo﻿
Start playing remote user video
﻿stopPlayRemoteVideo﻿
Stop playing remote user video
﻿muteRemoteAudioStream﻿
Mute remote user
Room User Information
API
Description
﻿getUserList﻿
Get the member list in the room
﻿getUserInfo﻿
Get member information
Room User Management
API
Description
﻿changeUserRole﻿
Modify user role (only administrator or group owner can call)
﻿kickRemoteUserOutOfRoom﻿
Kick Remote User out of the Room (Only Administrator or Group Owner can call)
﻿addCategoryTagForUsers﻿
Add category tags to users (Only Administrator or Group Owner can call)
﻿removeCategoryTagForUsers﻿
Remove category tags to users (Only Administrator or Group Owner can call)
﻿getUserListByTag﻿
Get user information in the room based on tags
Speech Management in Room
API
Description
﻿disableDeviceForAllUserByAdmin﻿
Control the permission status of whether all users in the current room can open Audio and Video streams capturing devices, such as: Prohibit all from turning on the mic, Prohibit all from turning on the Camera, Prohibit all from turning on Screen Sharing (currently only available in meeting scenes, and only administrators or group owners can invoke).
﻿openRemoteDeviceByAdmin﻿
Request Remote User to Open Media Device (Only Administrator or Group Owner can call)
﻿closeRemoteDeviceByAdmin﻿
Close Remote User's Media Device (Only Administrator or Group Owner can call)
﻿applyToAdminToOpenLocalDevice﻿
Request to Open Local Media Device (Available for Ordinary Users)
Microphone Seat Management in Room
API
Description
﻿setMaxSeatCount﻿
Set Maximum Number of Microphone Seats (Only supported when entering the room and creating the room)
﻿getSeatList﻿
Get Microphone Seat List
﻿lockSeatByAdmin﻿
Lock Microphone Seat (Including Position Lock, Audio State Lock, Video State Lock)
﻿takeSeat﻿
Apply to Go Live (Not Required in Free Speech Mode)
﻿leaveSeat﻿
Apply to leave the live (Not Required in Free Speech Mode)
﻿takeUserOnSeatByAdmin﻿
Host/Administrator invites user to go live
﻿kickUserOffSeatByAdmin﻿
Host/Administrator kicks user off the microphone seat
Signaling Management
API
Description
﻿cancelRequest﻿
Cancel Request
﻿responseRemoteRequest﻿
Reply to Request
Send Message
API
Description
﻿sendTextMessage﻿
Send Text Message
﻿sendCustomMessage﻿
Send Custom Message
﻿disableSendingMessageByAdmin﻿
Disable Remote User's Text Message Sending Ability (Only Administrator or Group Owner can call)
﻿disableSendingMessageForAllUser﻿
Disable All Users' Text Message Sending Ability (Only Administrator or Group Owner can call)
Advanced Feature: Get TRTC Instance
Advanced Features
API
Description
﻿switchCamera﻿
Switch front/rear camera
﻿setBeautyLevel﻿
Set beauty level
﻿setWhitenessLevel﻿
Set whiteness level
Debugging related
API
Description
﻿callExperimentalAPI﻿
Call experimental api
﻿
TUIRoomObserver Callback Event
TUIRoomObserver is the Callback Event class corresponding to TUIRoomEngine. You can monitor the Callback Events you need through this Callback.
TUIRoomObserver
TUIRoomObserver
Error Callback
API
Description
﻿onError﻿
Error Callback Event
Login Status Event Callback
API
Description
﻿onKickedOffLine﻿
User Kicked Offline Event
﻿onUserSigExpired﻿
User Credential Timeout Event
Room Event Callback
API
Description
﻿onRoomNameChanged﻿
Room Name Change Event
﻿onAllUserMicrophoneDisableChanged﻿
All Users' Microphones Disabled in Room Event
﻿onAllUserCameraDisableChanged﻿
All Users' Cameras Disabled in Room Event
﻿onSendMessageForAllUserDisableChanged﻿
All Users' Text Message Sending Disabled in Room Event
﻿onKickedOutOfRoom﻿
Room Dismissed Event
﻿onRoomDismissed﻿
Kicked Out of Room Event
﻿onRoomSpeechModeChanged﻿
Room Microphone Control Mode Change
Room User Event Callback
API
Description
﻿onRemoteUserEnterRoom﻿
Remote User Entering Room Event
﻿onRemoteUserLeaveRoom﻿
Remote User Leaving Room Event
﻿onUserRoleChanged﻿
User Role Change Event
﻿onUserVideoStateChanged﻿
User Video State Change Event
﻿onUserAudioStateChanged﻿
User Audio State Change Event
﻿onUserVoiceVolumeChanged﻿
User Volume Change Event
﻿onSendMessageForUserDisableChanged﻿
User Text Message Sending Ability Change Event
﻿onUserNetworkQualityChanged﻿
User Network Status Change Event
﻿onUserScreenCaptureStopped﻿
Screen Sharing End Event
Room Microphone Seat Event Callback
API
Description
﻿onRoomMaxSeatCountChanged﻿
Room Maximum Microphone Seat Number Change Event (Only effective in conference type rooms)
﻿onSeatListChanged﻿
Microphone Seat List Change Event
﻿onKickedOffSeat﻿
Received User Kicked Off Microphone Event
Request Signaling Event Callback
API
Description
﻿onRequestReceived﻿
Received Request Message Event
﻿onRequestCancelled﻿
Received Request Cancellation Event
Room Message Event Callback
API
Description
﻿onReceiveTextMessage﻿
Received Normal Text Message Event
﻿onReceiveCustomMessage﻿
Received Custom Message Event
﻿
﻿

Overview
- Integration method:
TUIRoomEngine API List
TUIRoomObserver Callback Event

API	Description
createInstance	Create TUIRoomEngine Instance
destroyInstance	Destroy TUIRoomEngine Instance
login	Login interface, you need to initialize user information before entering the room and perform a series of operations.
logout	Logout interface, there will be actively leave room operation, destroy resources
setSelfInfo	Set local user name and avatar
setLoginUserInfo	Set login user information
getSelfInfo	Get local user basic information
addObserver	Set event callback
removeObserver	Remove event callback

API	Description
createRoom	Create room
destroyRoom	Close the room
enterRoom	Entered room
exitRoom	Leave room
connectOtherRoom	Connect to other room
disconnectOtherRoom	Disconnect from other room
fetchRoomInfo	Get room data
updateRoomNameByAdmin	Update room name
updateRoomSpeechModeByAdmin	Set room management mode (only administrator or group owner can call)

API	Description
setLocalVideoView	Set the view control for local user video rendering
openLocalCamera	Open local camera
closeLocalCamera	Close local camera
updateVideoQuality	Update local video codec quality settings
updateVideoQualityEx	Set the encoding parameters of video encoder
setVideoResolutionMode	Set the resolution mode of video encoder
enableGravitySensor	Enable the gravity sensor
startPushLocalVideo	Start pushing local video
stopPushLocalVideo	Stop pushing local video
startScreenSharing	Start screen sharing
stopScreenSharing	Stop screen sharing

API	Description
openLocalMicrophone	Open local microphone
closeLocalMicrophone	Close local microphone
updateAudioQuality	Update local audio codec quality settings
muteLocalAudio	Mute local audio
unMuteLocalAudio	UnMute local audio

API	Description
setRemoteVideoView	Set the view control for remote user video rendering
startPlayRemoteVideo	Start playing remote user video
stopPlayRemoteVideo	Stop playing remote user video
muteRemoteAudioStream	Mute remote user

API	Description
getUserList	Get the member list in the room
getUserInfo	Get member information

API	Description
changeUserRole	Modify user role (only administrator or group owner can call)
kickRemoteUserOutOfRoom	Kick Remote User out of the Room (Only Administrator or Group Owner can call)
addCategoryTagForUsers	Add category tags to users (Only Administrator or Group Owner can call)
removeCategoryTagForUsers	Remove category tags to users (Only Administrator or Group Owner can call)
getUserListByTag	Get user information in the room based on tags

API	Description
disableDeviceForAllUserByAdmin	Control the permission status of whether all users in the current room can open Audio and Video streams capturing devices, such as: Prohibit all from turning on the mic, Prohibit all from turning on the Camera, Prohibit all from turning on Screen Sharing (currently only available in meeting scenes, and only administrators or group owners can invoke).
openRemoteDeviceByAdmin	Request Remote User to Open Media Device (Only Administrator or Group Owner can call)
closeRemoteDeviceByAdmin	Close Remote User's Media Device (Only Administrator or Group Owner can call)
applyToAdminToOpenLocalDevice	Request to Open Local Media Device (Available for Ordinary Users)

API	Description
setMaxSeatCount	Set Maximum Number of Microphone Seats (Only supported when entering the room and creating the room)
getSeatList	Get Microphone Seat List
lockSeatByAdmin	Lock Microphone Seat (Including Position Lock, Audio State Lock, Video State Lock)
takeSeat	Apply to Go Live (Not Required in Free Speech Mode)
leaveSeat	Apply to leave the live (Not Required in Free Speech Mode)
takeUserOnSeatByAdmin	Host/Administrator invites user to go live
kickUserOffSeatByAdmin	Host/Administrator kicks user off the microphone seat

API	Description
cancelRequest	Cancel Request
responseRemoteRequest	Reply to Request

API	Description
sendTextMessage	Send Text Message
sendCustomMessage	Send Custom Message
disableSendingMessageByAdmin	Disable Remote User's Text Message Sending Ability (Only Administrator or Group Owner can call)
disableSendingMessageForAllUser	Disable All Users' Text Message Sending Ability (Only Administrator or Group Owner can call) Advanced Feature: Get TRTC Instance

API	Description
switchCamera	Switch front/rear camera
setBeautyLevel	Set beauty level
setWhitenessLevel	Set whiteness level

API	Description
onKickedOffLine	User Kicked Offline Event
onUserSigExpired	User Credential Timeout Event

API	Description
onRoomNameChanged	Room Name Change Event
onAllUserMicrophoneDisableChanged	All Users' Microphones Disabled in Room Event
onAllUserCameraDisableChanged	All Users' Cameras Disabled in Room Event
onSendMessageForAllUserDisableChanged	All Users' Text Message Sending Disabled in Room Event
onKickedOutOfRoom	Room Dismissed Event
onRoomDismissed	Kicked Out of Room Event
onRoomSpeechModeChanged	Room Microphone Control Mode Change

API	Description
onRemoteUserEnterRoom	Remote User Entering Room Event
onRemoteUserLeaveRoom	Remote User Leaving Room Event
onUserRoleChanged	User Role Change Event
onUserVideoStateChanged	User Video State Change Event
onUserAudioStateChanged	User Audio State Change Event
onUserVoiceVolumeChanged	User Volume Change Event
onSendMessageForUserDisableChanged	User Text Message Sending Ability Change Event
onUserNetworkQualityChanged	User Network Status Change Event
onUserScreenCaptureStopped	Screen Sharing End Event

API	Description
onRoomMaxSeatCountChanged	Room Maximum Microphone Seat Number Change Event (Only effective in conference type rooms)
onSeatListChanged	Microphone Seat List Change Event
onKickedOffSeat	Received User Kicked Off Microphone Event

API	Description
onRequestReceived	Received Request Message Event
onRequestCancelled	Received Request Cancellation Event

API	Description
onReceiveTextMessage	Received Normal Text Message Event
onReceiveCustomMessage	Received Custom Message Event