Starter Deal! First 3 month from only  $9.9 /month!
Starter Deal! First 3 month from only  $9.9 /month!
Grab It Now 
RTC Engine
Overview
  • Web
    • Run Sample Demo
    • SDK Quickstart
    • Basic Features
      • Screen Sharing
      • Live Streaming
      • Media Device
      • Audio Volume
      • Set Encoding Profile
      • Detect Network Quality
      • Detect Capabilities
    • Advance Features
      • Enable AI Denoiser
      • Enable Audio Mixer
      • Enable Watermark
      • Enable Beauty and Effects
      • Data Messages
      • Custom Capturing and Rendering
    • API List
    • Released Notes
    • Supported Platforms
    • Web FAQs
      • Optimize Multi-Person Video Calls
      • Handle Autoplay Restriction
      • Handle Firewall Restriction
      • Others
  • Android
    • Integration
      • 1.API Examples
      • 2.Importing the SDK
      • 3.Entering a Room
      • 4.Subscribing to Audio/Video Streams
      • 5.Publish Audio/Video Streams
      • 6.Exiting a Room
      • 7.Sensing Network Quality
      • 8.Enabling Screen Sharing
      • 9.Setting Video Quality
      • 10.Rotating Videos
    • Testing Newwork Quality
    • Custom Capturing and Rendering
    • Custom Audio Capturing and Playback
    • Client APIs
      • Overview
      • TRTCCloud
      • TRTCStatistics
      • TRTCCloudListener
      • TXAudioEffectManager
      • TXBeautyManager
      • TXDeviceManager
      • Type Definition
      • Deprecated Interface
      • Error Codes
    • Solution
      • Real-Time Chorus (TUIKaraoke)
        • Quick Integration
        • Implementation Steps
        • Song Synchronization
        • Lyric Synchronization
        • Vocal Synchronization
        • Mixing Stream Solution
        • TRTCKaraoke APIs
        • FAQs
    • Release Notes
  • iOS
    • Integration
      • 1.API Examples
      • 2.Importing the SDK
      • 3.Entering a Room
      • 4.Subscribing to Audio/Video Streams
      • 5.Publish Audio/Video Streams
      • 6.Exiting a Room
      • 7.Sensing Network Quality
      • 8.Enabling Screen Sharing
      • 9.Setting Video Quality
      • 10.Rotating Videos
    • Testing Network Quality
    • Custom Capturing and Rendering
    • Custom Audio Capturing and Playback
    • Client APIs
      • Overview
      • TRTCCloud
      • TRTCCloudDelegate
      • TRTCStatistics
      • TXAudioEffectManager
      • TXBeautyManager
      • TXDeviceManager
      • Type Definition
      • Deprecated Interface
      • ErrorCode
    • Solution
      • Quick Integration
      • Implementation Steps
      • Song Synchronization
      • Lyric Synchronization
      • Vocal Synchronization
      • Mixing Stream Solution
      • TRTCKaraoke APIs
      • FAQs
    • Release Notes
  • macOS
    • Integration
      • 1.API Examples
      • 2.Importing the SDK
      • 3.Entering a Room
      • 4.Subscribing to Audio/Video Streams
      • 5.Publish Audio/Video Streams
      • 6.Exiting a Room
      • 7.Sensing Network Quality
      • 8.Enabling Screen Sharing
      • 9.Sharing Computer Audio
      • 10.Setting Video Quality
      • 11.Rotating Videos
    • Testing Hardware Devices
    • Testing Network Quality
    • Custom Capturing and Rendering
    • Custom Audio Capturing and Playback
    • Client APIs
      • Overview
      • TRTCCloud
      • TRTCCloudDelegate
      • TRTCStatistics
      • TXAudioEffectManager
      • TXBeautyManager
      • TXDeviceManager
      • Type Definition
      • Deprecated Interface
      • ErrorCode
      • Release Notes
    • Release Notes
  • Windows
    • Integration
      • 1.API Examples
      • 2.Importing the SDK
      • 3.Entering a Room
      • 4.Subscribing to Audio/Video Streams
      • 5.Publish Audio/Video Streams
      • 6.Exiting a Room
      • 7.Sensing Network Quality
      • 8.Enabling Screen Sharing
      • 9.Setting Video Quality
      • 10.Rotating Videos
    • Testing Hardware Devices
    • Testing Network Quality
    • Custom Capturing and Rendering
    • Custom Audio Capturing and Playback
    • Client APIs
      • Overview
      • ITRTCCloud
      • ITRTCStatistics
      • TRTCCloudCallback
      • ITXAudioEffectManager
      • ITXDeviceManager
      • Type Definition
      • Deprecated Interface
      • Error Codes
    • Release Notes
  • Electron
    • Integration
      • 1.API Examples
      • 2.Importing the SDK
      • 3.Entering a Room
      • 4.Subscribing to Audio/Video Streams
      • 5.Publish Audio/Video Streams
      • 6.Exiting a Room
      • 7.Sensing Network Quality
      • 8.Enabling Screen Sharing
      • 9.Sharing Computer Audio
      • 10.Setting Video Quality
      • 11.Rotating Videos
    • Client APIs
      • Overview
      • Error Codes
  • Flutter
    • Integration
      • 1.API Examples
      • 2.Importing the SDK
      • 3.Entering a Room
      • 4.Subscribing to Audio/Video Streams
      • 5.Publish Audio/Video Streams
      • 6.Exiting a Room
      • 7.Sensing Network Quality
      • 8.Enabling Screen Sharing
      • 9.Sharing Computer Audio
      • 10.Setting Video Quality
      • 11.Rotating Videos
    • Client APIs
      • Overview
      • Error Codes
  • Unity
    • Integration
      • 1.API Examples
      • 2Importing the SDK
    • Client APIs
      • Overview
      • Error Codes
  • Qt
    • Integration
      • 1.Importing the SDK
  • Overview
    • Overview
  • Concepts
  • Features
  • Performance Statistics
  • Pricing
    • RTC-Engine Packages
    • Billing of On-Cloud Recording
    • Billing of MixTranscoding and Relay to CDN
    • Billing Explanation for Subscription Package Duration
    • Billing of Monitoring Dashboard
    • Free Minutes
    • Pay-As-You-Go
  • Tencent RTC Quickplay: Experience Ultimate Real-Time Audio and Video Interaction!
  • FAQs
    • FAQs for Beginners
    • Migration Guide
      • Twilio Video to Tencent RTC
      • Billing
      • Features
      • UserSig
      • Firewall Restrictions
      • How to Downsize Installation Package
      • TRTCCalling for Web
      • Audio and Video Quality
      • Others
