tencent cloud

Feedback

Overview

Last updated: 2022-02-21 17:01:28

    TRTCCloud @ TXLiteAVSDK

    Instance creation and event callback APIs

    API Description
    sharedInstance Creates a TRTCCloud instance (singleton).
    destroySharedInstance Terminates a TRTCCloud instance (singleton).
    setListener Sets a TRTC event listener.
    setListenerHandler Sets the queue that drives TRTCCloudDelegate callbacks.

    Room APIs

    API Description
    enterRoom Enters a room.
    exitRoom Exits a room.
    switchRole Switches roles.
    switchRoom Switches rooms.
    ConnectOtherRoom Requests a cross-room call.
    DisconnectOtherRoom Exits a cross-room call.
    setDefaultStreamRecvMode Sets the subscription mode. It must be set before room entry to take effect.
    createSubCloud Creates a sub-room instance (for concurrent playback from multiple rooms).
    destroySubCloud Terminates a sub-room instance.

    CDN APIs

    API Description
    startPublishing Starts publishing audio/video streams to Tencent Cloud’s live streaming CDN.
    stopPublishing Stops publishing audio/video streams to Tencent Cloud’s live streaming CDN.
    startPublishCDNStream Starts publishing audio/video streams to a non-Tencent Cloud CDN.
    stopPublishCDNStream Stops publishing audio/video streams to a non-Tencent Cloud CDN.
    setMixTranscodingConfig Sets layout and transcoding parameters for On-Cloud MixTranscoding.

    Video APIs

    API Description
    startLocalPreview Enables local camera preview (mobile).
    updateLocalView Updates local camera preview.
    stopLocalPreview Disables local camera preview.
    muteLocalVideo Pauses/Resumes publishing the local video stream.
    setVideoMuteImage Sets the image to display when local video is paused.
    startRemoteView Subscribes to a remote user’s video stream and binds a video rendering control.
    updateRemoteView Updates a remote user’s video rendering control.
    stopRemoteView Unsubscribes from a remote user’s video stream and unbinds the rendering control.
    stopAllRemoteView Unsubscribes from all remote users’ video streams and unbinds all rendering controls.
    muteRemoteVideoStream Pauses/Resumes receiving a remote user’s video stream.
    muteAllRemoteVideoStreams Pauses/Resumes receiving all remote users’ video streams.
    setVideoEncoderParam Sets video encoder parameters.
    setNetworkQosParam Sets video preference.
    setLocalRenderParams Sets rendering parameters for the local image.
    setRemoteRenderParams Sets rendering parameters for a remote image.
    setVideoEncoderRotation Sets the rotation of encoded video images.
    setVideoEncoderMirror Sets the mirror mode of encoded images.
    setGSensorMode Sets the adaptation mode of the G-sensor.
    enableEncSmallVideoStream Enables/Disables the dual-channel (big and small images) encoding mode.
    setRemoteVideoStreamType Switches between the small and big images of a remote user.
    snapshotVideo Takes a video screenshot.

    Audio APIs

    API Description
    startLocalAudio Starts local audio capturing and publishing.
    stopLocalAudio Stops local audio capturing and publishing.
    muteLocalAudio Pauses/Resumes publishing the local audio stream.
    muteRemoteAudio Pauses/Resumes playing the audio stream of a remote user.
    muteAllRemoteAudio Pauses/Resumes playing the audio streams of all remote users.
    setAudioRoute Sets the audio route.
    setRemoteAudioVolume Sets the playback volume of a remote user.
    setAudioCaptureVolume Sets the local audio capturing volume.
    getAudioCaptureVolume Gets the local audio capturing volume.
    setAudioPlayoutVolume Sets the playback volume of remote audio.
    getAudioPlayoutVolume Gets the playback volume of remote audio.
    enableAudioVolumeEvaluation Enables the volume reminder.
    startAudioRecording Starts audio recording.
    stopAudioRecording Stops audio recording.
    startLocalRecording Starts local media recording.
    stopLocalRecording Stops local media recording.
    checkAudioCapabilitySupport Quires whether an audio capability is supported. This API works only on Android.
    setRemoteAudioParallelParams Configures policy for the playback of the audio of multiple remote speakers.

    Device management APIs

    API Description
    getDeviceManager Gets the device management class TXDeviceManager.

    Beauty filter and watermark APIs

    API Description
    getBeautyManager Gets the beauty filter management class TXBeautyManager.
    setWatermark Adds watermarks.

    Background music and audio effect APIs

    API Description
    getAudioEffectManager Gets the audio effect management class TXAudioEffectManager.

    Screen sharing APIs

    API Description
    startScreenCapture Starts screen sharing.
    stopScreenCapture Stops screen sharing.
    pauseScreenCapture Pauses screen sharing.
    resumeScreenCapture Resumes screen sharing.
    setSubStreamEncoderParam Sets encoding parameters for screen sharing (substream video). This API works on both desktop and mobile OS.

    Custom capturing and rendering APIs

    API Description
    enableCustomVideoCapture Enables/Disables custom video capturing.
    sendCustomVideoData Sends captured video frames to the SDK.
    enableCustomAudioCapture Enables/Disables custom audio capturing.
    sendCustomAudioData Sends captured audio data to the SDK.
    enableMixExternalAudioFrame Enables/Disables custom audio tracks.
    mixExternalAudioFrame Mixes a custom audio track into the SDK.
    setMixExternalAudioVolume Sets the publishing and playback volumes of external audio mixed into the published stream.
    generateCustomPTS Gets the PTS for custom capturing.
    setLocalVideoProcessListener Sets the callback of video data for application of third-party beauty filters.
    setLocalVideoRenderListener Sets the callback of local video for custom rendering.
    setRemoteVideoRenderListener Sets the callback of a remote video for custom rendering.
    setAudioFrameListener Sets the audio data callback.
    setCapturedRawAudioFrameCallbackFormat Sets the format of the callback of raw audio frames captured by the local mic.
    setLocalProcessedAudioFrameCallbackFormat Sets the format of the callback of pre-processed local audio frames.
    setMixedPlayAudioFrameCallbackFormat Sets the format of the callback of audio frames played by the system.
    enableCustomAudioRendering Enables/Disables custom audio rendering.
    getCustomAudioRenderingFrame Gets playable audio frames.

    Custom message sending APIs

    API Description
    sendCustomCmdMsg Sends a custom message to all users in a room via TRTC’s UDP channel.
    sendSEIMsg Sends a custom message to all users in a room via TRTC’s SEI channel.

    Network testing APIs

    API Description
    startSpeedTest Starts network speed testing. This API must be called before room entry.
    stopSpeedTest Stops network speed testing.

    Debugging APIs

    API Description
    getSDKVersion Gets the SDK version.
    setLogLevel Sets the log output level.
    setConsoleEnabled Enables/Disables console log printing.
    setLogCompressEnabled Enables/Disables local log compression.
    setLogDirPath Sets the path to save local logs.
    setLogListener Sets the log callback.
    showDebugView Sets whether to display the dashboard.
    setDebugViewMargin Sets the dashboard margin.
    callExperimentalAPI Calls the experimental API.
    setNetEnv Sets TRTC’s backend clusters (for use by Tencent Cloud R&D team only).

    Disused APIs

    API Description
    setMicVolumeOnMixing Sets the mic volume.
    setBeautyStyle Sets the strength of the beauty, skin brightening, and rosy skin filters.
    setEyeScaleLevel Sets the strength of the eye enlarging filter.
    setFaceSlimLevel Sets the strength of the face slimming filter.
    setFaceVLevel Sets the strength of the chin slimming filter.
    setChinLevel Sets the strength of the jaw lengthening/shortening filter.
    setFaceShortLevel Sets the strength of the face shortening filter.
    setNoseSlimLevel Sets the strength of the nose slimming filter.
    selectMotionTmpl Sets animated stickers.
    setMotionMute Mutes/Unmutes animated effects.
    setFilter Sets the color filter.
    setFilterConcentration Sets the strength of the color filter.
    setGreenScreenFile Sets green screen effects.
    playBGM Starts background music.
    stopBGM Stops background music.
    pauseBGM Pauses background music.
    resumeBGM Resumes background music.
    getBGMDuration Gets the total length of the music file, in milliseconds.
    setBGMPosition Sets the playback progress of background music.
    setBGMVolume Sets the volume of background music.
    setBGMPlayoutVolume Sets the local playback volume of background music.
    setBGMPublishVolume Sets the remote playback volume of background music.
    setReverbType Sets the reverb effect.
    setVoiceChangerType Sets the voice changing effect.
    playAudioEffect Plays an audio effect.
    setAudioEffectVolume Sets the volume of an audio effect.
    stopAudioEffect Stops an audio effect.
    stopAllAudioEffects Stops all audio effects.
    setAllAudioEffectsVolume Sets the volume of all audio effects.
    pauseAudioEffect Pauses an audio effect.
    resumeAudioEffect Resumes an audio effect.
    enableAudioEarMonitoring Enables/Disables in-ear monitoring.
    startRemoteView Plays the video of a remote user.
    stopRemoteView Stops playing the video of a remote user and pulling the user’s video data.
    setRemoteViewFillMode Sets the rendering mode of a remote image.
    setRemoteViewRotation Sets the clockwise rotation of a remote image.
    setLocalViewFillMode Sets the rendering mode of the local image.
    setLocalViewRotation Sets the clockwise rotation of the local image.
    setLocalViewMirror Sets the mirror mode of the local camera's preview image.
    startRemoteSubStreamView Starts playing the substream video of a remote user.
    stopRemoteSubStreamView Stops playing the substream video of a remote user.
    setRemoteSubStreamViewFillMode Sets the fill mode of the substream video of a remote user.
    setRemoteSubStreamViewRotation Sets the clockwise rotation of the substream video of a remote user.
    setPriorRemoteVideoStreamType Sets playback preference.
    setAudioQuality Sets audio quality.
    startLocalAudio Enables local audio capturing and publishing.
    switchCamera Switches cameras.
    isCameraZoomSupported Queries whether the current camera supports zoom.
    setZoom Sets the camera zoom factor (focal length).
    isCameraTorchSupported Queries whether the camera supports flash.
    enableTorch Enables/Disables flash.
    isCameraFocusPositionInPreviewSupported Queries whether the camera supports focus setting.
    setFocusPosition Sets the coordinates of camera focus.
    isCameraAutoFocusFaceModeSupported Queries whether the camera supports automatic facial recognition.
    setSystemVolumeType Sets the system volume type.
    enableCustomVideoCapture Enables/Disables custom video capturing.
    sendCustomVideoData Sends captured video data to the SDK.
    startScreenCapture Starts screen sharing (for Android).
    muteLocalVideo Pauses/Resumes publishing the local video stream.
    muteRemoteVideoStream Pauses/Resumes receiving a remote user’s video stream.
    startSpeedTest Starts network speed testing. This API must be called before room entry.

    Error and warning callback APIs

    API Description
    onError Callback for errors
    onWarning Callback for warnings

    Room event callback APIs

    API Description
    onEnterRoom Callback of the result of room entry
    onExitRoom Callback for room exit
    onSwitchRole Callback for role switching
    onSwitchRoom Callback for room switching
    onConnectOtherRoom Callback of the result of requesting a cross-room call
    onDisConnectOtherRoom Callback of the result of ending a cross-room call

    User event callback APIs

    API Description
    onRemoteUserEnterRoom Callback for the entry of a user
    onRemoteUserLeaveRoom Callback for the exit of a user
    onUserVideoAvailable Callback for publishing/unpublishing the primary-stream video by a remote user
    onUserSubStreamAvailable Callback for publishing/unpublishing the substream video by a remote user
    onUserAudioAvailable Callback for publishing/unpublishing audio by a remote user
    onFirstVideoFrame Callback for rendering the first video frame of the local user or a remote user
    onFirstAudioFrame Callback for playing the first audio frame of a remote user
    onSendFirstLocalVideoFrame Callback for sending the first local video frame
    onSendFirstLocalAudioFrame Callback for sending the first local audio frame
    onRemoteVideoStatusUpdated Callback for change of the video status of a remote user

    Callback APIs for statistics on network and technical metrics

    API Description
    onNetworkQuality Callback of real-time statistics on network quality
    onStatistics Callback of real-time statistics on technical metrics
    onSpeedTestResult Callback of network speed testing results

    Callback APIs for change of connection status

    API Description
    onConnectionLost Callback for the disconnection of the SDK from the server
    onTryToReconnect Callback for the SDK trying to reconnect to the server
    onConnectionRecovery Callback for the reconnection of the SDK to the server

    Hardware event callback APIs

    API Description
    onCameraDidReady Callback for the camera being ready
    onMicDidReady Callback for the mic being ready
    onAudioRouteChanged Callback for change of the audio route (for mobile devices only)
    onUserVoiceVolume Callback of volume

    Callback APIs for receiving custom messages

    API Description
    onRecvCustomCmdMsg Callback for receiving a custom message
    onMissCustomCmdMsg Callback for losing a custom message
    onRecvSEIMsg Callback for receiving an SEI message

    CDN event callback APIs

    API Description
    onStartPublishing Callback for publishing audio/video streams to Tencent Cloud’s live streaming CDN
    onStopPublishing Callback for stopping publishing audio/video streams to Tencent Cloud’s live streaming CDN
    onStartPublishCDNStream Callback for publishing audio/video streams to a non-Tencent Cloud CDN
    onStopPublishCDNStream Callback for stopping publishing audio/video streams to a non-Tencent Cloud CDN
    onSetMixTranscodingConfig Callback for setting layout and transcoding parameters for On-Cloud MixTranscoding

    Screen sharing callback APIs

    API Description
    onScreenCaptureStarted Callback for starting screen sharing
    onScreenCapturePaused Callback for pausing screen sharing
    onScreenCaptureResumed Callback for resuming screen sharing
    onScreenCaptureStopped Callback for stopping screen sharing

    Callback APIs for local recording and screenshot taking

    API Description
    onLocalRecordBegin Callback for starting local recording
    onLocalRecording Callback of the progress of local recording
    onLocalRecordComplete Callback for ending local recording

    Disused callback APIs

    API Description
    onUserEnter Callback for the entry of an anchor (disused)
    onUserExit Callback for the exit of an anchor (disused)
    onAudioEffectFinished Callback for ending an audio effect (disused)
    onSpeedTest Callback of server speed testing results. This callback has been disused.

    Callback APIs for custom video

    API Description
    onRenderVideoFrame Callback of video frames for custom rendering
    onGLContextCreated Callback for creating an OpenGL context in the SDK
    onProcessVideoFrame Callback of video frames for processing by third-party beauty filters
    onGLContextDestory Callback for destroying the OpenGL context in the SDK

    Callback APIs for custom audio

    API Description
    onCapturedRawAudioFrame Callback of audio data captured by the local mic and pre-processed by the audio module
    onLocalProcessedAudioFrame Callback of locally captured audio data that is pre-processed by the audio module, added with audio effects, and mixed with background music
    onRemoteUserAudioFrame Callback of the audio data of each remote user before audio mixing
    onMixedPlayAudioFrame Callback of data mixed from the audio of each user before playback
    onMixedAllAudioFrame Callback of data mixed from all audio in the SDK, including captured and to-be-played audio

    Other callback APIs

    API Description
    onLog Callback for printing local logs

    Definitions of video enumerated values

    API Description
    TRTCVideoResolution Resolution
    TRTCVideoResolutionMode Aspect ratio mode
    TRTCVideoStreamType Stream type
    TRTCVideoFillMode Image fill mode
    TRTCVideoRotation Rotation
    TRTCBeautyStyle Beauty (skin smoothing) algorithm
    TRTCVideoPixelFormat Pixel format
    TRTCVideoBufferType Video data transfer method
    TRTCVideoMirrorType Mirror mode
    TRTCSnapshotSourceType Source of local screenshots

    Definitions of network enumerated values

    API Description
    TRTCAppScene Application scenario
    TRTCRoleType Role
    TRTCQosControlMode QoS control mode (disused)
    TRTCVideoQosPreference Video quality preference
    TRTCQuality Network quality
    TRTCAVStatusType Video status
    TRTCAVStatusChangeReason Reason for change of video status

    Definitions of audio enumerated values

    API Description
    TRTCAudioSampleRate Audio sample rate
    TRTCAudioQuality Audio quality
    TRTCAudioRoute Audio route (audio playback mode)
    TRTCReverbType Reverb effect
    TRTCVoiceChangerType Voice changing effect
    TRTCSystemVolumeType System volume type (for mobile devices only)
    TRTCAudioCapabilityType Audio capabilities supported. This is only applicable to Android.

    Definitions of other enumerated values

    API Description
    TRTCLogLevel Log level
    TRTCGSensorMode G-sensor mode (for mobile devices only)
    TRTCTranscodingConfigMode Layout mode for On-Cloud MixTranscoding
    TRTCRecordType Type of media to record
    TRTCMixInputType Input type for stream mixing
    TRTCAudioRecordingContent Type of audio to record

    Definitions of TRTC key types

    API Description
    TRTCParams Room entry parameters
    TRTCVideoEncParam Video encoding parameters
    TRTCNetworkQosParam QoS control parameters
    TRTCRenderParams Video rendering parameters
    TRTCQualityInfo Network quality
    TRTCVolumeInfo Volume
    TRTCSpeedTestParams Network speed testing parameters
    TRTCSpeedTestResult Results of network speed testing
    TRTCTexture Video texture data (applicable to Android only), including texture ID and the EGL context
    TRTCVideoFrame Video frame information
    TRTCAudioFrame Audio frame information
    TRTCMixUser Information of each channel in On-Cloud MixTranscoding
    TRTCTranscodingConfig Layout and transcoding parameters for On-Cloud MixTranscoding
    TRTCPublishCDNParam Relaying parameters for publishing audio/video streams to a non-Tencent Cloud CDN
    TRTCAudioRecordingParams Local audio recording parameters
    TRTCLocalRecordingParams Local media recording parameters
    TRTCAudioEffectParam Audio effect parameters (disused)
    TRTCSwitchRoomConfig Room switching parameters
    TRTCAudioFrameCallbackFormat Format of the custom audio callback
    TRTCScreenShareParams Screen sharing parameters. This is only applicable to Android.
    Contact Us

    Contact our sales team or business advisors to help your business.

    Technical Support

    Open a ticket if you're looking for further assistance. Our Ticket is 7x24 avaliable.

    7x24 Phone Support