音流APP，一款专为音乐爱好者打造的NAS音乐播放器。通过轻松连接您的NAS设备，音流让您随时随地享受存储在私人服务器上的高品质音乐。无论身处何地，只需一键登录，即可畅享海量音乐库，实现跨平台无缝播放。音流以其卓越的音质表现和便捷的操作体验，成为您私人音乐盛宴的理想伴侣。

音流app介绍

音流是一款NAS音乐播放器，可以连接到您部署在 NAS 上的音乐服务1，能让您在不同平台2享受一致的音乐盛宴。

在使用音流之前，您必须拥有一台运行着音乐服务的 NAS，因为音流是一个纯粹的音乐播放器，专注于串流您已拥有的音乐，并不提供任何音乐资料。

音流app特色

易于使用

精心设计的操作界面，让您可以快速上手。

专注于音乐

支持常见的音乐服务，让您可以通过一个客户端访问多种音乐服务。

跨平台支持

可在 Android、iOS、macOS 和 Windows 上使用，并提供与平台一致的体验。

音流app功能

兼容多种音乐服务。

支持歌词显示，通过自定义 API 还可让不提供歌词接口的音乐服务也拥有显示歌词的能力！

使用 Flutter 构建，为您提供接近原生的使用体验，在跨平台适配上拥有无限的可能性。

音流app怎么用

同步模式

媒体库模式

媒体库模式下，音流需要将服务器端的歌曲列表、专辑列表和歌手列表完全同步到本地，以此获得完整的音乐库数据。

在此模式下，音流可以借助完整的音乐库数据实现一些服务端未实现的功能，如文件夹视图、歌单导入及部分高级筛选功能。

但凡事有利就有弊，由于需要完整同步服务端数据，若您的曲库较大，同步过程会耗费很多的时间。

自动同步

应用启动时会检测服务端歌曲数量，如果大于本地副本歌曲数量，则增量同步缺失的数据。

注意

增量更新的原理是按歌曲添加时间倒序查询，因此若您在服务端删除或修改过歌曲，则需要手动点击同步按钮从头同步。

应用启动时需要恢复上次播放列表，某些音乐服务的歌曲资源或图片资源需要登录后才能获取，因此将播放器的初始化放在了登录操作之后，若您在播放歌曲时遇到了播放器正在初始化的提示，请耐心等待片刻。

手动同步

若自动同步无法满足您的需求，请点击音乐资料库的「立即同步」按钮手动更新本地副本。

信息

手动同步是全量更新，若同步过程中中断，下次启动后会自动进行增量更新。

直连模式

在直连模式下，音流不会将服务端的数据同步到本地，而是在您每次操作时单独获取数据。若您的曲库较大，可以尝试开启此选项，以提升首次进入应用时的体验。

但请注意，由于直连模式完全依赖服务端接口的返回结果，现有功能可能会失去部分特性：

每日推荐无法筛选歌曲时长，即可能有部分长音频进入每日推荐。

无法检测重复歌曲。

在没有文件夹接口的服务端（Subsonic/Navidrome/Jellyfin）中，文件夹功能仅显示本地副本中的数据（即手动查询过的数据）。

部分排序和过滤功能不可用。

播放逻辑

音流的播放逻辑与常见音乐 APP 并不完全一致，加入了一些我自己的理解。

若您初次使用音流，强烈建议您阅读此章节以更加得心应手地使用音流。

播放模式

音流默认是队列播放，如需循环播放，可打开此开关，对队列播放和随机播放都会生效。

从歌曲列表中选择歌曲播放，默认是队列播放。

若列表头部有上面的按钮，则可点击有圆圈的按钮定位到当前歌曲，点击两个箭头的按钮切换列表的播放模式。

歌曲定位功能升级(V1.3.0):

若播放队列与当前歌曲列表一致，则会定位至当前歌曲。

若播放队列与当前歌曲列表不同，则会定位至列表中第一个未播放过的歌曲。

此外，由于歌曲列表数据采用分页加载的方式，若当前页没有满足条件的歌曲可供定位，则会滚动到列表底部并触发下一页数据的加载。

从歌曲列表切换播放模式会保存到配置中，不同的歌曲列表类型会分别存储用户偏好的播放模式。

反之，从播放列表或播放页面切换播放模式则是临时操作，仅当次生效。

播放控制

音流的控制栏如上图所示，可通过点击封面播放/暂停，点击歌词区域进入播放页，点击右侧按钮弹出正在播放列表。

从歌词区域向右滑动切换上一曲，向左滑动切换下一曲。

DLNA

目前 DLNA 功能会将服务器的播放地址投送到 DLNA 设备上，因此请保证 DLNA 设备可以连接到服务器。

为提升 DLNA 兼容性，目前采用轮询方式获取 DLNA 设备的播放状态，因此部分操作可能会有 2 秒左右的延迟。

自定义 API

某些情况下，音乐服务提供的接口可能无法返回我们需要的信息，故提供自定义 API，高级用户可以自定义返回内容。

鉴权（可选）

接口列表

获取歌词

请求方式：GET

响应体

如果有歌词，直接返回歌词内容，没有时返回空，或设置响应状态码为 404.

从 1.1.6 版本开始支持分页获取歌词，在响应类型 content-type 设置为 application/json 后，将尝试把响应内容解析为 json 列表，结构如下：

确认歌词

适用于 1.2.0 及以上版本。

在用户手动点击歌词切换界面的保存按钮后触发。

请求方式：POST

请求体：

响应码：若响应码不是20x，则提示用户「歌词确认异常」，没有异常则不提示信息。

备注

自 1.3.1 开始，调整歌词偏移后点击对勾按钮也会触发歌词确认接口，此时请求的数据中不包含lyricsId字段。

获取封面

请求方式：GET

通过此接口，音流可控制传递的参数尝试获取不同类型的封面：

三者都传：获取歌曲封面

不传歌曲标题：获取专辑封面

只传歌手名：获取歌手图片

响应体

文件流。

歌曲详情

适用于 1.2.4 及以上版本，用于在浏览器中跳转到音乐服务对应的歌曲链接。

示例配置：

路径替换的作用是当您的音乐服务在 Docker 部署时，识别到的路径可能和音乐文件实际路径是不同的，通过路径替换可以将第一个匹配到的字符串替换为 docker 服务可以识别的，即：

简易服务

搭配 Nginx 加载同目录下 Lrc 文件 @ZaneYork

APP 内直接配置 API 地址为 你的服务器地址 + /lyrics/ 即可。

搭配 php 返回同名 Lrc 文件@lingluos

在Linux系统上使用php方法返回lrc文件 要求lrc文件和歌曲文件名称完全相同

假设你的这个index.php放在/var/www/html/lyrics文件夹下，lrc文件放在/var/www/html/lyrics/lrc中

那么理论上你只要在自定义api歌词接口中输入http://域名/lyrics/就可以显示出歌词了

顺路提一嘴 如果发现歌词显示出来是乱码 可以尝试把lrc文件的编码改成utf-8

小编点评

音流APP以其出色的音乐播放功能和便捷性赢得了我的青睐。它能够轻松接入NAS设备，实现音乐资源的统一管理，让音乐播放变得更加简单。音质清晰，播放流畅，且支持多平台同步，真正做到了音乐无处不在。对于热爱音乐、追求高品质音效的用户来说，音流无疑是一个不可多得的好选择。