tencent cloud

Tencent Real-Time Communication

소식 및 공지 사항
제품 업데이트
Tencent Cloud 오디오/비디오 단말 SDK 재생 업그레이드 및 권한 부여 인증 추가
TRTC 월간 구독 패키지 출시 관련 안내
제품 소개
제품 개요
기본 개념
제품 기능
제품 장점
응용 시나리오
성능 데이터
구매 가이드
Billing Overview
무료 시간 안내
Monthly subscription
Pay-as-you-go
TRTC Overdue and Suspension Policy
과금 FAQ
Refund Instructions
신규 사용자 가이드
Demo 체험
Call
개요(TUICallKit)
Activate the Service
Run Demo
빠른 통합(TUICallKit)
오프라인 푸시
Conversational Chat
온클라우드 녹화(TUICallKit)
AI Noise Reduction
UI 사용자 정의
Calls integration to Chat
Additional Features
No UI Integration
Server APIs
Client APIs
Solution
ErrorCode
릴리스 노트
FAQs
라이브 스트리밍
Billing of Video Live Component
Overview
Activating the Service (TUILiveKit)
Demo 실행
No UI Integration
UI Customization
Live Broadcast Monitoring
Video Live Streaming
Voice Chat Room
Advanced Features
Client APIs
Server APIs
Error Codes
Release Notes
FAQs
RTC Engine
Activate Service
SDK 다운로드
API 코드 예시
Usage Guidelines
API 클라이언트 API
고급 기능
RTC RESTFUL API
History
Introduction
API Category
Room Management APIs
Stream mixing and relay APIs
On-cloud recording APIs
Data Monitoring APIs
Pull stream Relay Related interface
Web Record APIs
AI Service APIs
Cloud Slicing APIs
Cloud Moderation APIs
Making API Requests
Call Quality Monitoring APIs
Usage Statistics APIs
Data Types
Appendix
Error Codes
콘솔 가이드
애플리케이션 관리
사용량 통계
모니터링 대시보드
개발 보조
Solution
Real-Time Chorus
FAQs
과금 개요
기능 관련
UserSig 관련
방화벽 제한 처리
설치 패키지 용량 축소 관련 질문
Andriod 및 iOS 관련
Web 관련
Flutter 관련
Electron 관련
TRTCCalling Web 관련
멀티미디어 품질 관련
기타 질문
Protocols and Policies
컴플라이언스 인증
보안 백서
정보 보안에 관한 참고 사항
Service Level Agreement
Apple Privacy Policy: PrivacyInfo.xcprivacy
TRTC 정책
개인 정보 보호 정책
데이터 처리 및 보안 계약
용어집
문서Tencent Real-Time Communication

TUIRoomEngineObserver

포커스 모드
폰트 크기
마지막 업데이트 시간: 2024-12-18 14:57:43

TUIRoomEngine event callback

onError

Triggered when an error event occurs, indicating that the SDK encounters an irrecoverable error, such as a failure of entering a room or a device startup failure.
Note:
This function applies to conference room type and live room type (conference & livingRoom).
OnError onError = (TUIError errorCode, String message) {}
Parameters
Type
Description
errorCode
TUIError
Error Codes onLiveRoomInfoChanged
message
String
Error Message

onKickedOffLine

Triggered when the user is kicked offline.
Note:
This function applies to conference room type and live room type (conference & livingRoom).
OnKickedOffLine onKickedOffLine = (String message) {}
Parameters
Type
Description
message
String
Description of removed from service

onUserSigExpired

userSig expiration event, triggered when the user's credential expires.
Note:
This function applies to conference room type and live room type (conference & livingRoom).
OnUserSigExpired onUserSigExpired = () {}

onRoomNameChanged

Triggered when the room name changes.
Note:
This function applies to conference room type and live room type (conference & livingRoom).
OnRoomNameChanged onRoomNameChanged = (String roomId, String roomName) {}
Parameters
Type
Description
roomId
String
Room ID
roomName
String
Room Name


onAllUserMicrophoneDisableChanged


Triggered when the microphone disable status of all users changes.
Note:
This function is only applicable to conference room type (conference).
OnAllUserMicrophoneDisableChanged onAllUserMicrophoneDisableChanged = (String roomId, bool isDisable) {}
Parameters
Type
Description
roomId
String
Room ID
isDisable
bool
Whether disabled or not


