升级概述
为了更好地满足客户的接入需求，直播 SDK 在 API 以及支持的协议上做了重要的升级。API 2.0 相比与 API 1.0 在设计上更简洁也更实用。
TXLivePushConfig
V1 API | V2 API 对应接口 | 备注 |
setHomeOrientation | ||
setVideoResolution | | |
setVideoFPS | | |
setVideoBitrate | | |
setMinVideoBitrate | | |
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. 主播上行音视频：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 | 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 | - | |
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 | V2 对 V1 onPushEvent 回调进行了重新设计，细分为 onError、onWarning、onPushStatusUpdate 三个模块： onError中会抛出阻塞直播推流的错误信息onWarning中处理一些不会阻塞直播推流但是影响体验的警告信息onPushStatusUpdate是直播推流状态的改变信息回调 | |
onNetStatus | - |
TXLivePlayConfig
V1 API | V2 API 对应接口 | 备注 |
setCacheTime | ||
setAutoAdjustCacheTime | | |
setMaxAutoAdjustCacheTime | | |
setMinAutoAdjustCacheTime | | |
setVideoBlockThreshold | V2 API 去掉该接口 | - |
setConnectRetryCount | kV2MaxNumberOfReconnection | |
setConnectRetryInterval | | kV2SecondsBetweenReconnection |
setHeaders | | kV2SetHeaders |
enableAEC | V2 API 去掉该接口，由内部自动处理 | - |
setEnableMessage | ||
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 | V2 对 V1 onPushEvent 回调进行了重新设计，细分为 onError、onWarning、onVideoPlaying、onVideoLoading、onAudioPlaying、onAudioLoading 六个模块： onError中会抛出阻塞拉流的错误信息onWarning中处理一些不会阻塞拉流但是影响体验的警告信息onAudioPlaying和 onAudioLoading是拉流音频状态的改变信息回调onVideoPlaying和 onVideoLoading是拉流视频状态的改变信息回调 | |
onNetStatus | - |