MPDroid 技术文档

1. 安装指南

1.1 系统要求

MPDroid 适用于 Android 4.0.3（API 15）及以上版本的所有设备。

1.2 安装方式

MPDroid 可以通过 F-Droid 进行安装。F-Droid 是一个开源应用程序仓库，用户可以在其中找到并安装 MPDroid。

1.3 手动安装

用户也可以通过下载 APK 文件手动安装 MPDroid。请确保从可信来源下载 APK 文件，以避免安全风险。

2. 项目使用说明

2.1 功能概述

MPDroid 是一个适用于 Android 的 MPD（Music Player Daemon）客户端。它允许用户浏览音乐库、控制当前播放的歌曲和播放列表、管理输出设备，并将音乐流式传输到移动设备。MPDroid 采用了现代的 Holo 设计，界面美观。

2.2 主要功能

• 音乐库浏览：用户可以浏览音乐库，查看专辑、艺术家和歌曲。
• 播放控制：控制当前播放的歌曲，包括播放、暂停、上一首、下一首等。
• 播放列表管理：创建、编辑和删除播放列表。
• 输出管理：管理音频输出设备，选择不同的输出源。
• 流媒体支持：将音乐流式传输到移动设备。

2.3 界面介绍

MPDroid 的界面设计简洁直观，主要分为以下几个部分：

• 播放控制栏：位于屏幕底部，显示当前播放的歌曲信息，并提供播放控制按钮。
• 音乐库浏览：通过不同的标签页浏览专辑、艺术家和歌曲。
• 播放列表管理：用户可以在此处管理当前的播放列表。

3. 项目API使用文档

3.1 JMPDComm

JMPDComm 是 MPDroid 的核心 MPD 接口库，经过大量修改以适应 Android 平台。它负责与 MPD 服务器的通信，处理音乐库的浏览、播放控制等操作。

3.2 DragSortListView

DragSortListView 是一个用于替换 TouchInterceptor 的库，提供了更好的列表排序和拖放功能。

3.3 ActionBar-PullToRefresh

ActionBar-PullToRefresh 库为音乐库提供了下拉刷新功能，用户可以通过下拉操作刷新音乐库内容。

4. 项目安装方式

4.1 通过 F-Droid 安装

1. 打开 F-Droid 应用。
2. 搜索 "MPDroid"。
3. 点击安装按钮，等待安装完成。

4.2 手动安装

1. 下载 MPDroid 的 APK 文件。
2. 打开设备的“设置”应用，进入“安全”选项，启用“未知来源”安装。
3. 找到下载的 APK 文件，点击安装。
4. 按照屏幕提示完成安装。

5. 常见问题

5.1 多服务器支持

MPDroid 目前的多服务器支持有限，主要基于 WLAN 名称进行区分。未来版本将改进这一功能。

5.2 性能问题

MPDroid 的性能在某些情况下可能不够理想，尤其是在 3G 网络环境下。这是由于 MPD 的 API 设计并未考虑移动网络的特性。

6. 未来路线图

6.1 版本 1.1 计划

• 改进多服务器配置，提供更好的实现方式。
• 添加 Bonjour 支持。
• 重构流媒体存储。
• 按 CD 分割专辑详情，并允许仅添加一张 CD 到播放列表。

7. 特别感谢

MPDroid 的开发离不开以下开发者和项目的支持：

• PMix 项目，提供了原始代码基础。
• Mopidy 项目，协助实现了搜索功能。
• 众多开发者，贡献了代码和改进建议。

感谢所有为 MPDroid 做出贡献的人！