TRTC IOS&MAC V2TXLivePusherObserver

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

---

结构体说明


◆ V2TXLivePusherObserver-p

protocol V2TXLivePusherObserver-p

构造函数
(void)	- onError:message:extraInfo:
(void)	- onWarning:message:extraInfo:
(void)	- onCaptureFirstAudioFrame
(void)	- onCaptureFirstVideoFrame
(void)	- onMicrophoneVolumeUpdate:
(void)	- onPushStatusUpdate:message:extraInfo:
(void)	- onStatisticsUpdate:
(void)	- onSnapshotComplete:
(void)	- onProcessVideoFrame:dstFrame:
(void)	- onGLContextDestroyed
(void)	- onSetMixTranscodingConfig:message:
(void)	- onScreenCaptureStarted
(void)	- onScreenCaptureStopped:

函数文档


◆ onCaptureFirstAudioFrame()

- (void) onCaptureFirstAudioFrame

optional

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

◆ onCaptureFirstVideoFrame()

- (void) onCaptureFirstVideoFrame

optional

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

◆ onError:message:extraInfo)

- (void) onError: (V2TXLiveCode)  code message: (NSString *)  msg extraInfo: (NSDictionary *)  extraInfo

optional

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

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

◆ onGLContextDestroyed()

- (void) onGLContextDestroyed

optional

SDK 内部的 OpenGL 情况的销毁通知

◆ onMicrophoneVolumeUpdate)

- (void) onMicrophoneVolumeUpdate: (NSInteger)  volume

optional

麦克风采集音量值回调
参数

volume

音量巨细

注意
调用 enableVolumeEvaluation 开启采集音量巨细提示之后，会收到这个回调通知。

◆ onProcessVideoFrame:dstFrame)

- (void) onProcessVideoFrame: (V2TXLiveVideoFrame *_Nonnull)  srcFrame dstFrame: (V2TXLiveVideoFrame *_Nonnull)  dstFrame

optional

自界说视频处置惩罚回调
注意
须要调用 V2TXLivePusher::enableCustomVideoProcess:pixelFormat:bufferType: "enableCustomVideoProcess" 开启自界说视频处置惩罚，才会收到这个回调通知。
【情况一】美颜组件会产生新的纹理 如果您利用的美颜组件会在处置惩罚图像的过程中产生一帧全新的纹理（用于承载处置惩罚后的图像），那请您在回调函数中将 dstFrame.textureId 设置为新纹理的 ID。

1. [/code]
2. [list]
3. [*](void) onProcessVideoFrame:(V2TXLiveVideoFrame * _Nonnull)srcFrame dstFrame:(V2TXLiveVideoFrame * _Nonnull)dstFrame { GLuint dstTextureId = renderItemWithTexture(srcFrame.textureId, srcFrame.width, srcFrame.height); dstFrame.textureId = dstTextureId; return 0; }
4. [/list] [code]【情况二】美颜组件并不自身产生新纹理
5. 如果您使用的第三方美颜模块并不生成新的纹理，而是需要您设置给该模块一个输入纹理和一个输出纹理，则可以考虑如下方案：

复制代码

1. [/code]
2. [list]
3. [*](void) onProcessVideoFrame:(V2TXLiveVideoFrame * _Nonnull)srcFrame dstFrame:(V2TXLiveVideoFrame * _Nonnull)dstFrame { thirdparty_process(srcFrame.textureId, srcFrame.width, srcFrame.height, dstFrame.textureId); return 0; }
4. [/list] [code]

复制代码

[code][/code] 参数

srcFrame	用于承载未处置惩罚的视频画面
dstFrame	用于承载处置惩罚过的视频画面

◆ onPushStatusUpdate:message:extraInfo)

- (void) onPushStatusUpdate: (V2TXLivePushStatus)  status message: (NSString *)  msg extraInfo: (NSDictionary *)  extraInfo

optional

推流器连接状态回调通知
参数

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

◆ onScreenCaptureStarted()

- (void) onScreenCaptureStarted

optional

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

◆ onScreenCaptureStopped)

- (void) onScreenCaptureStopped: (int)  reason

optional

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

reason

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

◆ onSetMixTranscodingConfig:message)

- (void) onSetMixTranscodingConfig: (V2TXLiveCode)  code message: (NSString *)  msg

optional

设置云端的混流转码参数的回调，对应于 setMixTranscodingConfig 接口
参数

code	0表示成功，其余值表示失败
msg	详细错误原因

◆ onSnapshotComplete)

- (void) onSnapshotComplete: (TXImage *)  image

optional

截图回调
参数

image

已截取的视频画面

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

◆ onStatisticsUpdate)

- (void) onStatisticsUpdate: (V2TXLivePusherStatistics *)  statistics

optional

直播推流器统计数据回调
参数

statistics

推流器统计数据 V2TXLivePusherStatistics

◆ onWarning:message:extraInfo)

- (void) onWarning: (V2TXLiveCode)  code message: (NSString *)  msg extraInfo: (NSDictionary *)  extraInfo

optional

直播推流器告诫通知
参数

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

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。