AudioDock / 声仓
首页功能下载文档Github
文档用户指南

用户指南

本指南将帮助您快速上手 AudioDock，了解所有核心功能的使用方法。

目录

安装与配置

系统要求

  • 操作系统: macOS 10.15+, Windows 10+, Linux (Ubuntu 20.04+)
  • 内存: 至少 4GB RAM
  • 存储: 至少 2GB 可用空间
  • 网络: 用于同步功能和元数据获取

安装步骤

macOS

# 使用 Homebrew 安装
brew tap mmdctjj/audiodock
brew install audiodock
 
# 启动服务
audiodock start

Windows

  1. 从 GitHub Releases 下载安装包
  2. 运行安装程序
  3. 按照向导完成安装

Linux

# 下载安装脚本
curl -fsSL https://raw.githubusercontent.com/mmdctjj/AudioDock/main/install.sh | bash
 
# 或者使用包管理器
# Ubuntu/Debian
sudo apt install audiodock
 
# Fedora/RHEL
sudo dnf install audiodock

基本使用

添加音乐库

  1. 打开 AudioDock 应用
  2. 点击左上角的 ”+” 按钮
  3. 选择您的音乐文件夹
  4. AudioDock 会自动扫描并导入所有音频文件

播放控制

  • 播放/暂停: 空格键 或 点击播放按钮
  • 上一曲/下一曲: ← → 方向键
  • 音量控制: ↑ ↓ 方向键
  • 播放列表: 右键点击歌曲添加到播放列表

创建播放列表

  1. 在侧边栏点击 “新建播放列表”
  2. 输入播放列表名称
  3. 将歌曲拖拽到播放列表中
  4. 保存播放列表

高级功能

多设备同步

  1. 在所有设备上登录相同的 AudioDock 账户
  2. 确保设备在同一网络中
  3. 播放状态会自动同步

主题切换

AudioDock 支持两种主题模式：

  • 浅色主题: 适合白天使用
  • 深色主题: 适合夜间使用

切换方法：

  1. 点击右上角设置图标
  2. 选择 “外观”
  3. 选择喜欢的主题

歌词显示

AudioDock 自动从网络获取歌词：

  1. 播放歌曲时，歌词会自动显示
  2. 点击歌词区域可以切换显示模式
  3. 支持歌词翻译和音译

音频增强

在设置中启用音频增强功能：

  • 均衡器: 自定义音频频率
  • 空间音频: 3D 环绕声效果
  • 音量标准化: 统一所有歌曲音量

故障排除

常见问题

音乐无法播放

  1. 检查音频文件格式是否支持（MP3, FLAC, AAC, WAV）
  2. 确保有足够的磁盘空间
  3. 重启 AudioDock 应用

同步功能失效

  1. 检查网络连接
  2. 确认所有设备登录同一账户
  3. 重启同步服务

歌词无法显示

  1. 检查网络连接
  2. 确认歌曲信息完整
  3. 尝试手动搜索歌词

获取帮助

如果遇到其他问题：

  1. 查看 常见问题 页面
  2. 在 GitHub Issues 报告问题
  3. 联系技术支持: support@audiodock.com

下一步: 查看 API 参考 了解开发者功能。

常见问题首页