文档中心

视频直播

SDK API 参考

回调

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	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。

onPlayerStatusUpdate

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

播放状态发生变化时，触发此回调。相比 onPlayerStatusUpdate，本回调通过 extraInfo 返回当前播放流的补充信息。

传入参数

参数名类型说明

player VeLivePlayer 播放状态发生变化的播放器对象。

status VeLivePlayerStatus 当前播放器的状态，详情请参见 VeLivePlayerStatus。

extraInfo

Bundle

当前播放流的补充信息 Bundle，可能包含以下键：

url (String)：当前正在播放的流地址。
all_resolution_urls (Bundle)：所有清晰度档位对应的播放地址映射，Key 为清晰度标识，Value 为对应播放地址。仅在当前流为多分辨率流时存在。
resolution (String)：当前播放的清晰度标识。仅在当前流为多分辨率流时存在。
enable_abr (boolean)：是否开启自适应码率（ABR）。仅在当前流为多分辨率流时存在。取值如下：
- true：已开启。
- false：未开启。
enable_smooth_switch_resolution (boolean)：是否开启平滑切档功能。仅在当前流为多分辨率流时存在。取值如下：
- true：已开启。
- false：未开启。
max_retry_count (int)：当前流的最大重试次数。
retry_interval_time_ms (int)：当前流的重试间隔时间，单位为毫秒。
priority (int)：当前流在拉流列表中的优先级。

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.10.12 11:50:40

这个页面对您有帮助吗？

有用

无用

视频直播

成员函数 #

函数说明 #

onError #

onInfo #

onFirstVideoFrameRender #

onFirstAudioFrameRender #

onStallStart #

onStallEnd #

onVideoRenderStall #

onAudioRenderStall #

onResolutionSwitch #

onVideoSizeChanged #

onReceiveSeiMessage #

onReceiveBinarySeiMessage #

onMainBackupSwitch #

onStreamFormatSwitch #

onPlayerStatusUpdate #

onPlayerStatusUpdate #

onStatistics #

onSnapshotComplete #

onRenderVideoFrame #

onRenderAudioFrame #

onStreamFailedOpenSuperResolution #

onStreamFailedOpenSharpen #

成员函数

函数说明

onError

onInfo

onFirstVideoFrameRender

onFirstAudioFrameRender

onStallStart

onStallEnd

onVideoRenderStall

onAudioRenderStall

onResolutionSwitch

onVideoSizeChanged

onReceiveSeiMessage

onReceiveBinarySeiMessage

onMainBackupSwitch

onStreamFormatSwitch

onPlayerStatusUpdate

onPlayerStatusUpdate

onStatistics

onSnapshotComplete

onRenderVideoFrame

onRenderAudioFrame

onStreamFailedOpenSuperResolution

onStreamFailedOpenSharpen