最近更新时间：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 | 内部错误 | 请联系火山引擎技术支持。 |