直播 SDK
有奖捉虫：行业应用 & 管理与支持文档专题 HOT
文档中心 > 直播 SDK > 客户端 API > V1 升级 V2 API 对比说明

V1 升级 V2 API 对比说明

最近更新时间：2023-07-26 10:57:31

我的收藏

本页目录：

升级概述

为了更好地满足客户的接入需求，直播 SDK 在 API 以及支持的协议上做了重要的升级。API 2.0 相比与 API 1.0 在设计上更简洁也更实用。

TXLivePushConfig

V1 API
V2 API 对应接口
备注
setHomeOrientation
请参见V2TXLiveVideoEncoderparam.videoResolutionMode
setVideoResolution
请参见V2TXLiveVideoEncoderparam.videoResolution
setVideoFPS
请参见V2TXLiveVideoEncoderparam.videoFps
setVideoBitrate
请参见V2TXLiveVideoEncoderparam.videoBitrate
setMinVideoBitrate
请参见V2TXLiveVideoEncoderparam.minVideoBitrate
setVideoEncodeGop
V2 API 去掉该接口
-
setAutoAdjustBitrate
V2 API 去掉该接口
-
setAutoAdjustStrategy
V2 API 去掉该接口
-
setMaxVideoBitrate
V2 API 去掉该接口
-
setTouchFocus
-
setEnableZoom
V2 API 去掉该接口
-
setWatermark(Bitmap watermark, int x, int y)
-
setWatermark(Bitmap watermark, float x, float y, float width)
-
setPauseImg(Bitmap img)
V2 中有关垫片推流的场景使用主要会用到以下接口：
?startMicrophone 打开麦克风
?stopMicrophone 关闭麦克风
?startCamera 打开本地摄像头
?stopCamera 关闭本地摄像头
?startVirtualCamera 开启图片推流
?stopVirtualCamera 关闭图片推流
?pauseAudio 暂停推流器的音频流
?resumeAudio 恢复推流器的音频流
?pauseVideo 暂停推流器的视频流
?resumeVideo 恢复视频推流
场景1
场景2
场景3
主播上行音视频过程中，切后台推送默认背景图，回到前台继续推摄像头数据。
1. 主播上行音视频：startMicrophone + startCamera + startPush?
2. 主播切后台，不上行摄像头，上行主播已离开的提示图片：stopCamera + startVirtualCamera?
3. 主播回到前台，重新上行摄像头：stopVirtualCamera + startCamera?
主播以纯音频开播，可选择推送一张封面图；也可中途恢复推送摄像头数据；或者停止上行视频，只在本地预览摄像头数据。
1. 主播纯音频推垫片：startMicrophone + startVirtualCamera + startPush?
2. 主播打开摄像头上行摄像头数据：stopVirtualCamera + startCamera?
3. camera 不关闭，停止上行视频：pauseVideo?
4. camera 不关闭，恢复上行视频：resumeVideo?
主播直播过程中需要调整视频画面如美颜等，短暂暂停上行视频，同时保持摄像头预览。
1. 主播上行音视频：startMicrophone + startCamera + startPush?
2. camera 不关闭，停止上行视频：pauseVideo?
3. camera 不关闭，恢复上行视频：resumeVideo?
?
setPauseImg(int time, int fps)
V2 API 去掉该接口
setPauseFlag
V2 API 细分了暂停音频视频推流的接口，因此去掉该接口。
setAudioSampleRate
?V2TXLivePusher.setAudioQuality 接口可针对以下场景设置：
1. ?V2TXLiveAudioQualitySpeech 采样率：16k、单声道适合在线会议，语音通话
2. ?V2TXLiveAudioQualityDefault 采样率：48k、单声道如无特殊需求推荐
3. ?V2TXLiveAudioQualityMusic 采样率：48k、双声道 、全频带适合需要高保真传输音乐的场景，比如K 歌、音乐直播
setAudioChannels
enableAudioEarMonitoring
-
enablePureAudioPush
V2 API 去掉该接口
-
enableScreenCaptureAutoRotate
V2 API 去掉该接口
-
enableHighResolutionCaptureMode
V2 API 去掉该接口
-
setVideoEncoderXMirror
V2 API 去掉该接口
-
setConnectRetryCount
V2 API 去掉该接口，重连逻辑由内部自动处理
-
setConnectRetryInterval
V2 API 去掉该接口，重连逻辑由内部自动处理
-
setCustomModeType
开启自定义音频采集：
开始自定义视频采集：
-
enableANS
V2 API 去掉该接口，由内部自动处理
-
enableAEC
V2 API 去掉该接口，由内部自动处理
-
enableAGC
V2 API 去掉该接口，由内部自动处理
-
setVolumeType
-
setHardwareAcceleration
V2 API 去掉该接口，由内部自动处理，优先使用硬编
-
enableVideoHardEncoderMainProfile
V2 API 去掉该接口，由内部自动处理
-
setMetaData
V2 API 去掉该接口
-
enableMute
-
setFrontCamera
-
setBeautyFilter
?V2TXLivePusher.getBeautyManager.setBeautyLevel?
?V2TXLivePusher.getBeautyManager.setWhitenessLevel?
?V2TXLivePusher.getBeautyManager.setRuddyLevel?
-
setEyeScaleLevel
-
setFaceSlimLevel
-
enableNearestIP
V2 API 去掉该接口，由内部自动处理
-
setRtmpChannelType
V2 API 去掉该接口，由内部自动处理
-
setCustomVideoPreProcessLibrary
V2 API 去掉该接口
-
setCustomAudioPreProcessLibrary
V2 API 去掉该接口
-

