@tencent-rtc/mcp 1.4.7 → 1.6.0-beta.1

package/resource/doc/trtc/C++/ITRTCStatistics.md

@@ -1,70 +0,0 @@
-# TRTC Real-Time Communication (TRTC SDK) Documentation
-## Overview
-`ITRTCStatistics.h` provides read-only statistics for TRTC Real-Time Communication (TRTC SDK) on C++. The TRTC SDK reports real-time audio and video metrics—including frame rate, bitrate, and stutter status—every two seconds.
-
-## Struct Type
-| Function List | Description |
-| --- | --- |
-| TRTCLocalStatistics | Local Audio and Video Statistics |
-| TRTCRemoteStatistics | Remote Audio and Video Statistics |
-| TRTCStatistics | Summary Statistics of Network and Performance |
-
-## TRTCLocalStatistics
-
-#### Local Audio and Video Statistics
-| Enumeration Types | Description |
-| --- | --- |
-| audioBitrate | [Field Meaning] Local audio bitrate, that is, how much new audio data is generated per second, in Kbps. |
-| audioCaptureState | [Field Meaning] Audio device collection status (used to detect the health of audio peripherals).<br>0: Collection Device Status Normal; 1: Long Period of Silence Detected; 2: Crackling Sound Detected; 3: Abnormal Sound Intermittence Detected. |
-| audioSampleRate | [Field Meaning] Local audio sampling rate, in Hz. |
-| frameRate | [Field Meaning] Local video frame rate, that is, how many video frames per second, unit: FPS. |
-| height | [Field Meaning] Local video height, in px. |
-| streamType | [Field Meaning] Video stream type (HD large screen \\| Low-definition Small Picture \\| Auxiliary Stream Picture). |
-| videoBitrate | [Field Meaning] Local video bitrate, that is, how much new video data is generated per second, in Kbps. |
-| width | [Field Meaning] Local video width, in pixels (px). |
-
-## TRTCRemoteStatistics
-
-#### Remote Audio and Video Statistics
-| Enumeration Types | Description |
-| --- | --- |
-| audioBitrate | [Field Meaning] Local audio bitrate, in Kbps |
-| audioBlockRate | [Field Meaning] Audio playback stuttering rate, in percentage (%)<br>Audio playback stuttering rate (audioBlockRate) = cumulative stuttering duration during audio playback (audioTotalBlockTime) / total duration of audio playback |
-| audioPacketLoss | [Field Meaning] Total audio stream packet loss rate (%).<br>audioPacketLoss represents the packet loss rate at the audience end after an audio stream completes the transmission chain from ` Broadcaster > Cloud > Audience `.<br>The smaller the audioPacketLoss, the better. A packet loss rate of 0 means all audio stream data has been completely received by the audience.<br>If downLoss == 0 but audioPacketLoss != 0 occurs, it indicates that the audio stream has no packet loss on the "cloud=>audience" segment, but there is irrecoverable packet loss on the ` host>cloud ` segment. |
-| audioSampleRate | [Field Meaning] Local audio sampling rate, in Hz. |
-| audioTotalBlockTime | [Field Meaning] Cumulative stuttering duration during audio playback, in milliseconds (ms) |
-| finalLoss | [Field Meaning] Overall packet loss rate of the audio and video stream (%). Deprecated; it is recommended to use audioPacketLoss and videoPacketLoss instead. |
-| frameRate | [Field Meaning] Remote video frame rate, in FPS. |
-| height | [Field Meaning] Remote video height, in pixels (px). |
-| jitterBufferDelay | [Field Meaning] Playback latency, in milliseconds (ms)<br>To avoid audio and screen freezing caused by network jitter and packet disorder, TRTC manages a playback buffer at the playback end to organize received network packets. The size of this buffer is adaptively adjusted based on current network quality. This buffer size is translated into a time length in milliseconds, referred to as jitterBufferDelay. |
-| point2PointDelay | [Field Meaning] End-to-end latency, in milliseconds (ms)<br>point2PointDelay represents the delay from "Anchors => Cloud => Audience". More precisely, it represents the full-link latency of "Collection => Encoding => Network Transmission => Receive => Buffering => Decoding => Play".<br>point2PointDelay requires both local and remote SDKs to be version 8.5 or above to be effective. If the remote user is on a version before 8.5, this value will always be 0, meaning it is not applicable. |
-| remoteNetworkRTT | [Field Meaning] The round-trip time from the SDK to the cloud, in milliseconds (ms)<br>This value represents the total time it takes for a network packet to travel from the SDK to the cloud and back, summing up the "SDK => Cloud => SDK" time.<br>The smaller this value, the better: if remoteNetworkRTT < 50ms, it indicates low audio and video call latency; if remoteNetworkRTT > 200ms, it suggests high audio and video call latency.<br>It is important to note that remoteNetworkRTT represents the total time for "SDK => Cloud => SDK", so there is no need to differentiate between remoteNetworkUpRTT and remoteNetworkDownRTT |
-| remoteNetworkUplinkLoss | [Field Meaning] The uplink packet loss rate from the SDK to the cloud, in percentage (%)<br>The smaller the value, the better. If remoteNetworkUplinkLoss is 0%, it means the uplink network quality is good, with almost no data packet loss when uploading to the cloud.<br>If remoteNetworkUplinkLoss is 30%, it means that 30% of the audio and video data packets sent by the SDK to the cloud are lost in the transmission link. |
-| streamType | [Field Meaning] Video stream type (HD large screen \\| Low-definition Small Picture \\| Auxiliary Stream Picture). |
-| userId | [Field Meaning] User ID |
-| videoBitrate | [Field Meaning] Remote video bitrate, in Kbps. |
-| videoBlockRate | [Field Meaning] Video playback stutter rate, in percentage (%). Video playback stutter rate (videoBlockRate) = cumulative stutter duration during video playback (videoTotalBlockTime) / total duration of video playback. |
-| videoPacketLoss | [Field Meaning] Total packet loss rate of the video stream (%).<br>videoPacketLoss represents the packet loss rate at the audience end after the video stream completes the transmission chain from ` Anchors > Cloud > Audience `.<br>The smaller the videoPacketLoss, the better. A packet loss rate of 0 means all video stream data has been completely received by the audience.<br>If downLoss == 0 but videoPacketLoss != 0 occurs, it indicates that the video stream has no packet loss on the ` Cloud > Audience ` segment, but there is irrecoverable packet loss on the ` Anchors > Cloud ` segment. |
-| videoTotalBlockTime | [Field Meaning] Cumulative stutter duration during video playback, in milliseconds (ms) |
-| width | [Field Meaning] Remote video width, in pixels (px). |
-
-## TRTCStatistics
-
-#### Summary Statistics of Network and Performance
-| Enumeration Types | Description |
-| --- | --- |
-| appCpu | [Field Meaning] Current application CPU utilization, in percentage (%); not supported on Android 8.0 and above. |
-| appMemoryUsageInMB | [Field Meaning] Current application memory usage, in MB. |
-| downLoss | [Field Meaning] Downlink packet loss rate from the cloud to SDK, in percentage (%)<br>The smaller the value, the better. If downLoss is 0%, it means the downlink network quality is good, with almost no data packet loss from the cloud.<br>If downLoss is 30%, it means that 30% of the audio and video data packets transmitted from the cloud to the SDK are lost in the transmission link. |
-| gatewayRtt | [Field Meaning] Round-trip latency from the SDK to the local router, in milliseconds (ms). This value represents the total time it takes for a network packet to travel from the SDK to the local router gateway and back, summing up the [SDK -> Gateway -> SDK] time.<br>The smaller the value, the better. If gatewayRtt < 50ms, it means lower audio and video call latency. If gatewayRtt > 200ms, it means higher audio and video call latency.<br>This value is invalid when the network type is cellular. |
-| localStatisticsArray | [Field Meaning] Local audio and video statistical information<br>Since there may be three local audio and video streams (i.e., high-definition main screen, low-definition small screen, and auxiliary screen), the local audio and video statistical information is an array. |
-| localStatisticsArraySize | [Field Meaning] Size of the array localStatisticsArray |
-| receivedBytes | [Field Meaning] Total received bytes (including signaling data and audio and video data), in bytes. |
-| remoteStatisticsArray | [Field Meaning] Remote audio and video statistical information<br>Since there may be multiple remote users at the same time, and each remote user may simultaneously have multiple audio and video streams (i.e., high-definition main screen, low-definition small screen, and auxiliary screen), the remote audio and video statistical information is an array. |
-| remoteStatisticsArraySize | [Field Meaning] Size of the array remoteStatisticsArray. |
-| rtt | [Field Meaning] Round-trip latency from the SDK to the cloud, in milliseconds (ms)<br>This value represents the total time it takes for a network packet to travel from the SDK to the cloud and back, summing up the "SDK => Cloud => SDK" time.<br>The smaller the value, the better: if RTT < 50ms, it means lower audio and video call latency; if RTT > 200ms, it means higher audio and video call latency.<br>It needs to be specifically explained that RTT represents the total time for "SDK => Cloud => SDK," so there is no need to distinguish between upRtt and downRtt. |
-| sentBytes | [Field Meaning] Total bytes sent (including signaling data and audio and video data), in bytes (Bytes). |
-| systemCpu | [Field Meaning] Current system CPU utilization, in percentage (%); not supported on Android 8.0 and above. |
-| systemMemoryInMB | [Field Meaning] Current system memory, in MB. |
-| systemMemoryUsageInMB | [Field Meaning] Current system memory usage, in MB, not supported on iOS/MAC. |
-| upLoss | [Field Meaning] Uplink packet loss rate from the SDK to the cloud, in percentage (%)<br>The smaller the value, the better. If upLoss is 0%, it means the uplink network quality is good, with almost no data packet loss when uploading to the cloud.<br>If upLoss is 30%, it means that 30% of the audio and video data packets sent by the SDK to the cloud are lost in the transmission link. |

