[python]windows上通过whl文件安装sounddevice教程

要通过.whl文件完成sounddevice的安装,可参考以下流程:

一、前期准备

获取.whl文件
前往 gitee.com/FIRC/pythonlibs_whl_mirror 或其他可信资源站点,下载适用于你系统的sounddevice.whl包。注意核对Python版本与操作系统架构(如32位或64位)是否匹配。

确认pip已安装
pip是Python默认的包管理工具,通常随Python一同安装。可在命令行输入以下命令检查:

pip --version

若未安装,可通过如下命令进行安装并升级:

python -m ensurepip --upgrade

安装依赖库PortAudio
由于sounddevice基于PortAudio运行,因此需预先安装该底层音频库。

  • Windows系统:从PortAudio官网获取预编译的二进制文件并手动安装。
  • macOS系统:使用Homebrew工具安装,执行命令:
    brew install portaudio
  • Linux系统(如Ubuntu):利用系统包管理器安装开发包,例如:
    sudo apt-get install portaudio19-dev
二、执行安装

打开命令行工具

  • Windows用户可使用cmdPowerShell
  • macOS和Linux用户请打开终端程序。

进入.whl文件所在路径
使用cd命令切换至你保存.whl文件的目录,例如:

cd Downloads

运行安装命令
执行以下指令进行本地安装:

pip install sounddevice-x.x.x-py3-none-any.whl

请将sounddevice-x.x.x-py3-none-any.whl替换为你实际下载的文件名。

三、验证是否安装成功

导入模块测试
启动Python环境,尝试导入模块:

import sounddevice as sd

列出音频设备信息
运行以下代码查看当前系统的音频设备列表:

print(sd.query_devices())

判断安装结果
若无报错信息,并能正常输出设备列表,则表明sounddevice已成功安装。

至此,你已完成通过.whl文件对sounddevice安装配置。现在即可在Python项目中使用该库实现音频录制与播放功能。