TXLivePusher

V1 API
V2 API 对应接口
备注
setPushListener
-
setAudioVolumeEvaluationListener
enableAudioVolumeEvaluation
startCameraPreview
-
stopCameraPreview
-
startPusher
-
stopPusher
-
pausePusher
-
resumePusher
-
isPushing
-
setVideoQuality
adjustBitrate 和 adjustResolution 不再支持，由内部自动处理
switchCamera
-
frontCamera
-
setMirror
-
setRenderRotation
-
turnOnFlashLight
-
getMaxZoom
-
setZoom
-
setFocusPosition
-
setExposureCompensation
-
getBeautyManager
-
setMute
-
getAudioEffectManager
-
setVideoRecordListener
V2 API 去掉该接口
-
startRecord
V2 API 去掉该接口
-
stopRecord
V2 API 去掉该接口
-
snapshot
sendCustomVideoTexture
sendCustomVideoData
sendCustomPCMData
-
setVideoProcessListener
setAudioProcessListener
setSurface
-
setSurfaceSize
V2 API 去掉该接口
-
sendMessageEx
-
onLogRecord
V2 API 去掉该接口
-
startScreenCapture
-
stopScreenCapture
-
pauseScreenCapture
V2 API 去掉该接口
-
resumeScreenCapture
V2 API 去掉该接口
-
getBeautyManager
-
getAudioEffectManager
-
callExperimentalAPI
-

ITXLivePushListener

V1 API
V2 API 对应接口
备注
onPushEvent
?V2TXLivePusherObserver.onError?
?V2TXLivePusherObserver.onWarning?
?V2TXLivePusherObserver.onPushStatusUpdate?
V2 对 V1 onPushEvent 回调进行了重新设计，细分为 onError、onWarning、onPushStatusUpdate 三个模块：
onError中会抛出阻塞直播推流的错误信息
onWarning中处理一些不会阻塞直播推流但是影响体验的警告信息
onPushStatusUpdate是直播推流状态的改变信息回调
onNetStatus
-

TXLivePlayConfig

V1 API
V2 API 对应接口
备注
setCacheTime
当正确设置 V2TXLivePlayer.setCacheParams 中 minTime 和 maxTime 时，播放器会按照预设的最小值最大值范围内自动调整
setAutoAdjustCacheTime
setMaxAutoAdjustCacheTime
setMinAutoAdjustCacheTime
setVideoBlockThreshold
V2 API 去掉该接口
-
setConnectRetryCount
kV2MaxNumberOfReconnection
setConnectRetryInterval
kV2SecondsBetweenReconnection
setHeaders
kV2SetHeaders
enableAEC
V2 API 去掉该接口，由内部自动处理
-
setEnableMessage
V2 开启接收 SEI 消息后通过 V2TXLivePlayerObserver.onReceiveSeiMessage 回调接收到 SEI 消息
setEnableMetaData
V2 API 去掉该接口，默认开启
-
setFlvSessionKey
V2 API 去掉该接口
-
setEnableNearestIP
V2 API 去掉该接口，由内部自动处理
-
setRtmpChannelType
V2 API 去掉该接口，由内部自动处理
-
setCacheFolderPath
V2 API 去掉该接口
-
setMaxCacheItems
V2 API 去掉该接口
-

TXLivePlayer

V1 API
V2 API 对应接口
备注
setPlayListener
?
setAudioRawDataListener
setAudioVolumeEvaluationListener
enableAudioVolumeEvaluation
recordDelegate
V2 API 去掉该接口
?
isAutoPlay
V2 API 去掉该接口
?
setPlayerView
?
setSurface
?
setSurfaceSize
V2 API 去掉该接口
?
startPlay
?
stopPlay
?
isPlaying
?
pause
?
resume
?
setRenderRotation
?
setRenderMode
?
enableHardwareDecode
V2 API 去掉该接口，由内部自动处理，优先硬解
?
snapshot
getCurrentRenderPts
V2 API 去掉该接口
?
setMute
?
setVolume
?
setAudioRoute
?
prepareLiveSeek
V2 API 去掉该接口
?
resumeLive
V2 API 去掉该接口
?
seek
V2 API 去掉该接口
?
setAutoPlay
V2 API 去掉该接口
?
startRecord
V2 API 去掉该接口
?
stopRecord
V2 API 去掉该接口
?
setRate
V2 API 去掉该接口
?
switchStream
?
callExperimentalAPI
V2 API 去掉该接口
?

ITXLivePlayListener

V1 API
V2 API 对应接口
备注
onPlayEvent
?V2TXLivePlayerObserver.onError?
?V2TXLivePlayerObserver.onWarning?
?V2TXLivePlayerObserver.onVideoPlaying?
?V2TXLivePlayerObserver.onVideoLoading?
?V2TXLivePlayerObserver.onAudioPlaying?
?V2TXLivePlayerObserver.onAudioLoading?
V2 对 V1 onPushEvent 回调进行了重新设计，细分为 onError、onWarning、onVideoPlaying、onVideoLoading、onAudioPlaying、onAudioLoading 六个模块：
onError中会抛出阻塞拉流的错误信息
onWarning中处理一些不会阻塞拉流但是影响体验的警告信息
onAudioPlaying和 onAudioLoading是拉流音频状态的改变信息回调
onVideoPlaying和 onVideoLoading是拉流视频状态的改变信息回调
onNetStatus
-
?
中国站


http://www.vxiaotou.com