please select
Features & Server APIs
  • On-Cloud Recording
  • Relay to CDN
  • RTMP Streaming with TRTC
  • Event Callbacks
    • Room&Media Callbacks
    • Relay to CDN Callback
    • Cloud Recording Callback
    • Verify Signature Example
  • Sending and Receiving Messages
  • Access Management
    • Overview
    • Manageable Resources and Actions
    • Preset Policies
    • Custom Policies
  • Enabling Advanced Permission Control
  • How to push stream to TRTC room with OBS WHIP
  • Server APIs
    • API Category
    • History
    • Making API Request
      • Request Structure
      • Common Params
      • Signature v3
      • Signature
      • Responses
    • Room Management APIs
      • SetUserBlockedByStrRoomId
      • SetUserBlocked
      • RemoveUser
      • DismissRoom
      • RemoveUserByStrRoomId
      • DismissRoomByStrRoomId
    • Call Quality Monitoring APIs
      • DescribeRoomInfo
      • DescribeUserEvent
      • DescribeCallDetailInfo
      • DescribeUserInfo
      • DescribeScaleInfo
    • Pull Stream Relay Related Interface
      • StartStreamIngest
      • StopStreamIngest
      • DescribeStreamIngest
    • On-cloud Recording APIs
      • CreateCloudRecording
      • DescribeCloudRecording
      • ModifyCloudRecording
      • DeleteCloudRecording
    • Stream Mixing and Relay APIs
      • UpdatePublishCdnStream
      • StartPublishCdnStream
      • StopPublishCdnStream
    • Usage Statistics APIs
      • DescribeTrtcUsage
      • DescribeRecordingUsage
      • DescribeMixTranscodingUsage
      • DescribeRelayUsage
      • DescribeTrtcRoomUsage
    • Data Types
    • Error Codes
    • Appendix
      • Event ID Mapping Table

Event ID Mapping Table

SDK Event Mapping Table

Event IDFirst Parameter ValueSecond Parameter ValueSpecific Event
10010-1The user unplugged wired earphone
10011-1The user plugged wired earphone
10020-1The earphone has disconnected from Bluetooth connection
10021-1The earphone initiated a Bluetooth connection
10030-1The user has disconnected from the network
10031-1The user is using Wi-Fi network
10032-1The user is using 4G network
10033-1The user is using 3G network
10034-1The user is using 2G network
10035-1The user is using wired network
20010-1The application has been switched to run in the foreground
20011-1The application has been switched to run in the background
20021-1The application does not have network access
20022-1The application does not have permission to read local file
20023-1The application does not have permission to write local file
20024-1The application does not have permission to record audio
20025-1The application does not have permission to use camera
30010-1The mic started capturing audio
30011-1Muted
30012-1Mic capturing was disabled
30013-1Unmuted
30020-1Canceled mute playback
30021-1Mute playback mode
300310-1Audio codec: aac
300311-1Audio codec: opus
30040-1Speaker
30041-1Receiver
40010-1Enabled front camera successfully
40011-1Enabled rear camera successfully
40020-1Failed to enable front camera
40021-1Failed to enable rear camera
4003Resolution widthResolution heightVideo resolution has been switched
40040-1Switched software encoding mode (SW)
40041-1Switched to hardware encoding mode (HW)
40050-1Switched software decoding mode (SW)
40051-1Switched to hardware decoding mode (HW)
40060-1The user enabled video upstreaming
40061-1The user disabled video upstreaming
4007Resolution widthResolution heightThe user switched video resolution
4008Video frame rate-1The user switched video frame rate
4009Video bitrate-1The user switched video bitrate
40101-1RPS (reference picture selection) was disabled due to insufficient performance or poor network
4011-1-1Failed to start hardware decoder
4012-1-1Switched to software decoder as there is too much hardware decoder buffer
4013Number of frames failed to be decoded (3s)0(Software) decoding failed
4013Number of frames failed to be decoded (3s)1(Hardware) decoding failed
40140-1The playback client enabled remote image
40141-1The playback client disabled remote image
40150-1The primary video stream was unsubscribed from
40151-1The primary video stream was subscribed to
5001-1-1Started entering room
50020-1Failed to obtain IP address info
50021-1Obtained IP address info successfully
50030-1Failed to enter room
50031-1Entered room successfully
5004-1-1Started sending video data to the cloud
5005-1-1Connection to CVM timed out
5006-1-1The first video packet was received
5007-1-1Started playing the first video frame
50080-1Failed to exit room
50081-1Exited room successfully
5009-1-1Sent first audio frame
600110(Qos: local mode - smoothness preferred) video call
600111(Qos: local mode - smoothness preferred) live streaming
600112(Qos: local mode - smoothness preferred) audio call
600113(Qos: local mode - smoothness preferred) voice chat room
600120(Qos: local mode - definition preferred) video call
600121(Qos: local mode - definition preferred) live streaming
600122(Qos: local mode - definition preferred) audio call
600123(Qos: local mode - definition preferred) voice chat room
60011010(Qos: cloud control mode - smoothness preferred) video call
60011011(Qos: cloud control mode - smoothness preferred) live streaming
60011012(Qos: cloud control mode - smoothness preferred) audio call
60011013(Qos: cloud control mode - smoothness preferred) voice chat room
60011020(Qos: cloud control mode - definition preferred) video call
60011021(Qos: cloud control mode - definition preferred) live streaming
60011022(Qos: cloud control mode - definition preferred) audio call
60011023(Qos: cloud control mode - definition preferred) voice chat room
70000-1Entered room normally
70001-1Entered room again
70010-1Exited room normally
70011-1Timed out
70012-1Kicked out