onAllUserCameraDisableChanged


Triggered when the camera disable status of all users changes.
Note:
This function is only applicable to conference room type (conference).
OnAllUserCameraDisableChanged onAllUserCameraDisableChanged = (String roomId, bool isDisable) {}
Parameters
Type
Description
roomId
String
Room ID
isDisable
bool
Whether disabled or not


onSendMessageForAllUserDisableChanged


Triggered when the message sending permission of all users changes.
Note:
This function is only applicable to conference room type (conference).
OnSendMessageForAllUserDisableChanged onSendMessageForAllUserDisableChanged = (String roomId, bool isDisable) {}
Parameters
Type
Description
roomId
String
Room ID
isDisable
bool
Whether disabled or not

onScreenShareForAllUserDisableChanged

Triggered when the screen sharing permissions of all users change.
Note:
This function is only applicable to conference room type (conference).
OnScreenShareForAllUserDisableChanged onScreenShareForAllUserDisableChanged =(String roomId, bool isDisable) {}
Parameters
Type
Description
roomId
String
Room ID
isDisable
bool
Whether disabled or not

onRoomDismissed

Triggered when the room is dissolved.
Note:
This function applies to conference room type and live room type (conference & livingRoom).
OnRoomDismissed onRoomDismissed = (String roomId, TUIRoomDismissedReason reason) {}
Parameters
Type
Description
roomId
String
Room ID
reason
TUIRoomDismissedReason
Dissolution reason

onKickedOutOfRoom

Triggered when the user is kicked out of the room by the host/administrator.
Note:
This function applies to conference room type and live room type (conference & livingRoom).
OnKickedOutOfRoom onKickedOutOfRoom = (String roomId, String message) {}
Parameters
Type
Description
roomId
String
Room ID
message
String
Description of removed from room

onRoomSeatModeChanged

Triggered when the microphone mode of the room changes.
Note:
This function applies to conference room type and live room type (conference & livingRoom).
OnRoomSeatModeChanged onRoomSeatModeChanged =(String roomId, TUISeatMode seatMode) {}
Parameters
Type
Description
roomId
String
Room ID
seatMode
Microphone Mode

onRoomUserCountChanged

Triggered when the number of people in the room changes.
Note:
This function applies to conference room type and live room type (conference & livingRoom).
OnRoomUserCountChanged onRoomUserCountChanged =(String roomId, int userCount) {};
Parameters
Type
Description
roomId
String
Room ID
userCount
int
Room Occupancy

onRemoteUserEnterRoom

Triggered when a remote user enters the room.
Note:
This function applies to conference room type and live room type (conference & livingRoom).
OnRemoteUserEnterRoom onRemoteUserEnterRoom = (String roomId, TUIUserInfo userInfo) {}
Parameters
Type
Description
roomId
String
Room ID
userInfo
User Information

onRemoteUserLeaveRoom

Triggered when a remote user leaves the room.
Note:
This function applies to conference room type and live room type (conference & livingRoom).
OnRemoteUserLeaveRoom onRemoteUserLeaveRoom = (String roomId, TUIUserInfo userInfo) {}
Parameters
Type
Description
roomId
String
Room ID
userInfo
User Information

onUserInfoChanged

Triggered when user information in the room changes.
Note:
This function applies to conference room type and live room type (conference & livingRoom).
OnUserInfoChanged onUserInfoChanged = (TUIUserInfo userInfo, List<TUIUserInfoModifyFlag> modifyFlagList) {};
Parameters
Type
Description
userInfo
TUIUserInfo
User Information
modifyFlagList
List<TUIUserInfoModifyFlag>
TUIUserInfo change flag list

onUserVideoStateChanged

Triggered when the user's video status changes.
Note:
This function applies to conference room type and live room type (conference & livingRoom).
OnUserVideoStateChanged onUserVideoStateChanged = (String userId, TUIVideoStreamType streamType, bool hasVideo, TUIChangeReason reason) {}
Parameters
Type
Description
userId
String
User ID
streamType
Video stream type
hasVideo
bool
Has video stream
reason
Reason for video stream change

onUserAudioStateChanged

