You need to enable JavaScript to run this app.
最新活动
产品
解决方案
定价
生态与合作
支持与服务
开发者
了解我们
导航

消息回调与异常说明

最近更新时间2023.09.14 19:21:05

首次发布时间2022.01.17 10:33:21

本章节为您介绍拉流 SDK 相关的消息回调。

适用版本

本文档适用于 V1.39.1 版本的客户端 SDK,其他版本请参考历史版本文档。

前提条件

设置监听

通过实现 VeLivePlayerObserver 中定义的方法进行对播放中的各种状态及事件进行监听。

// VeLivePlayerObserver 回调
VeLivePlayerObserver mLivePlayerObserver = new VeLivePlayerObserver() {
	...
}
// 设置播放器回调
mLivePlayer.setObserver(mLivePlayerObserver);

播放器消息回调

回调说明
onError播放器错误信息回调,播放器出现错误时,触发回调。
onFirstVideoFrameRender视频首帧渲染事件回调。视频首帧渲染成功,或播放过程中发生重试,重试后的第一个视频帧渲染成功,均会触发此回调。
onFirstAudioFrameRender音频首帧渲染事件回调。音频首帧渲染成功,或播放过程中发生重试,重试后的第一个音频帧渲染成功,均会触发此回调。
onStallStart播放卡顿开始回调。音频缓冲区为 0 时,触发此回调。
onStallEnd播放卡顿结束回调。音频缓冲区达到起播条件且开始播放后,触发此回调。
onVideoRenderStall视频渲染卡顿回调。视频渲染发生卡顿时,触发此回调。
onAudioRenderStall音频渲染卡顿回调。音频渲染发生卡顿时,触发此回调。
onResolutionSwitch清晰度档位变化回调。
onVideoSizeChanged视频分辨率变化回调。视频大小发生变化时,触发回调。
onReceiveSeiMessageSEI 信息回调。当播放器 SDK 接收到 SEI 信息时,触发回调。
onMainBackupSwitch主备流切换回调。
onPlayerStatusUpdate播放状态发生变化时,触发回调。
onStatistics播放信息周期性回调。播放器 SDK 会周期性地回调本方法,您可以通过本方法获取当前播放器的播放地址、码率和帧率等信息。
onSnapshotComplete截图成功回调。当播放器调用 snapshot 截图成功后,会触发此回调。
onRenderVideoFrame视频帧回调。调用 enableVideoFrameObserver 开启视频帧解析回调后,当播放器成功解码视频帧时,会触发此回调。
onRenderAudioFrame音频帧回调。调用 enableAudioFrameObserver 开启音频帧解析回调后,当播放器成功解码音频帧时,会触发此回调。

播放器异常错误码定义及说明

错误码名称错误码数值错误码含义建议处理方式
VeLivePlayerNoError0无错误-
VeLivePlayerInvalidLicense-1License 证书无效可能证书集成错误或证书过期,请检查证书集成方式和有效性。
VeLivePlayerInvalidParameter-2调用时传入的参数不合法请检查入参,并重新调用。
VeLivePlayerErrorRefused-3调用被拒绝方法调用时机不合法,请检查调用时机。
VeLivePlayerErrorLibraryLoadFailed-4加载库文件失败可能是 SDK 集成错误,请检查 SDK 集成方式。
VeLivePlayerErrorPlayUrl-100播放地址不存在或无效可能是播放地址为空、地址格式不合法或地址长度不合法,请检查播放地址。
VeLivePlayerErrorNoStreamData-101无法获取流数据可能是直播流不存在、直播流中断或直播已结束,请检查直播状态。
VeLivePlayerErrorInternalRetryStart-102内部播放重试可能由于播放器内部错误触发了重试。
VeLivePlayerErrorInternalRetryFailed-103内部重试失败内部重试次数达到最大限制,播放器停止重试,您可以尝试重新播放。
VeLivePlayerErrorDnsParseFailed-200DNS 解析失败可能是播放地址异常或客户端网络异常,请您检查播放地址和网络情况,如果故障未排除,请联系火山引擎技术支持
VeLivePlayerErrorNetworkRequestFailed-201网络请求失败请检查网络情况,如果故障未排除,请联系火山引擎技术支持
VeLivePlayerErrorDemuxFailed-300直播格式解封装失败可能是使用了不支持的直播流格式和协议,或音视频流错误;请检查流格式,如果故障未排除,请联系火山引擎技术支持
VeLivePlayerErrorDecodeFailed-301视频解码失败。可能使用了不支持的直播流音视频格式,或解码器出错;请检查音视频格式,如果故障未排除,请联系火山引擎技术支持
VeLivePlayerErrorAVOutputFailed-302渲染失败可能是音视频输出设备异常,请重试;如果故障未排除,请联系火山引擎技术支持
VeLivePlayerLicenseUnsupportedH265-308您使用的基础版 License 暂不支持 H.265 硬件解码请登录火山引擎控制台获取高级版 License。
VeLivePlayerErrorInternal-999内部错误请联系火山引擎技术支持