tencent cloud

All product documents
Mobile Live Video Broadcasting
DocumentationMobile Live Video BroadcastingAPI DocumentationiOSPublishingV2TXLivePusherObserver
V2TXLivePusherObserver
Download PDF
Last updated: 2022-10-13 11:40:06
V2TXLivePusherObserver
Last updated: 2022-10-13 11:40:06
Download PDF
Overview
Callback notifications for live stream publishing
Features
You can use V2TXLivePusherObserver to receive notifications about V2TXLivePusher, including publisher connection status, first audio/video frame, statistics, and warning and error messages.

Basic Callback APIs

onError

Callback for error. This callback is triggered when the publisher encounters an error.
- (void)onError:(V2TXLiveCode)code message:(NSString *)msg extraInfo:(NSDictionary *)extraInfo

Parameters

Parameter
Type
Description
code
V2TXLiveCode
Error code
msg
NSString *
Error message
extraInfo
NSDictionary *
Extra information

onWarning

Callback for warning.
- (void)onWarning:(V2TXLiveCode)code message:(NSString *)msg extraInfo:(NSDictionary *)extraInfo

Parameters

Parameter
Type
Description
code
V2TXLiveCode
Warning code
msg
NSString *
Warning message
extraInfo
NSDictionary *
Extra information

Video Callback APIs

onPushStatusUpdate

Callback of the publisher’s connection status.
- (void)onPushStatusUpdate:(V2TXLivePushStatus)status
                   message:(NSString *)msg
                 extraInfo:(NSDictionary *)extraInfo

Parameters

Parameter
Type
Description
status
V2TXLivePushStatus
Status code
msg
NSString *
Status message
extraInfo
NSDictionary *
Extra information

V2TXLivePushStatus enumerated values

Value
Description
V2TXLivePushStatusDisconnected
Disconnected from the server
V2TXLivePushStatusConnecting
Connecting to the server
V2TXLivePushStatusConnectSuccess
Connected to the server
V2TXLivePushStatusReconnecting
Reconnecting to the server

onSnapshotComplete

Callback for a screenshot taken.
- (void)onSnapshotComplete:(TXImage *)image

Parameters

Parameter
Type
Description
image
TXImage *
The video image captured

onProcessVideoFrame

Callback for custom video processing.
Note:
You will receive this callback after you call V2TXLivePusher#enableCustomVideoProcess:(BOOL)enable pixelFormat:(V2TXLivePixelFormat)pixelFormat bufferType:(V2TXLiveBufferType)bufferType to enable custom video processing.
- (void)onProcessVideoFrame:(V2TXLiveVideoFrame * _Nonnull)srcFrame dstFrame:(V2TXLiveVideoFrame * _Nonnull)dstFrame

Parameters

Parameter
Type
Description
srcFrame
V2TXLiveVideoFrame *
Images before processing
dstFrame
V2TXLiveVideoFrame *
Images after processing

onGLContextDestroyed

Callback for a GL context for custom video processing being destroyed.
- (void)onGLContextDestroyed

onCaptureFirstVideoFrame

Callback for capturing the first video frame.
- (void)onCaptureFirstVideoFrame

Audio Callback APIs

onCaptureFirstAudioFrame

Callback for capturing the first audio frame.
- (void)onCaptureFirstAudioFrame

onMicrophoneVolumeUpdate

Callback of mic capturing volume.
- (void)onMicrophoneVolumeUpdate:(NSInteger)volume

Statistics Callback API

onStatisticsUpdate

Callback of publisher statistics.
- (void)onStatisticsUpdate:(V2TXLivePusherStatistics *)statistics

Parameters

Parameter
Type
Description
statistics
V2TXLivePusherStatistics *
Publisher statistics

MixTranscoding Callback API

onSetMixTranscodingConfig

Callback for setting On-Cloud MixTranscoding parameters.
Note:
You will receive this callback after you call V2TXLivePusher#setMixTranscodingConfig:(V2TXLiveTranscodingConfig *)config to set On-Cloud MixTranscoding parameters.
- (void)onSetMixTranscodingConfig:(V2TXLiveCode)code message:(NSString *)msg
Parameter
Type
Description
code
V2TXLiveCode
0: successful; other values: failed
msg
NSString *
Error message
Was this page helpful?
You can also Contact Sales or Submit a Ticket for help.
Yes
No

Feedback

Contact Us

Contact our sales team or business advisors to help your business.

Contact Us
Technical Support

Open a ticket if you're looking for further assistance. Our Ticket is 7x24 available.

Submit a Ticket
7x24 Phone Support
Hong Kong, China
+852 800 906 020 (Toll Free)
United States
+1 844 606 0804 (Toll Free)
United Kingdom
+44 808 196 4551 (Toll Free)
Canada
+1 888 605 7930 (Toll Free)
Australia
+61 1300 986 386 (Toll Free)
EdgeOne hotline
+852 300 80699
More local hotlines coming soon