很多音乐应用都在强调推荐、歌单和社交，但真正到了日常使用里，我们经常只需要一件很朴素的事：打开手机，安静地听一首歌。  
这个项目里的「悦听音乐」就是围绕这个需求做的。它不是一个复杂的内容平台，而是一款面向 HarmonyOS 的轻量音乐播放器：能播放本地音乐，能在听到旋律时识别歌曲，也能生成白噪音、自然音和动物音，陪用户专注、放松或入睡。

 一打开，就是为“听”准备的

悦听的首页很直接：当前播放卡片、进度条、上一首/下一首、播放详情和播放列表都放在第一屏里。界面用了深色背景、青绿色高亮和动态声波视觉，让播放器有一点沉浸感，但核心操作仍然清楚。

首页下方的分类筛选把歌曲来源分成「全部」「识曲」「儿童歌」「英文歌」「古典」「中文」「轻音乐」「白噪音」「本地」等类型。对于一个本地播放器来说，这个设计很实用：用户不需要在文件名里翻找，只要按场景切换就能继续听。

曲库不只是文件夹，而是一个会整理的音乐空间

悦听的曲库页把内容分成两个重点：一类是白噪音、自然音，另一类是识曲和本地歌曲。这样一来，它既可以是通勤路上的播放器，也可以是工作时的背景音工具。

项目里已经内置了默认开放曲库能力。应用启动后可以导入公开示例音源，也可以从开放授权音乐源中缓存可播放歌曲；如果用户没有准备本地音乐，仍然可以先听起来。  
同时，应用还支持手动选择和本地扫描，常见音频格式包括 MP3、FLAC、WAV、AAC、M4A 等。

听歌识曲：从“这首歌叫什么”到“直接加入播放列表”

「听歌识曲」是这个项目最有辨识度的功能。用户在识曲页点击开始，应用会录制一段音频进行识别；识别成功后，歌曲信息会写入历史记录，并尝试补齐可播放音源。

从代码结构看，识曲服务不是只依赖单一路径。它支持接入多种识别后端，也保留了自建开放识别接口的扩展方式。当在线识别返回歌名、歌手、专辑、流派、置信度等信息后，应用会把它整理成统一的歌曲模型，再进入播放和收藏流程。

实际界面里，识曲过程用圆形录音动画和声波条来反馈状态。用户能看到「正在聆听」「正在识别」「识别历史」这些明确提示，不需要理解底层发生了什么。

白噪音和动物音：不用联网也能生成

悦听并没有把白噪音做成一个外部资源列表，而是在本地生成 WAV 音频。项目里的 `AmbientSoundService` 会生成白噪音、粉噪音、棕噪音、雨声、海浪、鸟鸣、虫鸣、蛙鸣、猫呼噜等声音。

这带来两个好处：第一，用户不用依赖网络；第二，应用可以把这些声音作为普通音频加入播放列表，继续使用循环播放、进度控制和后台播放能力。对于助眠、阅读、写代码、午休这类场景，这种“本地即用”的设计很贴心。

默认纯音乐：让新用户不用空着进来

项目还实现了一个纯音乐生成服务。它会生成小星星、卡农回旋、铃儿响叮当、月光小品等入门曲目，并按儿童歌、英文歌、古典、中文、轻音乐等分类归档。

这是一处很聪明的产品细节：很多播放器刚安装时都是空的，必须先授权、扫描、导入，用户才能体验主流程。悦听则可以先给用户一个可播放的曲库，让应用第一分钟就有声音。


## 沉浸播放详情：把控制权放在顺手的位置

播放详情页将封面视觉、歌曲信息、进度条和播放控制集中在一个更安静的界面里。与首页相比，它更适合长时间听歌：页面信息更少，视觉焦点更集中。

应用还支持后台播放会话。代码中通过 AVSession 接入系统播放控制，用户离开应用后仍能在系统层面控制播放、暂停、上一首和下一首。这让它更接近一个真正可日用的播放器，而不是只能停留在页面里的 Demo。


## 技术上，它把几条线拧在了一起

这个项目的主体使用 ArkTS 开发，围绕一个主页面组织功能，同时拆出了多个服务层：

- `SongRecognitionService` 负责录音、识曲、候选音源搜索和识别结果解析。
- `LocalDbService` 负责保存识别历史和已识别歌曲。
- `DefaultLibraryService` 负责默认开放音乐的加载和缓存。
- `AmbientSoundService` 负责生成白噪音、自然音和动物音。
- `InstrumentalMusicService` 负责生成默认纯音乐曲库。
- `PlaybackSessionService` 负责系统媒体会话和后台控制。
- `PcmPlayer` 负责本地 WAV/PCM 播放兜底。

这些模块让悦听的功能边界比较清楚：页面负责交互，服务负责能力，数据模型负责识别结果在不同功能之间流转。

结语：一个有温度的小播放器

悦听音乐最打动人的地方，不是功能堆得多，而是它把几个真实的听歌场景放到了一起：  
想听本地歌时，它是播放器；听到陌生旋律时，它是识曲工具；想专注或睡前放松时，它又变成白噪音盒子。

它的目标感很明确：少一点打扰，多一点陪伴；少一点平台感，多一点“我的音乐空间”。  
对于一个 HarmonyOS 音乐应用项目来说，这已经不只是能跑起来，而是开始拥有了自己的产品气质。

下载地址：https://appgallery.huawei.com/app/detail?id=com.qxf.wnpaly&channelId=SHARE&source=appshare