Copyright (c) 2021 Tencent. All rights reserved.
Module: V2TXLivePremier @ TXLiteAVSDK
Function: V2TXLive 高级接口
V2TXLivePremier
V2TXLivePremierObserver
onLog |
自定义 Log 输出回调接口 |
onLicenceLoaded |
setLicence 接口回调 |
onCaptureAudioFrame |
本地麦克风采集到的音频数据回调 |
onPlayoutAudioFrame |
将各路待播放音频混合之后并在最终提交系统播放之前的数据回调 |
onVoiceEarMonitorAudioFrame |
耳返的音频数据 |
V2TXLivePremier
getSDKVersionStr |
获取 SDK 版本号 |
setObserver |
设置 V2TXLivePremier 回调接口 |
setLogConfig |
设置 Log 的配置信息 |
setEnvironment |
设置 SDK 接入环境 |
setLicence |
设置 SDK 的授权 License |
setSocks5Proxy |
设置 SDK socks5 代理配置 |
enableAudioCaptureObserver |
开启/关闭对音频采集数据的监听回调(可读写) |
enableAudioPlayoutObserver |
开启/关闭对最终系统要播放出的音频数据的监听回调 |
enableVoiceEarMonitorObserver |
开启/关闭耳返音频数据的监听回调 |
setUserId |
设置 userId |
callExperimentalAPI |
调用实验性 API 接口 |
onLog
onLog
void onLog |
(int level |
|
String log) |
自定义 Log 输出回调接口
onLicenceLoaded
onLicenceLoaded
void onLicenceLoaded |
(int result |
|
String reason) |
setLicence 接口回调
reason |
设置 licence 失败原因。 |
result |
设置 licence 结果 0 成功,负数失败。 |
onCaptureAudioFrame
onCaptureAudioFrame
void onCaptureAudioFrame |
(V2TXLiveDef.V2TXLiveAudioFrame frame) |
本地麦克风采集到的音频数据回调
注意 请不要在此回调函数中做任何耗时操作,建议直接拷贝到另一线程进行处理,否则会导致各种声音问题。 此接口回调出的音频数据支持修改。 此接口回调出的音频时间帧长固定为0.02s。由时间帧长转化为字节帧长的公式为【采样率 × 时间帧长 × 声道数 × 采样点位宽】。以SDK默认的音频录制格式48000采样率、单声道、16采样点位宽为例,字节帧长为【48000 × 0.02s × 1 × 16bit = 15360bit = 1920字节】。 此接口回调出的音频数据不包含背景音、音效、混响等前处理效果,延迟极低。 需要您调用 enableAudioCaptureObserver 开启回调开关。
onPlayoutAudioFrame
onPlayoutAudioFrame
void onPlayoutAudioFrame |
(V2TXLiveDef.V2TXLiveAudioFrame frame) |
将各路待播放音频混合之后并在最终提交系统播放之前的数据回调
当您设置完音频数据自定义回调之后,SDK 内部会把各路待播放的音频混合之后的音频数据,在提交系统播放之前,以 PCM 格式的形式通过本接口回调给您。 此接口回调出的音频时间帧长固定为 0.02s,格式为 PCM 格式。 由时间帧长转化为字节帧长的公式为 采样率 × 时间帧长 × 声道数 × 采样点位宽
。 以 SDK 默认的音频录制格式 48000 采样率、单声道、16 采样点位宽为例,字节帧长为 48000 × 0.02s × 1 × 16bit = 15360bit = 1920字节
。
注意1. 请不要在此回调函数中做任何耗时操作,由于 SDK 每隔 20ms 就要处理一帧音频数据,如果您的处理时间超过 20ms,就会导致声音异常。2. 此接口回调出的音频数据是可读写的,也就是说您可以在回调函数中同步修改音频数据,但请保证处理耗时。3. 此接口回调出的是对各路待播放音频数据的混合,但其中并不包含耳返的音频数据。
onVoiceEarMonitorAudioFrame
onVoiceEarMonitorAudioFrame
void onVoiceEarMonitorAudioFrame |
(V2TXLiveDef.V2TXLiveAudioFrame frame) |
耳返的音频数据
当您设置完音频数据自定义回调之后,SDK 内部会把耳返的音频数据在播放之前以 PCM 格式的形式通过本接口回调给您。 此接口回调出的音频时间帧长不固定,格式为 PCM 格式。 由时间帧长转化为字节帧长的公式为 采样率 × 时间帧长 × 声道数 × 采样点位宽
。 以 TRTC 默认的音频录制格式 48000 采样率、单声道、16采样点位宽为例,0.02s 的音频数据字节帧长为 48000 × 0.02s × 1 × 16bit = 15360bit = 1920字节
。
注意1. 请不要在此回调函数中做任何耗时操作,否则会导致声音异常。2. 此接口回调出的音频数据是可读写的,也就是说您可以在回调函数中同步修改音频数据,但请保证处理耗时。
getSDKVersionStr
getSDKVersionStr
获取 SDK 版本号
setObserver
setObserver
void setObserver |
(V2TXLivePremierObserver observer) |
设置 V2TXLivePremier 回调接口
setLogConfig
setLogConfig
void setLogConfig |
(V2TXLiveDef.V2TXLiveLogConfig config) |
设置 Log 的配置信息
setEnvironment
setEnvironment
void setEnvironment |
(String env) |
设置 SDK 接入环境
env |
目前支持 “default” 和 “GDPR” 两个参数。 default:默认环境,SDK 会在全球寻找最佳接入点进行接入。 GDPR:所有音视频数据和质量统计数据都不会经过中国大陆地区的服务器。 |
注意如您的应用无特殊需求,请不要调用此接口进行设置。
setLicence
setLicence
void setLicence |
(Context context |
|
String url |
|
String key) |
设置 SDK 的授权 License
文档地址:https://cloud.tencent.com/document/product/454/34750。
context |
|
key |
licence的秘钥。 |
url |
licence的地址。 |
setSocks5Proxy
setSocks5Proxy
void setSocks5Proxy |
(String host |
|
int port |
|
String username |
|
String password |
|
V2TXLiveDef.V2TXLiveSocks5ProxyConfig config) |
设置 SDK socks5 代理配置
config |
配置使用 socks5 代理服务器的协议。 |
host |
socks5 代理服务器的地址。 |
password |
socks5 代理服务器的验证的密码。 |
port |
socks5 代理服务器的端口。 |
username |
socks5 代理服务器的验证的用户名。 |
enableAudioCaptureObserver
enableAudioCaptureObserver
void enableAudioCaptureObserver |
(boolean enable |
|
V2TXLiveDef.V2TXLiveAudioFrameObserverFormat format) |
开启/关闭对音频采集数据的监听回调(可读写)
enable |
是否开启。 【默认值】:false。 |
format |
设置回调出的 AudioFrame 的格式。 |
注意需要在 startPush 之前调用,才会生效。
enableAudioPlayoutObserver
enableAudioPlayoutObserver
void enableAudioPlayoutObserver |
(boolean enable |
|
V2TXLiveDef.V2TXLiveAudioFrameObserverFormat format) |
开启/关闭对最终系统要播放出的音频数据的监听回调
enable |
是否开启。 【默认值】:false。 |
format |
设置回调出的 AudioFrame 的格式。 |
enableVoiceEarMonitorObserver
enableVoiceEarMonitorObserver
void enableVoiceEarMonitorObserver |
(boolean enable) |
开启/关闭耳返音频数据的监听回调
enable |
是否开启。 【默认值】:false。 |
setUserId
setUserId
void setUserId |
(String userId) |
设置 userId
callExperimentalAPI
callExperimentalAPI
int callExperimentalAPI |
(String jsonStr) |
调用实验性 API 接口
jsonStr |
接口及参数描述的 JSON 字符串。 |
注意该接口用于调用一些实验性功能。
返回值说明:
返回值 V2TXLiveCode。 V2TXLIVE_OK: 成功。 V2TXLIVE_ERROR_INVALID_PARAMETER: 操作失败,参数非法。
对音视频的解决方案有疑惑?想了解解决方案收费? 联系解决方案专家
腾讯云限时活动1折起,即将结束: 马上收藏
同尘科技为腾讯云授权服务中心,购买腾讯云享受折上折,更有现金返利:同意关联,立享优惠
阿里云解决方案也看看?: 点击对比阿里云的解决方案
暂无评论,你要说点什么吗?