LiteAVSDK
Tencent Cloud TRTC SDK, is a high availability components serving tens of thousands of enterprise customers, which is committed to helping you to minimize your research and development costs.
Create Instance And Event Callback
API DESC
sharedInstance Create TRTCCloud instance (singleton mode)
destroySharedIntance Terminate TRTCCloud instance (singleton mode)
delegate Set TRTC event callback
delegateQueue Set the queue that drives the TRTCCloudDelegate event callback

Room APIs

API DESC
enterRoom Enter room
exitRoom Exit room
switchRole Switch role
switchRoom Switch room
connectOtherRoom Request cross-room call
disconnectOtherRoom Exit cross-room call
setDefaultStreamRecvMode Set subscription mode (which must be set before room entry for it to take effect)
createSubCloud Create room subinstance (for concurrent multi-room listen/watch)
destroySubCloud Terminate room subinstance

CDN APIs

API DESC
startPublishing Start publishing audio/video streams to Tencent Cloud CSS CDN
stopPublishing Stop publishing audio/video streams to Tencent Cloud CSS CDN
startPublishCDNStream Start publishing audio/video streams to non-Tencent Cloud CDN
stopPublishCDNStream Stop publishing audio/video streams to non-Tencent Cloud CDN
setMixTranscodingConfig Set the layout and transcoding parameters of On-Cloud MixTranscoding

Video APIs

API DESC
startLocalPreview Enable the preview image of local camera (mobile)
startLocalPreview Enable the preview image of local camera (desktop)
updateLocalView Update the preview image of local camera
stopLocalPreview Stop camera preview
muteLocalVideo Pause/Resume publishing local video stream
setVideoMuteImage Set placeholder image during local video pause
startRemoteView Subscribe to remote user's video stream and bind video rendering control
updateRemoteView Update remote user's video rendering control
stopRemoteView Stop subscribing to remote user's video stream and release rendering control
stopAllRemoteView Stop subscribing to all remote users' video streams and release all rendering resources
muteRemoteVideoStream Pause/Resume subscribing to remote user's video stream
muteAllRemoteVideoStreams Pause/Resume subscribing to all remote users' video streams
setVideoEncoderParam Set the encoding parameters of video encoder
setNetworkQosParam Set network quality control parameters
setLocalRenderParams Set the rendering parameters of local video image
setRemoteRenderParams Set the rendering mode of remote video image
setVideoEncoderRotation Set the direction of image output by video encoder
setVideoEncoderMirror Set the mirror mode of image output by encoder
setGSensorMode Set the adaptation mode of G-sensor
enableEncSmallVideoStream Enable dual-channel encoding mode with big and small images
setRemoteVideoStreamType Switch the big/small image of specified remote user
snapshotVideo Screencapture video

Audio APIs

API DESC
startLocalAudio Enable local audio capturing and publishing
stopLocalAudio Stop local audio capturing and publishing
muteLocalAudio Pause/Resume publishing local audio stream
muteRemoteAudio Pause/Resume playing back remote audio stream
muteAllRemoteAudio Pause/Resume playing back all remote users' audio streams
setAudioRoute Set audio route
setRemoteAudioVolume Set the audio playback volume of remote user
setAudioCaptureVolume Set the capturing volume of local audio
getAudioCaptureVolume Get the capturing volume of local audio
setAudioPlayoutVolume Set the playback volume of remote audio
getAudioPlayoutVolume Get the playback volume of remote audio
enableAudioVolumeEvaluation Enable volume reminder
startAudioRecording Start audio recording
stopAudioRecording Stop audio recording
startLocalRecording Start local media recording
stopLocalRecording Stop local media recording
setRemoteAudioParallelParams Set the parallel strategy of remote audio streams

Device management APIs

API DESC
getDeviceManager Get device management class (TXDeviceManager)

Beauty filter and watermark APIs

API DESC
getBeautyManager Get beauty filter management class (TXBeautyManager)
setWatermark Add watermark

Background music and sound effect APIs

API DESC
getAudioEffectManager Get sound effect management class (TXAudioEffectManager)
startSystemAudioLoopback Enable system audio capturing (for desktop systems only)
stopSystemAudioLoopback Stop system audio capturing (for desktop systems only)
setSystemAudioLoopbackVolume Set the volume of system audio capturing

Screen sharing APIs

