Docs Overview/
Conference/
Flutter/
客户端 API/
RoomEngine 接口/
TUIRoomObserver/

TUIRoomObserver

TUIRoomEngine 事件回调

onError

错误事件。
OnError onError = (TUIError errorCode, String message) {}
参数
类型
描述
errorCode
TUIError
错误码
message
String
错误信息

onKickedOffLine

用户被移下线事件。
OnKickedOffLine onKickedOffLine = (String message) {}
参数
类型
描述
message
String
被移下线的描述

onUserSigExpired

userSig 过期事件。
OnUserSigExpired onUserSigExpired = () {}

onRoomNameChanged

房间名称更改事件。
OnRoomNameChanged onRoomNameChanged = (String roomId, String roomName) {}
参数
类型
描述
roomId
String
房间 ID
roomName
String
房间名称


onAllUserMicrophoneDisableChanged


房间内所有用户麦克风被禁用事件。
OnAllUserMicrophoneDisableChanged onAllUserMicrophoneDisableChanged = (String roomId, bool isDisable) {}
参数
类型
描述
roomId
String
房间 ID
isDisable
bool
是否被禁用


onAllUserCameraDisableChanged


房间内所有用户摄像头被禁用事件。
OnAllUserCameraDisableChanged onAllUserCameraDisableChanged = (String roomId, bool isDisable) {}
参数
类型
描述
roomId
String
房间 ID
isDisable
bool
是否被禁用


onSendMessageForAllUserDisableChanged


房间内所有用户发送文本消息被禁用事件。
OnSendMessageForAllUserDisableChanged onSendMessageForAllUserDisableChanged = (String roomId, bool isDisable) {}
参数
类型
描述
roomId
String
房间 ID
isDisable
bool
是否被禁用

onRoomDismissed

房间被解散事件。
OnRoomDismissed onRoomDismissed = (String roomId) {}
参数
类型
描述
roomId
String
房间 ID

onKickedOutOfRoom

移出房间事件。
OnKickedOutOfRoom onKickedOutOfRoom = (String roomId, String message) {}
参数
类型
描述
roomId
String
房间 ID
message
String
被移出的描述


onRoomSpeechModeChanged


房间麦控模式发生变化。
OnRoomSpeechModeChanged onRoomSpeechModeChanged = (String roomId, TUISpeechMode speechMode) {}
参数
类型
描述
roomId
String
房间 ID
speechMode
房间麦控模式

onRemoteUserEnterRoom

远端用户进入房间事件。
OnRemoteUserEnterRoom onRemoteUserEnterRoom = (String roomId, TUIUserInfo userInfo) {}
参数
类型
描述
roomId
String
房间 ID
userInfo
用户信息

onRemoteUserLeaveRoom

远端用户离开房间事件。
OnRemoteUserLeaveRoom onRemoteUserLeaveRoom = (String roomId, TUIUserInfo userInfo) {}
参数
类型
描述
roomId
String
房间 ID
userInfo
用户信息

onUserRoleChanged

用户角色改变事件。
OnUserRoleChanged onUserRoleChanged = (String userId, TUIRole role) {}
参数
类型
描述
userId
String
用户 ID
role
TUIRole
用户角色

onUserVideoStateChanged

用户视频状态改变事件。
OnUserVideoStateChanged onUserVideoStateChanged = (String userId, TUIVideoStreamType streamType, bool hasVideo, TUIChangeReason reason) {}
参数
类型
描述
userId
String
用户 ID
streamType
视频流类型
hasVideo
bool
是否有视频流
reason
视频流发生变化原因

onUserAudioStateChanged

用户音频状态改变事件。
OnUserAudioStateChanged onUserAudioStateChanged = (String userId, bool hasAudio, TUIChangeReason reason) {}
参数
类型
描述
userId
String
用户 ID
hasAudio
bool
是否有音频流
reason
视频流发生变化原因

onUserVoiceVolumeChanged

用户音量改变事件。
OnUserVoiceVolumeChanged onUserVoiceVolumeChanged = (Map<String, int> volumeMap) {}
参数
类型
描述
volumeMap
Map
用户音量 Map
key：userId
value：用于承载所有正在说话的用户的音量大小。取值范围 0 - 100

onSendMessageForUserDisableChanged

用户文本消息发送能力发生变化事件。
OnSendMessageForUserDisableChanged onSendMessageForUserDisableChanged = (String roomId, String userId, bool isDisable) {}
参数
类型
描述
roomId
String
房间 ID
userId
String
用户 ID
isDisable
bool
是否被禁止发送文本消息

onUserNetworkQualityChanged

用户网络质量改变事件。
OnUserNetworkQualityChanged onUserNetworkQualityChanged = (Map<String, TUINetwork> networkMap) {}
参数
类型
描述
networkMap
Map
用户网络状态 Map
key：userId
value：网络状况

onUserScreenCaptureStopped

屏幕分享结束事件。
OnUserScreenCaptureStopped onUserScreenCaptureStopped = (int reason) {}
参数
类型
描述
reason
int
停止原因
0：用户主动停止
1：屏幕窗口关闭导致停止
2：表示屏幕分享的显示屏状态变更（如接口被拔出、投影模式变更等）

onRoomMaxSeatCountChanged

房间内最大麦位数发生变化事件（仅在会议类型房间生效）。
OnRoomMaxSeatCountChanged onRoomMaxSeatCountChanged = (String roomId, int maxSeatCount) {}
参数
类型
描述
roomId
String
房间 ID
maxSeatCount
int
房间内最大麦位数量

onSeatListChanged

麦位列表改变事件。
OnSeatListChanged onSeatListChanged = (List<TUISeatInfo> seatList, List<TUISeatInfo> seatedList, List<TUISeatInfo> leftList) {}
参数
类型
描述
seatList
目前麦上最新的用户列表，包含新上麦的用户
seatedList
新上麦的用户列表
leftList
新下麦的用户列表


onKickedOffSeat


收到用户被移下麦事件。
OnKickedOffSeat onKickedOffSeat = (String userId) {}
参数
类型
描述
userId
String
操作移人的（主持人/管理员）用户 ID

onRequestReceived

请求接收事件。
OnRequestReceived onRequestReceived = (TUIRequest request) {}
参数
类型
描述
request
请求内容

onRequestCancelled

请求取消事件。
OnRequestCancelled onRequestCancelled = (String requestId, String userId) {}
参数
类型
描述
requestId
String
请求 ID
userId
String
取消信令的用户 ID

onReceiveTextMessage

接收文本消息事件。
OnReceiveTextMessage onReceiveTextMessage = (String roomId, TUIMessage message) {}
参数
类型
描述
roomId
String
房间 ID
message
消息内容

onReceiveCustomMessage

接收自定义消息事件。
OnReceiveCustomMessage onReceiveCustomMessage = (String roomId, TUIMessage message) {}
参数
类型
描述
roomId
String
房间 ID
message
消息内容