You need to enable JavaScript to run this app.
导航
视频直播
  • 文档首页
    • /视频直播/客户端 SDK/拉流 SDK/Android/SDK API 参考/回调
回调
最近更新时间：2024.10.25 18:38:03首次发布时间：2023.03.16 14:24:57
我的收藏

VeLivePlayerObserver
public interface com.ss.videoarch.liveplayer.VeLivePlayerObserver

播放器事件回调。

成员函数

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

函数说明

onError

default void com.ss.videoarch.liveplayer.VeLivePlayerObserver.onError(
    VeLivePlayer player,
    VeLivePlayerError error
)

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

传入参数

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

onFirstVideoFrameRender

default void com.ss.videoarch.liveplayer.VeLivePlayerObserver.onFirstVideoFrameRender(
    VeLivePlayer player,
    boolean isFirstFrame
)

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

传入参数

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

onFirstAudioFrameRender

default void com.ss.videoarch.liveplayer.VeLivePlayerObserver.onFirstAudioFrameRender(
    VeLivePlayer player,
    boolean isFirstFrame
)

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

传入参数

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

onStallStart

default void com.ss.videoarch.liveplayer.VeLivePlayerObserver.onStallStart(VeLivePlayer player)

播放卡顿开始回调。

传入参数

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

onStallEnd

default void com.ss.videoarch.liveplayer.VeLivePlayerObserver.onStallEnd(VeLivePlayer player)

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

传入参数

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

onVideoRenderStall

default void com.ss.videoarch.liveplayer.VeLivePlayerObserver.onVideoRenderStall(
    VeLivePlayer player,
    long stallTime
)

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

传入参数

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

onAudioRenderStall

default void com.ss.videoarch.liveplayer.VeLivePlayerObserver.onAudioRenderStall(
    VeLivePlayer player,
    long stallTime
)

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

传入参数

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

onResolutionSwitch

default void com.ss.videoarch.liveplayer.VeLivePlayerObserver.onResolutionSwitch(
    VeLivePlayer player,
    VeLivePlayerResolution resolution,
    VeLivePlayerError error,
    VeLivePlayerResolutionSwitchReason reason
)

清晰度档位变化回调。

传入参数

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

onVideoSizeChanged

default void com.ss.videoarch.liveplayer.VeLivePlayerObserver.onVideoSizeChanged(
    VeLivePlayer player,
    int width,
    int height
)

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

传入参数

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

onReceiveSeiMessage

default void com.ss.videoarch.liveplayer.VeLivePlayerObserver.onReceiveSeiMessage(
    VeLivePlayer player,
    String message
)

字符串 SEI 消息回调，当播放器 SDK 接收到 SEI 消息时，触发该回调。需要开启 VeLivePlayerConfiguration 中 enableSei 属性。当 enableBinarySei 属性开启时，字符串 SEI 消息将不再发送。

传入参数

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

onReceiveBinarySeiMessage

default void com.ss.videoarch.liveplayer.VeLivePlayerObserver.onReceiveBinarySeiMessage(
    VeLivePlayer player,
    byte[] message
)

二级制 SEI 消息回调，当播放器 SDK 接收到 SEI 消息时，触发该回调。需要开启 VeLivePlayerConfiguration 中 enableBinarySei 属性。当 enableBinarySei 属性开启时，字符串 SEI 消息将不再发送。

传入参数

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

onMainBackupSwitch

default void com.ss.videoarch.liveplayer.VeLivePlayerObserver.onMainBackupSwitch(
    VeLivePlayer player,
    VeLivePlayerStreamType streamType,
    VeLivePlayerError error
)

主备流切换回调。

传入参数

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

onPlayerStatusUpdate

default void com.ss.videoarch.liveplayer.VeLivePlayerObserver.onPlayerStatusUpdate(
    VeLivePlayer player,
    VeLivePlayerStatus status
)

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

传入参数

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

onStatistics

default void com.ss.videoarch.liveplayer.VeLivePlayerObserver.onStatistics(
    VeLivePlayer player,
    VeLivePlayerStatistics statistics
)

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

传入参数

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

onSnapshotComplete

default void com.ss.videoarch.liveplayer.VeLivePlayerObserver.onSnapshotComplete(
    VeLivePlayer player,
    Bitmap bitmap
)

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

传入参数

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

onRenderVideoFrame

default void com.ss.videoarch.liveplayer.VeLivePlayerObserver.onRenderVideoFrame(
    VeLivePlayer player,
    VeLivePlayerVideoFrame videoFrame
)

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

传入参数

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

注意

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

onRenderAudioFrame

default void com.ss.videoarch.liveplayer.VeLivePlayerObserver.onRenderAudioFrame(
    VeLivePlayer player,
    VeLivePlayerAudioFrame audioFrame
)

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

传入参数

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

注意

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

onStreamFailedOpenSuperResolution

default void com.ss.videoarch.liveplayer.VeLivePlayerObserver.onStreamFailedOpenSuperResolution(
    VeLivePlayer player,
    VeLivePlayerError error
)

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

传入参数

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

onStreamFailedOpenSharpen

default void com.ss.videoarch.liveplayer.VeLivePlayerObserver.onStreamFailedOpenSharpen(
    VeLivePlayer player,
    VeLivePlayerError error
)

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

传入参数

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