RTC Engine

TXAudioEffectManager

Copyright (c) 2021 Tencent. All rights reserved.

Module: management class for background music, short audio effects, and voice effects

Description: sets background music, short audio effects, and voice effects

TXAudioEffectManager

TXAudioEffectManager

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
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
Preload background music
Get the number of tracks of background music
Specify the playback track of background music

StructType

FuncList
DESC
Background music playback information

EnumType

EnumType
DESC
Reverb effects
Voice changing effects

enableVoiceEarMonitor:

enableVoiceEarMonitor:
- (void)enableVoiceEarMonitor:
(BOOL)enable

Enabling in-ear monitoring

After enabling in-ear monitoring, anchors can hear in earphones their own voice captured by the mic. This is designed for singing scenarios.

In-ear monitoring cannot be enabled for Bluetooth earphones. This is because Bluetooth earphones have high latency. Please ask anchors to use wired earphones via a UI reminder.
Given that not all phones deliver excellent in-ear monitoring effects, we have blocked this feature on some phones.
Param
DESC
enable
YES: enable; NO : disable
Note
In-ear monitoring can be enabled only when earphones are used. Please remind anchors to use wired earphones.

setVoiceEarMonitorVolume:

setVoiceEarMonitorVolume:
- (void)setVoiceEarMonitorVolume:
(NSInteger)volume

