You need to enable JavaScript to run this app.
导航

回调

最近更新时间2024.04.19 14:57:37

首次发布时间2023.03.16 14:24:57

VeLivePlayerObserver
public interface VeLivePlayerObserver

播放器事件回调。

成员函数

返回名称
voidonError
voidonFirstVideoFrameRender
voidonFirstAudioFrameRender
voidonStallStart
voidonStallEnd
voidonVideoRenderStall
voidonAudioRenderStall
voidonResolutionSwitch
voidonVideoSizeChanged
voidonReceiveSeiMessage
voidonMainBackupSwitch
voidonPlayerStatusUpdate
voidonStatistics
voidonSnapshotComplete
voidonRenderVideoFrame
voidonRenderAudioFrame
voidonStreamFailedOpenSuperResolution

函数说明

onError

void onError(
    VeLivePlayer player,
    VeLivePlayerError error
)

播放器错误信息回调,播放器出现错误时,触发回调。

传入参数

参数名类型说明
playerVeLivePlayer触发该事件回调的播放器对象。
errorVeLivePlayerError错误信息,详情请参见 VeLivePlayerError

onFirstVideoFrameRender

void onFirstVideoFrameRender(
    VeLivePlayer player,
    boolean isFirstFrame
)

视频首帧渲染事件回调。视频首帧渲染成功,或播放过程中发生重试,重试后的第一个视频帧渲染成功,均会触发此回调。

传入参数

参数名类型说明
playerVeLivePlayer触发该事件回调的播放器对象。
isFirstFrameboolean渲染成功的是否为视频首帧。
  • true:视频首帧;
  • false:重试后第一个视频帧。

onFirstAudioFrameRender

void onFirstAudioFrameRender(
    VeLivePlayer player,
    boolean isFirstFrame
)

音频首帧渲染事件回调。音频首帧渲染成功,或播放过程中发生重试,重试后的第一个音频帧渲染成功,均会触发此回调。

传入参数

参数名类型说明
playerVeLivePlayer触发该事件回调的播放器对象。
isFirstFrameboolean渲染成功的是否为音频首帧。
  • true:音频首帧;
  • false:重试后第一个音频帧。

onStallStart

void onStallStart(VeLivePlayer player)

播放卡顿开始回调。

传入参数

参数名类型说明
playerVeLivePlayer触发该事件回调的播放器对象。

onStallEnd

void onStallEnd(VeLivePlayer player)

播放卡顿结束回调。音频缓冲区达到起播条件且开始播放后,触发此回调。

传入参数

参数名类型说明
playerVeLivePlayer触发该事件回调的播放器对象。

onVideoRenderStall

void onVideoRenderStall(
    VeLivePlayer player,
    long stallTime
)

视频渲染卡顿回调。视频渲染发生卡顿时,触发此回调。

传入参数

参数名类型说明
playerVeLivePlayer触发该事件回调的播放器对象。
stallTimelong视频渲染卡顿时长,单位为 ms。

onAudioRenderStall

void onAudioRenderStall(
    VeLivePlayer player,
    long stallTime
)

音频渲染卡顿回调。音频渲染发生卡顿时,触发此回调。

传入参数

参数名类型说明
playerVeLivePlayer触发该事件回调的播放器对象。
stallTimelong音频渲染卡顿时长,单位为 ms。

onResolutionSwitch

void onResolutionSwitch(
    VeLivePlayer player,
    VeLivePlayerResolution resolution,
    VeLivePlayerError error,
    VeLivePlayerResolutionSwitchReason reason
)

清晰度档位变化回调。

传入参数

参数名类型说明
playerVeLivePlayer触发该事件回调的播放器对象。
resolutionVeLivePlayerResolution切换后的清晰度档位,详情请参见 VeLivePlayerResolution
errorVeLivePlayerError切换清晰度档位时,是否发生错误,详情请参见 VeLivePlayerError
reasonVeLivePlayerResolutionSwitchReason清晰度档位切换的原因,详情请参见 VeLivePlayerResolutionSwitchReason

onVideoSizeChanged