WebRTC Event Mapping Table

Event IDFirst Parameter ValueSecond Parameter ValueSpecific Event
36864-1-1Signaling channel has disconnected, which is reported by the backend
32768-1-1Enabled video
32769-1-1Enabled audio
32770-1-1Disabled video
32771-1-1Disabled audio
32772-1-1Disabled audio (still send mute packets)
32773-1-1Disabled video (still send black screen packets)
32774-1-1Enabled audio
32775-1-1Enabled video
32776-1-1Subscribed to video
32777-1-1Subscribed to audio
32778-1-1Unsubscribed from video
32779-1-1Unsubscribed from audio
32780-1-1Switched camera
32781-1-1Switched mic
32782-1-1Updated video
32783-1-1Updated audio
32784-1-1Disabled remote video
32785-1-1Disabled remote audio
32786-1-1Enabled remote video
32787-1-1Enabled remote audio
32788-1-1Entered room
32789-1-1Exited room
32790-1-1Signaling channel has disconnected
32791-1-1Connected signaling channel successfully
32792-1-1Media transmission channel has disconnected
32793-1-1Connected media transmission channel successfully

Exceptional Experience ID Mapping Table

Experience IDDescription
1Room entry was slow
2Unable to enable video
3Unable to enable audio
4Video lagged
5Audio lagged

Exceptional Room Dismissal Event ID Mapping Table

Note: events in this table are reported after the room is dismissed; therefore, the events can be queried only after the room is dismissed.

Exceptional Event IDDescription
1001Failed to initialize audio device
1002Failed to initialize video device
1003Failed to request token
1004Failed to request access server
1005Failed to enter room
1006Room entry eventually failed (including failures in any stage, such as SDK verification failure)
1007The user IP changed, and the IP in the signaling stage was different from that in the data stage
1008Empty room entry parameter. Please check whether valid parameters were passed into the enterRoom:appScene: API when it was called
1009Incorrect room entry parameter sdkAppId
1010Incorrect room entry parameter RoomId
1011Incorrect room entry parameter UserID
1012Incorrect room entry parameter UserSig
1013The room entry request timed out. Please check the network
1014Unavailable service. Please check whether the remained validity period in minutes in the package is greater than 0 and whether the Tencent Cloud account is in arrears
1015Failed to enable the camera; for example, the configuration program (driver) of the camera on Windows or macOS was exceptional. In this case, please try to disable and then enable the camera again, restart the device, or update the configuration program
1016The camera permission is not granted. This error usually occurs on mobile devices and may be caused by permission denial by user
1017Incorrect camera parameter settings (unsupported value or other causes)
1018The camera is being used. Please try to enable another camera
1019Failed to enable the mic; for example, the configuration program (driver) of the mic on Windows or macOS was exceptional. In this case, please try to disable and then enable the mic again, restart the device, or update the configuration program
1020The mic permission is not granted. This error usually occurs on mobile devices and may be caused by permission denial by user
1021Failed to set mic parameters
1022The mic is being used. For example, if the mobile device is on a call, the mic will fail to be enabled
1023Failed to enable the speaker; for example, the configuration program (driver) of the speaker on Windows or macOS was exceptional. In this case, please try to disable and then enable the speaker again, restart the device, or update the configuration program
1024Failed to start screen sharing. If this error occurs on a mobile device, it may be caused by permission denial by user; if on Windows or macOS, please check whether parameters of the screen sharing API meet the requirements
1025Screen sharing failed. Please use Android 5.0 or above if the device is on Android or use iOS 11.0 or above if the device is on iOS
1026No permission to upstream substream
1027Another user is upstreaming substream
1028Screen sharing was stopped by the system
1029Failed to encode video frames; for example, when a user switches from an iOS device to another device, the hardware encoder may be released by the system; and after the user switches back, this error may be thrown before the hardware encoder is restarted
1030Unsupported video resolution
1031Failed to encode audio frames; for example, the SDK could not process the custom audio data passed in
1032Unsupported audio sample rate

Real-Time Exceptional Event ID Mapping Table

Note: as it takes time to collect statistics, there may be a delay of less than 5 minutes.

Exceptional Event IDDescription
2001The system CPU utilization was too high
2002The application CPU utilization was too high
2003The upstream network latency was too high
2004The upstream network jitter was too high
2005The packet loss rate of upstream audio was too high
2006The volume level of audio capturing was 0
2007The packet loss rate of upstream big image was too high
2008The packet loss rate of upstream small image was too high
2009The packet loss rate of upstream substream image was too high
2010The FPS capturing of upstream big image was exceptional
2011The FPS capturing of upstream small image was exceptional
2012The FPS capturing of upstream substream image was exceptional
2013The downstream network latency was too high
2014The downstream network jitter was too high
2015The packet loss rate of downstream audio was too high
2016The volume level of audio playback was 0
2017The packet loss rate of downstream big image was too high
2018The packet loss rate of downstream small image was too high
2019The packet loss rate of downstream substream image was too high
2020The FPS rendering of downstream big image was exceptional
2021The FPS rendering of downstream small image was exceptional
2022The FPS rendering of downstream substream image was exceptional
2023The downstream audio lagged
2024The downstream big image lagged
2025The downstream small image lagged
2026The downstream substream image lagged