腾讯云直播SDKV2TXLivePremier_音视频解决方案_同尘科技

直播SDK 1年前 (2023-10-19) 浏览 31

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)

本地麦克风采集到的音频数据回调

参数 描述
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字节

参数 描述
frame PCM 格式的音频数据帧。

注意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字节

参数 描述
frame PCM 格式的音频数据帧。

注意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

参数 描述
userId 业务侧自身维护的用户/设备id。

callExperimentalAPI

callExperimentalAPI

int callExperimentalAPI (String jsonStr)

调用实验性 API 接口

参数 描述
jsonStr 接口及参数描述的 JSON 字符串。

注意该接口用于调用一些实验性功能。

返回值说明:

返回值 V2TXLiveCode。 V2TXLIVE_OK: 成功。 V2TXLIVE_ERROR_INVALID_PARAMETER: 操作失败,参数非法。

对音视频的解决方案有疑惑?想了解解决方案收费? 联系解决方案专家

腾讯云限时活动1折起,即将结束: 马上收藏

同尘科技为腾讯云授权服务中心,购买腾讯云享受折上折,更有现金返利:同意关联,立享优惠

阿里云解决方案也看看?: 点击对比阿里云的解决方案

- 0人点赞 -

发表点评 (0条)

not found

暂无评论,你要说点什么吗?