tencent cloud

Tencent Real-Time Communication

Release Notes and Announcements
Release Notes
Recent Product Announcement
TRTC Live (TUILiveKit) Product Launch Announcement
TRTC Conference Official Editions Launched
The commercial version of Conference is coming soon
Terms and Conditions Applicable to $9.9 Starter Package
Rules for the "First Subscription $100 Discount" Promotion
Announcement on the Start of Beta Testing for Multi-person Audio and Video Conference
TRTC Call Official Editions Launched
License Required for Video Playback in New Version of LiteAV SDK
TRTC to Offer Monthly Packages
Product Introduction
Overview
Concepts
Features
Strengths
Use Cases
Performance Statistics
Tencent RTC Quickplay: Experience Ultimate Real-Time Audio and Video Interaction!
Purchase Guide
Billing Overview
Free Minutes
Monthly subscription
Pay-as-you-go
TRTC Overdue and Suspension Policy
FAQs
Refund Instructions
User Tutorial
Free Demo
Call
Overview
Activate the Service
Run Demo
Integration
Offline Call Push
Conversational Chat
On-Cloud Recording
AI Noise Reduction
UI Customization
Calls integration to Chat
Additional Features
No UI Integration
Server APIs
Client APIs
Solution
ErrorCode
Release Notes
FAQs
Conference
Overview(TUIRoomKit)
Activate the Service (TUIRoomKit)
Run Demo(TUIRoomKit)
Integration(TUIRoomKit)
Screen Sharing (TUIRoomKit)
Schedule a meeting (TUIRoomKit)
In-meeting Call (TUIRoomKit)
UI Customization(TUIRoomKit)
Virtual Background (TUIRoomKit)
Conference Control (TUIRoomKit)
Cloud Recording (TUIRoomKit)
AI Noise Reduction (TUIRoomKit)
In-Conference Chat (TUIRoomKit)
Robot Streaming (TUIRoomKit)
Enhanced Features (TUIRoomKit)
Client APIs (TUIRoomKit)
Server APIs (TUIRoomKit)
FAQs (TUIRoomKit)
Error Code (TUIRoomKit)
SDK Update Log (TUIRoomKit)
Live
Billing of Video Live Component
Overview
Activating the Service (TUILiveKit)
Run 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 Download
API Examples
Usage Guidelines
API Reference Manual
Advanced Features
AI Integration
Overview
Configure MCP Server
Install Skills
Integration Guide
FAQ
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
Console Guide
Application Management
Package Management
Usage Statistics
Monitoring Dashboard
Development Assistance
Solution
Real-Time Chorus
FAQs
Migration Guide
Billing
Features
UserSig
Firewall Restrictions
How to Downsize Installation Package
Android and iOS
Web
Flutter
Electron
TRTCCalling for Web
Audio and Video Quality
Others
Legacy Documentation
RTC RoomEngine SDK(Old)
Integrating TUIRoom (Web)
Integrating TUIRoom (Android)
Integrating TUIRoom (iOS)
Integrating TUIRoom (Flutter)
Integrating TUIRoom (Electron)
TUIRoom APIs
On-Cloud Recording and Playback (Old)
RTC Analytics Monthly Packages (Previous Version)
Protocols and Policies
Compliance
Security White Paper
Notes on Information Security
Service Level Agreement
Apple Privacy Policy: PrivacyInfo.xcprivacy
TRTC Policy
Privacy Policy
Data Processing And Security Agreement
Glossary

Error Code

PDF
Focus Mode
Font Size
Last updated: 2025-06-23 14:25:01

TUIError

TUIError

Error Code Enum Definition

