# ESP Player

[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），与内置解码器共存

此文档对您有帮助吗？

- 反馈已收到，谢谢！
- 如果您有其他意见，欢迎填写乐鑫文档反馈表。

- 我们重视您的反馈。
- 您可以填写乐鑫文档反馈表告诉我们如何改进该文档。