Setting in-ear monitoring volume

This API is used to set the volume of in-ear monitoring.
Param
DESC
volume
Volume. Value range: 0-100; default: 100
Note
If 100 is still not loud enough for you, you can set the volume to up to 150, but there may be side effects.

setVoiceReverbType:

setVoiceReverbType:
- (void)setVoiceReverbType:
(TXVoiceReverbType)reverbType

Setting voice reverb effects

This API is used to set reverb effects for human voice. For the effects supported, please see TXVoiceReverbType.
Note
Effects become invalid after room exit. If you want to use the same effect after you enter the room again, you need to set the effect again using this API.

setVoiceChangerType:

setVoiceChangerType:
- (void)setVoiceChangerType:
(TXVoiceChangeType)changerType

Setting voice changing effects

This API is used to set voice changing effects. For the effects supported, please see TXVoiceChangeType.
Note
Effects become invalid after room exit. If you want to use the same effect after you enter the room again, you need to set the effect again using this API.

setVoiceVolume:

setVoiceVolume:
- (void)setVoiceVolume:
(NSInteger)volume

Setting speech volume

This API is used to set the volume of speech. It is often used together with the music volume setting API setAllMusicVolume to balance between the volume of music and speech.
Param
DESC
volume
Volume. Value range: 0-100; default: 100
Note
If 100 is still not loud enough for you, you can set the volume to up to 150, but there may be side effects.

setVoicePitch:

setVoicePitch:
-(void)setVoicePitch:
(double)pitch

Setting speech pitch

This API is used to set the pitch of speech.
Param
DESC
pitch
Ptich,Value range: -1.0f~1.0f; default: 0.0f。

startPlayMusic:onStart:onProgress:onComplete:

startPlayMusic:onStart:onProgress:onComplete:
- (void)startPlayMusic:
(TXAudioMusicParam *)musicParam
onStart:
(TXAudioMusicStartBlock _Nullable)startBlock
onProgress:
(TXAudioMusicProgressBlock _Nullable)progressBlock
onComplete:
(TXAudioMusicCompleteBlock _Nullable)completeBlock

Starting background music

You must assign an ID to each music track so that you can start, stop, or set the volume of music tracks by ID.
Param
DESC
completeBlock
Callback of ending music
musicParam
Music parameter
progressBlock
Callback of playback progress
startBlock
Callback of starting music
Note
1. If you play the same music track multiple times, please use the same ID instead of a separate ID for each playback.
2. If you want to play different music tracks at the same time, use different IDs for them.
3. If you use the same ID to play a music track different from the current one, the SDK will stop the current one before playing the new one.

stopPlayMusic:

stopPlayMusic:
- (void)stopPlayMusic:
(int32_t)id

Stopping background music

Param
DESC
id
Music ID

pausePlayMusic:

pausePlayMusic:
- (void)pausePlayMusic:
(int32_t)id

Pausing background music

Param
DESC
id
Music ID

resumePlayMusic:

resumePlayMusic:
- (void)resumePlayMusic:
(int32_t)id

Resuming background music

Param
DESC
id
Music ID

setAllMusicVolume:

setAllMusicVolume:
- (void)setAllMusicVolume:
(NSInteger)volume

Setting the local and remote playback volume of background music

This API is used to set the local and remote playback volume of background music.
Local volume: the volume of music heard by anchors
Remote volume: the volume of music heard by audience
Param
DESC
volume
Volume. Value range: 0-100; default: 60
Note
If 100 is still not loud enough for you, you can set the volume to up to 150, but there may be side effects.

setMusicPublishVolume:volume:

setMusicPublishVolume:volume:
- (void)setMusicPublishVolume:
(int32_t)id
volume:
(NSInteger)volume

Setting the remote playback volume of a specific music track

