常见问题

基础问题

听咚咚是一款简洁优雅的本地音乐播放器。它扫描你设备里的音乐文件来建立曲库，提供播放、歌单、收藏、歌词、搜索等常用功能。所有音乐都在本地播放，不联网、不上传。

核心功能完全免费，包括扫描、播放、歌单、收藏、歌词、搜索。登录咕咚账号后可以开通 PRO，解锁播放页毛玻璃背景等高级外观。不登录、不付费也能完整听歌。

支持 Android 7.0（API 24）及以上版本。

两者是同一个开发者做的音乐类 App，共用一套咕咚账号和 PRO 权益套餐（同一个 appCodeName music）。MusicPlus 偏向在线订阅和聚合，听咚咚专注于本地音乐播放，是纯粹离线的那个。

常见原因和解决办法：

没加音乐目录：先去侧边菜单「音乐来源」点「添加音乐目录」，选中存放音乐的文件夹。
权限没给：Android 13 及以上需要「音乐和音频」权限，去系统设置确认已授予听咚咚该权限。
文件没被系统识别：音乐文件得是 Android 媒体库能识别的音频格式（mp3、flac、m4a、wav、aac、ogg 等常见格式）。某些小众格式系统可能不收录。
文件太短：时长过短的音频可能被系统媒体库过滤掉。
目录选错了：你添加的目录路径得真的包含那些音乐文件，可以到「音乐来源」核对每个来源的路径。

如果以上都没问题，到「音乐来源」页点右上角的「重新扫描」按钮强制全量扫一次。还不行就在 设置 → 支持与高级 → 导出日志 把日志发出来反馈。

听咚咚每次启动都会做一次增量扫描，自动拉取新增和修改过的文件。一般重新打开 App 后新歌就会出现。如果急着要，去「音乐来源」点「重新扫描」立即生效。

不会。扫描走的是增量策略——只查询自上次扫描以来 DATE_MODIFIED 更新的文件，平时启动几乎是一扫而过。全量扫描只在第一次或手动触发时执行。

听咚咚只读取音乐文件内嵌的歌词，不联网下载。如果文件本身没写入歌词字段（MP3 的 USLT，或 FLAC 的 LYRICS / UNSYNCEDLYRICS 等），就显示「这首歌暂时没有歌词」。

解决方法：用「音乐标签」之类的标签编辑工具，把歌词写进文件再回 App 重扫。App 的歌曲「更多」菜单里就集成了「使用音乐标签」入口，没装的话会引导你去安装。

歌词是否同步取决于文件里写的歌词带不带时间标记。带时间戳的同步歌词会逐行高亮、逐字点亮；纯文本歌词只能按大致顺序显示。建议写入带时间轴的 LRC 歌词以获得最佳效果。

不会。听咚咚用 Android 的前台媒体播放服务（Foreground Service），系统会优先保障播放进程不被清理。切到别的 App、锁屏都能继续放，通知栏和锁屏都会显示播放控制。

接听电话时系统会暂停音频播放，挂断后需要在通知栏或 App 里手动点播放继续（具体行为取决于机型）。

在播放页点「定时」图标，选一个时长（15/30/45/60 分钟或自定义 1–120 分钟），到点自动暂停。建议勾选「自动延长到整首歌播完」，避免把一首歌拦腰截断。

全部在设备本地：

听咚咚不联网上传你的音乐或个人数据，详见隐私政策。

听咚咚目前以本地存储为主，没有内置云备份。换机时可以利用 Android 的应用数据备份机制，或手动迁移音乐文件后重新扫描——歌单信息保存在 App 数据里，清除 App 数据会丢失。

建议重要歌单信息自己留个记录；音乐文件本身始终属于你，随时可以重新导入。

会清空 App 内的歌单、收藏、播放历史、偏好设置和歌词缓存，但不会删除你的音乐文件——音乐文件还在原位，重新打开 App 扫描一下就能恢复曲库，只是歌单等元数据需要重建。

麦克风、录音权限是清单里声明的预留项，听咚咚本身不会录音。所有播放都在本地完成。

还有其他疑问？先翻翻功能详解和快速上手，没找到答案的话欢迎联系我们。