ESP Player
================================

:link_to_translation:`en:[English]`

``esp_player`` 是乐鑫嵌入式多媒体播放组件，在单实例内串联解封装、解码与渲染，支持本地文件、HTTP(S) 流、HLS 以及无容器的外部帧输入，适用于资源受限的 IoT 与多媒体应用。

主要特性
-------------------------------------

- 多种输入源：本地文件（``file:///``\ ）、HTTP/HTTPS 流、HLS（``.m3u8``\ 自动识别）、外部帧模式（``fill:///``\ 、``block:///``\ ）
- 常见封装容器：WAV、MP4、M4A、TS、OGG、AVI、FLV、CAF；裸 ES 流文件（``.mp3``\ 、``.aac``\ 、``.flac``\ 、``.amr``\ ，无容器头）
- 音频解码格式：AAC、MP3、Vorbis、Opus、FLAC、AMR-NB/WB、G.711 A-law/μ-law、ALAC、ADPCM、SBC、LC3
- 视频解码格式：H.264、MJPEG
- 音视频同步：可配置系统时钟、以音频为主钟、以视频为主钟、无同步（freerun）四种模式
- 播放控制：播放、暂停、继续、停止、Seek（毫秒）、倍速
- 音视频轨选择：可分别开关音频/视频侧，支持多轨容器的轨道枚举与选择
- 网络缓冲：基于队列水位的启动预缓冲与运行期重缓冲
- 事件通知：支持同步回调与异步事件队列两种模式，覆盖播放状态、缓冲、错误、轨道信息等事件
- 自定义解码器：通过工厂回调注册自有 GMF 音视频解码处理单元（element），与内置解码器共存