package/resource/doc/trtc/C++/ITXAudioEffectManager.md

@@ -1,469 +0,0 @@
-# TRTC Real-Time Communication (TRTC SDK) Documentation
-## Feature Overview
-`ITXAudioEffectManager.h` is the manager class for handling background music, sound effects, and vocal effects on the TRTC Real-Time Communication (TRTC SDK) C++. Use this class to configure and control background music, sound effects, and vocal processing features.
-
-## ITXMusicPreloadObserver
-| Function List | Description |
-| --- | --- |
-| onLoadProgress | Background music preloading progress |
-| onLoadError | Error in background music preloading |
-
-## ITXMusicPlayObserver
-| Function List | Description |
-| --- | --- |
-| onStart | Start playing background music |
-| onPlayProgress | Background music playback progress |
-| onComplete | Background music playback completed |
-
-## ITXAudioEffectManager
-| Function List | Description |
-| --- | --- |
-| enableVoiceEarMonitor | Enable ear return |
-| setVoiceEarMonitorVolume | Set ear return volume |
-| setVoiceReverbType | Set vocal reverb effect |
-| setVoiceChangerType | Set vocal voice changing effect |
-| setVoiceCaptureVolume | Set speech volume |
-| setVoicePitch | Set speech tone |
-| setMusicObserver | Set the event callback interface for background music |
-| startPlayMusic | Start playing background music |
-| stopPlayMusic | Stop playing background music |
-| pausePlayMusic | Pause background music |
-| resumePlayMusic | Resume background music |
-| setAllMusicVolume | Set the local and remote volume of all background music |
-| setMusicPublishVolume | Set the remote volume of a specific background music track |
-| setMusicPlayoutVolume | Set the local volume of a specific background music track |
-| setMusicPitch | Adjust the pitch of background music |
-| setMusicSpeedRate | Adjust the variable speed effect of background music |
-| getMusicCurrentPosInMS | Get the playback progress of background music (unit: milliseconds) |
-| getMusicDurationInMS | Get the total duration of background music (unit: milliseconds) |
-| seekMusicToPosInTime | Set the playback progress of background music (unit: milliseconds) |
-| setMusicScratchSpeedRate | Adjust the variable speed effect of scratching |
-| setPreloadObserver | Set the preloading event callback |
-| preloadMusic | Preload background music |
-| getMusicTrackCount | Obtain the number of background music tracks |
-| setMusicTrack | Specify the playback track of background music |
-
-## Struct Type
-| Function List | Description |
-| --- | --- |
-| AudioMusicParam | Playback control information for background music |
-
-## Enumeration Types
-| Enumeration Types | Description |
-| --- | --- |
-| TXVoiceReverbType | Reverb effects |
-| TXVoiceChangerType | Voice changing effects |
-
-## onLoadProgress
-
-#### Background music preloading progress
-
-## onLoadError
-
-#### Error in background music preloading
-| Parameters | Description |
-| --- | --- |
-| errorCode | -4001: Failed to open file due to invalid audio data or FFmpeg protocol not found, etc.; -4002: Decoding failed due to corrupted audio file or inaccessible network audio file server, etc.; -4003: Preloading quantity exceeds the limit. Please call stopPlayMusic to release unused preloads first; -4005: Failed to open file due to invalid path. Please check if your path parameter points to a valid music file; -4006: Failed to open file due to illegal URL. Please check if the URL provided can download the expected music file using a browser; -4007: Failed to open file due to no audio stream. Please confirm if the file you provided is a legal audio file and whether it is damaged; -4008: Failed to open file due to unsupported format. Please confirm if the file format you provided is supported. Supported formats on mobile are [mp3, aac, m4a, wav, ogg, mp4, mkv], and supported formats on desktop are [mp3, aac, m4a, wav, mp4, mkv]. |
-
-## onStart
-
-#### Start playing background music
-
-Called when background music starts playing successfully or fails to play.
-| Parameters | Description |
-| --- | --- |
-| errCode | Error Code. 0: Play started successfully; -4001: Failed to open file, such as invalid audio data, FFMPEG protocol not found, etc.; -4005: Invalid path, check if the provided path points to a valid music file; -4006: Invalid URL, check in the browser if the provided URL can download the expected music file; -4007: No audio stream, confirm if the provided file is a valid audio file and is not corrupted; -4008: Unsupported format, verify if the provided file is in a supported format. Mobile supports [mp3, aac, m4a, wav, ogg, mp4, mkv], desktop supports [mp3, aac, m4a, wav, mp4, mkv]. |
-| id | Music ID. |
-
-## onPlayProgress
-
-#### Background music playback progress
-
-## onComplete
-
-#### Background music playback completed
-
-Called when background music finishes playing or encounters an error.
-| Parameters | Description |
-| --- | --- |
-| errCode | Error Code. 0: Play ended; -4002: Decoding failed, such as corrupted audio file, or unreachable network audio file server. |
-| id | Music ID. |
-
-## enableVoiceEarMonitor
-
-#### Enable ear return
-
-After the host enables ear return, they can hear their own voice collected by the microphone in the headphones. This effect is suitable for scenarios where the host is singing.
-
-It should be noted that due to the high hardware latency of Bluetooth headphones, this effect cannot be enabled when the host is wearing Bluetooth headphones. Please try to prompt the host to wear wired headphones in the user interface.
-
-Also, please note that not all mobile phones can achieve excellent ear return effects after enabling this feature. We have blocked this effect for phones with poor ear return performance.
-| Parameters | Description |
-| --- | --- |
-| enable | true: on; false: off. |
-
-> **Note**
->
-
-> This effect can only be enabled when the host is wearing headphones. Please also prompt the host to wear wired headphones.
->
-
-## setVoiceEarMonitorVolume
-
-#### Set ear return volume
-
-Through this interface, you can set the volume of the sound in the ear return effect.
-| Parameters | Description |
-| --- | --- |
-| volume | Volume. Value range: 0 - 100. Default value: 100. |
-
-> **Note**
->
-
-> If you still feel the volume is too low after setting it to 100, you can set the maximum volume to 150. However, a volume above 100 carries a risk of pop noise, so proceed with caution.
->
-
-## setVoiceReverbType
-
-#### Set vocal reverb effect
-
-Through this interface, you can set the vocal reverb effect. For specific effects, please refer to the enumeration Definition TXVoiceReverbType.
-
-> **Note**
->
-
-> The set effect will automatically become invalid after leaving the room. If the corresponding effect is needed next time you enter the room, you need to call this interface to set it again.
->
-
-## setVoiceChangerType
-
-#### Set vocal voice changing effect
-
-Through this interface, you can set the voice changing effect. For specific effects, please refer to the enumeration Definition TXVoiceChangeType.
-
-> **Note**
->
-
-> The set effect will automatically become invalid after leaving the room. If the corresponding effect is needed next time you enter the room, you need to call this interface to set it again.
->
-
-## setVoiceCaptureVolume
-
-#### Set speech volume
-
-This interface allows you to set the voice volume. It is generally used in conjunction with the music volume setting interface setAllMusicVolume, to balance the respective volumes of voice and music before mixing.
-| Parameters | Description |
-| --- | --- |
-| volume | Volume. Value range: 0-100. Default value: 100. |
-
-> **Note**
->
-
-> If you still feel the volume is too low after setting it to 100, you can set the maximum volume to 150. However, a volume above 100 carries a risk of pop noise, so proceed with caution.
->
-
-## setVoicePitch
-
-#### Set speech tone
-
-This interface can set the voice pitch, achieving pitch change without speed variation.
-| Parameters | Description |
-| --- | --- |
-| pitch | Pitch, value range: -1.0f to 1.0f, default value: 0.0f. |
-
-## setMusicObserver
-
-#### Set the event callback interface for background music
-
-Ensure to set the playback event callback using this API before playing the background music. This allows to be aware of the background music's playback progress.
-| Parameters | Description |
-| --- | --- |
-| musicId | Music ID. |
-| observer | Refer to ITXMusicPlayObserver Definition interface for details. |
-
-> **Note**
->
-
-> 1. If the ID does not need to be used, the observer can be set to NULL to completely release it.
->
-
-## startPlayMusic
-
-#### Start playing background music
-
-Each piece of music requires a specific ID. With this ID, you can control the start, stop, volume, etc., of the music.
-| Parameters | Description |
-| --- | --- |
-| musicParam | Music parameters. |
-
-> **Note**
->
-
-> 1. If you need to play the same background music multiple times, do not assign a new ID each time. We recommend using the same ID.
->
-
-> 2. If you want to play different pieces of music simultaneously, assign different IDs for each piece.
->
-
-> 3. If you use the same ID to play different music, the SDK will stop the old music before playing the new one.
->
-
-## stopPlayMusic
-
-#### Stop playing background music
-| Parameters | Description |
-| --- | --- |
-| id | Music ID. |
-
-## pausePlayMusic
-
-#### Pause background music
-| Parameters | Description |
-| --- | --- |
-| id | Music ID. |
-
-## resumePlayMusic
-
-#### Resume background music
-| Parameters | Description |
-| --- | --- |
-| id | Music ID. |
-
-## setAllMusicVolume
-
-#### Set the local and remote volume of all background music
-
-This interface allows you to set both the local and remote volume of all background music.
--  Local Volume: The volume of background music that the host can hear locally.
-
--  Remote Volume: The volume of background music that the audience can hear.
-
-| Parameters | Description |
-| --- | --- |
-| volume | Volume range, value range is 0-100, default value: 60. |
-
-> **Note**
->
-
-> If you still feel the volume is too low after setting it to 100, you can set the maximum volume to 150. However, a volume above 100 carries a risk of pop noise, so proceed with caution.
->
-
-## setMusicPublishVolume
-
-#### Set the remote volume of a specific background music track
-
-This interface can finely control the remote volume for each background music track, which is the volume the audience can hear.
-| Parameters | Description |
-| --- | --- |
-| id | Music ID. |
-| volume | Volume range, value range is 0-100; default value: 60. |
-
-> **Note**
->
-
-> If you still feel the volume is too low after setting it to 100, you can set the maximum volume to 150. However, a volume above 100 carries a risk of pop noise, so proceed with caution.
->
-
-## setMusicPlayoutVolume
-
-#### Set the local volume of a specific background music track
-
-This interface can finely control the local volume for each background music track, which is the volume the host can hear locally.
-| Parameters | Description |
-| --- | --- |
-| id | Music ID. |
-| volume | Volume range, value range is 0-100, default value: 60. |
-
-> **Note**
->
-
-> If you still feel the volume is too low after setting it to 100, you can set the maximum volume to 150. However, a volume above 100 carries a risk of pop noise, so proceed with caution.
->
-
-## setMusicPitch
-
-#### Adjust the pitch of background music
-| Parameters | Description |
-| --- | --- |
-| id | Music ID. |
-| pitch | Pitch, default value is 0.0f, value range is a floating point between [-1 ~ 1]. |
-
-## setMusicSpeedRate
-
-#### Adjust the variable speed effect of background music
-| Parameters | Description |
-| --- | --- |
-| id | Music ID. |
-| speedRate | Speed, default value is 1.0f, value range is a floating point between [0.5 ~ 2]. |
-
-## getMusicCurrentPosInMS
-
-#### Get the playback progress of background music (unit: milliseconds)
-| Parameters | Description |
-| --- | --- |
-| id | Music ID. |
-
-#### Return value description:
-
-On success, returns current playback time in milliseconds, on failure returns -1.
-
-## getMusicDurationInMS
-
-#### Get the total duration of background music (unit: milliseconds)
-| Parameters | Description |
-| --- | --- |
-| path | Music file path. |
-
-#### Return value description:
-
-On success, returns duration, on failure returns -1.
-
-## seekMusicToPosInTime
-
-#### Set the playback progress of background music (unit: milliseconds)
-| Parameters | Description |
-| --- | --- |
-| id | Music ID. |
-| pts | Unit: milliseconds. |
-
-> **Note**
->
-
-> Please avoid calling this interface too frequently as it may read and write music files again, which can be time-consuming.
->
-
-> Therefore, when users drag the playback progress bar of the music, please call this interface after the user completes the drag operation.
->
-
-> Because the progress bar control on the UI often feeds back the user's drag progress at a high frequency, it would lead to a poor user experience without frequency limitations.
->
-
-## setMusicScratchSpeedRate
-
-#### Adjust the variable speed effect of scratching
-| Parameters | Description |
-| --- | --- |
-| id | Music ID. |
-| scratchSpeedRate | Scratching speed, the default value is 1.0f, the range is a floating point number between [-12.0 ~ 12.0], the positive/negative value represents the forward/reverse direction, and the absolute value represents the speed. |
-
-> **Note**
->
-
-> Precondition: preloadMusic is successful.
->
-
-## setPreloadObserver
-
-#### Set the preloading event callback
-
-Set the callback using this API before preloading background music to monitor the preload progress.
-| Parameters | Description |
-| --- | --- |
-| observer | Refer to ITXMusicPreloadObserver Definition interface for details. |
-
-## preloadMusic
-
-#### Preload background music
-
-Each piece of music requires a specific ID. With this ID, you can control the start, stop, volume, etc., of the music.
-| Parameters | Description |
-| --- | --- |
-| preloadParam | Preload music parameters. |
-
-> **Note**
->
-
-> 1. Preloading supports up to 2 different IDs simultaneously, and the preload duration does not exceed 10 minutes. After use, stopPlayMusic must be called to prevent memory from not being released.
->
-
-> 2. If the music corresponding to this ID is playing, preloading will fail. You need to call stopPlayMusic first.
->
-
-> 3. When the musicParam is exactly the same as the musicParam passed to startPlayMusic, preloading is effective.
->
-
-## getMusicTrackCount
-
-#### Obtain the number of background music tracks
-| Parameters | Description |
-| --- | --- |
-| id | Music ID. |
-
-## setMusicTrack
-
-#### Specify the playback track of background music
-| Parameters | Description |
-| --- | --- |
-| id | Music ID. |
-| index | By default, the first audio track is played. The range of values is 0, total number of tracks). |
-
-> **Note**
->
-
-> The total number of tracks can be obtained through the getMusicTrackCount interface.
->
-
-## TXVoiceReverbType
-
-#### Reverb effects
-
-Reverb effects can be applied to vocals, using acoustic algorithms to overlap the sound and simulate various immersive experiences in different environments. Currently, the following reverb effects are supported:
-
-0:Off; 1:KTV; 2:Small Room; 3:Hall; 4:Deep; 5:Loud; 6:Metallic; 7:Magnetic; 8:Ethereal; 9:Studio; 10:Melodious; 11:Studio2.
-| Enumeration | Value | Description |
-| --- | --- | --- |
-| TXLiveVoiceReverbType_0 | 0 | Turn off effects |
-| TXLiveVoiceReverbType_1 | 1 | KTV |
-| TXLiveVoiceReverbType_2 | 2 | Small Room |
-| TXLiveVoiceReverbType_3 | 3 | Hall |
-| TXLiveVoiceReverbType_4 | 4 | Low-pitched |
-| TXLiveVoiceReverbType_5 | 5 | Loud |
-| TXLiveVoiceReverbType_6 | 6 | Metallic sound |
-| TXLiveVoiceReverbType_7 | 7 | Magnetic |
-| TXLiveVoiceReverbType_8 | 8 | Ethereal voice |
-| TXLiveVoiceReverbType_9 | 9 | Recording studio |
-| TXLiveVoiceReverbType_10 | 10 | Melodious |
-| TXLiveVoiceReverbType_11 | 11 | Recording studio 2 |
-
-## TXVoiceChangeType
-
-#### Voice changing effects
-
-Voice changing effect can be applied to vocals. By using acoustic algorithms for secondary processing, the voice can acquire a different sound quality from the original. Currently, the following voice changing effects are supported:
-
-0: Off; 1: Naughty kid; 2: Lolita; 3: Uncle; 4: Heavy metal; 5: Cold; 6: Foreign accent; 7: Trapped beast; 8: Fat nerd; 9: Strong current; 10: Heavy machinery; 11: Ethereal.
-| Enumeration | Value | Description |
-| --- | --- | --- |
-| TXVoiceChangerType_0 | 0 | Off |
-| TXVoiceChangerType_1 | 1 | Naughty kid |
-| TXVoiceChangerType_2 | 2 | Lolita |
-| TXVoiceChangerType_3 | 3 | Uncle |
-| TXVoiceChangerType_4 | 4 | Heavy metal |
-| TXVoiceChangerType_5 | 5 | Cold |
-| TXVoiceChangerType_6 | 6 | Foreign accent |
-| TXVoiceChangerType_7 | 7 | Trapped beast |
-| TXVoiceChangerType_8 | 8 | Otaku |
-| TXVoiceChangerType_9 | 9 | Strong electric current |
-| TXVoiceChangerType_10 | 10 | Heavy Machinery |
-| TXVoiceChangerType_11 | 11 | Ethereal voice |
-
-## TXAudioMusicParam
-
-#### Playback control information for background music
-
-This information is used to specify background music details in the interface [startPlayMusic, including play ID, file path, loop count, etc.:
-
-1. If you need to play the same background music multiple times, do not assign a new ID each time. We recommend using the same ID.
-
-2. If you want to play different pieces of music simultaneously, assign different IDs for each piece.
-
-3. If you use the same ID to play different music, the SDK will stop the old music before playing the new one.
-| Enumeration Types | Description |
-| --- | --- |
-| endTimeMS | [Field Meaning] Music play end time, in milliseconds. 0 means play until the end of the file. |
-| id | [Field Meaning] Music ID.<br>[Special Instructions] The SDK allows playing multiple music tracks simultaneously, so IDs are needed to control start, stop, volume, etc. |
-| isShortFile | [Field Meaning] Whether the played file is a short music file.<br>[Recommended Value] true: Requires repeating short music file; false: Normal music file. Default: false. |
-| loopCount | [Field Meaning] The number of times the music loops.<br>[Recommended Value] Value range is 0 to any positive integer. Default: 0. 0 means play the music once; 1 means play the music twice; and so on. |
-| path | [Field Meaning] The full path or URL of the audio file. Supported audio formats include MP3, AAC, M4A, WAV. |
-| publish | [Field Meaning] Whether to transmit the music to the remote end.<br>[Recommended Value] true: Music can be heard by remote users while playing locally; false: Only the host can hear the music locally, remote audience cannot hear it. Default: false. |
-| startTimeMS | [Field Meaning] Music start time, in milliseconds. |