Json规范的播放器SDK事件输出协议与示例

本文档详细介绍了播放器SDK调用方事件输出的协议规范，该规范采用JSON格式进行事件报告。事件输出遵循GitLab上Zuoye LiveClient Doc项目提供的文档，链接为<http://gitlab.17zuoye.net/zylive/zuoye-liveclient-doc/blob/master/log_server_doc.md#5-%E6%B3%A8%E6%84%8F%E4%BA%8B%E9%A1%B9>。关键参数包括： 1. **category** 和 **info_type**：这两个参数需要保持一致，前者通常用于分类事件类型，后者是具体的事件标识符，如`event_first_key_frame`，表示首帧信息事件。 2. **content**：这个字段包含了丰富的事件详细信息，例如首帧事件中包括： - `net_break_off`: 网络断开次数，0表示没有断开。 - `class_type`: 类型标识，空字符串可能表明未提供特定类别。 - `sdk_core_version` 和 `player_version`: SDK核心版本和播放器版本，用于追踪软件更新。 - `play_uuid`: 播放器唯一标识符。 - `time`: 事件发生的时间戳（单位可能是毫秒）。 - `count_begin_time`: 数据统计的起始时间。 - `line_id`, `line_url`, `line_ip`: 线路相关信息。 - `bitrate`: 当前比特率。 - `rtmp_connect_delay`: Rtmp连接延迟，包含DNS查询时间。 - `stream_info_delay`: 流信息获取延迟。 - `first_frame_delay`: 首帧接收延迟。 - `first_key_frame_recv_delay`: 首个关键帧接收延迟。 - `first_key_frame_render_delay`: 首个关键帧渲染延迟。 - `cur_cache_video_size`: 当前缓存视频大小。 - `video_decoder`: 视频解码器类型。 - `fps`: 帧率。 - `width` 和 `height`: 视频分辨率。 3. **rtmp_connect_delay`, `first_frame_delay`, `first_key_frame_recv_delay` 等时间参数：这些时间字段在计算时应考虑DNS查询等额外因素，SDK协议中的时间不包含这些延迟。 4. **参数说明**：文档列出了每个参数的名称、描述以及数据类型，方便调用方理解并处理接收到的事件数据。 总结来说，这份协议指南提供了如何通过自研播放器上报事件的具体步骤，以及事件数据结构的清晰定义，这对于确保播放器SDK与服务端的有效交互至关重要。开发者在集成和使用时，需按照文档要求正确配置和解析这些事件，以实现流畅的播放体验和性能监控。