void onVideoSizeChanged(
    VeLivePlayer player,
    int width,
    int height
)

视频分辨率变化回调。视频大小发生变化时,触发回调。

传入参数

参数名类型说明
playerVeLivePlayer触发该事件回调的播放器对象。
widthint变化后的视频宽度,单位为 px。
heightint变化后的视频高度,单位为 px。

onReceiveSeiMessage

void onReceiveSeiMessage(
    VeLivePlayer player,
    String message
)

SEI 信息回调。当播放器 SDK 接收到 SEI 信息时,触发回调。

传入参数

参数名类型说明
playerVeLivePlayer触发该事件回调的播放器对象。
messageStringSEI 信息。

onMainBackupSwitch

void onMainBackupSwitch(
    VeLivePlayer player,
    VeLivePlayerStreamType streamType,
    VeLivePlayerError error
)

主备流切换回调。

传入参数

参数名类型说明
playerVeLivePlayer触发该事件回调的播放器对象。
streamTypeVeLivePlayerStreamType切换后的流类型为主路流或备路流,详情请参见 VeLivePlayerStreamType
errorVeLivePlayerError触发主备流切换的原因,详情请参见 VeLivePlayerError

onPlayerStatusUpdate

void onPlayerStatusUpdate(
    VeLivePlayer player,
    VeLivePlayerStatus status
)

播放状态发生变化时,触发回调。

传入参数

参数名类型说明
playerVeLivePlayer触发该事件回调的播放器对象。
statusVeLivePlayerStatus当前播放器的状态,详情请参见 VeLivePlayerStatus

onStatistics

void onStatistics(
    VeLivePlayer player,
    VeLivePlayerStatistics statistics
)

播放信息周期性回调。播放器 SDK 会周期性地回调本方法,您可以通过本方法获取当前播放器的播放地址、码率和帧率等信息。

传入参数

参数名类型说明
playerVeLivePlayer触发该事件回调的播放器对象。
statisticsVeLivePlayerStatistics播放器周期性回调的统计信息,详情请参见 VeLivePlayerStatistics

onSnapshotComplete

void onSnapshotComplete(
    VeLivePlayer player,
    Bitmap bitmap
)

截图成功回调。当播放器调用 snapshot 截图成功后,会触发此回调。

传入参数

参数名类型说明
playerVeLivePlayer触发该事件回调的播放器对象。
bitmapBitmap截图的 Bitmap 对象。

onRenderVideoFrame

void onRenderVideoFrame(
    VeLivePlayer player,
    VeLivePlayerVideoFrame videoFrame
)

视频帧回调。调用 enableVideoFrameObserver 开启视频帧解析回调后,当播放器成功解码视频帧时,会触发此回调。

传入参数

参数名类型说明
playerVeLivePlayer触发该事件回调的播放器对象。
videoFrameVeLivePlayerVideoFrame视频帧数据,包含像素格式、封装格式、视频宽高等信息,详情请参见 VeLivePlayerVideoFrame

注意

如果自定义渲染使用纹理格式,建议在视频帧回调线程中执行渲染操作。

onRenderAudioFrame

void onRenderAudioFrame(
    VeLivePlayer player,
    VeLivePlayerAudioFrame audioFrame
)

音频帧回调。调用 enableAudioFrameObserver 开启音频帧解析回调后,当播放器成功解码音频帧时,会触发此回调。

传入参数

参数名类型说明
playerVeLivePlayer触发该事件回调的播放器对象。
audioFrameVeLivePlayerAudioFrame音频数据,详情请参见 VeLivePlayerAudioFrame

注意

回调的音频帧数据为 float32 格式,大端字节序存储。

onStreamFailedOpenSuperResolution

void onStreamFailedOpenSuperResolution(
    VeLivePlayer player,
    VeLivePlayerError error
)

超分开启失败。调用 setEnableSuperResolution 开启超分后,当播放器不支持超分开启或者超分处理出错时,会触发此回调。

传入参数

参数名类型说明
playerVeLivePlayer触发该事件回调的播放器对象。
errorVeLivePlayerError超分开启失败原因,错误码请参见 VeLivePlayerErrorCode