API DESC
startScreenCaptureInApp Start in-app screen sharing (for iOS 13.0 and above only)
startScreenCaptureByReplaykit Start system-level screen sharing (for iOS 11.0 and above only)
startScreenCapture Start desktop screen sharing (for desktop systems only)
stopScreenCapture Stop screen sharing
pauseScreenCapture Pause screen sharing
resumeScreenCapture Resume screen sharing
getScreenCaptureSourcesWithThumbnailSize Enumerate shareable screens and windows (for macOS only)
selectScreenCaptureTarget Select the screen or window to share (for macOS only)
setSubStreamEncoderParam Set the video encoding parameters of screen sharing (i.e., substream) (for desktop and mobile systems)
setSubStreamMixVolume Set the audio mixing volume of screen sharing (for desktop systems only)
addExcludedShareWindow Add specified windows to the exclusion list of screen sharing (for desktop systems only)
removeExcludedShareWindow Remove specified windows from the exclusion list of screen sharing (for desktop systems only)
removeAllExcludedShareWindows Remove all windows from the exclusion list of screen sharing (for desktop systems only)
addIncludedShareWindow Add specified windows to the inclusion list of screen sharing (for desktop systems only)
removeIncludedShareWindow Remove specified windows from the inclusion list of screen sharing (for desktop systems only)
removeAllIncludedShareWindows Remove all windows from the inclusion list of screen sharing (for desktop systems only)

Custom capturing and rendering APIs

API DESC
enableCustomVideoCapture Enable/Disable custom video capturing mode
sendCustomVideoData Deliver captured video frames to SDK
enableCustomAudioCapture Enable custom audio capturing mode
sendCustomAudioData Deliver captured audio data to SDK
enableMixExternalAudioFrame Enable/Disable custom audio track
mixExternalAudioFrame Mix custom audio track into SDK
setMixExternalAudioVolume Set the publish volume and playback volume of mixed custom audio track
generateCustomPTS Generate custom capturing timestamp
setLocalVideoProcessDelegete Set video data callback for third-party beauty filters
setLocalVideoRenderDelegate Set the callback of custom rendering for local video
setRemoteVideoRenderDelegate Set the callback of custom rendering for remote video
setAudioFrameDelegate Set custom audio data callback
setCapturedRawAudioFrameDelegateFormat Set the callback format of original audio frames captured by local mic
setLocalProcessedAudioFrameDelegateFormat Set the callback format of preprocessed local audio frames
setMixedPlayAudioFrameDelegateFormat Set the callback format of audio frames to be played back by system
enableCustomAudioRendering Enabling custom audio playback
getCustomAudioRenderingFrame Getting playable audio data

Custom message sending APIs

API DESC
sendCustomCmdMsg Use UDP channel to send custom message to all users in room
sendSEIMsg Use SEI channel to send custom message to all users in room

Network test APIs

API DESC
startSpeedTest Start network speed test (used before room entry)
stopSpeedTest Stop network speed test

Debugging APIs

API DESC
getSDKVersion Get SDK version information
setLogLevel Set log output level
setConsoleEnabled Enable/Disable console log printing
setLogCompressEnabled Enable/Disable local log compression
setLogDirPath Set local log storage path
setLogDelegate Set log callback
showDebugView Display dashboard
setDebugViewMargin Set dashboard margin
callExperimentalAPI Call experimental APIs

Disused APIs

