NeriPlayer本地音乐管理指南：导入、扫描、本地歌单与下载管理全攻略

NeriPlayer本地音乐管理指南导入、扫描、本地歌单与下载管理全攻略【免费下载链接】NeriPlayerA native Android audio player that combines multi-source streaming, local control, rich lyrics, and self-hosted sync. / ✨ 一个把多源在线播放、本地管理、歌词体验和自建同步做进原生 Android 的音频播放器 项目地址: https://gitcode.com/gh_mirrors/ne/NeriPlayerNeriPlayer是一款原生 Android 音频播放器它的本地音乐管理能力让你把手机里的音频文件、在线下载的曲目和自建歌单全部收进同一个播放器管理支持一键导入本地音频、自动扫描读取封面与歌词标签、创建本地歌单以及完整的下载目录管理与清理。本指南带你从零上手这些功能。一、本地音乐管理总览为什么选择 NeriPlayerNeriPlayer 的定位是「多源在线播放 本地可控 数据自持」在本地音乐管理方面做了三件关键的事本地导入通过系统文件选择器SAF把设备上的音频文件导入曲库自动读取标题、艺术家、专辑、封面、歌词等标签深度扫描自动识别内嵌封面、内嵌歌词也能找到同目录的封面图片和.lrc歌词文件下载管理在线歌曲下载后按统一的目录结构存放支持重命名、清理、恢复和迁移说明本地歌曲不参与GitHub / WebDAV 同步你的音乐文件始终只留在自己的设备上隐私安全有保证。二、一键导入本地音乐文件的完整步骤导入功能由 LocalAudioImportManager.kt 实现操作非常简单进入 NeriPlayer 的本地曲库页面点击「导入」按钮系统会弹出 Android 标准文件选择器你可以选择单个音频文件或整个文件夹导入完成后曲库会显示导入结果包含成功数量和失败数量见 LocalAudioImportManager.kt 中的LocalAudioImportResult结构小技巧建议按「艺术家/专辑」组织文件夹结构导入后曲库展示会更整齐导入时会自动匹配同目录的封面图片和歌词文件并随曲目一起导入如果音频文件是下载目录里的受管文件导入逻辑会智能解析其命名模板文件名模板解析见 ManagedDownloadNaming.kt避免重复入库三、本地音乐扫描封面、歌词与元数据如何被读取导入或扫描本地音频时NeriPlayer 由 LocalMediaSupport.kt 负责深度解析文件元数据支持元数据项内嵌标签外部文件封面✅✅ 同目录封面文件原文歌词✅✅ 同目录.lrc翻译歌词✅✅ 同目录歌词文件标题/艺术家/专辑✅—码率/采样率/声道/位深✅—播放本地歌曲时点进「本地歌曲详情」可以看到文件名、标题、艺术家、专辑、作曲、流派、年份、音轨号、碟号、时长、码率、采样率、声道数、位深等完整信息文案定义见 strings_local_media.xml。更酷的是你可以在应用内回写本地音频标签——修改标题、艺术家、封面、歌词后直接写回音频文件的标签里其他播放器也能看到。歌曲播放与标签处理逻辑见 LocalSongSupport.kt。四、本地歌单管理系统歌单与自建歌单4.1 两个内置系统歌单NeriPlayer 内置了两个特殊歌单定义见 SystemLocalPlaylists.kt⭐收藏歌单由 FavoritesPlaylist.kt 管理收藏的歌曲会自动汇总到这里本地文件歌单由 LocalFilesPlaylist.kt 管理自动收录已导入的设备本地音频这两个系统歌单的名字是保留的创建自建歌单时不能使用相同名称。4.2 创建和管理自建本地歌单自建歌单的增删改查由 LocalPlaylistRepository.kt 统一管理新建歌单 → 从曲库批量勾选歌曲加入歌单内可调整播放顺序、移除歌曲歌单数据以 JSON 文件形式存储在应用私有目录见 LocalPlaylistFileStorage.kt并可参与备份恢复 需要提醒本地歌单中的本地歌曲不参与远端同步同步到 GitHub / WebDAV 时只包含在线歌曲的元数据这是为了保护本地文件的隐私与完整性。五、下载管理从下载、清理到迁移5.1 统一管理的下载目录在线歌曲下载后由 GlobalDownloadManager.kt 统一调度所有文件按标准目录树存放目录树结构见 ManagedDownloadTreeDirectories.kt并自动生成规范文件名见 ManagedDownloadStorageNaming.kt写入音频标签与封面见 DownloadedAudioTagWriter.kt保存配套歌词文件见 ManagedDownloadLyricStore.kt下载完成后的曲目会进入「已下载曲库」在曲库中即可离线播放曲库存储见 DownloadedSongCatalogStore.kt。5.2 清理、恢复与迁移清理删除下载歌曲时会先做引用检查安全清理音频、封面、歌词等所有关联文件见 ManagedDownloadDeletePlanner.kt恢复下载中断或崩溃后恢复机制会自动处理未完成的写入见 ManagedDownloadRecoveryFiles.kt迁移更换存储位置时迁移工具会按计划拷贝、校验并收尾见 ManagedDownloadMigrationCopyWorker.kt⚙️ 下载存储路径等设置可在 ManagedDownloadStorageSettings.kt 对应入口中调整六、常见问题快速解答Q1导入的本地歌曲不见了检查是否仍保留在设备存储中。NeriPlayer 记录的是文件引用而非拷贝删除原文件会导致曲目失效。Q2本地歌曲能同步到其他设备吗不能。本地歌曲和自建歌单中的本地条目不参与同步在线歌曲的收藏、历史与歌单才能同步。Q3歌词没有显示确认音频同目录存在.lrc文件或音频标签中嵌入了歌词导入后在「本地歌曲详情」中可查看歌词来源。Q4所有数据存在哪里歌单、收藏、历史、统计等元数据统一存储在 Room 本地数据库中数据库版本定义见 NeriUserDataDatabase.kt完全保存在本机。七、写在最后NeriPlayer 把「本地可控」做到了细节里从导入、扫描、标签回写到歌单与下载目录的全生命周期管理每一步都不把数据交给第三方服务器。如果你想要一款隐私自持、本地优先的原生安卓音乐播放器这套本地音乐管理体系值得一试。【免费下载链接】NeriPlayerA native Android audio player that combines multi-source streaming, local control, rich lyrics, and self-hosted sync. / ✨ 一个把多源在线播放、本地管理、歌词体验和自建同步做进原生 Android 的音频播放器 项目地址: https://gitcode.com/gh_mirrors/ne/NeriPlayer创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考