NAS 上已经放好了音乐手机也能打开 Jellyfin电视却仍在用文件管理器逐个找文件。这时候需要补的是一个适合遥控器操作的音乐客户端。NASMusicTV 把服务端曲库、播放队列和歌词放进同一套 Android 界面电视不用承担整理音乐库的工作。本文以 v2.38.0 为基础重点说明接入前需要准备什么、连接时怎样填地址以及曲库为空时如何缩小问题范围。它支持 Jellyfin、Navidrome、Subsonic、道理鱼和飞牛选哪一种取决于已有服务不需要为了播放器再部署一套后端。先分清服务端和播放器NASMusicTV 是客户端。音乐文件、账号权限和服务端索引仍由原音乐服务管理在电视上安装 APK不会自动把一个共享文件夹变成 Jellyfin 曲库。开始前准备三样东西可访问的音乐服务地址、该服务的账号信息以及一张已经在服务端出现的专辑。用这张专辑作对照后面才容易区分是连接失败、权限不对还是扫描尚未完成。先在同一家庭网络内接入更容易检查。服务器地址应是音乐服务的入口包含正确的协议和端口NAS 管理后台的地址不一定就是它。若服务经反向代理访问填写已经确认可用的服务入口不要把内网端口和外网域名随意拼接。安装后在服务器页完成连接本版发布的是通用 APK支持 Android 5.1 及以上包含 arm64-v8a、armeabi-v7a 和 x86_64。电视、手机、平板共用安装包但最低系统版本只代表安装门槛不能推导所有可视化效果都能在老设备上正常运行。电视可通过设备支持的安装方式打开 APK需要允许外部安装时只给实际使用的文件管理器开启相应权限。软件会按设备类型切换交互电视用方向键焦点手机使用触屏与底部导航。连接按以下顺序进行打开服务器配置页选择实际后端类型例如 Jellyfin。输入音乐服务地址检查协议、主机名和端口。按当前后端表单填写账号信息点击地址旁的连接测试。测试可达后执行连接再进入曲库找准备好的专辑。服务器类型要先选对再检查下面的地址和登录字段切换后端时默认地址也可能随之变化。这里有个容易忽略的区别地址测试回答的是服务能否访问执行连接还需要完成登录。测试成功但曲库没出现不应直接得出音乐文件损坏的结论。先看连接状态再确认账号是否能访问该音乐库。用一首歌检查完整链路连接后进入曲库按专辑或艺术家浏览找到对照歌曲并开始播放。检查封面、播放进度和声音比一口气加载全部歌单更容易发现问题。音乐已出声、歌词却没出现时音频链路已经成立下一步应检查歌词来源。播放器支持内嵌歌词、本地 LRC、网络匹配和缓存播放页可切换来源。若歌曲名称能显示歌词却跟错版本可先换一个来源对照现场版、翻唱版与录音室版不一定共享相同时间轴。逐字高亮也需要对应的歌词数据不能仅凭按钮存在就认定每首歌都能逐字同步。歌词来源位于歌词区上方播放控制位于封面下方可以分开检查音频播放与歌词显示。队列页用于增删歌曲和调整顺序。先添加几首歌再切换顺序、循环或随机模式队列有持久化机制应用重启后可恢复队列但这不等于服务器永远在线也不等于所有歌曲已经离线保存。百度网盘和本地音乐走另一条接入路径没有 NAS 服务也能从本地音乐或百度网盘开始。百度入口在设置中的网盘相关项目启用后选择登录按照设备码授权提示在手机上完成授权。项目明确限制百度读取范围为/apps/NASMusicTV及其子目录。音乐放在网盘根目录、其他共享目录或另一个应用目录里即使账号登录成功也读不到。可先放少量歌曲到/apps/NASMusicTV/音乐/再回应用浏览并确认文件出现。这项限制属于文件访问范围重新登录无法替代移动文件。本地音乐则通过设备和 USB、SD 卡扫描建立索引如果目标只是播放 U 盘里的歌不必先填服务器地址。按出现问题的位置排查连接测试失败时优先核对地址和网络可达性测试通过而登录失败时核对后端类型与账号字段。已经连接但曲库空白时回服务端确认索引和音乐库权限再到客户端重新检查。只有百度歌曲不出现时先看授权状态和目录位置只有歌词异常时换歌词来源核对只有全屏效果卡顿时回设置降低可视化画质。这样不会把网络、歌词和渲染三个问题混成一次反复重装。v2.38.0 新增低、中、高可视化画质选择并修复数字雨在低画质下进入闪退的问题。旧电视适合从低档开始再按播放稳定性逐级调整发布说明没有给出所有机型的帧率保证。应用检测到已保存服务器配置时会提示是否连接。重启后若没有立即出现曲库可以先处理这项提示再检查连接状态队列恢复和服务器重新连接是两个环节不应只依据队列里还有歌曲就认定服务已连通。接入是否完成最终看同一账号能否浏览目标专辑并播放而不是只看“连接成功”提示。把这条链路跑通以后再添加更多音乐源和歌单后续问题会好判断得多。来源与下载项目与版本NASMusicTV、v2.38.0 发布说明。百度网盘百度网盘 请输入提取码 提取码64vw夸克网盘夸克网盘分享