Overview

TRTCCloud

Basic Method

API
Description
Create a `TRTCCloud` singleton.
Destroy the `TRTCCloud` singleton.
Set event listening.
Remove event listening.

Room APIs

API
Description
enterRoom
Enters a room. If the room does not exist, the system will create one automatically.
exitRoom
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.
Set placeholder image during local video pause.
Add watermark.
Sets the beauty (skin smoothing) filter algorithm.

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 Audio Capture Mode.
Submit your captured audio data to the SDK.

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

API
Description
onError
Error callback, indicating an irrecoverable error in the SDK. It is essential to listen and provide users with appropriate interface prompts accordingly.
onWarning
Warning callback, designed to inform you of non-critical issues, such as lag or recoverable decoding failure.

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
onLog
Local Log print callback.

Callback interface for playing background music

API
Description
onStart
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.
TRTCUser
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.