This API is used to control the remote playback volume (the volume heard by audience) of a specific music track.
Param
DESC
id
Music ID
volume
Volume. Value range: 0-100; default: 60
Note
If 100 is still not loud enough for you, you can set the volume to up to 150, but there may be side effects.

setMusicPlayoutVolume:volume:

setMusicPlayoutVolume:volume:
- (void)setMusicPlayoutVolume:
(int32_t)id
volume:
(NSInteger)volume

Setting the local playback volume of a specific music track

This API is used to control the local playback volume (the volume heard by anchors) of a specific music track.
Param
DESC
id
Music ID
volume
Volume. Value range: 0-100. default: 60
Note
If 100 is still not loud enough for you, you can set the volume to up to 150, but there may be side effects.

setMusicPitch:pitch:

setMusicPitch:pitch:
- (void)setMusicPitch:
(int32_t)id
pitch:
(double)pitch

Adjusting the pitch of background music

Param
DESC
id
Music ID
pitch
Pitch. Value range: floating point numbers in the range of [-1, 1]; default: 0.0f

setMusicSpeedRate:speedRate:

setMusicSpeedRate:speedRate:
- (void)setMusicSpeedRate:
(int32_t)id
speedRate:
(double)speedRate

Changing the speed of background music

Param
DESC
id
Music ID
speedRate
Music speed. Value range: floating point numbers in the range of [0.5, 2]; default: 1.0f

getMusicCurrentPosInMS:

getMusicCurrentPosInMS:
- (NSInteger)getMusicCurrentPosInMS:
(int32_t)id

Getting the playback progress (ms) of background music

Param
DESC
id
Music ID

Return Desc:

The milliseconds that have passed since playback started. -1 indicates failure to get the the playback progress.

getMusicDurationInMS:

getMusicDurationInMS:
- (NSInteger)getMusicDurationInMS:
(NSString *)path

Getting the total length (ms) of background music

Param
DESC
path
Path of the music file.

Return Desc:

The length of the specified music file is returned. -1 indicates failure to get the length.

seekMusicToPosInMS:pts:

seekMusicToPosInMS:pts:
- (void)seekMusicToPosInMS:
(int32_t)id
pts:
(NSInteger)pts

Setting the playback progress (ms) of background music

Param
DESC
id
Music ID
pts
Unit: millisecond
Note
Do not call this API frequently as the music file may be read and written to each time the API is called, which can be time-consuming.
Wait till users finish dragging the progress bar before you call this API.
The progress bar controller on the UI tends to update the progress at a high frequency as users drag the progress bar. This will result in poor user experience unless you limit the frequency.

setMusicScratchSpeedRate:speedRate:

setMusicScratchSpeedRate:speedRate:
- (void)setMusicScratchSpeedRate:
(int32_t)id
speedRate:
(double)scratchSpeedRate

Adjust the speed change effect of the scratch disc

Param
DESC
id
Music ID
scratchSpeedRate
Scratch disc speed, the default value is 1.0f, the range is: a floating point number between [-12.0 ~ 12.0], the positive/negative speed value indicates the direction is positive/negative, and the absolute value indicates the speed.
Note
Precondition preloadMusic succeeds.

preloadMusic:onProgress:onError:

preloadMusic:onProgress:onError:
- (void)preloadMusic:
(TXAudioMusicParam *)preloadParam
onProgress:
(TXMusicPreloadProgressBlock _Nullable)progressBlock
onError:
(TXMusicPreloadErrorBlock _Nullable)errorBlock

Preload background music

You must assign an ID to each music track so that you can start, stop, or set the volume of music tracks by ID.
Param
DESC
musicParam
Music parameter
Note
1. Preload supports up to 2 preloads with different IDs at the same time, and the preload time does not exceed 10 minutes,you need to stopPlayMusic after use, otherwise the memory will not be released.
2. If the music corresponding to the ID is being played, the preloading fails, and stopPlayMusic must be called first.
3. When the musicParam passed to startPlayMusic is exactly the same, preloading works.

