狐狸FM 离线音频播放器 完整说明

版本：离线工具安卓APK，内嵌模拟本地服务器，无需网络、不需要飞书账号，签名固定，支持覆盖安装保留全部用户数据，适配读屏软件（天坦读屏等）

一、核心定位

纯本地离线音频工具，MP3音频播放器，所有数据全部保存在手机本机，不上传互联网；内置独立模拟服务器，负责音频读取、合集管理、播放进度持久化、播放记录存储。

二、全部功能清单

📁合集管理功能

1. 新建音频合集，自定义合集名称

​

2. 删除合集，合集内音频同步管理

​

3. 每个合集独立保存播放进度记录：A合集记住A的播放曲目与时间点，B合集记住B的；切换合集互不干扰；切回旧合集自动读取该合集上次播放状态

​

4. 合集列表浏览，进入合集详情页面

🎵音频导入与管理

1. 系统文件管理器导入MP3音频文件

​

2. 内置手机音乐库：直接扫描本机全部音频，自带搜索框，搜索音频导入（读屏友好）

​

3. 删除音频：删除音频同时同步清除服务器对应记录

​

4. 音频播放统计：统计每首音频播放次数、上次播放时间；统计页面展示全部播放过的音频，按最近播放排序

▶播放核心能力

1. 四种播放模式完整可切换

- 顺序播放：播完全部曲目结束停止

​

- 列表循环：列表循环往复播放

​

- 单曲循环：重复播放当前一首歌

​

- 随机播放：随机跳转曲目

2. 快进、快退功能，支持按钮操作、双指手势滑动跳转进度，修复seek从头播放bug

​

3. 断点续播

​

- APP彻底关闭（任务栏划掉强杀）也可以保存进度

​

- 打开APP不会自动播放，点击播放按钮，恢复该合集上次播放歌曲+上次播放的几分几秒

​

4. 定时关闭功能：设置时间，时间到自动停止播放

​

5. 音量控制：应用内档位音量调节；同时支持手机侧边媒体音量键调节音量

​

6. 音量快捷键可控制暂停/播放：侧边音量按键可以实现暂停、恢复播放

​

7. 支持和其他游戏、APP声音同时播放，不会被其他应用直接抢占静音；被系统暂停后会自动恢复播放

​

8. 合集详情页面直接播放暂停，不需要跳转独立播放器页面，在合集页面直接控制上一首、下一首、暂停、音量

🔔后台&锁屏媒体卡片

1. 前台播放服务，后台保活，切到其他软件音乐不会中断

​

2. Android锁屏媒体通知卡片：锁屏界面显示歌名、合集名称、播放进度条

​

3. 锁屏卡片按键：上一首 / 播放暂停 / 下一首；支持拖动进度条跳转播放位置

​

4. 耳机线控按键全部适配，可线控切歌、暂停播放

​

5. 通知栏常驻播放通知，点击通知快速回到APP

🛡权限相关

1. 文件管理访问权限，用于读取本地MP3音频导入

​

2. 媒体库读取权限，读取手机全部音乐

​

3. 前台服务通知权限，实现后台播放、锁屏卡片

三、内嵌模拟服务器说明

本应用内嵌的是本地内存+磁盘持久化模拟服务器，不是联网云服务器，所有数据全部存在手机本地，不会联网传输任何数据

存储内容：

1. 用户创建的全部合集信息

​

2. 音频文件索引、音频元数据

​

3. 分合集独立存储播放记录：每个合集保存：上次播放歌曲ID、播放进度（时分秒）

​

4. 每首音频播放次数、最后播放时间

​

5. 导入音频的文件缓存映射

📊存储上限

1. 数据库元数据（合集信息、播放记录、统计信息）：元数据本身占用极小，理论上限：上万条音频条目、上千个合集完全没问题，普通个人使用不会触达上限。

​

2. 音频本体MP3文件：服务器不会复制、二次拷贝你的MP3原文件！

⚠重点：导入音频只是保存文件路径引用，不复制音频文件，音频仍然占用你手机原本的存储空间，服务器不额外复制一份音频，不会二次消耗空间。

也就是说：能导入多少首歌，只取决于你手机磁盘剩余空间，服务器本身不对音频数量做硬性限制。

注意：如果原始MP3文件，你在手机文件管理器手动删除，APP会找不到该音频文件，会提示播放失败。

数据保存特性

- 进程直接被杀、APP划掉关闭，磁盘文件会持久保存合集、播放进度记录；

​

- 覆盖安装新版本APK（使用相同签名）：全部合集、播放进度、播放统计完整保留

​

- 如果卸载APP，全部服务器存储的数据会全部清除（卸载会删除应用私有目录）

四、已知注意事项

1. 仅支持安卓系统，只识别MP3音频格式

​

2. 锁屏媒体卡片需要安卓系统给予通知权限，不给权限则锁屏卡片不显示，但播放功能不受影响

​

3. 原始音频文件不要手动删除，否则APP无法读取音源

​

4. 不连接互联网，没有云同步，全部数据仅本机留存

​

5. 签名一致的安装包覆盖更新，用户数据不会丢失；如果安装签名不一样的包，系统视为新应用，旧数据无法读取。