API DESC
setMicVolumeOnMixing Set mic volume
setBeautyStyle Set the strength of beauty, brightening, and rosy skin filters
setEyeScaleLevel Set the strength of eye enlarging filter
setFaceScaleLevel Set the strength of face slimming filter
setFaceVLevel Set the strength of chin slimming filter
setChinLevel Set the strength of chin lengthening/shortening filter
setFaceShortLevel Set the strength of face shortening filter
setNoseSlimLevel Set the strength of nose slimming filter
selectMotionTmpl Set animated sticker
setMotionMute Mute animated sticker
startScreenCapture Start screen sharing
setFilter Set color filter
setFilterConcentration Set the strength of color filter
setGreenScreenFile Set green screen video
playBGM Start background music
stopBGM Stop background music
pauseBGM Stop background music
resumeBGM Stop background music
getBGMDuration Get the total length of background music in ms
setBGMPosition Set background music playback progress
setBGMVolume Set background music volume
setBGMPlayoutVolume Set the local playback volume of background music
setBGMPublishVolume Set the remote playback volume of background music
setReverbType Set reverb effect
setVoiceChangerType Set voice changing type
playAudioEffect Play sound effect
setAudioEffectVolume Set sound effect volume
setAudioEffectVolume Stop sound effect
stopAllAudioEffects Stop all sound effects
setAllAudioEffectsVolume Set the volume of all sound effects
pauseAudioEffect Pause sound effect
resumeAudioEffect Pause sound effect
enableAudioEarMonitoring Enable or disable in-ear monitoring
startRemoteView Start displaying remote video image
stopRemoteView Stop displaying remote video image and pulling the video data stream of remote user
setRemoteViewFillMode Set the rendering mode of remote image
setRemoteViewRotation Set the clockwise rotation angle of remote image
setLocalViewFillMode Set the rendering mode of local image
setLocalViewRotation Set the clockwise rotation angle of local image
setLocalViewMirror Set the mirror mode of local camera's preview image
startRemoteSubStreamView Start displaying the substream image of remote user
stopRemoteSubStreamView Stop displaying the substream image of remote user
setRemoteSubStreamViewFillMode Set the fill mode of substream image
setRemoteSubStreamViewRotation Set the clockwise rotation angle of substream image
setPriorRemoteVideoStreamType Specify whether to view the big or small image
setAudioQuality Set sound quality
startLocalAudio Set sound quality
switchCamera Switch camera
isCameraZoomSupported Query whether the current camera supports zoom
setZoom Set camera zoom ratio (focal length)
isCameraTorchSupported Query whether the device supports flash
enbaleTorch Enable/Disable flash
isCameraFocusPositionInPreviewSupported Query whether the camera supports setting focus
setFocusPosition Set the focal position of camera
isCameraAutoFocusFaceModeSupported Query whether the device supports the automatic recognition of face position
enableAutoFaceFoucs Enable/Disable face auto focus
startCameraDeviceTestInView Start camera test
stopCameraDeviceTest Start camera test
startMicDeviceTest Start mic test
stopMicDeviceTest Start mic test
startSpeakerDeviceTest Start speaker test
stopSpeakerDeviceTest Stop speaker test
getMicDevicesList Get the list of mics
getCurrentMicDevice Get the current mic device
setCurrentMicDevice Select the currently used mic
getCurrentMicDeviceVolume Get the current mic volume
setCurrentMicDeviceVolume Set the current mic volume
getCurrentMicDeviceMute Get the mute status of the current system mic
setCurrentMicDeviceMute Set the mute status of the current system mic
getSpeakerDevicesList Get the list of speakers
getCurrentSpeakerDevice Get the currently used speaker
setCurrentSpeakerDevice Set the speaker to use
getCurrentSpeakerDeviceVolume Get the current speaker volume
setCurrentSpeakerDeviceVolume Set the current speaker volume
getCurrentSpeakerDeviceMute Get the mute status of the current system speaker
setCurrentSpeakerDeviceMute Set whether to mute the current system speaker
getCameraDevicesList Get the list of cameras
getCurrentCameraDevice Get the currently used camera
setCurrentCameraDevice Set the camera to be used currently
setSystemVolumeType Setting the system volume type (for mobile OS)
snapshotVideo Screencapture video
enableCustomVideoCapture Enable custom video capturing mode
sendCustomVideoData Deliver captured video data to SDK
startScreenCaptureInApp tart in-app screen sharing (for iOS 13.0 and above only)
startScreenCaptureByReplaykit Start system-level screen sharing (for iOS 11.0 and above only)
muteLocalVideo Pause/Resume publishing local video stream
muteRemoteVideoStream Pause/Resume subscribing to remote user's video stream
startSpeedTest Start network speed test (used before room entry)

Error and warning events

API DESC
onError Error event callback
onWarning Warning event callback

Room event callback

API DESC
onEnterRoom Whether room entry is successful
onExitRoom Room exit
onSwitchRole Role switching
onSwitchRoom Result of room switching
onConnectOtherRoom Result of requesting cross-room call
onDisconnectOtherRoom Result of ending cross-room call

User event callback

API DESC
onRemoteUserEnterRoom A user entered the room
onRemoteUserLeaveRoom A user exited the room
onUserVideoAvailable A remote user published/unpublished primary stream video
onUserSubStreamAvailable A remote user published/unpublished substream video
onUserAudioAvailable A remote user published/unpublished audio
onFirstVideoFrame The SDK started rendering the first video frame of the local or a remote user
onFirstAudioFrame The SDK started playing the first audio frame of a remote user
onSendFirstLocalVideoFrame The first local video frame was published
onSendFirstLocalAudioFrame The first local audio frame was published
onRemoteVideoStatusUpdated Change of remote video status

Callback of statistics on network and technical metrics

API DESC
onNetworkQuality Real-time network quality statistics
onStatistics Real-time statistics on technical metrics
onSpeedTestResult Callback of network speed test

Callback of connection to the cloud

API DESC
onConnectionLost The SDK was disconnected from the cloud
onTryToReconnect The SDK is reconnecting to the cloud
onConnectionRecovery The SDK is reconnected to the cloud

Callback of hardware events

API DESC
onCameraDidReady The camera is ready
onMicDidReady The mic is ready
onAudioRouteChanged The audio route changed (for mobile devices only)
onUserVoiceVolume Volume
onDevice The status of a local device changed (for desktop OS only)
onAudioDeviceCaptureVolumeChanged The capturing volume of the mic changed
onAudioDevicePlayoutVolumeChanged The playback volume changed
onSystemAudioLoopbackError Whether system audio capturing is enabled successfully (for macOS only)

