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. |
- TRTCCloud
- Basic Method
- Room APIs
- CDN Interface Functions
- Video Interface Functions
- Audio related interface functions
- Device management interface
- Music and Vocal Special Effects
- Auxiliary stream related interface functions
- Custom capturing and custom rendering
- Custom message sending APIs
- Network Testing
- Log Interface Functions
- TRTCCloudListener
- Error and warning event callback APIs
- Room event callback APIs
- Member Event Callback
- Callback for local recording and local screenshot events
- Statistics and quality callback
- Server event callback
- Hardware Device Event Callback
- Custom message receipt callback
- CDN Bypass Forward Callback
- Screen sharing callback
- More event callbacks
- TXAudioEffectManager
- TXDeviceManager
- Enumeration definitions
- Type Definition
- Video rendering component