Triggered when the user's audio status changes.
Note:
This function applies to conference room type and live room type (conference & livingRoom).
OnUserAudioStateChanged onUserAudioStateChanged = (String userId, bool hasAudio, TUIChangeReason reason) {}
Parameters
Type
Description
userId
String
User ID
hasAudio
bool
Is there an audio stream
reason
Reason for video stream change

onUserVoiceVolumeChanged

Triggered when the user's volume changes.
Note:
This function applies to conference room type and live room type (conference & livingRoom).
OnUserVoiceVolumeChanged onUserVoiceVolumeChanged = (Map<String, int> volumeMap) {}
Parameters
Type
Description
volumeMap
Map
User volume map
key: userId
value: Used to carry the volume levels of all speaking users. Range: 0 - 100

onSendMessageForUserDisableChanged

Triggered when the user's message sending permissions change.
Note:
This function applies to conference room type and live room type (conference & livingRoom).
OnSendMessageForUserDisableChanged onSendMessageForUserDisableChanged = (String roomId, String userId, bool isDisable) {}
Parameters
Type
Description
roomId
String
Room ID
userId
String
User ID
isDisable
bool
Whether sending text messages is forbidden

onUserNetworkQualityChanged

Triggered when the user's network quality changes.
Note:
This function applies to conference room type and live room type (conference & livingRoom).
OnUserNetworkQualityChanged onUserNetworkQualityChanged = (Map<String, TUINetwork> networkMap) {}
Parameters
Type
Description
networkMap
Map
User network status map
key:userId
value: Network condition

onUserScreenCaptureStopped

Triggered when the user's screen sharing stops.
Note:
This function applies to conference room type and live room type (conference & livingRoom).
OnUserScreenCaptureStopped onUserScreenCaptureStopped = (int reason) {}
Parameters
Type
Description
reason
int
Stop reason
0: User stopped voluntarily
1: Stop due to screen window being closed
2: Indicates screen sharing display state change (e.g., interface unplugged, projection mode change, etc.)

onRoomMaxSeatCountChanged

Maximum number of microphones in room changed event (only in meeting type rooms).
OnRoomMaxSeatCountChanged onRoomMaxSeatCountChanged = (String roomId, int maxSeatCount) {}
Parameters
Type
Description
roomId
String
Room ID
maxSeatCount
int
Maximum number of microphone positions in the room

onSeatListChanged

Triggered when the microphone list changes.
Note:
This function applies to conference room type and live room type (conference & livingRoom).
OnSeatListChanged onSeatListChanged = (List<TUISeatInfo> seatList, List<TUISeatInfo> seatedList, List<TUISeatInfo> leftList) {}
Parameters
Type
Description
seatList
The latest list of users currently on the microphone, including newly joined users
seatedList
List of newly joined users on the microphone
leftList
List of users who left the microphone


onKickedOffSeat


Triggered when the user is kicked off the microphone.
Note:
This function applies to conference room type and live room type (conference & livingRoom).
OnKickedOffSeat onKickedOffSeat = (int seatIndex, TUIUserInfo operateUser) {}
Parameters
Type
Description
seatIndex
int
Microphone slot number
operateUser
TUIUserInfo
Operator's information

onRequestReceived

Triggered when a request from another user is received.
Note:
This function applies to conference room type and live room type (conference & livingRoom).
OnRequestReceived onRequestReceived = (TUIRequest request) {}
Parameters
Type
Description
request
Request content

onRequestCancelled

Triggered when another user cancels the request.
Note:
This function applies to conference room type and live room type (conference & livingRoom).
OnRequestCancelled onRequestCancelled = (TUIRequest request, TUIUserInfo operateUser) {}
Parameters
Type
Description
request
TUIRequest
Request Information
operateUser
TUIUserInfo
User information of the canceled signal

onRequestProcessed

Triggered when the request is handled by another admin/host.
Note:
This function applies to conference room type and live room type (conference & livingRoom).
OnRequestProcessed onRequestProcessed = (TUIRequest request, TUIUserInfo operateUser) {};
Parameters
Type
Description
request
TUIRequest
Request Information
operateUser
TUIUserInfo
User information of the canceled signal

도움말 및 지원

문제 해결에 도움이 되었나요?

피드백