tencent cloud

文档反馈

V2TXLivePlayerObserver

最后更新时间:2024-11-28 17:46:19
    Copyright (c) 2021 Tencent. All rights reserved.
    
    Module: V2TXLivePlayerObserver @ TXLiteAVSDK
    
    Function: 腾讯云直播的播放器回调通知
    

    功能

    腾讯云直播的播放器回调通知。

    介绍

    可以接收 V2TXLivePlayer 播放器的一些回调通知,包括播放器状态、播放音量回调、音视频首帧回调、统计数据、警告和错误信息等。
    
    V2TXLivePlayerObserver

    V2TXLivePlayerObserver

    函数列表
    描述
    直播播放器错误通知,播放器出现错误时,会回调该通知
    直播播放器警告通知
    直播播放器分辨率变化通知
    已经成功连接到服务器
    视频播放事件
    音频播放事件
    视频加载事件
    音频加载事件
    播放器音量大小回调
    直播播放器统计数据回调
    截图回调
    自定义视频渲染回调
    音频数据回调
    收到 SEI 消息的回调,发送端通过 V2TXLivePusher 中的 sendSeiMessage 来发送 SEI 消息
    分辨率无缝切换回调
    录制任务开始的事件回调
    录制任务正在进行中的进展事件回调
    录制任务已经结束的事件回调

    onError

    onError
    void onError
    (V2TXLivePlayer player
    
    int code
    
    String msg
    
    Bundle extraInfo)

    直播播放器错误通知,播放器出现错误时,会回调该通知

    参数
    描述
    code
    错误码 V2TXLiveCode
    extraInfo
    扩展信息。
    msg
    错误信息。
    player
    回调该通知的播放器对象。

    onWarning

    onWarning
    void onWarning
    (V2TXLivePlayer player
    
    int code
    
    String msg
    
    Bundle extraInfo)

    直播播放器警告通知

    参数
    描述
    code
    警告码 V2TXLiveCode
    extraInfo
    扩展信息。
    msg
    警告信息。
    player
    回调该通知的播放器对象。

    onVideoResolutionChanged

    onVideoResolutionChanged
    void onVideoResolutionChanged
    (V2TXLivePlayer player
    
    int width
    
    int height)

    直播播放器分辨率变化通知

    参数
    描述
    height
    视频高。
    player
    回调该通知的播放器对象。
    width
    视频宽。

    onConnected

    onConnected
    void onConnected
    (V2TXLivePlayer player
    
    Bundle extraInfo)

    已经成功连接到服务器

    参数
    描述
    extraInfo
    扩展信息。
    player
    回调该通知的播放器对象。

    onVideoPlaying

    onVideoPlaying
    void onVideoPlaying
    (V2TXLivePlayer player
    
    boolean firstPlay
    
    Bundle extraInfo)

    视频播放事件

    参数
    描述
    extraInfo
    扩展信息。
    firstPlay
    第一次播放标志。
    player
    回调该通知的播放器对象。

    onAudioPlaying

    onAudioPlaying
    void onAudioPlaying
    (V2TXLivePlayer player
    
    boolean firstPlay
    
    Bundle extraInfo)

    音频播放事件

    参数
    描述
    extraInfo
    扩展信息。
    firstPlay
    第一次播放标志。
    player
    回调该通知的播放器对象。

    onVideoLoading

    onVideoLoading
    void onVideoLoading
    (V2TXLivePlayer player
    
    Bundle extraInfo)

    视频加载事件

    参数
    描述
    extraInfo
    扩展信息。
    player
    回调该通知的播放器对象。

    onAudioLoading

    onAudioLoading
    void onAudioLoading
    (V2TXLivePlayer player
    
    Bundle extraInfo)

    音频加载事件

    参数
    描述
    extraInfo
    扩展信息。
    player
    回调该通知的播放器对象。

    onPlayoutVolumeUpdate

    onPlayoutVolumeUpdate
    void onPlayoutVolumeUpdate
    (V2TXLivePlayer player
    
    int volume)

    播放器音量大小回调

    参数
    描述
    player
    回调该通知的播放器对象。
    volume
    音量大小。
    注意
    调用 enableVolumeEvaluation 开启播放音量大小提示之后,会收到这个回调通知。

    onStatisticsUpdate

    onStatisticsUpdate
    void onStatisticsUpdate
    (V2TXLivePlayer player
    
    V2TXLivePlayerStatistics statistics)

    直播播放器统计数据回调

    参数
    描述
    player
    回调该通知的播放器对象。
    statistics
    播放器统计数据 V2TXLivePlayerStatistics

    onSnapshotComplete

    onSnapshotComplete
    void onSnapshotComplete
    (V2TXLivePlayer player
    
    Bitmap image)

    截图回调

    参数
    描述
    image
    已截取的视频画面。
    player
    回调该通知的播放器对象。

    onRenderVideoFrame

    onRenderVideoFrame
    void onRenderVideoFrame
    (V2TXLivePlayer player
    
    V2TXLiveVideoFrame videoFrame)

    自定义视频渲染回调

    参数
    描述
    player
    回调该通知的播放器对象。
    videoFrame
    视频帧数据 V2TXLiveVideoFrame
    注意
    需要您调用 enableObserveVideoFrame 开启回调开关。

    onPlayoutAudioFrame

    onPlayoutAudioFrame
    void onPlayoutAudioFrame
    (V2TXLivePlayer player
    
    V2TXLiveAudioFrame audioFrame)

    音频数据回调

    参数
    描述
    audioFrame
    音频帧数据 V2TXLiveAudioFrame
    player
    回调该通知的播放器对象。
    注意
    需要您调用 enableObserveAudioFrame 开启回调开关。请在当前回调中使用 audioFrame 的 data。

    onReceiveSeiMessage

    onReceiveSeiMessage
    void onReceiveSeiMessage
    (V2TXLivePlayer player
    
    int payloadType
    
    byte[] data)

    收到 SEI 消息的回调,发送端通过 {@link V2TXLivePusher} 中的 `sendSeiMessage` 来发送 SEI 消息

    参数
    描述
    data
    数据。
    payloadType
    回调数据的SEI payloadType。
    player
    回调该通知的播放器对象。
    注意
    调用 V2TXLivePlayer 中的 enableReceiveSeiMessage 开启接收 SEI 消息之后,会收到这个回调通知。

    onStreamSwitched

    onStreamSwitched
    void onStreamSwitched
    (V2TXLivePlayer player
    
    String url
    
    int code)

    分辨率无缝切换回调

    参数
    描述
    code
    状态码,0:成功,-1:切换超时,-2:切换失败,服务端错误,-3:切换失败,客户端错误。
    player
    回调该通知的播放器对象。
    url
    切换的播放地址。
    注意
    调用 V2TXLivePlayer 中的 switchStream 切换分辨率,会收到这个回调通知。

    onLocalRecordBegin

    onLocalRecordBegin
    void onLocalRecordBegin
    (V2TXLivePlayer player
    
    int code
    
    String storagePath)

    录制任务开始的事件回调

    参数
    描述
    code
    状态码。
    0:录制任务启动成功。
    -1:内部错误导致录制任务启动失败。
    -2:文件后缀名有误(比如不支持的录制格式)。
    -6:录制已经启动,需要先停止录制。
    -7:录制文件已存在,需要先删除文件。
    -8:录制目录无写入权限,请检查目录权限问题。
    player
    回调该通知的播放器对象。
    storagePath
    录制的文件地址。

    onLocalRecording

    onLocalRecording
    void onLocalRecording
    (V2TXLivePlayer player
    
    long durationMs
    
    String storagePath)

    录制任务正在进行中的进展事件回调

    参数
    描述
    durationMs
    录制时长。
    player
    回调该通知的播放器对象。
    storagePath
    录制的文件地址。

    onLocalRecordComplete

    onLocalRecordComplete
    void onLocalRecordComplete
    (V2TXLivePlayer player
    
    int code
    
    String storagePath)

    录制任务已经结束的事件回调

    参数
    描述
    code
    状态码。
    0:结束录制任务成功。
    -1:录制失败。
    -2:切换分辨率或横竖屏导致录制结束。
    -3:录制时间太短,或未采集到任何视频或音频数据,请检查录制时长,或是否已开启音、视频采集。
    player
    回调该通知的播放器对象。
    storagePath
    录制的文件地址。
    联系我们

    联系我们,为您的业务提供专属服务。

    技术支持

    如果你想寻求进一步的帮助,通过工单与我们进行联络。我们提供7x24的工单服务。

    7x24 电话支持