You need to enable JavaScript to run this app.
文档中心
视频直播

视频直播

复制全文
下载 pdf
SDK API 参考
回调
复制全文
下载 pdf
回调

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

播放器事件回调。

成员函数

返回

名称

default void

onError

default void

onInfo

default void

onFirstVideoFrameRender

default void

onFirstAudioFrameRender

default void

onStallStart

default void

onStallEnd

default void

onVideoRenderStall

default void

onAudioRenderStall

default void

onResolutionSwitch

default void

onVideoSizeChanged

default void

onReceiveSeiMessage

default void

onReceiveBinarySeiMessage

default void

onMainBackupSwitch

default void

onStreamFormatSwitch

default void

onPlayerStatusUpdate

default void

onStatistics

default void

onSnapshotComplete

default void

onRenderVideoFrame

default void

onRenderAudioFrame

default void

onStreamFailedOpenSuperResolution

default void

onStreamFailedOpenSharpen

函数说明

onError

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

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

参数名

类型

说明

player

VeLivePlayer

触发该事件回调的播放器对象。

error

VeLivePlayerError

错误信息,详情请参见 VeLivePlayerError

onInfo

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

播放器信息回调。在播放器有内部错误时,SDK 会触发此回调。
传入参数

参数名

类型

说明

player

VeLivePlayer

触发该回调的播放器对象。详见 VeLivePlayer

error

VeLivePlayerError

播放器信息。详见 VeLivePlayerError

onFirstVideoFrameRender

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

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

参数名

类型

说明

player

VeLivePlayer

触发该事件回调的播放器对象。

isFirstFrame

boolean

渲染成功的是否为视频首帧。

  • true:视频首帧;
  • false:重试后第一个视频帧。

onFirstAudioFrameRender

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

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

参数名

类型

说明

player

VeLivePlayer

触发该事件回调的播放器对象。

isFirstFrame

boolean

渲染成功的是否为音频首帧。

  • true:音频首帧;
  • false:重试后第一个音频帧。

onStallStart

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

播放卡顿开始回调。
传入参数

参数名

类型

说明

player

VeLivePlayer

触发该事件回调的播放器对象。

onStallEnd

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

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

参数名

类型

说明

player

VeLivePlayer

触发该事件回调的播放器对象。

onVideoRenderStall

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

视频渲染卡顿回调。视频渲染发生卡顿时,触发此回调。
传入参数

参数名

类型

说明

player

VeLivePlayer

触发该事件回调的播放器对象。

stallTime

long

视频渲染卡顿时长,单位为 ms。

onAudioRenderStall

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

音频渲染卡顿回调。音频渲染发生卡顿时,触发此回调。
传入参数

参数名

类型

说明

player

VeLivePlayer

触发该事件回调的播放器对象。

stallTime

long

音频渲染卡顿时长,单位为 ms。

onResolutionSwitch

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

清晰度档位变化回调。
传入参数

参数名

类型

说明

player

VeLivePlayer

触发该事件回调的播放器对象。

resolution

VeLivePlayerResolution

切换后的清晰度档位,详情请参见 VeLivePlayerResolution

error

VeLivePlayerError

切换清晰度档位时,是否发生错误,详情请参见 VeLivePlayerError

reason

VeLivePlayerResolutionSwitchReason

清晰度档位切换的原因,详情请参见 VeLivePlayerResolutionSwitchReason

onVideoSizeChanged

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

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

参数名

类型

说明

player

VeLivePlayer

触发该事件回调的播放器对象。

width

int

变化后的视频宽度,单位为 px。

height

int

变化后的视频高度,单位为 px。

onReceiveSeiMessage

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

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

参数名

类型

说明

player

VeLivePlayer

触发该事件回调的播放器对象。

message

String

SEI 信息。

onReceiveBinarySeiMessage

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

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

参数名

类型

说明

player

VeLivePlayer

触发该事件回调的播放器对象。

message

byte[]

SEI 信息。

onMainBackupSwitch

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

主备流切换回调。
传入参数

参数名

类型

说明

player

VeLivePlayer

触发该事件回调的播放器对象。

streamType

VeLivePlayerStreamType

切换后的流类型为主路流或备路流,详情请参见 VeLivePlayerStreamType

error

VeLivePlayerError

触发主备流切换的原因,详情请参见 VeLivePlayerError

onStreamFormatSwitch

default void com.ss.videoarch.liveplayer.VeLivePlayerObserver.onStreamFormatSwitch(
    VeLivePlayer player,
    VeLivePlayerFormat fromStreamFormat,
    VeLivePlayerFormat toStreamFormat,
    VeLivePlayerError error,
    Bundle extraInfo
)

当播放器切换流的格式时,SDK 会触发此回调。
传入参数

参数名

类型

说明

player

VeLivePlayer

触发该回调的播放器对象。详见 VeLivePlayer

fromStreamFormat

VeLivePlayerFormat

切换前的流格式。详见 VeLivePlayerFormat

toStreamFormat

VeLivePlayerFormat

切换后的流格式。详见 VeLivePlayerFormat

error

VeLivePlayerError

触发流格式切换的原因。详见 VeLivePlayerError

extraInfo

Bundle

额外信息,包含切换相关的详细数据。

onPlayerStatusUpdate

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

播放状态发生变化时,触发回调。
传入参数

参数名

类型

说明

player

VeLivePlayer

触发该事件回调的播放器对象。

status

VeLivePlayerStatus

当前播放器的状态,详情请参见 VeLivePlayerStatus

onStatistics

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

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

参数名

类型

说明

player

VeLivePlayer

触发该事件回调的播放器对象。

statistics

VeLivePlayerStatistics

播放器周期性回调的统计信息,详情请参见 VeLivePlayerStatistics

onSnapshotComplete

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

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

参数名

类型

说明

player

VeLivePlayer

触发该事件回调的播放器对象。

bitmap

Bitmap

截图的 Bitmap 对象。

onRenderVideoFrame

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

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

参数名

类型

说明

player

VeLivePlayer

触发该事件回调的播放器对象。

videoFrame

VeLivePlayerVideoFrame

视频帧数据,包含像素格式、封装格式、视频宽高等信息,详情请参见 VeLivePlayerVideoFrame

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

onRenderAudioFrame

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

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

参数名

类型

说明

player

VeLivePlayer

触发该事件回调的播放器对象。

audioFrame

VeLivePlayerAudioFrame

音频数据,详情请参见 VeLivePlayerAudioFrame

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

onStreamFailedOpenSuperResolution

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

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

参数名

类型

说明

player

VeLivePlayer

触发该事件回调的播放器对象。

error

VeLivePlayerError

超分开启失败原因,错误码请参见 VeLivePlayerErrorCode

onStreamFailedOpenSharpen

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

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

参数名

类型

说明

player

VeLivePlayer

触发该事件回调的播放器对象

error

VeLivePlayerError

锐化开启失败原因。错误码请参见 VeLivePlayerErrorCode

最近更新时间:2026.04.07 23:17:22
这个页面对您有帮助吗?
有用
有用
无用
无用