PHP MP3 PNG波形生成器技术文档

1. 安装指南

环境要求

• PHP 5+版本
• LAME MP3编码器（Windows版本可以从rarewares网站获取）
• Web服务器（如Apache，除非修改为命令行脚本运行）

安装步骤

1. 将项目文件复制到Web服务器的某个位置。
2. 确保从该目录可以访问并执行'lame'命令（对于Windows系统，将下载的.exe和.dll文件放入同一目录中，或修改脚本）。
3. 确保目录具有写权限，或者指定一个具有写权限的备用临时输出目录。
4. 在浏览器中启动脚本（例如，http://localhost/php-waveform-png.php），上传MP3文件并选择输出设置（尺寸、颜色等）。

2. 项目使用说明

在浏览器中加载脚本后，初始表单允许您指定生成和显示图像的一些基本参数。除了明显的尺寸和颜色外，还有两个高级选项：

• “绘制直线”选项表示是否绘制值为0的波形点细节。启用此选项可以在没有音频播放的地方看到一条平坦的零级线。否则将留空。
• “立体声波形”选项允许您在单个图像中分别生成左右音频通道。

波形的细节可以通过修改脚本顶部的DETAIL常量来调整。数值越低，跳过的数据点越少，从而产生更详细的波形。

脚本中最耗时的部分是LAME编码器，它首先将上传的MP3转换为16位单声道8 KHz的MP3，然后转换为WAV音频文件。不幸的是，使用LAME编码器似乎不能一步完成这个过程。如果此脚本要修改为对同一MP3多次实时生成波形，建议保存最终WAV文件的副本，或者修改脚本以保持振幅点的数据集，以便可以更快地重绘图波形。

3. 项目API使用文档

本项目未提供API接口。

4. 项目安装方式

请遵循上述“安装指南”中的步骤进行安装。