最近更新时间: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 | 视频分辨率变化回调。视频大小发生变化时,触发回调。 |
onReceiveSeiMessage | SEI 信息回调。当播放器 SDK 接收到 SEI 信息时,触发回调。 |
onMainBackupSwitch | 主备流切换回调。 |
onPlayerStatusUpdate | 播放状态发生变化时,触发回调。 |
onStatistics | 播放信息周期性回调。播放器 SDK 会周期性地回调本方法,您可以通过本方法获取当前播放器的播放地址、码率和帧率等信息。 |
onSnapshotComplete | 截图成功回调。当播放器调用 snapshot 截图成功后,会触发此回调。 |
onRenderVideoFrame | 视频帧回调。调用 enableVideoFrameObserver 开启视频帧解析回调后,当播放器成功解码视频帧时,会触发此回调。 |
onRenderAudioFrame | 音频帧回调。调用 enableAudioFrameObserver 开启音频帧解析回调后,当播放器成功解码音频帧时,会触发此回调。 |
错误码名称 | 错误码数值 | 错误码含义 | 建议处理方式 |
---|---|---|---|
VeLivePlayerNoError | 0 | 无错误 | - |
VeLivePlayerInvalidLicense | -1 | License 证书无效 | 可能证书集成错误或证书过期,请检查证书集成方式和有效性。 |
VeLivePlayerInvalidParameter | -2 | 调用时传入的参数不合法 | 请检查入参,并重新调用。 |
VeLivePlayerErrorRefused | -3 | 调用被拒绝 | 方法调用时机不合法,请检查调用时机。 |
VeLivePlayerErrorLibraryLoadFailed | -4 | 加载库文件失败 | 可能是 SDK 集成错误,请检查 SDK 集成方式。 |
VeLivePlayerErrorPlayUrl | -100 | 播放地址不存在或无效 | 可能是播放地址为空、地址格式不合法或地址长度不合法,请检查播放地址。 |
VeLivePlayerErrorNoStreamData | -101 | 无法获取流数据 | 可能是直播流不存在、直播流中断或直播已结束,请检查直播状态。 |
VeLivePlayerErrorInternalRetryStart | -102 | 内部播放重试 | 可能由于播放器内部错误触发了重试。 |
VeLivePlayerErrorInternalRetryFailed | -103 | 内部重试失败 | 内部重试次数达到最大限制,播放器停止重试,您可以尝试重新播放。 |
VeLivePlayerErrorDnsParseFailed | -200 | DNS 解析失败 | 可能是播放地址异常或客户端网络异常,请您检查播放地址和网络情况,如果故障未排除,请联系火山引擎技术支持。 |
VeLivePlayerErrorNetworkRequestFailed | -201 | 网络请求失败 | 请检查网络情况,如果故障未排除,请联系火山引擎技术支持。 |
VeLivePlayerErrorDemuxFailed | -300 | 直播格式解封装失败 | 可能是使用了不支持的直播流格式和协议,或音视频流错误;请检查流格式,如果故障未排除,请联系火山引擎技术支持。 |
VeLivePlayerErrorDecodeFailed | -301 | 视频解码失败 | 。可能使用了不支持的直播流音视频格式,或解码器出错;请检查音视频格式,如果故障未排除,请联系火山引擎技术支持 |
VeLivePlayerErrorAVOutputFailed | -302 | 渲染失败 | 可能是音视频输出设备异常,请重试;如果故障未排除,请联系火山引擎技术支持。 |
VeLivePlayerLicenseUnsupportedH265 | -308 | 您使用的基础版 License 暂不支持 H.265 硬件解码 | 请登录火山引擎控制台获取高级版 License。 |
VeLivePlayerErrorInternal | -999 | 内部错误 | 请联系火山引擎技术支持。 |