Callback of the receipt of a custom message

API DESC
onRecvCustomCmdMsgUserId Receipt of custom message
onMissCustomCmdMsgUserId Loss of custom message
onRecvSEIMsg Receipt of SEI message

CDN event callback

API DESC
onStartPublishing Started publishing to Tencent Cloud CSS CDN
onStopPublishing Stopped publishing to Tencent Cloud CSS CDN
onStartPublishCDNStream Started publishing to non-Tencent Cloud’s live streaming CDN
onStopPublishCDNStream Stopped publishing to non-Tencent Cloud’s live streaming CDN
onSetMixTranscodingConfig Set the layout and transcoding parameters for On-Cloud MixTranscoding

Screen sharing event callback

API DESC
onScreenCaptureStarted Screen sharing started
onScreenCapturePaused Screen sharing was paused
onScreenCaptureResumed Screen sharing was resumed
onScreenCaptureStoped Screen sharing stopped

Callback of local recording and screenshot events

API DESC
onLocalRecordBegin Local recording started
onLocalRecording Local media is being recorded
onLocalRecordComplete Local recording stopped

Disused callbacks

API DESC
onUserEnter An anchor entered the room (disused)
onUserExit An anchor left the room (disused)
onAudioEffectFinished Audio effects ended (disused)

Callback of custom video processing

API DESC
onRenderVideoFrame Custom video rendering
onProcessVideoFrame Video processing by third-party beauty filters
onGLContextDestory The OpenGL context in the SDK was destroyed

Callback of custom audio processing

API DESC
onCapturedRawAudioFrame Raw audio data captured locally
onLocalProcessedAudioFrame Audio data captured by the local mic and pre-processed by the audio module
onRemoteUserAudioFrame Audio data of each remote user before audio mixing
onMixedPlayAudioFrame Data mixed from each channel before being submitted to the system for playback
onMixedAllAudioFrame Data mixed from all the captured and to-be-played audio in the SDK

Other event callbacks

API DESC
onLog Printing of local log

Definitions of video enumerated values

API DESC
TRTCVideoResolution Video resolution
TRTCVideoResolutionMode Video aspect ratio mode
TRTCVideoStreamType Video stream type
TRTCVideoFillMode Video image fill mode
TRTCVideoRotation Video image rotation direction
TRTCVideoPixelFormat Video pixel format
TRTCVideoBufferType Video data transfer method
TRTCVideoMirrorType Video mirror type
TRTCSnapshotSourceType Data source of local video screenshot

Definitions of network enumerated values

API DESC
TRTCAppScene Use cases
TRTCRoleType Role
TRTCQosControlMode QoS control mode (disused)
TRTCVideoQosPreference Image quality preference
TRTCQualityInfo Network quality
TRTCAVStatusType Audio/Video playback status
TRTCAVStatusChangeReason Reasons for playback status changes

Definitions of audio enumerated values

API DESC
TRTCAudioSampleRate Audio sample rate
TRTCAudioQuality Sound quality
TRTCAudioRoute Audio route (i.e., audio playback mode)
TRTCReverbType Audio reverb mode
TRTCVoiceChangerType Voice changing type

Definitions of other enumerated values

API DESC
TRTCLogLevel Log level
TRTCGSensorMode G-sensor switch (for mobile devices only)
TRTCTranscodingConfigMode Layout mode of On-Cloud MixTranscoding
TRTCRecordType Media recording type
TRTCMixInputType Stream mix input type
TRTCMediaDeviceType Device type (for desktop platforms only)
TRTCAudioRecordingContent Audio recording content type

Definitions of core TRTC classes

API DESC
TRTCParams Room entry parameters
TRTCVideoEncParam Video encoding parameters
TRTCNetworkQosParam Network QoS control parameter set
TRTCRenderParams Rendering parameters of video image
TRTCQualityInfo Network quality
TRTCVolumeInfo Volume
TRTCSpeedTestParams Network speed testing parameters
TRTCSpeedTestResult Network speed test result
TRTCVideoFrame Video frame information
TRTCAudioFrame Audio frame data
TRTCMixUser Description information of each video image in On-Cloud MixTranscoding
TRTCTranscodingConfig Layout and transcoding parameters of On-Cloud MixTranscoding
TRTCPublishCDNParam Push parameters required to be set when publishing audio/video streams to non-Tencent Cloud CDN
TRTCAudioRecordingParams Local audio file recording parameters
TRTCLocalRecordingParams Local media file recording parameters
TRTCAudioEffectParam Sound effect parameter (disused)
TRTCSwitchRoomConfig Room switch parameter
TRTCAudioFrameDelegateFormat Format parameter of custom audio callback
TRTCScreenCaptureSourceInfo Screen sharing target information (for desktop systems only)