RTSP播放器或RTMP播放器常用Event事件回调设计

原创

音视频牛哥

修改于 2020-10-15 09:52:07

1.1K0

很多开发者在开发RTSP或RTMP播放器的时候，不晓得哪些event回调事件是有意义的，针对此，我们以大牛直播SDK（github）的Android平台RTSP/RTMP直播播放端为例，简单介绍下常用的event id，总的来说，有以下几个部分组成：

1. 常规网络状态显示：如开始播放、网络中断、重连、收不到媒体数据等；

2. 视频宽高信息回调：用于上层显示回调的分辨率信息；

3. 快速切换url：如播放过程中，切换其他url时，分辨率发生变化，给到回调事件；

4. 录像状态：如开始录像、录像完成；

5. 实时快照：返回快照状态和快照存放路径；

6. 数据缓冲状态：如开始buffering、buffering percent、停止buffering；

7. 流实时下载回调：显示播放rtsp或rtmp流时，实时流量，注意，这块最好是可设置回调时间间隔，防止不必要的资源消耗；

8. RTSP错误状态：如401鉴权不通过。

以下接口定义可供参考：

Android 播放端 SDK Event 回调说明
事件 ID	事件描述
EVENT_DANIULIVE_ERC_PLAYER_STARTED	开始播放
EVENT_DANIULIVE_ERC_PLAYER_CONNECTING	播放端连接中
EVENT_DANIULIVE_ERC_PLAYER_CONNECTION_FAILED	播放端连接失败
EVENT_DANIULIVE_ERC_PLAYER_CONNECTED	播放端连接成功
EVENT_DANIULIVE_ERC_PLAYER_DISCONNECTED	播放端连接断开
EVENT_DANIULIVE_ERC_PLAYER_STOP	停止播放
EVENT_DANIULIVE_ERC_PLAYER_RESOLUTION_INFO	返回视频宽、高信息
EVENT_DANIULIVE_ERC_PLAYER_NO_MEDIADATA_RECEIVED	收不到媒体数据(可能是 URL错误)
EVENT_DANIULIVE_ERC_PLAYER_SWITCH_URL	快速切换 URL
EVENT_DANIULIVE_ERC_PLAYER_RECORDER_START_NEW_FILE	开始一个新的录像文件(param3 返回包含录像路径在内的录像文件名)
EVENT_DANIULIVE_ERC_PLAYER_ONE_RECORDER_FILE_FINISHED	已生成一个录像文件(param3 返回包含录像路径在内的录像文件名)
EVENT_DANIULIVE_ERC_PLAYER_CAPTURE_IMAGE	播放端实时快照
EVENT_DANIULIVE_ERC_PLAYER_START_BUFFERING	开始缓冲数据
EVENT_DANIULIVE_ERC_PLAYER_BUFFERING	缓冲中(param1 参数会返回缓冲百分比)
EVENT_DANIULIVE_ERC_PLAYER_STOP_BUFFERING	停止缓冲数据
EVENT_DANIULIVE_ERC_PLAYER_DOWNLOAD_SPEED	返回当前 RTSP/RTMP 流实时下载速度
EVENT_DANIULIVE_ERC_PLAYER_RTSP_STATUS_CODE	RTSP 收到错误码，可能是用户名、密码不对