getMusicTrackCount:

getMusicTrackCount:
- (NSInteger)getMusicTrackCount:
(int32_t)id

Get the number of tracks of background music

Param
DESC
id
Music ID

setMusicTrack:track:

setMusicTrack:track:
- (void)setMusicTrack:
(int32_t)id
track:
(NSInteger)track

Specify the playback track of background music

Param
DESC
id
Music ID
index
Specify which track to play (the first track is played by default). Value range [0, total number of tracks).
Note
The total number of tracks can be obtained through the getMusicTrackCount interface.

TXVoiceReverbType

TXVoiceReverbType

Reverb effects

Reverb effects can be applied to human voice. Based on acoustic algorithms, they can mimic voice in different environments. The following effects are supported currently:
0: original; 1: karaoke; 2: room; 3: hall; 4: low and deep; 5: resonant; 6: metal; 7: husky; 8: ethereal; 9: studio; 10: melodious; 11: studio2;
Enum
Value
DESC
TXVoiceReverbType_0
0
disable
TXVoiceReverbType_1
1
KTV
TXVoiceReverbType_2
2
small room
TXVoiceReverbType_3
3
great hall
TXVoiceReverbType_4
4
deep voice
TXVoiceReverbType_5
5
loud voice
TXVoiceReverbType_6
6
metallic sound
TXVoiceReverbType_7
7
magnetic sound
TXVoiceReverbType_8
8
ethereal
TXVoiceReverbType_9
9
studio
TXVoiceReverbType_10
10
melodious
TXVoiceReverbType_11
11
studio2

TXVoiceChangeType

TXVoiceChangeType

Voice changing effects

Voice changing effects can be applied to human voice. Based on acoustic algorithms, they change the tone of voice. The following effects are supported currently:
0: original; 1: child; 2: little girl; 3: middle-aged man; 4: metal; 5: nasal; 6: foreign accent; 7: trapped beast; 8: otaku; 9: electric; 10: robot; 11: ethereal
Enum
Value
DESC
TXVoiceChangeType_0
0
disable
TXVoiceChangeType_1
1
naughty kid
TXVoiceChangeType_2
2
Lolita
TXVoiceChangeType_3
3
uncle
TXVoiceChangeType_4
4
heavy metal
TXVoiceChangeType_5
5
catch cold
TXVoiceChangeType_6
6
foreign accent
TXVoiceChangeType_7
7
caged animal trapped beast
TXVoiceChangeType_8
8
indoorsman
TXVoiceChangeType_9
9
strong current
TXVoiceChangeType_10
10
heavy machinery
TXVoiceChangeType_11
11
intangible

TXAudioMusicParam

TXAudioMusicParam

Background music playback information

The information, including playback ID, file path, and loop times, is passed in the startPlayMusic API.
1. If you play the same music track multiple times, please use the same ID instead of a separate ID for each playback.
2. If you want to play different music tracks at the same time, use different IDs for them.
3. If you use the same ID to play a music track different from the current one, the SDK will stop the current one before playing the new one.
EnumType
DESC
ID
Field description: music ID
Note
the SDK supports playing multiple music tracks. IDs are used to distinguish different music tracks and control their start, end, volume, etc.
endTimeMS
Field description: the point in time in milliseconds for ending music playback. 0 indicates that playback continues till the end of the music track.
isShortFile
Field description: whether the music played is a short music track
Valid values: YES : short music track that needs to be looped; NO (default): normal-length music track
loopCount
Field description: number of times the music track is looped
Valid values: 0 or any positive integer. 0 (default) indicates that the music is played once, 1 twice, and so on.
path
Field description: absolute path of the music file or url.the mp3,aac,m4a,wav supported.
publish
Field description: whether to send the music to remote users
Valid values: YES : remote users can hear the music played locally; NO (default): only the local user can hear the music.
startTimeMS
Field description: the point in time in milliseconds for starting music playback