V2TXLivePusherObserver

详细描述

腾讯云直播推流的回调通知。
V2TXLivePusher 的一些回调事件，包括推流器状态，推流音量，统计信息，警告以及错误信息。

---

结构体说明

liteav::V2TXLivePusherObserver

class liteav::V2TXLivePusherObserver

Public 成员函数
virtual	~V2TXLivePusherObserver ()
virtual void	onError (int32_t code, const char *msg, void *extraInfo)
virtual void	onWarning (int32_t code, const char *msg, void *extraInfo)
virtual void	onCaptureFirstAudioFrame ()
virtual void	onCaptureFirstVideoFrame ()
virtual void	onMicrophoneVolumeUpdate (int32_t volume)
virtual void	onPushStatusUpdate (V2TXLivePushStatus state, const char *msg, void *extraInfo)
virtual void	onStatisticsUpdate (V2TXLivePusherStatistics statistics)
virtual void	onSnapshotComplete (const char *image, int length, int width, int height, V2TXLivePixelFormat format)
virtual void	onRenderVideoFrame (const V2TXLiveVideoFrame *videoFrame)
virtual int	onProcessVideoFrame (V2TXLiveVideoFrame *srcFrame, V2TXLiveVideoFrame *dstFrame)
virtual void	onScreenCaptureStarted ()
virtual void	onScreenCaptureStoped (int reason)

构造及析构函数说明

~V2TXLivePusherObserver()

virtual ~V2TXLivePusherObserver ( )

inlinevirtual

成员函数说明

onCaptureFirstAudioFrame()

virtual void onCaptureFirstAudioFrame ( )

inlinevirtual

首帧音频采集完成的回调通知

onCaptureFirstVideoFrame()

virtual void onCaptureFirstVideoFrame ( )

inlinevirtual

首帧视频采集完成的回调通知

onError()

virtual void onError ( int32_t  code, const char *  msg, void *  extraInfo  )

inlinevirtual

直播推流器错误通知，推流器出现错误时，会回调该通知

参数

code	错误码 V2TXLiveCode
msg	错误信息
extraInfo	扩展信息

onMicrophoneVolumeUpdate()

virtual void onMicrophoneVolumeUpdate ( int32_t  volume )

inlinevirtual

麦克风采集音量值回调

参数

volume

音量大小

注意

调用 enableVolumeEvaluation 开启采集音量大小提示之后，会收到这个回调通知。

onProcessVideoFrame()

virtual int onProcessVideoFrame ( V2TXLiveVideoFrame *  srcFrame, V2TXLiveVideoFrame *  dstFrame  )

inlinevirtual

自定义视频预处理数据回调

注意

调用 V2TXLivePusher#enableCustomVideoProcessing 接口开启/关闭自定义视频处理回调 Windows 暂时只支持 YUV420 格式。

参数

srcFrame	处理前的视频帧
dstFrame	处理后的视频帧

返回

- 0： 成功

• 其他： 错误

onPushStatusUpdate()

virtual void onPushStatusUpdate ( V2TXLivePushStatus  state, const char *  msg, void *  extraInfo  )

inlinevirtual

推流器连接状态回调通知

参数

status	推流器连接状态 V2TXLivePushStatus
msg	连接状态信息
extraInfo	扩展信息

onRenderVideoFrame()

virtual void onRenderVideoFrame ( const V2TXLiveVideoFrame *  videoFrame )

inlinevirtual

自定义视频渲染回调

注意

调用 enableCustomVideoRender 开启本地视频自定义渲染之后，会收到这个回调通知

参数

videoFrame

视频帧数据 V2TXLiveVideoFrame

onScreenCaptureStarted()

virtual void onScreenCaptureStarted ( )

inlinevirtual

当屏幕分享开始时，SDK 会通过此回调通知

onScreenCaptureStoped()

virtual void onScreenCaptureStoped ( int  reason )

inlinevirtual

当屏幕分享停止时，SDK 会通过此回调通知

参数

reason

停止原因 0：表示用户主动停止； 1：表示屏幕分享窗口被关闭； 2：表示屏幕分享的显示屏状态变更（如接口被拔出、投影模式变更等）

onSnapshotComplete()

virtual void onSnapshotComplete ( const char *  image, int  length, int  width, int  height, V2TXLivePixelFormat  format  )

inlinevirtual

截图回调

注意

调用 snapshot 截图之后，会收到这个回调通知

参数

image	已截取的视频画面
length	截图数据长度，对于BGRA32而言，length = width * height * 4
width	截图画面的宽度
height	截图画面的高度
format	截图数据格式，目前只支持 V2TXLivePixelFormatBGRA32

onStatisticsUpdate()

virtual void onStatisticsUpdate ( V2TXLivePusherStatistics  statistics )

inlinevirtual

直播推流器统计数据回调

参数

statistics

推流器统计数据 V2TXLivePusherStatistics

onWarning()

virtual void onWarning ( int32_t  code, const char *  msg, void *  extraInfo  )

inlinevirtual

直播推流器警告通知

参数

code	警告码 V2TXLiveCode
msg	警告信息
extraInfo	扩展信息

宏定义说明

MODULE_CPP_V2TXLIVEPUSHEROBSERVER_H_

#define MODULE_CPP_V2TXLIVEPUSHEROBSERVER_H_