Groove Basin 技术文档

本文档将详细介绍如何安装、使用 Groove Basin 音乐播放服务器，以及如何利用其 API 进行开发。

1. 安装指南

Ubuntu 17.04 Zesty

1. 安装必要的依赖：

   sudo apt-get install nodejs libgrooveloudness-dev libgroovefingerprinter-dev libgrooveplayer-dev libgroove-dev
   

2. 克隆仓库并进入目录：

   git clone [仓库地址]  # 替换为实际的仓库地址
   cd groove-basin
   

3. 构建项目：

   npm run build
   

4. 启动服务：

   npm start
   

Ubuntu 18.04 Bionic

1. 从源代码安装 node-groove 和其依赖，按照以下指南进行操作：

   https://github.com/andrewrk/node-groove/blob/2.x/README.md#ubuntu-1804
   

2. 修改 package.json 文件，将 "groove" 依赖更改为指向 node-groove 安装的目录。

3. 按照上述 Ubuntu 17.04 的步骤 2 继续操作。

2. 项目的使用说明

Groove Basin 提供了一个基于网页的用户界面，用于控制音乐播放服务器。以下是基本使用方法：

• 打开浏览器，输入服务器的 IP 地址和端口，访问 Groove Basin 界面。
• 使用拖放功能上传音乐文件到播放列表。
• 使用搜索功能查找音乐。
• 使用自动 DJ 功能随机播放音乐。
• 通过键盘快捷键进行快速操作。

3. 项目 API 使用文档

Groove Basin 提供了一个协议，允许开发者编写自己的客户端。以下是一些基本的 API 使用示例：

• 获取当前播放列表：

  // 示例代码，实际使用时需要根据实际情况编写
  groovelbasin.getPlaylist(function(err, playlist) {
      if (err) throw err;
      console.log(playlist);
  });
  

• 添加歌曲到播放列表：

  // 示例代码，实际使用时需要根据实际情况编写
  groovelbasin.addToPlaylist(songId, function(err) {
      if (err) throw err;
      console.log('Song added to playlist');
  });
  

• 播放/暂停音乐：

  // 示例代码，实际使用时需要根据实际情况编写
  groovelbasin.playPause(function(err) {
      if (err) throw err;
      console.log('Playback toggled');
  });
  

4. 项目安装方式

Groove Basin 的安装方式已在上述安装指南中详细说明，主要包括从源代码克隆、安装依赖、构建和启动服务。

请按照上述步骤进行操作，确保 Groove Basin 正确安装并运行。如果在安装过程中遇到任何问题，请参考项目文档或在社区寻求帮助。

---

本文档旨在帮助用户更好地理解和使用 Groove Basin，如有任何问题或建议，请随时向项目维护者反馈。