|
|
大神啊。这个说明书就要好几天吧！
xxbin1911/xTune
概览
代码
Issues
Pull Requests
xTune/docs/manual/ README.md
xTune用户使用手册
xTune简介
xTune 是一款专为 LMS（Lyrion Music Server / Logitech Media Server）设计的控制端应用，并集成了支持独占 USB DAC 输出的内置播放器，专为追求高保真音质的 Hi-Fi 用户量身打造。
xTune 不仅可以支持独立部署的 LMS 服务器，还兼容所有基于 LMS 的系统，包括达菲（Daphile）、piCorePlayer，理论上兼容所有基于 LMS 8.x/9.x 的系统。
系统版本要求
xTune目前仅开发了安卓版本，需要安卓9.0及以上版本支持，如果在安装时提示“解析软件包时出现问题”，则是安卓系统版本不兼容导致的。另外xTune也不支持纯血鸿蒙系统，低版本的鸿蒙系统（基于安卓）可以安装xTune 1.3.6及以下版本（此版本不支持内置播放器）。 xTune目前只针对手机进行了优化，特别是单手操作优化。安卓平板可以安装xTune，但是目前版本的xTune仅支持竖屏操作，并且一些布局（例如快捷按钮等）会被明显放大不太美观。在合适的时候，作者会对安卓平板进行支持，提供横屏功能，并对平板的布局进行优化。
主要功能
LMS控制器
首页提供了我的音乐信息聚合功能，并提供了搜索、发现、最近添加专辑等功能。
提供收藏夹、歌单管理及网络电台功能。
提供按专辑、艺术家、流派、年代和文件夹的音乐浏览与播放功能。
支持集成 Spotify、Qobuz、Tidal 等流媒体平台（需在 LMS 中安装对应插件）。
底部迷你播放控制条，方便快速操作。
全屏播放控制界面提供经典与现代两种样式，用户可以自由选择。
全局导航菜单和全局快捷对话框提供快捷的操作与控制。
LMS服务器与播放器
提供LMS服务器管理，包括切换服务器、重启服务器以及唤醒服务器。
提供LMS音乐库管理功能，可展示音乐库信息及对音乐库进行重新扫描。
提供LMS播放器管理功能，可管理和切换多个播放器，支持多房间同步播放、闹铃与睡眠等功能设置。
内置播放器（ZeroPlayer）
兼容LMS系统的内置播放器（不支持本地文件播放，仅支持从 LMS 媒体库播放或推送）。
支持多种音频格式，包括 FLAC、Apple Lossless、PCM、MP3 及 DSD。
支持安卓音频输出，提供采样率限制与采样深度选择。
支持独占USB-DAC输出，并可开启Bit-Perfect模式，确保高保真音质。
支持多种DSD输出模式，包括Native DSD、DSD Over PCM（DoP）及 DSD 转 PCM模式。
支持数字音量调节，包括等响曲线数字音量调节及线性数字音量调节。
内置播放器支持自适应SRC，自动调整采样率以适配系统设置。
其他功能
提供多语言支持，目前支持简体中文和英文（美国）。
支持主题及颜色自定义功能，提供了浅色主题与暗色主题供用户选择。
通知设置提供了锁屏通告与持续通告等设置选项。
高级设置中提供了手机音量按键控制以及音乐信息抓取等设置选项。
我的音乐
首页
首页提供了信息聚合功能，并提供自定义卡片来展现音乐信息，用户可通过首页快速发现自己所需的音乐资源。
首页提供的聚合卡片如下：
最近添加（最近添加的专辑）
收藏的专辑
收藏的艺术家
我的歌单
我的电台
快捷方式
通过点击首页顶部右上方的卡片自定义设置按钮，可以进入首页卡片设置对话框，用户可通过长按（卡片项最左侧的图标）拖动来调整卡片顺序，也可以直接用卡片项右侧的开关关闭不需要的卡片。
搜索音乐
通过点击首页顶部右上方的搜索按钮，或者通过选择全局菜单的搜索菜单，可以进入搜索音乐页面，用户可以在顶部的搜索栏中输入想查找的音乐专辑、艺术家和歌曲名称等信息，最后点击搜索栏右边的搜索按钮即可对音乐库中的音乐进行搜索。 搜索结果根据专辑、艺术家和歌曲进行分类，在搜索结果的摘要页面，只会显示少数的搜索结果，用户可以通过点击更多按钮或者点击上方的专辑、艺术家和歌曲标签页查看完整的搜索结果。
发现音乐
通过点击首页底部右方的发现按钮（浮动按钮），或者通过选择全局菜单的发现菜单，可以进入发现页面。 发现页面随机的用封面墙的方式展示了音乐库中的50张专辑，这种随机的方式可以让用户在选择困难的时候找到心仪的专辑进行播放。
最近添加专辑
最近添加专辑页面提供了以添加时间来排序的所有专辑列表。通过选择全局菜单的最近专辑菜单，或者在首页的最近专辑卡片右方点击更多按钮，可进入最近添加专辑页面。
我的收藏
通过选择全局菜单的我的搜藏菜单，即可进入我的收藏页面。我的收藏提供了两种方式来显示收藏的数据——聚合显示方式和收藏文件夹浏览方式。聚合显示方式是默认的展现方式，在我的收藏页面，收藏的音乐会通过专辑、艺术家、歌单、电台以及歌曲等分类的方式呈现，用户可以点击更多按钮来查看不同类别的所有的收藏信息。收藏文件夹浏览方式是LMS的默认方式，点击我的收藏页面的顶部右侧图标，即可对收藏的信息进行文件夹方式的浏览。
我的歌单
我的歌单提供了用户编辑的歌单列表（Playlist）浏览和播放、管理等功能。此功能完全依赖LMS的Playlist功能开发，因为LMS的Playlist是基于m3u文件来实现的，因此歌单的各项功能操作可能会有些慢，这个和xTune无关，这是LMS服务器的缺点之一。
我的电台
我的电台功能也是基于LMS的Radio功能进行开发，因为众所周知的原因，此功能在国内大多数地方无法正常使用。
音乐库
音乐库又叫做媒体库，LMS服务器经过对指定的音乐目录进行扫描之后，提取音频文件的标签，把音频文件类型，流派，发行年代，专辑名称，专辑封面，艺术家，采样率，采样深度，时长等等十多个数据进行分门别类的存储，并根据专辑，艺术家，流派，发行年份等进行索引。这样就形成了LMS的音乐库。
注意：音乐库的信息完全由LMS服务器提供，若出现专辑、艺术家或歌曲名称乱码、发行年份不对或者流派不正确、无专辑封面或专辑封面错乱，基本上都是因为用户的音频文件的标签不对或者CUE文件的编码不对等引起的，也有可能是更新了一些音乐文件后LMS没有做扫描引起的。建议出现以上情况时，一方面要检查用户的音频文件标签是否正确，另外一方面可以对LMS的音乐库进行全盘重新扫描，必要的时候可以清除标签数据库并重新扫描音乐库。
专辑
专辑是音乐库最常用的浏览方式。在专辑页面的右上角，提供了发现功能的快捷按钮。另外，通过xTune的设置菜单，或者点击专辑页面右上角的显示设置按钮，可以对专辑的显示方式进行设置。
专辑显示排序方式：
专辑标题（默认选项）
艺术家、专辑标题
艺术家、年份、专辑标题
年份、专辑标题
年份、艺术家、专辑标题
最新
专辑显示设置还提供了专辑显示视图的设置，用户可以在网格视图和列表试图中进行选择。
艺术家
艺术家是音乐库的零一个常用的浏览方式。艺术家信息会按照标签页进行显示，默认显示专辑艺术家标签。通过xTune的设置菜单，或者点击艺术家页面右上角的显示设置按钮，可以对艺术家的显示方式以及艺术家标签页进行设置。 艺术家页面提供了三种视图，网格视图（大）、网格视图（小）以及列表视图。用户可以按需选择。另外艺术家默认以头像的方式进行展示，用户可以在显示设置中关闭头像显示功能。头像显示功能的更多设置在高级选项中的音乐信息选项中，用户可以在此对头像数据来源进行设置和管理。
艺术家列表页面提供了如下的标签页：
专辑艺术家
作曲家
指挥家
乐队
所有艺术家
这些信息都来自LMS的音乐库，有些用户的音乐库中内容可能会导致有些艺术家的标签页为空。例如用户没有古典音乐，那么艺术家中的指挥家信息可能都是空的。用户可以通过艺术家显示设置来调整这些标签页的顺序或者关闭某些标签页。
流派
当用户的音乐库规模很大时，可能需要通过流派来进行选择性浏览。例如可以通过流派浏览古典音乐或者爵士音乐，某个流派的音乐会按照专辑、艺术家和歌曲分标签页展现。用户可以点击专辑跳转到专辑详情页面，或者点击艺术家跳转到艺术家详情页面，并在详情页面中有选择性的进行播放。
若用户希望播放一个流派的所有歌曲，可以在某个流派的页面的右上角中点击更多按钮，并在底部弹出的对话框中选择立即播放。
年代
年代是另一个浏览大规模音乐库的方式。因为LMS服务器的限制，只提供了具体的年份的音乐库索引，而没有提供一个年代（例如90年代）的专辑索引，因此这里的年代，更多是指年份。 当用户选择了某个年份之后，会按照标签页分别展现该年份的专辑和歌曲信息（年份并没有艺术家标签页，因为艺术家并不能简单的划分到某个年份或者年代）。用户可以点击专辑跳转到专辑详情页面，或者在歌曲标签页直接进行播放。
若用户希望播放某一年的所有歌曲，可以在某个年份页面的右上角中点击更多按钮，并在底部弹出的对话框中选择立即播放。
文件夹
从媒体服务器的角度，文件夹浏览和播放的方式并不是一个主流的方式。此功能是为了国内用户的习惯进行开发的，但是LMS服务器在文件夹功能上表现并不稳定，会出现响应缓慢、文件夹播放顺序错乱等各种问题，这些问题都不是xTune能够解决的，再此还是建议尽量使用专辑、艺术家等入口进行音乐的流浪和播放。
文件夹功能分为音乐文件夹首页和文件夹浏览两个主要的页面。在音乐文件夹首页，顶部列出了LMS系统中所有挂载的文件夹，在系统的文件夹的下方会以列表的形式列出用户收藏的文件夹（此文件夹收藏功能是xTune的功能，收藏的数据是存储在手机上的，若卸载重新安装需要重新搜藏）。
在文件夹浏览页面，会对当前文件夹及文件进行列表方式的展现。为了方便在大量的目录进行快速定位，文件夹浏览提供了字母索引的功能。长按字母索引并拖动可以快速的切换显示首字母开头的文件夹或文件，或者也可以胆机字母索引继续快速切换。
播放控制
xTune提供两种播放控制界面，常驻底部的迷你播放控制和全屏播放控制。
迷你播放控制
在所有的音乐相关界面，底部都会常驻迷你播放控制条，迷你播放控制条的最左侧是xTune全局快捷对话框按钮，点击这个按钮会弹出全局快捷对话框，在迷你播放控制条的中间位置是正在播放的封面图片和曲目信息以及艺术家信息。 在迷你播放控制条的右侧依次是播放控制按钮和附加的操作按钮。播放控制按钮可以用来快速的播放和暂停音乐，操作按钮可以通过设置选项来设置为当前播放器按钮或者当前播放列表按钮。 迷你播放控制条还带有进度条功能，会显示当前正在播放的歌曲的进度信息，进度条的样式可以在设置选项中进行选择，有水平进度条和圆形进度条两种样式。
全屏播放控制
点击迷你播放控制条的歌曲封面和歌曲信息区域，即可进入全屏播放控制界面。 全屏播放控制提供了两种样式可供选择——经典和现代。除此以外，全屏播放控制还提供了各种自定义界面选项，例如是否显示采样率，是否显示曲目编号和是否显示收藏按钮等等，这些选项都可以在设置选项里面进行自定义。 在全屏播放控制界面，除了播放和暂停按钮以外，还提供了上一首、下一首以及切换循环模式以及切换随机模式的按钮。
注意：LMS的循环模式和其他系统稍有区别，一共有3种模式——不循环、单曲循环、专辑循环。
LMS服务器与播放器
xTune提供了一些必要的LMS服务器管理和播放器设置功能。
LMS服务器管理
用户可以在设置菜单种的服务器和媒体库页面中对LMS服务器进行管理，这个界面会显示当前连接的LMS服务器的信息，用户可以通过重启服务器按钮来重启LMS服务器（实际上为重启LMS服务而不是重启LSM服务器所在的电脑或设备）。
另外，xTune还提供了在多台LMS服务器中切换的功能，点击切换服务器按钮后，会列出当前网络中自动发现的所有LMS服务器，如果LMS服务器和移动设备不在一个网段，用户可以点击切换服务器页面底部的添加按钮来手工添加服务器。手工添加的服务器会显示在已发现的服务器列表中供用户选择。
手工添加服务器的功能提供了一种可能性，就是通过互联网，利用VPN技术，访问家中的LMS服务器，例如使用ZeroTier的服务，将移动设备和LMS服务器加入一个网络，这样即便在世界任何角落，都可以使用xTune连接家中的LMS服务器并进行控制，若开启了xTune的内置播放器功能，可以将远程的LMS服务器的音乐推送到xTune移动设备上进行播放。
LMS音乐库管理
用户可以在设置菜单种的服务器和媒体库页面中查看音乐库（媒体库）的信息，并对音乐库进行重新扫描。重新扫描音乐库提供了三个选项：
重新扫描整个音乐库
仅重新扫描歌单
清楚标签数据库并重新扫描音乐库
通常用户只需要选择第一个选项即可。但若是音乐库出现各种错误，例如专辑封面错乱，可以尝试使用第三个选项来重新构建整个音乐库。
LMS播放器管理
作为一个LMS控制端程序，xTune可以管理所有连接到LMS上的播放器，例如squeezlite等。xTune提供了便捷的方式在多个播放器中进行切换：
全局导航菜单：点击页面左上角的菜单按钮唤出导航菜单，菜单接近顶部。点击播放器右侧的上箭头图标，展开并显示所有连接的播放器，选择即可切换。
播放器管理：在全局导航菜单中，点击播放器旁的管理图标，进入播放器管理界面，列出所有连接的播放器。点击眼睛图标即可切换激活的播放器。
全局快捷对话框：点击底部左侧的xTune图标唤出全局快捷对话框。在对话框中，点击播放器右侧的小三角图标，进入播放器管理界面以切换播放器。
播放器操作对话框：在迷你播放条或全屏播放界面，点击播放器图标打开操作对话框。点击顶部播放器旁的小三角图标，显示所有连接的播放器，选择即可切换。
xTune可以对连接到LMS服务器上的播放器进行一些设置和管理，包括音量控制，睡眠、闹铃、多播放器（多房间）同步播放以及对播放器执行关机操作。
注意：关机对于播放器来说实际上是让播放器进入待机状态，例如罗技出品的Squeezebox Transporter在接收到关机指令后除了停止当前播放的音乐以外，还会进入低功耗的待机模式。对于安装在树莓派（Raspberry Pi）的squeezlite播放器，可以在收到待机指令后执行一个脚本，通过GPIO来控制外置的12V Trigger电路，并以此来控制DAC和前后级功放的关机动作。
内置播放器
xTune内置的播放器ZeroPlayer是一个以C语言开发的内置播放器，兼容LMS的SlimProto TCP协议，提供了稳定的高品质音频播放功能。
注意：虽然xTune在开启内置播放器后会使用各种手段让自己常驻后台，但是国产的安卓系统在杀后台这件事情上是越来越不讲规矩，因此建议开启了内置播放器功能的用户，可以将xTune的电池优化管理选项修改未不优化（或者是允许完全的后台行为），因为不同的系统中这个选项差异太大，在此也不能给出非常具体的操作步骤，简而言之，就是要在安卓系统中设置，不要杀掉xTune的后台服务。
支持的音频格式
xTune内置了独立于系统的高性能解码器，可以支持各种音频格式的解码，因为xTune专为HIFI回放而设计，因此xTune仅支持单声道/双声道解码，多声道音频会被转换为双声道解码。xTune支持的音频格式如下：
FLAC
PCM/WAVE
Apple Lossness
DSD (DSF/DSDIFF)
MP3
安卓音频
xTune可以利用安卓系统的音频输出来播放音乐，因为安卓系统会对音频进行SRC，因此安卓音频输出并不是一种高保真的输出，此功能仅为没有条件使用DAC的环境设计。因为安卓系统音频的特点（例如强制重采样到48KHz），播放一些音频文件时可能会有破音、停顿等现象。若对音质有较高要求，强烈建议使用独占的USB DAC输出方式来回放高保真音频。 在安卓系统音频输出模式下，DSD格式的音频会自动转换为PCM并降频播放，高采样率的音频文件也会被降频以及降采样深度进行播放。这些都是有损的播放方式。
注意：在设置菜单中，用户可以对安卓音频输出的采样深度和采样率进行控制，但是因为硬件设备差异较大，有些设备在24bit采样深度的格式下输出会有噪音等现象，而有些设备，则不支持高采样率（超过48KHz）的音频输出，用户应该根据自己设备的情况进行合理的设置。
独占USB-DAC
xTune的内置播放器支持独占模式的USB DAC，在此模式下，xTune会绕过安卓系统的限制，直接访问USB DAC硬件，使用USB Audio 1.0/2.0进行音频数据的输出。在此模式下，若DAC的硬件支持，可以直接输出DSD Native音频数据，或者使用DoP(DSD Over PCM)的格式进行输出，若DAC不支持这两种模式，DSD的音频会自动转换为PCM进行输出。
在独占USB DAC模式下，采样率可以支持到(44.1 kHz / 48 kHz / 88.2 kHz / 96 kHz / 176.4 kHz / 192 kHz / 352.8 kHz / 384 kHz) ，采样深度支持16bit/24bit/32bit。
xTune会自动检测到USB DAC的插入，并弹出请求获取录音权限的对话框，此处需要确认，才能让xTune拥有直接访问USB DAC的权限。xTune只有音频重放的功能，不会使用USB设备来录音（绝大多数USB DAC也没有录音的功能）。当xTune使用USB DAC进行音频重放时，在全屏的播放控制界面，可以看到USB的图标，点击后可以打开音频输出路径对话框，用户可以在路径对话框中查看xTune的音频处理逻辑和路径，并以此为依据来调整xTune的相关设置。
DSD输出模式
DSD Native：当开启了DSD Native选项时，若DAC支持，会优先采用DSD Native格式输出DSD音频。
DSD Over PCM (DoP)：若DSD选项没有开启，或者DAC不支持DSD Native输出格式时，若开启了DoP选项，会使用DoP格式输出DSD音频。
DSD 转 PCM：当DSD Native和DSD Over PCM没有开启或者不支持时，会自动进行DSD到PCM的转换，并以PCM的格式输出。
Bit-Perfect模式
xTune提供了Bit-Perfect模式，在此模式下，会绕过所有的数字DSP处理，源码会Bit-Perfect的输出到DAC。
若未开启Bit-Perfect模式，所有的音频（DSD除外），会转换到内部的64bit双精度格式，并进行各种DSP的处理（包括音量调节等），最终输出会根据DAC的情况，选择一个最高的采样深度进行输出（例如32bit），尽量减轻DSP处理带来的音质的影响。
若开启了Bit-Perfect模式，所有的音频（包括DSD），不会转换到任何的内部格式，直接以最接近原始采样率和采样深度的源码输出到DAC。例如，若DAC支持192K/24bit，任何192K/24bit的音频，都会以这个格式输出到DAC；又例如，若DAC支持44.1K/16bit，那么任何44.1K/16bit的音频都会以同样的格式输出到DAC。
自适应SRC
若DAC支持的最高采样率不够高，或者采样深度不够，在播放高码率的音频文件时，会进行自动的自适应SRC转换，这种转换会尽量的采用倍频的方式进行转换，可以有效的降低音质的损耗。
数字音量调节
xTune提供了两种模式的数字音量调节方式：
线性音量调节：这是一种传统的数字音量调节方式，采用的是完全线性的按比例降低音量的算法。
等响曲线音量调节：等响曲线简单的理解是人类的听力对同样声压的不同频率的声音的主观感觉会不一样，当使线性音量调节算法等比例的降低音量后，人类会觉得低频和高频会更明显的变弱，因此才会有等响曲线这样的在调节音量时采用曲线补偿低频和高频的算法。
用户可以选择开启或关闭等响曲线调节算法，但理论上，小音量环境下（特别是深夜不想打扰旁人），等响曲线音量调节是一个更好的选择。
菜单和快捷方式
xTune设计的最初就考虑了易用性以及操作的便利性，因此导航菜单及快捷方式是xTune不断优化的功能。
全局导航菜单
点击xTune界面左上角的菜单按钮，即可唤出全局导航菜单，全局导航菜单除了提供了几乎所有的菜单选项之外，还在顶部提供了当前的服务器信息以及当前的播放器信息，也在这些区域提供了快速设置服务器和播放器的各种按钮和选项。 全局导航菜单提供了上下滑动来显示菜单其余部分的功能，同时，若觉得某个功能不需要，可以在设置选项中关闭该功能，与此同时，全局导航菜单也会隐藏被关闭的功能菜单项。
全局快捷对话框
在所有的音乐界面（设置界面以外），点击界面左下角的xTune图标，即可弹出全局快捷对话框。 在这个快捷对话框中，提供了更丰富的播放控制功能，也提供了可自定义的快捷图标选项。
在全局快捷对话框的播放控制功能中，可以快速的切换当前播放器，可以暂停或开始播放，上一首、下一首、循环、随机等控制。点击这个对话框右上角的音量图标后，之前的播放控制按钮会暂时变成音量控制按钮，用户可以同通过这里快速的调整音量。
全局快捷对话框右侧顶部，提供了设置按钮，点击此按钮可以快速的进入设置界面。
在全局快捷对话框的底部，提供了可自定义的快捷按钮，用户可以在几乎任何界面一键唤出全局快捷对话框，并点击首页、专辑、艺术家等快捷按钮来快速的继续页面跳转和导航。快捷按钮提供了自定义功能，滑动快捷按钮区域翻到最后一页，点击+号图标即可进行自定义操作。用户可以长按并拖动来进行排序，并删除不需要的按钮，或者添加所需的按钮。
首页快捷方式
在首页的卡片中，提供了一个快捷方式卡片，其功能与全局快捷对话框的快捷按钮区域功能基本一致，用户也可以通过点击+号自定义按钮来进行自定义。操作可以参考全局快捷对话框快捷方式的操作逻辑。
设置选项
为了在不断增加功能的同时还能保证良好的易用性，xTune实现了大量的可调整的设置选项来让用户进行各种功能和界面自定义的选择。
多语言
xTune默认会跟随系统语言，若不是中文系统，会优先采用英文作为默认语言，用户可以在设置选项中进行修改。
主题与样式
xTune提供了两套主题，浅色主题和暗色主题供用户选则。在默认的设置下，xTune会跟随系统的主题样式设置，若系统是暗黑模式，那么会自动优先使用暗色主题。
通知设置
若在xTune的设置选项中开启了通知设置，会默认打开锁屏通知和持续通知选项，用户也可以有选择性的关闭这些选项。
锁屏通知：开启这个选项后，并在安卓系统中开启xTune的锁屏通知功能，在锁屏中可以看到xTune的正在播放的信息通知。
持续通知：开启了这个选项后，若xTune处于正在播放音乐的状态，这个通知条将不能被滑动删除，当停止播放后，通知可以被删除。
高级设置
屏幕常亮：高级设置中提供了屏幕常亮设置，有些人如果希望使用xTune当作数字转盘，可以考虑开启此选项。
音量键控制：开启了这个选项后，可以使用移动设备的硬件音量键来控制播放器的音量。
音乐信息：此选项控制的是艺术家头像、艺术家简介以及艺术家照片集的信息抓取功能。目前有两个数据来源，QQ音乐和Last.fm，其中QQ音乐只能获取艺术家头像，Last.fm可以提供额外的艺术家简介和艺术家照片集信息，但是因为总所周知的原因，Last.fm在国内是无法访问的。
TrackStat插件：TrackStat插件是一个LMS服务器的插件，安装并打开TrackStat支持后，xTune可以额外的提供最近播放专辑、播放最多专辑、热门艺术家等功能。但这个插件的作者已经不再维护，并且有网友反馈在媒体库偏大的情况下，这个插件会严重的拖慢LMS服务器的性能，并影响LMS服务器的稳定性，超过100张专辑的媒体库不建议安装这个插件。
|
|
楼主: xxbin1911
粤公网安备 44030602000598号 耳机大家坛、www.erji.net、网站LOGO图形均为注册商标 
IP卡
狗仔卡
楼主
显身卡
发表于 2024-10-18 22:21
