Copyright (c) 2021 Tencent. All rights reserved.
Module: V2TXLivePremier @ TXLiteAVSDK
Function: V2TXLive High-level interface
V2TXLivePremier
|
| Get the SDK version number |
| Set V2TXLivePremier callback interface |
| Set Log configuration information |
| Set up SDK access environment |
| Set SDK authorization license |
| Set SDK socks5 proxy config |
| Enables/Disables audio capture callback |
| Enables/Disables audio playout callback |
| Enables/Disables in-ear monitoring callback |
| Set user id |
| Call experimental APIs |
V2TXLivePremierObserver
|
| Custom Log output callback interface |
| setLicence result callback interface |
| Raw audio data captured locally |
| Data mixed from each channel before being submitted to the system for playback |
| In-ear monitoring data |
getSDKVersionStr
Get the SDK version number
setObserver:
Set V2TXLivePremier callback interface
setLogConfig:
+ (V2TXLiveCode)setLogConfig: | |
Set Log configuration information
setEnvironment:
+ (V2TXLiveCode)setEnvironment: | |
Set up SDK access environment|
env | currently supports two parameters "default" and "GDPR". default: In the default environment, the SDK will find the best access point in the world for access. GDPR: All audio and video data and quality statistics will not pass through servers in mainland China. |
Note
If your application has no special requirements, please do not call this interface for setting.
setLicence:key:
Set SDK authorization license
Try and Purchase a License: https://www.tencentcloud.com/document/product/1071/38546.
|
key | the key of licence. |
url | the url of licence. |
setSocks5Proxy:port:username:password:config:
setSocks5Proxy:port:username:password:config:
+ (V2TXLiveCode)setSocks5Proxy: | |
| |
| |
| |
| |
Set SDK socks5 proxy config|
config | protocol configured with socks5 proxy. |
host | socks5 proxy host. |
password | socks5 proxy password. |
port | socks5 proxy port. |
username | socks5 proxy username. |
enableAudioCaptureObserver:format:
enableAudioCaptureObserver:format:
+ (V2TXLiveCode)enableAudioCaptureObserver: | |
| |
Enables/Disables audio capture callback|
enable | YES : enable; NO (default): disable.
|
format | audio frame format. |
Note
This API works only if you call it before startPush. enableAudioPlayoutObserver:format:
enableAudioPlayoutObserver:format:
+ (V2TXLiveCode)enableAudioPlayoutObserver: | |
| |
Enables/Disables audio playout callback|
enable | YES : enable; NO (default): disable.
|
format | audio frame format. |
enableVoiceEarMonitorObserver:
enableVoiceEarMonitorObserver:
+ (V2TXLiveCode)enableVoiceEarMonitorObserver: | |
Enables/Disables in-ear monitoring callback|
enable | YES : enable; NO (default): disable.
|
setUserId:
Set user id|
userId | User/device id maintained by the service side itself. |
callExperimentalAPI:
+ (V2TXLiveCode)callExperimentalAPI: | |
Call experimental APIs|
jsonStr | JSON string describing interface and parameters. |
V2TXLIVE_OK: successful.
V2TXLIVE_ERROR_INVALID_PARAMETER: operation failed because of illegal parameter.
onLog:log:
Custom Log output callback interface
onLicenceLoaded:Reason:
setLicence result callback interface|
reason | the reason for failure. |
result | the result of setLicence interface, 0 succeeds, negative number fails. |
onCaptureAudioFrame:
- (void) onCaptureAudioFrame: | (V2TXLiveAudioFrame *)frame |
Raw audio data captured locally|
frame | Audio frames in PCM format. |
Note
1. Please avoid time-consuming operations in this callback function. The SDK processes an audio frame every 20 ms, so if your operation takes more than 20 ms, it will cause audio exceptions.
2. The audio data returned via this callback can be read and modified, but please keep the duration of your operation short.
3. The audio data returned via this callback does not include pre-processing effects like background music, audio effects, or reverb, and therefore has a very short delay.
onPlayoutAudioFrame:
- (void) onPlayoutAudioFrame: | (V2TXLiveAudioFrame *)frame |
Data mixed from each channel before being submitted to the system for playbackAfter you configure the callback of custom audio processing, the SDK will return to you via this callback the data (PCM format) mixed from each channel before it is submitted to the system for playback.
The audio data returned via this callback is in PCM format and has a fixed frame length (time) of 0.02s.
The formula to convert a frame length in seconds to one in bytes is sample rate * frame length in seconds * number of sound channels * audio bit depth.
Assume that the audio is recorded on a single channel with a sample rate of 48,000 Hz and audio bit depth of 16 bits, which are the default settings of SDK. The frame length in bytes will be 48000 * 0.02s * 1 * 16 bits = 15360 bits = 1920 bytes.
|
frame | Audio frames in PCM format. |
Note
1. Please avoid time-consuming operations in this callback function. The SDK processes an audio frame every 20 ms, so if your operation takes more than 20 ms, it will cause audio exceptions.
2. The audio data returned via this callback can be read and modified, but please keep the duration of your operation short.
3. The audio data returned via this callback is the audio data mixed from each channel before it is played. It does not include the in-ear monitoring data.
onVoiceEarMonitorAudioFrame:
onVoiceEarMonitorAudioFrame:
- (void) onVoiceEarMonitorAudioFrame: | (V2TXLiveAudioFrame *)frame |
In-ear monitoring dataAfter you configure the callback of custom audio processing, the SDK will return to you via this callback the in-ear monitoring data (PCM format) before it is submitted to the system for playback.
The audio returned is in PCM format and has a not-fixed frame length (time).
The formula to convert a frame length in seconds to one in bytes is sample rate * frame length in seconds * number of sound channels * audio bit depth.
Assume that the audio is recorded on a single channel with a sample rate of 48,000 Hz and audio bit depth of 16 bits, which are the default settings of TRTC. The length of 0.02s frame in bytes will be 48000 * 0.02s * 1 * 16 bits = 15360 bits = 1920 bytes.
|
frame | Audio frames in PCM format |
Note
1. Please avoid time-consuming operations in this callback function, or it will cause audio exceptions.
2. The audio data returned via this callback can be read and modified, but please keep the duration of your operation short.