支持的音频格式说明

官方支持格式

Leelaa Reader 官方支持并保证兼容性的音频格式如下：

• .mp3 (最推荐，兼容性最好)
• .m4a / .m4b (推荐用于有声书)
• .flac (无损格式)
• .wav
• .wma (通过服务端 FFmpeg 转码播放)

明确不支持的格式

为了保证跨端播放的稳定性和进度记录的准确性，系统明确不支持以下格式。即使您在后台强行添加了这些后缀，客户端也可能无法播放或出现进度跳跃、无法记录书签等严重问题：

• .aac (不支持直接播放裸流，请封装为 .m4a)
• .ogg (不支持)
• .opus (不支持)

为什么有些格式不支持？

有声书平台对音频格式的要求比普通音乐播放器更苛刻：

1. 时长获取精确度：系统需要精确的音频时长来计算总进度和记录上次播放位置。.aac 裸流等格式没有标准的头部信息，无法快速、准确地获取时长。
2. 跨端兼容性：我们需要确保音频在 Web 浏览器、iOS 和 Android 客户端上都能表现一致。.wma 依赖服务端转码为 MP3 流播放；如果服务端未开启或未检测到 FFmpeg，播放会失败。部分格式（如 .ogg）在某些移动端系统底层解码器中缺乏原生支持。

Web 端 HLS 转码限制

Web 端在播放 .wma、部分 .m4b 等需要在线转码的章节时，可能会使用 HLS 分片流进行兼容播放。此模式主要用于“能稳定播放”，不等同于完整的本地音频文件播放体验。

当前限制：

• 不支持快进 / 快退
• 不支持任意拖动进度条跳转
• 转码过程中，缓冲进度显示可能与实际可跳转范围不完全一致

如果您需要在 Web 端稳定使用快进、快退和拖动跳转，建议提前将音频转换为 .mp3 或 .m4a 后再导入。

格式转换建议

如果您手头有大量不受支持格式的有声书，建议您在导入系统前进行批量转换。.wma 虽可由服务端实时转码播放，但会消耗服务端 CPU；弱性能设备上仍建议预先转换。

推荐的转换目标： 将所有格式统一转换为 .mp3（通用性最强）或 .m4a。

您可以使用的免费转换工具：

• 格式工厂 (Format Factory)：适合 Windows 用户，支持拖拽批量转换。
• FFmpeg：适合高级用户，可使用命令行极速转换。 (例如：ffmpeg -i input.ogg -c:a libmp3lame -q:a 2 output.mp3)
• XLD (X Lossless Decoder)：适合 macOS 用户的无损转换工具。