tencent cloud

Feedback

V2TXLivePlayerObserver

Last updated: 2022-06-14 13:11:47

    Overview

    Callbacks of Tencent Cloud’s live stream player.

    Features

    You can use V2TXLivePlayerObserver to receive callbacks of V2TXLivePlayer, including player status, playback volume, first audio/video frame, statistics, warning and error messages, etc.

    Basic Callback APIs

    onError

    Callback for error

    - (void)onError:(id<V2TXLivePlayer>)player
               code:(V2TXLiveCode)code
            message:(NSString *)msg
          extraInfo:(NSDictionary *)extraInfo
    

    Parameters

    Parameter Type Description
    player V2TXLivePlayer The player object sending the callback
    code V2TXLiveCode Error code
    msg NSString * Error message
    extraInfo NSDictionary * Extra information

    onWarning

    Callback for warning

    - (void)onWarning:(id<V2TXLivePlayer>)player
                 code:(V2TXLiveCode)code
              message:(NSString *)msg
            extraInfo:(NSDictionary *)extraInfo
    

    Parameters

    Parameter Type Description
    player V2TXLivePlayer The player object sending the callback
    code V2TXLiveCode Warning code
    msg NSString * Warning message
    extraInfo NSDictionary * Extra information

    onConnected

    Callback for successfully connecting to the server

    - (void)onConnected:(id<V2TXLivePlayer>)player 
             extraInfo:(NSDictionary *)extraInfo
    

    Parameters

    Parameter Type Description
    player V2TXLivePlayer The player object sending the callback
    extraInfo NSDictionary * Extra information

    Video Callback APIs

    onVideoPlaying

    Callback for video playback

    - (void)onVideoPlaying:(id<V2TXLivePlayer>)player
                firstPlay:(BOOL)firstPlay 
                extraInfo:(NSDictionary *)extraInfo
    

    Parameters

    Parameter Type Description
    player V2TXLivePlayer The player object sending the callback
    firstPlay BOOL Whether it is the first playback
    extraInfo NSDictionary * Extra information

    onVideoLoading

    Callback for loading video

    - (void)onVideoLoading:(id<V2TXLivePlayer>)player
                extraInfo:(NSDictionary *)extraInfo;
    

    Parameters

    Parameter Type Description
    player V2TXLivePlayer The player object sending the callback
    extraInfo NSDictionary * Extra information

    onVideoResolutionChanged

    Callback for change of player resolution

    - (void)onVideoResolutionChanged:(id<V2TXLivePlayer>)player 
                              width:(NSInteger)width 
                             height:(NSInteger)height;
    

    Parameters

    Parameter Type Description
    player V2TXLivePlayer The player object sending the callback
    width NSInteger Video width
    height NSInteger Video height

    onSnapshotComplete

    Callback for a screenshot taken

    - (void)onSnapshotComplete:(id<V2TXLivePlayer>)player image:(TXImage *)image
    

    Parameters

    Parameter Type Description
    player V2TXLivePlayer The player object sending the callback
    image TXImage * The video image captured

    onRenderVideoFrame

    Callback for custom video rendering

    Note:

    You will receive this callback after calling [V2TXLivePlayer enableCustomRendering:pixelFormat:bufferType:] to enable custom video rendering.

    - (void)onRenderVideoFrame:(id<V2TXLivePlayer>)player
                       frame:(V2TXLiveVideoFrame *)videoFrame
    

    Parameters

    Parameter Type Description
    player V2TXLivePlayer The player object sending the callback
    videoFrame V2TXLiveVideoFrame * Video frame

    Audio Callback APIs

    onAudioPlaying

    Callback for audio playback

    - (void)onAudioPlaying:(id<V2TXLivePlayer>)player 
                firstPlay:(BOOL)firstPlay 
                extraInfo:(NSDictionary *)extraInfo;
    

    Parameters

    Parameter Type Description
    player V2TXLivePlayer The player object sending the callback
    firstPlay BOOL Whether it is the first playback
    extraInfo NSDictionary * Extra information

    onAudioLoading

    Callback for loading audio

    - (void)onAudioLoading:(id<V2TXLivePlayer>)player 
                extraInfo:(NSDictionary *)extraInfo;
    

    Parameters

    Parameter Type Description
    player V2TXLivePlayer The player object sending the callback
    extraInfo NSDictionary * Extra information

    onPlayoutVolumeUpdate

    Callback of the player’s volume

    - (void)onPlayoutVolumeUpdate:(id<V2TXLivePlayer>)player volume:(NSInteger)volume
    

    Parameters

    Parameter Type Description
    player V2TXLivePlayer The player object sending the callback
    volume NSInteger Volume. Value range: 0-100

    Statistics Callback API

    onStatisticsUpdate

    Callback of the player’s statistics

    - (void)onStatisticsUpdate:(id<V2TXLivePlayer>)player
                   statistics:(V2TXLivePlayerStatistics *)statistics
    

    Parameters

    Parameter Type Description
    player V2TXLivePlayer The player object sending the callback
    statistics V2TXLivePlayerStatistics Player statistics
    Contact Us

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

    Technical Support

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

    7x24 Phone Support