【亲测免费】 Sonic Visualiser 技术文档

1. 安装指南

1.1 系统要求

Sonic Visualiser 支持 Windows、Linux 和 macOS 操作系统。请确保您的系统满足以下要求：

• Windows: Windows 7 及以上
• macOS: macOS 10.12 及以上
• Linux: 大多数现代 Linux 发行版

1.2 下载与安装

1. 访问 Sonic Visualiser 的官方网站（https://sonicvisualiser.org/）。
2. 根据您的操作系统，下载相应的安装包。
3. 运行下载的安装包，按照提示完成安装过程。

1.3 从源代码编译

如果您希望从源代码编译 Sonic Visualiser，请参考以下指南：

• Linux 和类似系统: 参考 COMPILE_linux.md
• macOS: 参考 COMPILE_macos.md
• Windows: 参考 COMPILE_windows.md

2. 项目使用说明

2.1 加载音频文件

1. 启动 Sonic Visualiser。
2. 点击菜单栏中的“文件” -> “打开”，选择您要分析的音频文件。
3. 支持的音频格式包括 WAV、AIFF、Ogg、Opus、MP3 等。

2.2 查看音频波形

1. 加载音频文件后，您将看到音频的波形图。
2. 您可以通过拖动时间轴来查看不同部分的波形。

2.3 音频可视化

1. 点击菜单栏中的“视图” -> “添加视图”，选择您想要的可视化类型（如频谱图）。
2. 您可以通过调整显示参数来优化可视化效果。

2.4 音频标注

1. 点击菜单栏中的“标注” -> “添加标注”，选择您要添加的标注类型（如时间点、段落等）。
2. 您可以为标注添加标签，并定义其属性。

2.5 音频播放与回放

1. 点击播放按钮以播放音频。
2. 您可以通过调整播放速度和循环段落来更好地分析音频。

3. 项目 API 使用文档

3.1 Open Sound Control (OSC) 协议

Sonic Visualiser 支持通过 Open Sound Control (OSC) 协议进行远程控制。如果您的系统支持 OSC，您可以通过以下步骤进行配置：

1. 确保 Sonic Visualiser 编译时启用了 OSC 支持。
2. 使用 OSC 客户端发送控制命令到 Sonic Visualiser。

3.2 插件 API

Sonic Visualiser 支持多种插件，包括 Vamp 插件和 LADSPA 插件。您可以通过以下步骤使用这些插件：

1. 下载并安装所需的插件。
2. 在 Sonic Visualiser 中加载插件，并配置其参数。
3. 运行插件以自动生成标注或进行其他分析。

4. 项目安装方式

4.1 二进制安装包

1. 访问 Sonic Visualiser 的官方网站（https://sonicvisualiser.org/）。
2. 下载适用于您操作系统的二进制安装包。
3. 运行安装包，按照提示完成安装。

4.2 源代码编译

1. 克隆 Sonic Visualiser 的 GitHub 仓库：

   git clone https://github.com/sonic-visualiser/sonic-visualiser.git
   

2. 根据您的操作系统，参考相应的编译指南进行编译。

通过以上步骤，您可以顺利安装并使用 Sonic Visualiser 进行音频文件的可视化、分析和标注。