Error Example
Value
Description
SUCCESS
0
Operation succeeded.
FAILED
-1
General error not yet categorized.
FREQ_LIMIT
-2
Request frequency limited. Please retry later.
REPEAT_OPERATION
-3
Repeat the operation.
SDKAPPID_NOT_FOUND
-1000
SDKAppID not found. Please confirm the application information in Tencent Cloud Vision Cube SDK Console.
INVALID_PARAMETER
-1001
When calling API, the passed parameters are invalid. Check whether the input parameters are valid.
SDK_NOT_INITIALIZED
-1002
Not logged in. Please call the Login Interface.
PERMISSION_DENIED
-1003
Failed to obtain permissions. Currently, audio/video permissions are not authorized. Check whether device permissions are enabled. In Room scenario, please use the following error codes to handle:
The camera has no system authorization: ERR_CAMERA_NOT_AUTHORIZED.
The microphone has no system authorization: ERR_MICROPHONE_NOT_AUTHORIZED.
REQUIRE_PAYMENT
-1004
This feature requires the activation of an additional package. Please activate the corresponding package on-demand in the Tencent Cloud Vision Cube SDK console.
CAMERA_START_FAIL
-1100
System issue. Failed to open the camera. Check whether the camera equipment is normal.
CAMERA_NOT_AUTHORIZED
-1101
The camera has no system authorization. Check the system authorization.
CAMERA_OCCUPIED
-1102
The camera is occupied. Check whether there are other processes using the camera.
CAMERA_DEVICE_EMPTY
-1103
Currently there is no camera device. Please insert a camera device to solve this problem.
MICROPHONE_START_FAIL
-1104
System issue. Failed to open the mic. Check whether the microphone device is normal.
MICROPHONE_NOT_AUTHORIZED
-1105
The microphone has no system authorization. Check the system authorization.
MICROPHONE_OCCUPIED
-1106
The microphone is occupied.
MICROPHONE_DEVICE_EMPTY
-1107
No microphone device currently.
GET_SCREEN_SHARING_TARGET_FAILED
-1108
Failed to retrieve the screen sharing source (screen and window). Check the screen recording permission.
START_SCREEN_SHARING_FAILED
-1109
Screen sharing failed to start. Check whether someone inside the room is having an ongoing screen sharing.
ROOM_ID_NOT_EXIST
-2100
The room does not exist when entering. It may have been dissolved.
OPERATION_INVALID_BEFORE_ENTER_ROOM
-2101
This feature can only be used after entering the room.
EXIT_NOT_SUPPORTED_FOR_ROOM_OWNER
-2102
Room owners do not support room exiting operations. For Conference room type: You can transfer ownership first, then exit the room. For LivingRoom room type: Room owners can only dismiss the room.
OPERATION_NOT_SUPPORTED_IN_CURRENT_ROOM_TYPE
-2103
This operation is not supported in the current room type.
ROOM_ID_INVALID
-2105
The room ID is invalid. The custom ID must be printable ASCII characters (0x20-0x7e), with a maximum length of 48 bytes.
ROOM_ID_OCCUPIED
-2106
The room ID is already used. Please select another room ID.
ROOM_NAME_INVALID
-2107
The room name is invalid. The name must be up to 30 bytes long. If it contains Chinese, the character encoding must be UTF-8.
ALREADY_IN_OTHER_ROOM
-2108
The current user is already in another room and needs to exit the room before joining a new one.
A single roomEngine instance only supports a user to enter one room. If you want to enter a different room, please first exit the room or use a new roomEngine instance.
NEED_PASSWORD
-2109
The current room requires a password for entry.
WRONG_PASSWORD
-2110
Error in room password.
ROOM_USER_FULL
-2111
Members in the room are full.
ROOM_METADATA_EXCEED_KEY_COUNT_LIMIT
-2112
The number of keys of room metadata exceeds the upper limit.
ROOM_METADATA_EXCEED_VALUE_SIZE_LIMIT
-2113
The byte size of the value of room custom information exceeds the upper limit.
USER_NOT_EXIST
-2200
User does not exist.
USER_NOT_ENTERED
-2201
The user is not in the current room.
NEED_OWNER_PERMISSION
-2300
Owner permission is required to perform this operation.
NEED_ADMIN_PERMISSION
-2301
Owner or admin permission is required to perform this operation.
REQUEST_NO_PERMISSION
-2310
No permission for signaling request, for example, canceling an invitation not initiated by oneself.
REQUEST_ID_INVALID
-2311
The signaling request ID is invalid or has already been processed.
REQUEST_ID_REPEAT
-2312
Signaling request repeated.
REQUEST_ID_CONFLICT
-2313
Signaling request conflict.
MAX_SEAT_COUNT_LIMIT
-2340
The maximum number of seats exceeds the package quota.
ALREADY_IN_SEAT
-2341
The current user is already in the seat.
SEAT_OCCUPIED
-2342
The current seat is already occupied.
SEAT_LOCKED
-2343
The current seat is locked.
SEAT_INDEX_NOT_EXIST
-2344
The microphone position ID does not exist.
USER_NOT_IN_SEAT
-2345
The current user is not on the seat.
ALL_SEAT_OCCUPIED
-2346
The number of people on the mic is full.
SEAT_NOT_SUPPORT_LINK_MIC
-2347
No support for mic connection.
OPEN_MICROPHONE_NEED_SEAT_UNLOCK
-2360
The current seat audio is locked.
OPEN_MICROPHONE_NEED_PERMISSION_FROM_ADMIN
-2361
You need to apply to the room owner or administrator before turning on the microphone.
OPEN_CAMERA_NEED_SEAT_UNLOCK
-2370
The video of the current seat is locked. You need the room owner to unlock the seat before you can turn on the camera.
OPEN_CAMERA_NEED_PERMISSION_FROM_ADMIN
-2371
You need to apply to the room owner or administrator before turning on the camera.
OPEN_SCREEN_SHARE_NEED_SEAT_UNLOCK
-2372
The video of the current seat is locked. The seat needs to be unlocked by the room owner before enabling screen sharing.
OPEN_SCREEN_SHARE_NEED_PERMISSION_FROM_ADMIN
-2373
You need to apply to the room owner or administrator before enabling screen sharing.
SEND_MESSAGE_DISABLED_FOR_ALL
-2380
Room-wide mute is enabled in the current room.
SEND_MESSAGE_DISABLED_FOR_CURRENT
-2381
You have been muted in the current room.
ROOM_ALREADY_CONNECTED
-3001
The current room is connecting.
ROOM_CONNECTED_IN_OTHER
-3002
The current room is connecting with other rooms.
MAX_CONNECTED_COUNT_LIMIT
-3003
The connection in the current room exceeds the maximum number limit.
ROOM_NOT_SUPPORT_PRELOADING
-4001
Preload is not supported in the current room.

Help and Support

Was this page helpful?

Help us improve! Rate your documentation experience in 5 mins.

Feedback