Overview
TRTCCloud
Basic Method
| API | Description | 
| Create a `TRTCCloud` singleton. | |
| Destroy the `TRTCCloud` singleton. | |
| Set event listening | |
| Remove event listening | 
Room APIs
| API | Description | 
| Enters a room. If the room does not exist, the system will create one automatically. | |
| Leave the room. | |
| Switch roles, applicable only to live streaming scenarios (TRTC_APP_SCENE_LIVE and TRTC_APP_SCENE_VOICE_CHATROOM). | |
| Switches rooms. | |
| Request cross-room call (host PK). | |
| Exit cross-room call. | |
| Set the audio and video data reception mode, which must be configured before entering the room to take effect. | 
CDN Interface Functions
| API | Description | 
| Start publishing media stream. | |
| Update published media stream. | |
| Stop publishing media stream. | 
Video Interface Functions
| API | Description | 
| Enable the preview of local video. | |
| Update local video preview screen. | |
| Stop local video capture and preview. | |
| Pauses/resumes publishing local video data. | |
| Starts playing the video of a remote user. | |
| Update the video rendering view of the remote user. | |
| Stops playing and pulling the video of a remote user. | |
| Stops playing and pulling the videos of all remote users. | |
| Pauses/Resumes receiving the video of a specified remote user. | |
| Pauses/Resumes receiving the videos of all remote users. | |
| Sets video encoder parameters. | |
| Sets the parameters for network flow control. | |
| Sets the rendering mode of the local image. | |
| Sets the parameters related to remote images. | |
| Enables dual-stream encoding mode for large and small screens. | |
| Selects the big or small screen for a specified UID. | |
| Takes a video screenshot. | |
| Sets the adaptive mode for gravity sensing. | 
Audio related interface functions
| API | Description | 
| Enables local audio capturing and publishing. | |
| Disables local audio capturing and publishing. | |
| Mute/unmute local audio. | |
| Mute/unmute the sound of a specified remote user. | |
| Mute/Unmute all user's voices. | |
| Set the volume of a specific remote user's audio playback. | |
| Sets the SDK capturing volume. | |
| Obtains the SDK capture volume. | |
| Sets the SDK playback volume. | |
| Gets the SDK playback volume. | |
| Enables volume level prompt. | |
| Start local media recording, which includes both audio and video data. | |
| Stop local media recording. | 
Device management interface
| API | Description | 
| Obtain device management module. For interface details, see Device Management Interface Documentation | 
Music and Vocal Special Effects
| API | Description | 
| Obtain TXAudioEffectManager for managing BGM, short sound effects, and vocal special effects. For interface details, see Sound Effect Management Documentation | |
| Enable system audio capture. | |
| Stop system audio capture. | |
| Set system audio capturing volume. | 
Auxiliary stream related interface functions
| API | Description | 
| Start screen sharing | |
| Stop screen capturing | |
| Pause screen sharing | |
| Resumes screen sharing | |
| Enumerate shareable screens and windows (this API is only supported on Windows) | |
| Select the screen or window to be shared (this API is only supported on Windows) | |
| Set the screen sharing (i.e., substream) video encoding parameters (supported on both desktop and mobile systems) | 
Custom capturing and custom rendering
| API | Description | 
| Enable/Disable Custom Video Capture Mode. | |
| Submit your captured video frames to the SDK. | |
| Enable/Disable Custom Audio Capture Mode. | |
| Submit your captured audio data to the SDK. | |
| Enable/Disable Custom Audio Track. | 
Custom message sending APIs
| API | Description | 
| Sends a custom message to all users in a room. | |
| Embeds small-volume custom data into video frames. | 
Network Testing
| API | Description | 
| Starts network speed testing. This may compromise the quality of video calls and should be avoided during a video call. | |
| Stops server speed measurement. | 
Log Interface Functions
| API | Description | 
| Gets the SDK version. | |
| Sets the log output level. | |
| Enables/Disables console log printing. | |
| Enables/Disables local log compression. | |
| Modifies the log save path. | |
| Sets the log callback. | |
| Display Debug Information Floating Layer (can show audio and video information and event information). | |
| Calls the experimental API. | 
TRTCCloudListener
Event callback interface for Tencent Cloud video call feature.
Error and warning event callback APIs
Room event callback APIs
| API | Description | 
| Callback for having joined the room. | |
| Event callback for leaving the room. | |
| Event callback for switching roles. | |
| Result callback for switching rooms (switchRoom). | |
| Result callback for requesting cross-room call (Host PK). | |
| Result callback for ending cross-room call (Host PK). | 
Member Event Callback
| API | Description | 
| A user has joined the current room. | |
| A user has left the current room. | |
| Whether the remote user has a main route view that can be played (generally used for cameras). | |
| Whether the remote user has an auxiliary route view that can be played (generally used for screen sharing). | |
| Whether the remote user has playable audio data. | |
| Start rendering the first frame image of a local or remote user. | |
| Start playing the first frame audio of a remote user (local sound is not notified for the time being). | |
| The first frame of local video data has been sent out. | |
| The first frame of local audio data has been sent out. | |
| Callback for changes in remote video status. | |
| Callback for changes in remote audio status. | |
| Callback for changes in user's video size. | 
Callback for local recording and local screenshot events
| API | Description | 
| When the local recording task has started, the SDK will notify through this callback. | |
| While the local recording task is in progress, the SDK will periodically notify users through this callback. | |
| When you enable segmented recording, the SDK will notify you through this callback each time a segment is completed. | |
| When the local recording task has ended, the SDK will notify you through this callback. | |
| Callback for local screenshot completion. | 
Statistics and quality callback
| API | Description | 
| Network quality, this callback is triggered every 2 seconds, providing statistics for the current network's upload and download quality. | |
| Technical indicators statistics callback. | |
| Callback for the result of the network speed test. | 
Server event callback
| API | Description | 
| The SDK's connection to the server has disconnected. | |
| The SDK attempts to reconnect to the server. | |
| The SDK's connection to the server has been restored. | 
Hardware Device Event Callback
| API | Description | 
| Camera Ready. | |
| Microphone Ready. | |
| Callback for indicating volume level, including the volume of each userId and the remote master volume. | |
| The system capture volume of the current microphone has changed. | |
| The playback volume of the current system has changed. | |
| Event callback for successful system sound capture (only applicable to desktop systems). | |
| Microphone test volume callback | |
| Speaker test volume callback | 
Custom message receipt callback
| API | Description | 
| Receipt of a custom message callback. | |
| Custom message loss callback. | |
| Received SEI message callback. | 
CDN Bypass Forward Callback
| API | Description | 
| Callback for setting On-Cloud MixTranscoding parameters, corresponding to the startPublishMediaStream() interface in TRTCCloud. | |
| Callback for setting On-Cloud MixTranscoding parameters, corresponding to the updatePublishMediaStream() interface in TRTCCloud. | |
| Callback for setting On-Cloud MixTranscoding parameters, corresponding to the stopPublishMediaStream() interface in TRTCCloud. | |
| Callback for changes in RTMP/RTMPS stream pushing status. | 
Screen sharing callback
| API | Description | 
| When screen sharing starts, the SDK will notify through this callback. | |
| When the pauseScreenCapture() is called to pause screen sharing, the SDK will notify through this callback. | |
| When the resumeScreenCapture() is called to resume screen sharing, the SDK will notify through this callback. | |
| When screen sharing stops, the SDK will notify via this callback. | |
| Event callback for when the target window of screen sharing is obscured (applicable only to Windows operating systems) | 
More event callbacks
TRTC Log Callback
| API | Description | 
| Local LOG print callback | 
Callback interface for playing background music
| API | Description | 
| Callback notification for music playback start. | |
| Callback notification for music playback progress. | |
| Callback notification for music playback end. | 
Background Music Preload Event Callback
| API | Description | 
| Background Music Preload Progress. | |
| Background Music Preload Error. | 
Device Connectivity Status Change Callback
| API | Description | 
| The connectivity status of the local device has changed (Desktop systems only) | 
TXAudioEffectManager
| API | Description | 
| Enable ear monitoring, allowing local users to hear their own voice. | |
| Set ear monitoring volume | |
| Set voice reverb effects (KTV, small room, auditorium, deep, bright, etc.) | |
| Set voice changing effects (loli, uncle, heavy metal, punk, etc.) | |
| Set microphone voice volume | |
| Set voice pitch. | |
| Set event callback interface for background music. | |
| Start playing background music | |
| Stop playing background music | |
| Pause playing background music | |
| Resumes background music | |
| Sets global background music volume for local and remote users | |
| Sets the remote volume of background music. The host can use this API to set the volume of background music heard by remote audiences. | |
| Sets the local volume of background music. The host can use this API to set the volume of local background music. | |
| Adjusts the pitch of background music | |
| Adjusts the speed of background music | |
| Gets the current playback progress of the background music (milliseconds) | |
| Gets the total duration of the background music file (milliseconds) | |
| Sets the playback progress of the background music (milliseconds) | |
| Adjusts the speed effect of the scratch disk | |
| Set preload event callback | |
| Preload background music | |
| Get the number of tracks in background music | |
| Specify the track to play background music | 
TXDeviceManager
| API | Description | 
| Set whether to use the front camera | |
| Switch camera (front/rear) | |
| Get the maximum zoom level of the camera | |
| Set the camera zoom factor (focal length) | |
| Check if the device supports automatic face position recognition | |
| Set whether to enable automatic face position recognition | |
| Set the camera focus position | |
| Enable/disable flashlight, also known as torch mode | |
| Set audio routing, i.e., use receiver or speaker | |
| Get the device list of specified type | |
| Set the device currently in use | |
| Get the device currently in use | |
| Set the volume of the current device | |
| Get the volume of the current device | |
| Set the mute state of the current device | |
| Query the mute state of the current device | |
| Set the audio device used by the SDK to follow the system default device (desktop only) | |
| Start camera testing (desktop only) | |
| Stop camera testing (desktop only) | |
| Start mic testing (desktop only) | |
| Start mic testing (desktop only) | |
| Stop mic testing (desktop only) | |
| Start speaker testing (desktop only) | |
| Stop speaker testing (desktop only) | |
| Set the volume of the current process in the Windows system volume mixer | |
| Get the volume of the current process in the Windows system volume mixer | |
| Set the mute state of the current process in the Windows system volume mixer | |
| Get the mute state of the current process in the Windows system volume mixer | |
| Set camera capture preferences | |
| Set onDeviceChanged event callback | 
Enumeration definitions
| Enum Type | Description | 
| Application scenario | |
| Audio Frame Content Format | |
| Audio Callback Data Operation Mode | |
| Sound Quality | |
| Audio Recording Content Type | |
| Playback State Change Reason | |
| Audio and video playback status | |
| Media recording type | |
| Sets the adaptive mode for gravity sensing (only applicable to mobile devices) | |
| Media recording type. | |
| Log level | |
| Publishing mode | |
| Network quality | |
| Roles | |
| Screen sharing target type (desktop only) | |
| Local video screenshot data source | |
| Speed test scenario | |
| Video data shipping method | |
| Video image fill mode | |
| Video mirroring type | |
| Video pixel format | |
| Image quality preference | |
| Video resolution | |
| Video aspect ratio mode | |
| Video image rotation direction | |
| Video stream type | |
| Watermark image source type | |
| Reverb special effect | |
| Voice change special effect | |
| Audio routing (i.e., sound playback mode) | |
| Device type (desktop platform only) | |
| Device operation | |
| Camera capture preferences | 
Type Definition
| Struct type | Description | 
| Audio frame data | |
| Format parameters for custom audio callbacks | |
| Volume evaluation and other related parameter settings | |
| Structure for storing window thumbnails and icons | |
| Local media file recording parameters | |
| Local audio and video metrics | |
| Network bandwidth limit parameters | |
| Room entry parameters | |
| Target URL for publishing to Tencent Cloud or a third-party CDN | |
| Publishing target | |
| Network quality | |
| Remote audio and video metrics | |
| Rendering parameters of the video image | |
| Advanced control parameters for screen sharing | |
| Target information for screen sharing (desktop only) | |
| List of screen windows | |
| Network speed test parameters | |
| Network speed test results | |
| Network and performance metrics | |
| Encoding parameters | |
| Transcoding parameters | |
| Room switch parameters | |
| Video texture data | |
| User to publish stream | |
| Video codec parameters | |
| Video frame information | |
| Video layout for transcoded stream | |
| Volume | |
| Watermark layout | |
| Background music playback control information | |
| Camera capture parameters | |
| Information about audio and video devices (desktop platform only) | 
Video rendering component
| API | Description | 
| Video view window for displaying local video, remote video, or auxiliary stream. |