tencent cloud

Feedback

Overview

Last updated: 2024-08-22 15:28:08
    API OVERVIEW

    Create Instance And Event Callback

    FuncList
    DESC
    Create TRTCCloud instance (singleton mode)
    Terminate TRTCCloud instance (singleton mode)
    Add TRTC event callback
    Remove TRTC event callback

    Room APIs

    FuncList
    DESC
    Enter room
    Exit room
    Switch role
    Switch room
    Request cross-room call
    Exit cross-room call
    Set subscription mode (which must be set before room entry for it to take effect)
    Create room subinstance (for concurrent multi-room listen/watch)
    Terminate room subinstance
    

    CDN APIs

    FuncList
    DESC
    Publish a stream
    Modify publishing parameters
    Stop publishing

    Video APIs

    FuncList
    DESC
    Enable the preview image of local camera (mobile)
    Update the preview image of local camera
    Stop camera preview
    Pause/Resume publishing local video stream
    Set placeholder image during local video pause
    Subscribe to remote user's video stream and bind video rendering control
    Update remote user's video rendering control
    Stop subscribing to remote user's video stream and release rendering control
    Stop subscribing to all remote users' video streams and release all rendering resources
    Pause/Resume subscribing to remote user's video stream
    Pause/Resume subscribing to all remote users' video streams
    Set the encoding parameters of video encoder
    Set network quality control parameters
    Set the rendering parameters of local video image
    Set the rendering mode of remote video image
    Enable dual-channel encoding mode with big and small images
    Switch the big/small image of specified remote user
    Screencapture video
    Set the adaptation mode of gravity sensing (version 11.7 and above)

    Audio APIs

    FuncList
    DESC
    Enable local audio capturing and publishing
    Stop local audio capturing and publishing
    Pause/Resume publishing local audio stream
    Pause/Resume playing back remote audio stream
    Pause/Resume playing back all remote users' audio streams
    Set the audio playback volume of remote user
    Set the capturing volume of local audio
    Get the capturing volume of local audio
    Set the playback volume of remote audio
    Get the playback volume of remote audio
    Enable volume reminder
    Start audio recording
    Stop audio recording
    Start local media recording
    Stop local media recording
    Set the parallel strategy of remote audio streams
    Enable 3D spatial effect
    Update self position and orientation for 3D spatial effect
    Update the specified remote user's position for 3D spatial effect
    Set the maximum 3D spatial attenuation range for userId's audio stream

    Device management APIs

    FuncList
    DESC
    Get device management class (TXDeviceManager)

    Beauty filter and watermark APIs

    FuncList
    DESC
    Set special effects such as beauty, brightening, and rosy skin filters
    Add watermark

    Background music and sound effect APIs

    FuncList
    DESC
    Get sound effect management class (TXAudioEffectManager)
    Enable system audio capturing(iOS not supported)
    Stop system audio capturing(iOS not supported)
    Set the volume of system audio capturing

    Screen sharing APIs

    FuncList
    DESC
    Start screen sharing
    Stop screen sharing
    Pause screen sharing
    Resume screen sharing
    Enumerate shareable screens and windows (for desktop systems only)
    Select the screen or window to share (for desktop systems only)
    Set the video encoding parameters of screen sharing (i.e., substream) (for desktop and mobile systems)
    Set the audio mixing volume of screen sharing (for desktop systems only)
    Add specified windows to the exclusion list of screen sharing (for desktop systems only)
    Remove specified windows from the exclusion list of screen sharing (for desktop systems only)
    Remove all windows from the exclusion list of screen sharing (for desktop systems only)
    Add specified windows to the inclusion list of screen sharing (for desktop systems only)
    Remove specified windows from the inclusion list of screen sharing (for desktop systems only)
    Remove all windows from the inclusion list of screen sharing (for desktop systems only)

    Custom capturing and rendering APIs

    FuncList
    DESC
    Enable/Disable custom video capturing mode
    Deliver captured video frames to SDK
    Enable custom audio capturing mode
    Deliver captured audio data to SDK
    Enable/Disable custom audio track
    Mix custom audio track into SDK
    Set the publish volume and playback volume of mixed custom audio track
    Generate custom capturing timestamp
    .1 Enable third-party beauty filters in video
    .2 Set video data callback for third-party beauty filters
    Set the callback of custom rendering for local video
    Set the callback of custom rendering for remote video
    Set custom audio data callback
    Set the callback format of audio frames captured by local mic
    Set the callback format of preprocessed local audio frames
    Set the callback format of audio frames to be played back by system
    Enabling custom audio playback
    Getting playable audio data

    Custom message sending APIs

    FuncList
    DESC
    Use UDP channel to send custom message to all users in room
    Use SEI channel to send custom message to all users in room

    Network test APIs

    FuncList
    DESC
    Start network speed test (used before room entry)
    Stop network speed test

    Debugging APIs

    FuncList
    DESC
    Get SDK version information
    Set log output level
    Enable/Disable console log printing
    Enable/Disable local log compression
    Set local log storage path
    Set log callback
    Display dashboard
    Call experimental APIs

    Encrypted interface

    FuncList
    DESC
    Enable or disable private encryption of media streams

    Error and warning events

    FuncList
    DESC
    Error event callback
    Warning event callback

    Room event callback

    FuncList
    DESC
    Whether room entry is successful
    Room exit
    Role switching
    Result of room switching
    Result of requesting cross-room call
    Result of ending cross-room call
    Result of changing the upstream capability of the cross-room anchor

    User event callback

    FuncList
    DESC
    A user entered the room
    A user exited the room
    A remote user published/unpublished primary stream video
    A remote user published/unpublished substream video
    A remote user published/unpublished audio
    The SDK started rendering the first video frame of the local or a remote user
    The SDK started playing the first audio frame of a remote user
    The first local video frame was published
    The first local audio frame was published
    Change of remote video status
    Change of remote audio status
    Change of remote video size

    Callback of statistics on network and technical metrics

    FuncList
    DESC
    Real-time network quality statistics
    Real-time statistics on technical metrics
    Callback of network speed test

    Callback of connection to the cloud

    FuncList
    DESC
    The SDK was disconnected from the cloud
    The SDK is reconnecting to the cloud
    The SDK is reconnected to the cloud

    Callback of hardware events

    FuncList
    DESC
    The camera is ready
    The mic is ready
    Volume
    The status of a local device changed (for desktop OS only)
    The capturing volume of the mic changed
    The playback volume changed
    Whether system audio capturing is enabled successfully (for desktop OS only)
    Volume during mic test
    Volume during speaker test

    Callback of the receipt of a custom message

    FuncList
    DESC
    Receipt of custom message
    Loss of custom message
    Receipt of SEI message

    CDN event callback

    FuncList
    DESC
    Started publishing to Tencent Cloud CSS CDN
    Stopped publishing to Tencent Cloud CSS CDN
    Started publishing to non-Tencent Cloud’s live streaming CDN
    Stopped publishing to non-Tencent Cloud’s live streaming CDN
    Set the layout and transcoding parameters for On-Cloud MixTranscoding
    Callback for starting to publish
    Callback for modifying publishing parameters
    Callback for stopping publishing
    Callback for change of RTMP/RTMPS publishing status

    Screen sharing event callback

    FuncList
    DESC
    Screen sharing started
    Screen sharing was paused
    Screen sharing was resumed
    Screen sharing stopped
    The shared window was covered (for Windows only)

    Callback of local recording and screenshot events

    FuncList
    DESC
    Local recording started
    Local media is being recorded
    Record fragment finished.
    Local recording stopped
    Finished taking a local screenshot

    Disused callbacks

    FuncList
    DESC
    An anchor entered the room (disused)
    An anchor left the room (disused)
    Audio effects ended (disused)
    Started playing background music (disused)
    Playback progress of background music (disused)
    Background music stopped (disused)
    Result of server speed testing (disused)

    Callback of custom video processing

    FuncList
    DESC
    Custom video rendering
    An OpenGL context was created in the SDK.
    Video processing by third-party beauty filters
    The OpenGL context in the SDK was destroyed

    Callback of custom audio processing

    FuncList
    DESC
    Audio data captured by the local mic and pre-processed by the audio module
    Audio data captured by the local mic, pre-processed by the audio module, effect-processed and BGM-mixed
    Audio data of each remote user before audio mixing
    Data mixed from each channel before being submitted to the system for playback
    Data mixed from all the captured and to-be-played audio in the SDK

    Other event callbacks

    FuncList
    DESC
    Printing of local log

    Background music preload event callback

    FuncList
    DESC
    Background music preload progress
    Background music preload error

    Callback of playing background music

    FuncList
    DESC
    Background music started.
    Playback progress of background music
    Background music ended

    Voice effect APIs

    FuncList
    DESC
    Enabling in-ear monitoring
    Setting in-ear monitoring volume
    Setting voice reverb effects
    Setting voice changing effects
    Setting speech volume
    Setting speech pitch

    Background music APIs

    FuncList
    DESC
    Setting the background music callback
    Starting background music
    Stopping background music
    Pausing background music
    Resuming background music
    Setting the local and remote playback volume of background music
    Setting the remote playback volume of a specific music track
    Setting the local playback volume of a specific music track
    Adjusting the pitch of background music
    Changing the speed of background music
    Getting the playback progress (ms) of background music
    Getting the total length (ms) of background music
    Setting the playback progress (ms) of background music
    Adjust the speed change effect of the scratch disc
    Setting music preload callback
    Preload background music
    Get the number of tracks of background music
    Specify the playback track of background music

    Device APIs

    FuncList
    DESC
    Querying whether the front camera is being used
    Switching to the front/rear camera (for mobile OS)
    Getting the maximum zoom ratio of the camera (for mobile OS)
    Setting the camera zoom ratio (for mobile OS)
    Querying whether automatic face detection is supported (for mobile OS)
    Enabling auto focus (for mobile OS)
    Adjusting the focus (for mobile OS)
    Enabling/Disabling flash, i.e., the torch mode (for mobile OS)
    Setting the audio route (for mobile OS)
    Getting the device list (for desktop OS)
    Setting the device to use (for desktop OS)
    Getting the device currently in use (for desktop OS)
    Setting the volume of the current device (for desktop OS)
    Getting the volume of the current device (for desktop OS)
    Muting the current device (for desktop OS)
    Querying whether the current device is muted (for desktop OS)
    Set the audio device used by SDK to follow the system default device (for desktop OS)
    Starting camera testing (for desktop OS)
    Ending camera testing (for desktop OS)
    Starting mic testing (for desktop OS)
    Ending mic testing (for desktop OS)
    Starting speaker testing (for desktop OS)
    Ending speaker testing (for desktop OS)
    Setting the volume of the current process in the volume mixer (for Windows)
    Getting the volume of the current process in the volume mixer (for Windows)
    Muting the current process in the volume mixer (for Windows)
    Querying whether the current process is muted in the volume mixer (for Windows)
    Set camera acquisition preferences
    set onDeviceChanged callback

    Disused APIs

    FuncList
    DESC
    Setting the system volume type (for mobile OS)

    Disused APIs

    FuncList
    DESC
    Enable volume reminder
    Set sound quality
    Start displaying remote video image
    Stop displaying remote video image and pulling the video data stream of remote user
    Set the rendering mode of local image
    Set the clockwise rotation angle of local image
    Set the mirror mode of local camera's preview image
    Set the fill mode of substream image
    Set the clockwise rotation angle of remote image
    Start displaying the substream image of remote user
    Stop displaying the substream image of remote user
    Set the fill mode of substream image
    Set the clockwise rotation angle of substream image
    Set sound quality
    Specify whether to view the big or small image
    Set mic volume
    Start background music
    Stop background music
    Stop background music
    Stop background music
    Get the total length of background music in ms
    Set background music playback progress
    Set background music volume
    Set the local playback volume of background music
    Set the remote playback volume of background music
    Play sound effect
    Set sound effect volume
    Stop sound effect
    Stop all sound effects
    Set the volume of all sound effects
    Pause sound effect
    Pause sound effect
    Enable custom video capturing mode
    Deliver captured video data to SDK
    Pause/Resume publishing local video stream
    Pause/Resume subscribing to remote user's video stream
    Start network speed test (used before room entry)
    Start screen sharing
    Set video data callback for third-party beauty filters
    Get the list of cameras
    Set the camera to be used currently
    Get the currently used camera
    Get the list of mics
    Get the current mic device
    Select the currently used mic
    Get the current mic volume
    Set the current mic volume
    Set the mute status of the current system mic
    Get the mute status of the current system mic
    Get the list of speakers
    Get the currently used speaker
    Set the speaker to use
    Get the current speaker volume
    Set the current speaker volume
    Get the mute status of the current system speaker
    Set whether to mute the current system speaker
    Start camera test
    Start camera test
    Start mic test
    Start mic test
    Start speaker test
    Stop speaker test
    start in-app screen sharing (for iOS 13.0 and above only)
    Set the direction of image output by video encoder
    Set the mirror mode of image output by encoder
    Start publishing audio/video streams to Tencent Cloud CSS CDN
    Stop publishing audio/video streams to Tencent Cloud CSS CDN
    Start publishing audio/video streams to non-Tencent Cloud CDN
    Stop publishing audio/video streams to non-Tencent Cloud CDN
    Set the layout and transcoding parameters of On-Cloud MixTranscoding
    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